> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Realiza el seguimiento de las revisiones y corrige los rechazos.

> Solicita la revisión KYC/KYB de una entidad, consulta el resultado y corrige lo que Localpayment te pida.

Cuando la entidad tiene sus datos y archivos, tú solicitas la revisión con [Solicitar verificación](https://docs.localpayment.com/es/reference/request-entity-verification.md); tú nunca la apruebas. El equipo de Cumplimiento de Localpayment decide sobre cada archivo y sobre la entidad. No necesitas esperar el resultado ni consultar la entidad de forma periódica. Cuando algo deba cambiar, Cumplimiento te indica qué y por qué, tú lo corriges y solicitas la verificación nuevamente. Si deseas seguir el resultado, utiliza [Obtener estado de KYC](https://docs.localpayment.com/es/reference/get-kyc-status.md) y [Obtener historial de estados](https://docs.localpayment.com/es/reference/get-entity-status-history.md).

## Requisitos previos

* Una entidad con sus documentos y archivos cargados. Consulta [Cargar documentos y comprobantes](https://docs.localpayment.com/es/docs/upload-documents-and-proofs.md).
* Para una empresa, cada propietario está vinculado y tiene sus propios documentos y archivos. Consulta [Gestionar beneficiarios finales](https://docs.localpayment.com/es/docs/manage-ubos.md).

## ¿Quién hace qué?

```mermaid theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
%%{init: {'theme': 'base', 'themeVariables': {'background': '#ffffff', 'primaryColor': '#31467c', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#0c1a29', 'secondaryColor': '#31467c', 'tertiaryColor': '#ffffff', 'lineColor': '#0c1a29', 'textColor': '#0c1a29', 'edgeLabelBackground': '#ffffff', 'fontFamily': 'Manrope'}, 'fontFamily': 'Manrope', 'htmlLabels': false, 'flowchart': {'htmlLabels': false, 'wrappingWidth': 400, 'padding': 20}}}%%
flowchart TD
    A["Su backend<br/>GET /api/entity/v1/entities/{entityId}/kyc-status"] --> B["Entities API<br/>documentationStatus COMPLETE"]:::lp
    B --> V["Su backend<br/>Solicita la revisión<br/>POST /api/entity/v1/entities/{entityId}/verify"]
    V --> C["Entities API<br/>202 Accepted: entidad IN_REVIEW"]:::lp
    C --> D["Compliance de Localpayment<br/>Revisa cada comprobante: APPROVED o REJECTED, con motivo"]:::lp
    D --> E["Compliance de Localpayment<br/>Resuelve la entidad: ACTIVE, REJECTED, o vuelve a PENDING_KYC para una corrección"]:::lp
    E --> F["Su backend, opcional<br/>GET /api/entity/v1/entities/{entityId}/kyc-status<br/>para seguir el resultado"]
    F --> G["Su backend<br/>GET /api/entity/v1/entities/{entityId}/status-history<br/>cada cambio, con quién lo hizo y por qué"]
    classDef default fill:#31467c,stroke:#0c1a29,stroke-width:1px,color:#ffffff,font-family:Manrope
    classDef lp fill:#0c1a29,stroke:#0c1a29,color:#ffffff
    classDef terminal fill:#0c1a29,stroke:#0c1a29,color:#ffffff
    classDef lbl fill:#0c1a29,stroke:#0c1a29,color:#ffffff,font-size:13px
```

> [!NOTE]
>
> No necesitas consultar la entidad de forma periódica. Los webhooks de cambio de estado no están disponibles para las entidades; si deseas seguir la revisión, llama a Obtener estado de KYC a intervalos razonables, por ejemplo cada pocos minutos mientras la entidad esté en `IN_REVIEW`.

## Antes de la revisión

* Cada documento tiene sus archivos: `documentationStatus` es `COMPLETE` en Obtener estado de KYC.
* En una empresa, cada propietario está vinculado y tiene sus propios documentos y archivos.
* Se ha cargado al menos un archivo; de lo contrario, `verify` devuelve 422 `NO_PROOFS_UPLOADED`.

Mientras la entidad está en `IN_REVIEW` permanece bloqueada: no puede editar sus datos, agregar ni editar documentos, cargar ni eliminar archivos, ni vincular, modificar o finalizar UBO (409 `ENTITY_IN_REVIEW`).

## Lee el estado de KYC

Mientras la entidad está en `IN_REVIEW`, después de que Cumplimiento aprobó ambos archivos:

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "entityId": "5aced5da-40c1-4bec-85ff-c8cd1bcb4526",
  "status": "IN_REVIEW",
  "documentationStatus": "COMPLETE",
  "statusReason": "Review started",
  "documents": [
    {
      "documentId": "2e16d844-4fa9-4295-9a21-83ec32ef241a",
      "type": "CPF",
      "status": "VERIFIED",
      "proofs": [
        {
          "proofId": "2c4c2f74-7179-4113-83fb-f11dbce9e07d",
          "verificationStatus": "APPROVED"
        }
      ]
    },
    {
      "documentId": "e0ea9515-442e-4bc5-bc82-b8d278255c37",
      "type": "PROOF_OF_ADDRESS",
      "status": "VERIFIED",
      "proofs": [
        {
          "proofId": "acb78b3f-fe18-4094-b6a9-2107f502d709",
          "verificationStatus": "APPROVED"
        }
      ]
    }
  ]
}
```

| Campo | Cómo leerlo |
| - | - |
| status | El estado del ciclo de vida de la entidad. El objetivo es ACTIVE. |
| statusReason | Motivo del último cambio de estado. Cuando la entidad vuelve al estado PENDING\_KYC, indica qué se debe corregir. |
| documentationStatus | Cobertura de archivo únicamente. COMPLETE con pruebas aún PENDING es normal antes de la revisión. |
| documents\[].status | VERIFIED cuando todas sus pruebas activas son APPROVED, REJECTED si alguna es rechazada, EXPIRED si ha pasado la fecha de caducidad declarada. |
| documents\[].proofs\[].verificationStatus | PENDING, luego IN\_REVIEW, luego APPROVED o REJECTED, establecido por Localpayment. |

Si deseas seguir la revisión, un bucle de consulta en Python:

```python theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
import os
import time
import requests

BASE_URL = "https://api.stage.localpayment.com/api/entity"
access_token = os.environ["LOCALPAYMENT_ACCESS_TOKEN"]
entity_id = "5aced5da-40c1-4bec-85ff-c8cd1bcb4526"
headers = {"Authorization": f"Bearer {access_token}"}
last_reason = None

while True:
    response = requests.get(f"{BASE_URL}/v1/entities/{entity_id}/kyc-status", headers=headers, timeout=30)
    if response.status_code != 200:
        problem = response.json()
        raise RuntimeError(f"{problem.get('code')} correlationId={problem.get('correlationId')}")

    kyc = response.json()
    if kyc["status"] in ("ACTIVE", "REJECTED"):
        break

    if kyc["status"] == "PENDING_KYC" and kyc.get("statusReason") and kyc["statusReason"] != last_reason:
        # Correction requested: read statusReason and the verificationReason of each
        # rejected proof (GET /v1/proofs/{proofId}), then correct the data or upload
        # a replacement with the same proofType, then call POST .../verify again.
        last_reason = kyc["statusReason"]

    time.sleep(300)  # every 5 minutes
```

## Posibles resultados

```mermaid theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
%%{init: {'theme': 'base', 'themeVariables': {'background': '#ffffff', 'primaryColor': '#31467c', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#0c1a29', 'secondaryColor': '#31467c', 'tertiaryColor': '#ffffff', 'lineColor': '#0c1a29', 'textColor': '#0c1a29', 'edgeLabelBackground': '#ffffff', 'fontFamily': 'Manrope'}, 'fontFamily': 'Manrope', 'htmlLabels': false, 'flowchart': {'htmlLabels': false, 'wrappingWidth': 400, 'padding': 20}}}%%
flowchart LR
    R["IN_REVIEW"]:::lp --> A{"Decisión de Compliance"}
    A --- L1(["todos los comprobantes aprobados"]):::lbl --> OK["ACTIVE"]
    A --- L2(["corrección solicitada"]):::lbl --> P["PENDING_KYC<br/>statusReason, y verificationReason en el comprobante"]
    P --> U["Corrija los datos o<br/>cargue de nuevo el mismo proofType,<br/>luego POST .../verify otra vez"]
    U --> R
    A --- L3(["caso rechazado"]):::lbl --> NO["REJECTED<br/>motivo en el historial de estados"]
    OK --> B["Compliance puede bloquear y desbloquear más adelante"]
    classDef default fill:#31467c,stroke:#0c1a29,stroke-width:1px,color:#ffffff,font-family:Manrope
    classDef lp fill:#0c1a29,stroke:#0c1a29,color:#ffffff
    classDef terminal fill:#0c1a29,stroke:#0c1a29,color:#ffffff
    classDef lbl fill:#0c1a29,stroke:#0c1a29,color:#ffffff,font-size:13px
```

* **Aprobada:** la entidad pasa a `ACTIVE`.
* **Corrección solicitada:** la entidad vuelve a `PENDING_KYC` con el motivo en `statusReason`, y cada archivo rechazado incluye su propio `verificationReason`. Carga un reemplazo con el mismo `proofType`, o corrige los datos, y luego llama de nuevo a [Solicitar verificación](https://docs.localpayment.com/es/reference/request-entity-verification.md).
* **Rechazada:** la entidad pasa a `REJECTED` y el motivo queda en el historial de estados. Una entidad `REJECTED` no puede enviarse de nuevo: registra una nueva entidad con un nuevo `externalId`, o ponte en contacto con tu gestor de cuenta.

Historial de estado después de la aprobación, con cada cambio, quién lo realizó y por qué:

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
[
  {
    "fromStatus": "PENDING_KYC",
    "toStatus": "IN_REVIEW",
    "reason": "Review started",
    "changedBy": "12345",
    "correlationId": "b68165b9-1d60-4f9d-9919-7fee12411714",
    "createdAt": "2024-01-15T17:03:15Z"
  },
  {
    "fromStatus": "IN_REVIEW",
    "toStatus": "ACTIVE",
    "reason": "KYC approved",
    "changedBy": "67890",
    "correlationId": "b07a3416-11fb-48d8-8671-be471694f0a2",
    "createdAt": "2024-01-15T17:03:22Z"
  }
]
```

## Reglas para recordar

* Tú solicitas la revisión con `verify`; aprobarla o rechazarla lo hace únicamente Localpayment.
* La edición de los datos de la entidad después de la aprobación no cambia la revisión registrada. La edición de un documento restablece sus archivos aprobados a `PENDING`, y se revisan de nuevo.
* `BLOCKED` y el regreso a `ACTIVE` los decide Cumplimiento. Puedes verlos en el historial de estados junto con su motivo.

## Próximos pasos

> [card] [Gestionar beneficiarios finales](https://docs.localpayment.com/es/docs/manage-ubos.md)
>
> Para las empresas: vincula a los beneficiarios finales.

> [card] [Estados de las entidades y códigos de error](https://docs.localpayment.com/es/reference/entity-statuses-and-error-codes.md)
>
> Todos los estados, transiciones y códigos de error.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.