Primeros pasos
Integración / SDKs
Verificación de usuarios
Verificación de empresas
Monitorización de transacciones
Registro de cambiosDiagrama del ciclo de vida
Estados en detalle
Cambiar el estado mediante
PATCH /v3/users/{vendor_data}/update-status/ o PATCH /v3/businesses/{vendor_data}/update-status/ emite un webhook (user.status.updated / business.status.updated) para que los sistemas downstream puedan reaccionar en tiempo real.Fases del ciclo de vida
Creación
Una entidad se crea de una de estas tres formas:
- Creada automáticamente cuando inicias una sesión con un
vendor_datanuevo. La entidad se crea con el estadoACTIVE. - Creada previamente mediante la API con
POST /v3/users/create/oPOST /v3/businesses/create/. El estado predeterminado esACTIVE. - Creada en la consola por un operador de cumplimiento: el estado inicial es
ACTIVE, salvo que el operador indique otro.
uuid generado por Didit y un identificador vendor_data propiedad del cliente.Verificación
Las sesiones se vinculan a la entidad mediante
vendor_data. Cada sesión pasa por el flujo de verificación (workflow) que hayas configurado: verificación de identidad, prueba de vida, coincidencia facial, AML, documentos, consulta del registro para KYB, etc.Las sesiones completadas actualizan los contadores agregados de la entidad:session_count,approved_count,declined_count,in_review_count- El mapa
features: el estado más reciente de cada función en todas las sesiones (p. ej.,{ "id_verification": "APPROVED", "aml": "IN_REVIEW" }) - Los campos del perfil se propagan desde la sesión aprobada más reciente (p. ej.,
full_name,date_of_birth,portrait_image).
Uso activo
Una vez que una entidad tiene una o más sesiones aprobadas, puedes:
- Enviar transacciones que hagan referencia a la entidad mediante
vendor_dataen el payload de la transacción - Ejecutar la monitorización AML continua: nuevos análisis periódicos de las listas de sanciones, PEP y medios adversos
- Reverificar de forma programada: crear nuevas sesiones para el mismo
vendor_dataa intervalos regulares - Agregar señales de riesgo de todas las sesiones y transacciones
Transiciones de estado
Los cambios de estado de una entidad se producen de forma automática o manual.Transiciones automáticas
ACTIVE → BLOCKEDcuando una sesión esDECLINEDy tu flujo está configurado para bloquear automáticamente.ACTIVE → FLAGGEDcuando una transacción supera el umbral de revisión o una regla añade la entidad a una lista de vigilancia.ACTIVE → BLOCKEDcuando una biometría facial coincide con una entrada de la lista de bloqueo.
update-status.Cada transición emite un webhook user.status.updated o business.status.updated.Eliminación
Las entidades se eliminan mediante
POST /v3/users/delete/ o POST /v3/businesses/delete/ (por lotes). El registro de la entidad se elimina de forma permanente. Al eliminar un User también se purgan todas las plantillas biométricas que se conservaron tras eliminar sus sesiones, por lo que la persona deja de coincidir en la detección de duplicados y en la Búsqueda facial.Estos endpoints no cubren las sesiones de verificación ni las transacciones. Elimina las sesiones con Delete Session o Batch Delete Sessions; las transacciones se eliminan desde la consola.Marcas de tiempo de actividad
Las entidades registran la actividad para ayudarte a identificar perfiles inactivos o activos:
Usa estas marcas de tiempo para filtrar entidades inactivas, programar reverificaciones o activar la monitorización continua.
Eventos emitidos durante el ciclo de vida
Consulta los webhooks de entidades para ver la estructura de los payloads y la semántica de entrega.
Próximos pasos
Vinculación con vendor data
Cómo
vendor_data vincula sesiones, transacciones y entidades.Operaciones con usuarios
Crea, actualiza, cambia el estado y elimina entidades User.
Operaciones con empresas
Crea, actualiza, cambia el estado y elimina entidades Business.