Modelo de datos de usuario: esquema Vendor User

Esta página describe todos los campos de una entidad User. Los campos se agrupan en cinco bloques: identidad, estado, agregados de sesiones, marcas de tiempo de actividad y metadatos.

Campos de identidad

Campo	Tipo	Descripción
`uuid`	UUID	Clave primaria asignada por Didit. Estable y única.
`didit_internal_id`	string	Identificador interno legible (se muestra en las respuestas de la API).
`vendor_data`	string	Tu identificador para el usuario. Único por aplicación. Más información.
`display_name`	string	Nombre personalizado que se muestra en la consola. Si no se define, se usa `full_name` o `vendor_data`.
`full_name`	string	Nombre legal completo, tomado del documento de identidad de la sesión de Verificación de usuarios (KYC) aprobada más reciente.
`date_of_birth`	date (ISO 8601)	Tomada de la sesión de Verificación de usuarios (KYC) aprobada más reciente.
`portrait_image`	URL	URL firmada de S3 de la selfie de la prueba de vida aprobada más reciente.

full_name, date_of_birth y portrait_image son de solo lectura cuando provienen de una sesión verificada. Puedes sobrescribirlos desde la consola o mediante PATCH /v3/users/{vendor_data}/, pero las modificaciones manuales quedan marcadas en el registro de auditoría.

Estado

Campo	Tipo	Valores	Descripción
`status`	enum	`ACTIVE`, `FLAGGED`, `BLOCKED`	Controla la aplicación de restricciones en sesiones y transacciones futuras. Consulta el ciclo de vida.

Campos agregados de sesiones

Didit calcula estos campos, que se actualizan en tiempo real a medida que se completan las sesiones.

Campo	Tipo	Descripción
`session_count`	int	Total de sesiones creadas para este usuario
`approved_count`	int	Sesiones que terminaron con `APPROVED`
`declined_count`	int	Sesiones que terminaron con `DECLINED`
`in_review_count`	int	Sesiones actualmente en `IN_REVIEW`
`issuing_states[]`	array de códigos de país ISO	Países de todos los documentos de identidad verificados en todas las sesiones
`approved_emails[]`	array de strings	Correos electrónicos verificados mediante Verificación de correo electrónico
`approved_phones[]`	array de strings	Teléfonos verificados mediante Verificación de teléfono
`features`	object	Estado más reciente de cada función en todas las sesiones

El mapa `features`

Cada sesión ejecuta una o más funciones (verificación de identidad, prueba de vida, coincidencia facial, AML, prueba de domicilio, NFC, etc.). El mapa features contiene el estado más reciente de cada función para este usuario:

{
  "id_verification": "APPROVED",
  "liveness": "APPROVED",
  "face_match": "APPROVED",
  "aml": "IN_REVIEW",
  "proof_of_address": "APPROVED",
  "nfc_verification": "NOT_FINISHED"
}

Estados de las funciones: NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW, EXPIRED, ABANDONED, RESUB_REQUESTED. Usa el mapa features como la vía rápida para responder “¿está este usuario completamente verificado en este momento?” sin recorrer todas las sesiones.

Marcas de tiempo de actividad

Campo	Tipo	Se actualiza cuando
`first_session_at`	marca de tiempo ISO	Se creó la primera sesión
`last_session_at`	marca de tiempo ISO	Se creó o actualizó la sesión más reciente
`last_activity_at`	marca de tiempo ISO	Hay cualquier cambio: sesión, transacción, estado, perfil, notas, etiquetas
`created_at`	marca de tiempo ISO	Se creó la fila de la entidad
`updated_at`	marca de tiempo ISO	Se actualizó por última vez la fila de la entidad

Metadatos

Campo	Tipo	Descripción
`metadata`	object (JSON)	JSON de formato libre que controlas. Úsalo para etiquetas internas, nivel, origen del registro, etc.
`tags[]`	array	Etiquetas gestionadas desde la consola o la API para filtrar y agrupar

Los metadatos no tienen esquema: Didit guarda lo que escribas.

Relaciones (no se almacenan en la registro del usuario)

Relación	Cómo acceder
Sesiones	`GET /v3/sessions?vendor_data=<value>`
Transacciones (como solicitante)	`GET /v3/transactions/?vendor_data=<value>`
Transacciones (como contraparte)	Filtra la lista de transacciones por el vendor_data de la contraparte en la consola
Empresas vinculadas (director / UBO)	Se muestran en la página de detalle del usuario en la consola
Biometría facial	Consola + Lists API
Entradas de la lista de bloqueo	Lists API: filtra las entradas por los identificadores del usuario

Ejemplo de respuesta

{
  "uuid": "9c7d2a30-2f98-4d4f-9d2d-1a7c4b1e5b6a",
  "didit_internal_id": "U-2026-00042",
  "vendor_data": "user-42",
  "display_name": "Jane Doe",
  "full_name": "John Doe",
  "date_of_birth": "1990-01-01",
  "portrait_image": "https://<media-host>/...",
  "status": "ACTIVE",
  "session_count": 3,
  "approved_count": 2,
  "declined_count": 0,
  "in_review_count": 1,
  "issuing_states": ["US", "ES"],
  "approved_emails": ["jane@example.com"],
  "approved_phones": ["+14155550123"],
  "features": {
    "id_verification": "APPROVED",
    "liveness": "APPROVED",
    "face_match": "APPROVED",
    "aml": "IN_REVIEW"
  },
  "first_session_at": "2025-03-01T12:00:00Z",
  "last_session_at": "2026-04-10T09:00:00Z",
  "last_activity_at": "2026-04-16T10:00:00Z",
  "metadata": { "tier": "premium" }
}

Próximos pasos

Operaciones

Crear, actualizar, cambiar el estado y eliminar.

Historial de KYC

Obtener todas las sesiones vinculadas al usuario.

Referencia de la API

Esquema de GET /v3/users//.

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

Modelo de datos de usuario: esquema Vendor User

Campos de identidad

Estado

Campos agregados de sesiones

El mapa `features`

Marcas de tiempo de actividad

Metadatos

Relaciones (no se almacenan en la registro del usuario)

Ejemplo de respuesta

Próximos pasos

Operaciones

Historial de KYC

Referencia de la API

​Campos de identidad

​Estado

​Campos agregados de sesiones

​El mapa features

​Marcas de tiempo de actividad

​Metadatos

​Relaciones (no se almacenan en la registro del usuario)

​Ejemplo de respuesta

​Próximos pasos

Operaciones

Historial de KYC

Referencia de la API

Campos de identidad

Estado

Campos agregados de sesiones

El mapa `features`

Marcas de tiempo de actividad

Metadatos

Relaciones (no se almacenan en la registro del usuario)

Ejemplo de respuesta

Próximos pasos