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

# Utenti Vendor: record KYC persistente

> Gli Utenti Vendor sono il record d'identità persistente di Didit: storico KYC, biometria, documenti, transazioni e stato blocklist in un profilo.

Un'**entità utente** rappresenta un singolo individuo (il tuo cliente, utente finale o richiedente) in tutte le interazioni relative a verifiche, transazioni e compliance che ha con la tua piattaforma su Didit.

Una volta che un utente esiste, tutte le attività collegate allo stesso `vendor_data` confluiscono nello stesso profilo: ottieni un'unica vista su identità, rischio e compliance di ogni persona.

## Cosa contiene un utente

| Categoria | Campi / oggetti |
| - | - |
| **Identità** | `vendor_data`, `uuid`, `display_name`, `full_name`, `date_of_birth`, `portrait_image` |
| **Stato** | `ACTIVE`, `FLAGGED`, `BLOCKED` |
| **Aggregati di sessione** | `session_count`, `approved_count`, `declined_count`, `in_review_count`, mappa `features` |
| **Contatti verificati** | `approved_emails[]`, `approved_phones[]` |
| **Geografia** | `issuing_states[]` (dai documenti d'identità verificati) |
| **Attività** | `first_session_at`, `last_session_at`, `last_activity_at` |
| **Biometria** | Record facciali associati (per ricerca / rilevamento di duplicati / blocklist) |
| **Documenti** | Documenti d'identità, prove di residenza, selfie dalle sessioni |
| **Relazioni** | Entità aziendali collegate (se l'utente è amministratore / titolare effettivo di aziende verificate sulla tua app) |
| **Metadati** | JSON arbitrario per i tuoi dati |

Per tipi, indici e casi limite, consulta il [modello dati utente](https://docs.didit.me/it/entities/users/data-model.md).

## Quando viene creato un utente

**1. Automaticamente: alla prima sessione con un nuovo vendor\_data**

Il caso tipico. Chiami `POST /v3/session/` con un valore `vendor_data` che Didit non ha mai visto. Viene creata un'entità utente in stato `ACTIVE` e collegata a quella sessione.

**2. Esplicitamente: tramite POST /v3/users/create/**

Crei l'utente in anticipo, prima che venga eseguita una sessione. Utile per inserire metadati iniziali, impostare lo stato iniziale o fare l'onboarding in blocco dei clienti da un database esistente.

**3. Dalla Console**

Un operatore di compliance crea l'utente dalla pagina Utenti, ad esempio quando registra un cliente verificato manualmente.

## Cosa puoi fare

| Operazione | Come |
| - | - |
| [Elencare gli utenti](https://docs.didit.me/it/entities/users/operations.md#elenca-gli-utenti) | `GET /v3/users/` con filtri (stato, data, paese) |
| [Ottenere un utente](https://docs.didit.me/it/entities/users/operations.md#recupera-un-utente) | `GET /v3/users/{vendor_data}/` |
| [Creare un utente](https://docs.didit.me/it/entities/users/operations.md#crea-un-utente) | `POST /v3/users/create/` |
| [Aggiornare il profilo](https://docs.didit.me/it/entities/users/operations.md#aggiorna-un-utente) | `PATCH /v3/users/{vendor_data}/` |
| [Modificare lo stato](https://docs.didit.me/it/entities/users/operations.md#cambia-stato) | `PATCH /v3/users/{vendor_data}/update-status/` |
| [Eliminare gli utenti](https://docs.didit.me/it/entities/users/operations.md#elimina-utenti-in-batch) | `POST /v3/users/delete/` (in blocco) |
| [Associare / cercare volti](https://docs.didit.me/it/entities/users/faces-and-biometrics.md) | Console + Lists API per le blocklist |
| [Visualizzare i documenti](https://docs.didit.me/it/entities/users/documents.md) | Tramite le decisioni della sessione |
| [Aggiungere alla blocklist](https://docs.didit.me/it/entities/users/blocklist.md) | Console + Lists API |
| [Consultare lo storico KYC](https://docs.didit.me/it/entities/users/kyc-history.md) | `GET /v3/sessions?vendor_data=...` |
| [Consultare le transazioni](https://docs.didit.me/it/entities/users/transactions.md) | `GET /v3/transactions/?vendor_data=...` |
| [Importare / esportare](https://docs.didit.me/it/entities/users/import-export.md) | Solo Console (CSV) |
| [Gestire nella Console](https://docs.didit.me/it/entities/users/console.md) | Guida completa all'interfaccia |

## Utenti e aziende

Un singolo utente può essere collegato a una o più aziende, ad esempio quando la stessa persona è amministratore di un'azienda e titolare effettivo di un'altra. Didit mantiene automaticamente questi collegamenti quando la [KYB](https://docs.didit.me/it/business-verification/overview.md) identifica le persone dai registri delle imprese.

## Relazione utente ↔ sessione

```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'utente aggrega lo stato **più recente** di ogni funzionalità su tutte le sessioni. Un controllo `aml` non riuscito nella sessione più recente comparirà nel campo `features.aml` dell'utente anche se le sessioni precedenti sono state approvate.

## Passi successivi

> [card] [Modello dati](https://docs.didit.me/it/entities/users/data-model.md)
>
> Ogni campo, tipo e indice.

> [card] [Operazioni](https://docs.didit.me/it/entities/users/operations.md)
>
> Creare, aggiornare, modificare lo stato, eliminare.

> [card] [Volti e biometria](https://docs.didit.me/it/entities/users/faces-and-biometrics.md)
>
> Associare un volto per la ricerca e la blocklist.

> [card] [Blocklist](https://docs.didit.me/it/entities/users/blocklist.md)
>
> Come funziona la blocklist per gli utenti.

> [card] [Storico KYC](https://docs.didit.me/it/entities/users/kyc-history.md)
>
> Ogni sessione collegata all'utente.

> [card] [Console](https://docs.didit.me/it/entities/users/console.md)
>
> Guida completa all'interfaccia Utenti.


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