> ## 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.

# Usuaris de proveïdor: registre KYC persistent

> Vendor Users de Didit: registre d'identitat persistent amb historial KYC, biometria, documents, transaccions i estat de bloqueig.

Una **entitat d'Usuari** representa una única persona física (el teu client, usuari final o sol·licitant) en totes les interaccions que té amb la plataforma de Didit relacionades amb la verificació, les transaccions i el compliment.

Quan ja existeix un Usuari, tota l'activitat vinculada al mateix `vendor_data` s'afegeix al mateix perfil. Així tens una vista única de la identitat, el risc i el compliment de cada persona.

## Què conté un Usuari

| Categoria | Camps / objectes |
| - | - |
| **Identitat** | `vendor_data`, `uuid`, `display_name`, `full_name`, `date_of_birth`, `portrait_image` |
| **Estat** | `ACTIVE`, `FLAGGED`, `BLOCKED` |
| **Agregats de sessions** | `session_count`, `approved_count`, `declined_count`, `in_review_count`, mapa `features` |
| **Contacte verificat** | `approved_emails[]`, `approved_phones[]` |
| **Geografia** | `issuing_states[]` (a partir dels documents d'identitat verificats) |
| **Activitat** | `first_session_at`, `last_session_at`, `last_activity_at` |
| **Biometria** | Registres facials adjunts (per a cerca, detecció de duplicats i llista de bloqueig) |
| **Documents** | Documents d'identitat, comprovants de domicili i selfies de les sessions |
| **Relacions** | Entitats empresarials vinculades (si l'usuari és administrador o titular real d'empreses verificades a la teva aplicació) |
| **Metadades** | JSON arbitrari per a les teves pròpies dades |

Consulta el [model de dades de l'Usuari](https://docs.didit.me/ca/entities/users/data-model.md) per veure els tipus, els índexs i els casos especials.

## Quan es crea un Usuari

**1. Automàticament: en la primera sessió amb un vendor\_data nou**

És el cas habitual. Crides `POST /v3/session/` amb un valor de `vendor_data` que Didit no ha vist mai. Es crea una entitat d'Usuari en estat `ACTIVE` i s'enllaça amb aquesta sessió.

**2. Explícitament: mitjançant POST /v3/users/create/**

Crees l'Usuari abans que s'executi cap sessió. És útil per afegir metadades inicials, definir l'estat inicial o donar d'alta clients en lot a partir d'una base de dades existent.

**3. Des de la consola**

Un operador de compliment crea l'Usuari des de la pàgina Usuaris, per exemple quan dona d'alta un client verificat manualment.

## Què pots fer

| Operació | Com |
| - | - |
| [Llistar usuaris](https://docs.didit.me/ca/entities/users/operations.md#llistar-usuaris) | `GET /v3/users/` amb filtres (estat, data, país) |
| [Obtenir un usuari](https://docs.didit.me/ca/entities/users/operations.md#obtenir-un-usuari) | `GET /v3/users/{vendor_data}/` |
| [Crear un usuari](https://docs.didit.me/ca/entities/users/operations.md#crear-un-usuari) | `POST /v3/users/create/` |
| [Actualitzar el perfil](https://docs.didit.me/ca/entities/users/operations.md#actualitzar-un-usuari) | `PATCH /v3/users/{vendor_data}/` |
| [Canviar l'estat](https://docs.didit.me/ca/entities/users/operations.md#canviar-l’estat) | `PATCH /v3/users/{vendor_data}/update-status/` |
| [Eliminar usuaris](https://docs.didit.me/ca/entities/users/operations.md#eliminar-usuaris-en-lot) | `POST /v3/users/delete/` (per lots) |
| [Adjuntar i cercar rostres](https://docs.didit.me/ca/entities/users/faces-and-biometrics.md) | Consola i API de llistes per a llistes de bloqueig |
| [Veure documents](https://docs.didit.me/ca/entities/users/documents.md) | Mitjançant les decisions de sessió |
| [Afegir a la llista de bloqueig](https://docs.didit.me/ca/entities/users/blocklist.md) | Consola i API de llistes |
| [Revisar l'historial KYC](https://docs.didit.me/ca/entities/users/kyc-history.md) | `GET /v3/sessions?vendor_data=...` |
| [Revisar les transaccions](https://docs.didit.me/ca/entities/users/transactions.md) | `GET /v3/transactions/?vendor_data=...` |
| [Importar i exportar](https://docs.didit.me/ca/entities/users/import-export.md) | Només des de la consola (CSV) |
| [Gestionar a la consola](https://docs.didit.me/ca/entities/users/console.md) | Recorregut complet per la interfície |

## Usuaris i empreses

Un mateix Usuari pot estar vinculat a una o diverses empreses. Per exemple, quan la mateixa persona és administradora d'una empresa i titular real d'una altra. Didit manté aquests enllaços automàticament quan [KYB](https://docs.didit.me/ca/business-verification/overview.md) identifica persones a partir dels registres mercantils.

## Relació usuari ↔ sessió

```mermaid theme={null}
flowchart LR
    U[User entity<br/>vendor_data = user-42]
    S1["User Verification (KYC) session #1<br/>(approved 2025-01)"]
    S2["User Verification (KYC) session #2<br/>(resubmit, in review)"]
    S3["User Verification (KYC) session #3<br/>(re-verification 2026-01)"]
    S1 --> U
    S2 --> U
    S3 --> U
```

L'Usuari consolida l'estat **més recent** de cada funcionalitat en totes les sessions. Una comprovació `aml` fallida en la sessió més recent apareixerà al camp `features.aml` de l'Usuari, fins i tot si les sessions anteriors van ser aprovades.

## Següents passos

> [card] [Model de dades](https://docs.didit.me/ca/entities/users/data-model.md)
>
> Cada camp, tipus i índex.

> [card] [Operacions](https://docs.didit.me/ca/entities/users/operations.md)
>
> Crear, actualitzar, canviar l'estat i eliminar.

> [card] [Rostres i biometria](https://docs.didit.me/ca/entities/users/faces-and-biometrics.md)
>
> Adjunta un rostre per a la cerca i la inclusió en llistes de bloqueig.

> [card] [Llista de bloqueig](https://docs.didit.me/ca/entities/users/blocklist.md)
>
> Com funcionen les llistes de bloqueig per als usuaris.

> [card] [Historial KYC](https://docs.didit.me/ca/entities/users/kyc-history.md)
>
> Cada sessió vinculada a l'usuari.

> [card] [Consola](https://docs.didit.me/ca/entities/users/console.md)
>
> Recorregut complet per la interfície d'Usuaris.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.