Primeros pasos
Integración / SDKs
Verificación de usuarios
Verificación de empresas
Monitorización de transacciones
Registro de cambios"In Progress" y "Not Finished", las mismas cadenas que incluyen los webhooks.
Haz coincidir esas cadenas, no con nombres en mayúsculas.
Estado de la sesión
El estado general de una sesión de Verificación de empresas (KYB). Es el campo que más a menudo usarás para decidir qué hacer."Awaiting User" es un estado transitorio: no necesitas sacar las sesiones de él manualmente. En cuanto el usuario final completa la acción pendiente (por ejemplo, envía la lista de personas clave o vuelve a cargar un documento solicitado), Didit vuelve a evaluar la sesión y la pasa automáticamente a "In Review", "Approved" o "Declined" según el resultado.Estado de las funciones
Cada función de KYB tiene su propio estado, que se agrega al estado de la sesión.Nombres de las funciones de KYB
Estos son los valores defeatures en una sesión de KYB y en los webhooks:
KYB_REGISTRY: consulta al registro de empresas.AML: análisis AML a nivel de empresa.KYB_DOCUMENTS: recopilación de documentos y OCR.KYB_KEY_PEOPLE: personas clave: beneficiarios finales, accionistas, directores, representantes y otros cargos.
Estado del registro (según el proveedor)
El estado oficial de la empresa tal como se obtiene de las fuentes de registro oficiales. Refleja la situación legal o regulatoria de la entidad según informa el registro de cada jurisdicción, por lo que los valores exactos varían según la fuente. Aparece en la decisión de KYB encompany.registry_status.
Como
registry_status refleja los valores sin procesar del registro, usa verification_status (ver más abajo) cuando necesites un indicador coherente entre jurisdicciones para guiar la lógica de tu producto.Estado de verificación de la empresa
Un estado estandarizado, orientado a empresas, para cada resultado de empresa. Normaliza los distintos estados de los registros y de las empresas de diferentes países y fuentes en un único indicador coherente que puedes interpretar directamente en tu producto. Aparece en la decisión de KYB encompany.verification_status.
Estado de obtención de datos de la empresa
Indica el progreso de la obtención de datos de un registro de empresa concreto desde registros externos u oficiales. Úsalo para saber qué tan completa es la información obtenida de una empresa. Aparece en la decisión de KYB encompany.fetch_status.
Estado de la verificación AML
Se devuelve por cada screening (de empresa o de persona).Cómo se explica una decisión
La decisión KYB no incluye una única cadena de código de motivo. Cada array de funciones (registry_checks[], document_verifications[], key_people_checks[], aml_screenings[]) incluye warnings[] con etiquetas KYB_* y AML, y decision_trace registra cómo se llegó a la decisión.
Consulta las etiquetas en Advertencias KYB y regístralas junto al estado de la sesión.
Cuando un revisor establece manualmente el estado, anulando la agregación de la plataforma, la decisión incluye status_override con la hora overridden_at y el automatic_status que la plataforma habría establecido.
Consulta el esquema de respuesta.
Próximos pasos
Esquema de respuesta
Dónde aparece cada estado en el payload.
Evaluación de riesgo
Qué determina el resultado de un KYB.
Webhooks
Eventos que se disparan con los cambios de estado.