> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.
# Vendor Users: registro KYC persistente
> Vendor Users: el registro de identidad persistente de Didit, con historial KYC, biometría, documentos, transacciones y lista de bloqueo.
Una **entidad User** representa a una sola persona (tu cliente, usuario final o solicitante) en cada verificación, transacción e interacción de cumplimiento que tenga con tu plataforma en Didit.
Una vez que existe un User, toda la actividad vinculada al mismo `vendor_data` se integra en el mismo perfil: obtienes una vista única de la identidad, el riesgo y el cumplimiento de cada persona.
## Qué contiene un User
| Categoría | Campos / objetos |
| - | - |
| **Identidad** | `vendor_data`, `uuid`, `display_name`, `full_name`, `date_of_birth`, `portrait_image` |
| **Estado** | `ACTIVE`, `FLAGGED`, `BLOCKED` |
| **Agregados de sesiones** | `session_count`, `approved_count`, `declined_count`, `in_review_count`, mapa `features` |
| **Contacto verificado** | `approved_emails[]`, `approved_phones[]` |
| **Geografía** | `issuing_states[]` (de documentos de identidad verificados) |
| **Actividad** | `first_session_at`, `last_session_at`, `last_activity_at` |
| **Biometría** | Registros faciales asociados (para búsqueda, detección de duplicados y lista de bloqueo) |
| **Documentos** | Documentos de identidad, pruebas de domicilio y selfies de las sesiones |
| **Relaciones** | Entidades Business vinculadas (si el usuario es director o UBO de empresas verificadas en tu aplicación) |
| **Metadatos** | JSON arbitrario para tus propios datos |
Consulta el [modelo de datos de User](https://docs.didit.me/es/entities/users/data-model.md) completo para ver tipos, índices y casos límite.
## Cuándo se crea un User
**1. Automáticamente: en la primera sesión con un vendor\_data nuevo**
Es el caso habitual. Invocas `POST /v3/session/` con un valor de `vendor_data` que Didit nunca ha visto. Se crea una entidad User en estado `ACTIVE` y se vincula a esa sesión.
**2. Explícitamente: mediante POST /v3/users/create/**
Creas el User antes de que se ejecute cualquier sesión. Es útil para precargar metadatos, establecer un estado inicial o incorporar clientes de forma masiva desde una base de datos existente.
**3. Desde la consola**
Un operador de cumplimiento crea el User desde la página de usuarios, por ejemplo, al incorporar un cliente verificado manualmente.
## Qué puedes hacer
| Operación | Cómo |
| - | - |
| [Listar usuarios](https://docs.didit.me/es/entities/users/operations.md#listar-usuarios) | `GET /v3/users/` con filtros (estado, fecha, país) |
| [Obtener un usuario](https://docs.didit.me/es/entities/users/operations.md#obtener-un-usuario) | `GET /v3/users/{vendor_data}/` |
| [Crear un usuario](https://docs.didit.me/es/entities/users/operations.md#crear-un-usuario) | `POST /v3/users/create/` |
| [Actualizar el perfil](https://docs.didit.me/es/entities/users/operations.md#actualizar-un-usuario) | `PATCH /v3/users/{vendor_data}/` |
| [Cambiar el estado](https://docs.didit.me/es/entities/users/operations.md#cambiar-el-estado) | `PATCH /v3/users/{vendor_data}/update-status/` |
| [Eliminar usuarios](https://docs.didit.me/es/entities/users/operations.md#eliminar-usuarios-en-lote) | `POST /v3/users/delete/` (por lotes) |
| [Adjuntar y buscar rostros](https://docs.didit.me/es/entities/users/faces-and-biometrics.md) | Consola + API de listas para las listas de bloqueo |
| [Ver documentos](https://docs.didit.me/es/entities/users/documents.md) | Mediante las decisiones de sesión |
| [Añadir a la lista de bloqueo](https://docs.didit.me/es/entities/users/blocklist.md) | Consola + API de listas |
| [Revisar el historial de KYC](https://docs.didit.me/es/entities/users/kyc-history.md) | `GET /v3/sessions?vendor_data=...` |
| [Revisar transacciones](https://docs.didit.me/es/entities/users/transactions.md) | `GET /v3/transactions/?vendor_data=...` |
| [Importar / exportar](https://docs.didit.me/es/entities/users/import-export.md) | Solo en la consola (CSV) |
| [Gestionar en la consola](https://docs.didit.me/es/entities/users/console.md) | Recorrido completo por la interfaz |
## Usuarios y empresas
Un mismo usuario puede estar vinculado a una o varias empresas, por ejemplo, cuando la misma persona es directora de una empresa y UBO de otra. Didit conserva estos vínculos automáticamente cuando [KYB](https://docs.didit.me/es/business-verification/overview.md) identifica a personas a partir de registros de empresas.
## Relación entre User y sesión
```mermaid theme={null}
flowchart LR
U[User entity
vendor_data = user-42]
S1["User Verification (KYC) session #1
(approved 2025-01)"]
S2["User Verification (KYC) session #2
(resubmit, in review)"]
S3["User Verification (KYC) session #3
(re-verification 2026-01)"]
S1 --> U
S2 --> U
S3 --> U
```
El User agrupa el estado **más reciente** de cada función en todas las sesiones. Una comprobación `aml` fallida en la sesión más reciente aparecerá en el campo `features.aml` del User aunque las sesiones anteriores se hayan aprobado.
## Próximos pasos
> [card] [Modelo de datos](https://docs.didit.me/es/entities/users/data-model.md)
>
> Cada campo, tipo e índice.
> [card] [Operaciones](https://docs.didit.me/es/entities/users/operations.md)
>
> Crear, actualizar, cambiar el estado y eliminar.
> [card] [Rostros y biometría](https://docs.didit.me/es/entities/users/faces-and-biometrics.md)
>
> Adjunta un rostro para realizar búsquedas y añadirlo a la lista de bloqueo.
> [card] [Lista de bloqueo](https://docs.didit.me/es/entities/users/blocklist.md)
>
> Cómo funciona la inclusión de usuarios en la lista de bloqueo.
> [card] [Historial de KYC](https://docs.didit.me/es/entities/users/kyc-history.md)
>
> Cada sesión vinculada al usuario.
> [card] [Consola](https://docs.didit.me/es/entities/users/console.md)
>
> Recorrido completo por la interfaz de usuarios.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.