Requisitos previos
- Una entidad con sus documentos y archivos cargados. Consulta Cargar documentos y comprobantes.
- Para una empresa, cada propietario está vinculado y tiene sus propios documentos y archivos. Consulta Gestionar beneficiarios finales.
¿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:
documentationStatusesCOMPLETEen 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,
verifydevuelve 422NO_PROOFS_UPLOADED.
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á enIN_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_KYCcon el motivo enstatusReason, y cada archivo rechazado incluye su propioverificationReason. Carga un reemplazo con el mismoproofType, o corrige los datos, y luego llama de nuevo a Solicitar verificación. - Rechazada: la entidad pasa a
REJECTEDy el motivo queda en el historial de estados. Una entidadREJECTEDno puede enviarse de nuevo: registra una nueva entidad con un nuevoexternalId, o ponte en contacto con tu gestor de cuenta.
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. BLOCKEDy el regreso aACTIVElos 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.

