Historial KYC del usuario: sesiones y reverificación

Cada sesión de Verificación de usuarios (KYC) que un usuario haya realizado queda vinculada de forma permanente a su entidad User. Puedes obtener el historial completo, inspeccionar los resultados de cada sesión, iniciar una reverificación y exportar informes de cumplimiento.

Listar todas las sesiones de un usuario

Filtra la lista de sesiones por vendor_data:

curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=user-42" \
  --data-urlencode "page_size=50"

La respuesta incluye todas las sesiones (sea cual sea su estado): aprobadas, rechazadas, en revisión, abandonadas o expiradas.

Comprender el estado agregado de las funciones

El mapa features de la entidad User refleja el estado más reciente de cada función en todas las sesiones:

"features": {
  "id_verification": "APPROVED",
  "liveness": "APPROVED",
  "face_match": "APPROVED",
  "aml": "IN_REVIEW"
}

Úsalo como vía rápida para responder a “¿el usuario está verificado ahora mismo?”. Para el registro histórico (todas las sesiones, todas las funciones, todos los resultados), lista las sesiones e inspecciona cada decisión.

Inspeccionar una sesión

curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"

La decisión incluye:

Resultados por función (documento de identidad, prueba de vida, coincidencia facial, AML, prueba de domicilio, NFC, etc.)
Datos e imágenes extraídos del documento (URL firmadas)
Coincidencias AML con puntuaciones de coincidencia y de riesgo
Análisis de dispositivo e IP y contexto del dispositivo
Notas del revisor y acciones manuales

Consulta obtener sesión para ver el esquema completo.

Activar una reverificación

Cuando necesites que un usuario vuelva a verificarse (por ejemplo, re-KYC anual, caducidad del documento o una nueva comprobación activada por un disparador):

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "wf_reverification",
    "vendor_data": "user-42"
  }'

La nueva sesión se vincula a la misma entidad User. Al completarse, el mapa features de la entidad se actualiza para reflejar los nuevos resultados.

Reenvío frente a sesión nueva

Escenario	Qué usar
La sesión del usuario se rechazó por un problema subsanable (documento borroso, mala iluminación)	Reenviar: misma sesión, nueva carga
Reverificación completa o re-KYC periódico	Crear una sesión completamente nueva
Remediación disparada por una regla de transacción	La transacción crea automáticamente una sesión de remediación (estado `AWAITING_USER`)

Exportar un informe de cumplimiento

Para auditorías, SAR o solicitudes de reguladores, genera un PDF de cualquier sesión:

curl https://verification.didit.me/v3/session/{session_id}/generate-pdf/ \
  -H "x-api-key: YOUR_API_KEY" \
  -o session-report.pdf

Para cubrir todo el historial de un usuario en un solo archivo, descarga el PDF del historial del usuario: una portada (resumen del perfil, estado de las funciones, índice de sesiones) seguida del informe completo de cada sesión que puede incluirse en el informe, de la más antigua a la más reciente, hasta un máximo de las 20 más recientes.

curl --fail https://verification.didit.me/v3/users/user-42/generate-pdf/ \
  -H "x-api-key: YOUR_API_KEY" \
  -o user-history.pdf

Es el mismo documento que genera la consola desde Users → [usuario] → Actions → Download PDF. Para exportaciones masivas en CSV de muchos usuarios, usa la exportación de toda la aplicación en Review & Operations → Export PDF/CSV.

Compartir una sesión con un tercero

Cuando necesites compartir la verificación de un usuario con una aplicación asociada (por ejemplo, en un escenario de KYC reutilizable), usa:

POST /v3/session/{session_id}/share/: genera un token para compartir.
POST /v3/session/import-shared/: importa una sesión compartida en el sistema receptor.

Consulta KYC reutilizable para ver el patrón completo.

Flujos basados en el historial

Usa el historial de sesiones para tomar decisiones de cumplimiento más inteligentes:

Omitir pasos si el usuario ya tiene una prueba de vida aprobada en los últimos N días.
Exigir comprobaciones adicionales si la sesión más reciente del usuario fue rechazada.
Marcar cuando el número de sesiones de un usuario aumenta de forma inesperada.
Monitorizar los reanálisis AML continuos con la función de monitorización continua.

Próximos pasos

Modelo de datos

Cómo se calculan el mapa de funciones y los contadores.

Obtener sesión

Esquema completo de la decisión de la sesión.

KYC reutilizable

Reutiliza datos verificados entre aplicaciones.

Última modificación el 1 de noviembre de 2026

Visión general

Precios

Flujos y verificación

Revisión y operaciones

Entidades (usuarios y empresas)

Ajustes y personalización

Seguridad y cumplimiento

Didit Academy

Recursos

Historial KYC del usuario: sesiones y reverificación

Listar todas las sesiones de un usuario

Comprender el estado agregado de las funciones

Inspeccionar una sesión

Activar una reverificación

Reenvío frente a sesión nueva

Exportar un informe de cumplimiento

Compartir una sesión con un tercero

Flujos basados en el historial

Próximos pasos

Modelo de datos

Obtener sesión

KYC reutilizable

​Listar todas las sesiones de un usuario

​Comprender el estado agregado de las funciones

​Inspeccionar una sesión

​Activar una reverificación

​Reenvío frente a sesión nueva

​Exportar un informe de cumplimiento

​Compartir una sesión con un tercero

​Flujos basados en el historial

​Próximos pasos

Modelo de datos

Obtener sesión

KYC reutilizable

Listar todas las sesiones de un usuario

Comprender el estado agregado de las funciones

Inspeccionar una sesión

Activar una reverificación

Reenvío frente a sesión nueva

Exportar un informe de cumplimiento

Compartir una sesión con un tercero

Flujos basados en el historial

Próximos pasos