Saltar al contenido principal
Cuando la entidad tiene sus datos y archivos, tú solicitas la revisión con Solicitar verificación; 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 y Obtener historial de estados.

Requisitos previos

¿Quién hace qué?

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:
Si deseas seguir la revisión, un bucle de consulta en Python:

Posibles resultados

  • 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.
  • 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é:

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

Gestionar beneficiarios finales

Para las empresas: vincula a los beneficiarios finales.

Estados de las entidades y códigos de error

Todos los estados, transiciones y códigos de error.
Última modificación el 10 de noviembre de 2026