Entidades: usuarios y empresas en Didit

Didit organiza todo lo que ocurre en tu aplicación en torno a dos tipos de entidad principales:

Entidad	Representa	Vinculada a
Usuario	Una persona física	Sesiones de verificación de usuarios (KYC), biometría facial, transacciones (como solicitante o contraparte), listas de bloqueo
Empresa	Una persona jurídica (sociedad, LLC, empresario individual, fondo)	Sesiones de verificación de empresas (KYB), directivos, UBO, transacciones (como solicitante o contraparte), listas de bloqueo

Cada sesión de verificación, cada transacción y cada entrada de la lista de bloqueo puede vincularse a una entidad. Una vez vinculada, la entidad se convierte en un perfil duradero que reúne el historial, las señales de riesgo y el estado de cumplimiento a lo largo del tiempo.

Entidad frente a sesión

Una entidad y una sesión son cosas distintas.

Concepto	Alcance	Duración	Ejemplo
Sesión	Un evento de verificación	Un único flujo (de minutos a días mientras está en revisión)	Un solo intento de KYC
Entidad	Un perfil duradero	Vive mientras el usuario o la empresa exista en tu plataforma	La clienta “Jane Doe” con 3 sesiones de verificación de usuarios (KYC) a lo largo de 2 años

Una misma entidad puede tener muchas sesiones: reverificaciones, reenvíos, comprobaciones adicionales, monitorización continua periódica. La entidad agrega los resultados.

Creación automática o precreación manual

Las entidades se crean de una de estas tres formas:

Creada automáticamente desde una sesión

Cuando creas una sesión con un identificador vendor_data y no existe ninguna entidad que coincida, Didit crea la entidad automáticamente. Es el camino más habitual.

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

Una entidad Usuario para user-42 se crea en el momento en que empieza la sesión.

Precreada mediante la Management API

Crea primero la entidad y después inicia sesiones asociadas a ella. Es útil cuando quieres sembrar señales de riesgo (estado, etiquetas, metadatos personalizados) antes de la primera verificación.

curl -X POST https://verification.didit.me/v3/users/create/ \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{ "vendor_data": "user-42", "display_name": "Jane Doe" }'

Creada en la consola

Tu equipo de cumplimiento puede crear usuarios o empresas directamente desde la Business Console, algo útil para altas manuales, importaciones o flujos de subsanación.

Cómo las entidades lo vinculan todo

El campo vendor_data es la clave de vinculación. Cuando envías vendor_data en cualquier sesión o transacción, Didit la dirige a la entidad correspondiente. Consulta más detalles en la guía de vinculación con vendor_data.

Qué puedes hacer con una entidad

Con cada entidad Usuario o Empresa puedes:

Operación	Finalidad
Crear / actualizar	Definir o cambiar los datos del perfil de la entidad (nombre, país, metadatos personalizados)
Cambiar el estado	Marcarla como `ACTIVE`, `FLAGGED` o `BLOCKED`: la aplicación del bloqueo se propaga a las futuras sesiones y transacciones
Adjuntar biometría	Subir una referencia facial para búsqueda 1:N, detección de duplicados o listas de bloqueo
Revisar el historial KYC/KYB	Obtener todas las sesiones vinculadas a la entidad, con los resultados por función
Revisar el historial de transacciones	Obtener todas las transacciones en las que la entidad es solicitante o contraparte
Añadir a una lista de bloqueo	Bloquear futuras sesiones o transacciones que involucren a esta entidad
Importar / exportar	Cargar entidades de forma masiva desde CSV o exportarlas a herramientas externas de cumplimiento
Eliminar	Eliminar la entidad (el historial se conserva para auditoría)

Los tutoriales detallados están en Usuarios y Empresas.

Relaciones entre usuarios y empresas

Un mismo usuario puede estar vinculado a una o varias empresas. Esto ocurre de forma natural durante el KYB:

Un usuario puede ser director de una empresa y UBO de otra.
La sesión de verificación de usuarios (KYC) de un usuario puede vincularse con la sesión de verificación de empresas (KYB) de una empresa mediante el flujo de personas clave.

Didit conserva estas relaciones: al consultar una entidad Empresa puedes ver todos los usuarios vinculados, y al consultar una entidad Usuario puedes ver todas las empresas con las que está asociada.

Ciclo de vida y estados

Cada entidad tiene un estado que determina si Didit aplica bloqueos a la nueva actividad:

Estado	Efecto
`ACTIVE`	Normal: las sesiones y transacciones siguen según lo configurado en los flujos y reglas
`FLAGGED`	Las sesiones y transacciones se permiten, pero se envían automáticamente a revisión manual
`BLOCKED`	Las sesiones y transacciones se rechazan automáticamente y no se pueden crear nuevas sesiones

Consulta el ciclo de vida de la entidad completo para ver las transiciones y los eventos de webhook.

Siguientes pasos

Ciclo de vida

Estados, transiciones y eventos del ciclo de vida de cada entidad.

Vinculación con vendor_data

Cómo vendor_data vincula sesiones, transacciones y entidades.

Usuarios

Análisis en profundidad de las entidades Usuario, sus operaciones y los flujos de la consola.

Empresas

Análisis en profundidad de las entidades Empresa, sus operaciones y los flujos de la consola.

Webhooks de entidades

Eventos en tiempo real para cada cambio en una entidad.

Lista de bloqueo

Cómo interactúan las entradas de la lista de bloqueo con las entidades Usuario y Empresa.

Visión general

Flujos y verificación