Entità: Utenti e Aziende in Didit

Didit organizza tutto ciò che accade nella tua applicazione attorno a due tipi di entità di prima classe:

Entità	Rappresenta	Collegata a
Utente	Una persona fisica	Sessioni di Verifica degli utenti (KYC), dati biometrici del volto, transazioni (come richiedente o controparte), blocklist
Azienda	Un soggetto giuridico (società, S.r.l., ditta individuale, fondo)	Sessioni di Verifica aziendale (KYB), dirigenti, UBO, transazioni (come richiedente o controparte), blocklist

Ogni sessione di verifica, ogni transazione e ogni voce di blocklist può essere associata a un’entità. Una volta associata, l’entità diventa un profilo duraturo che aggrega cronologia, segnali di rischio e stato di compliance nel tempo.

Entità e sessione

Un’entità e una sessione sono cose diverse.

Concetto	Ambito	Durata	Esempio
Sessione	Un singolo evento di verifica	Un singolo flusso (da pochi minuti a diversi giorni, mentre è in revisione)	Un singolo tentativo di KYC
Entità	Un profilo duraturo	Dura finché l’utente o l’azienda esiste sulla tua piattaforma	Il cliente “Jane Doe” con 3 sessioni di Verifica degli utenti (KYC) nell’arco di 2 anni

Una singola entità può avere molte sessioni: nuove verifiche, reinvii, controlli aggiuntivi, monitoraggio continuo periodico. L’entità aggrega i risultati.

Creazione automatica o pre-creazione manuale

Le entità vengono create in uno di tre modi:

Creata automaticamente da una sessione

Quando crei una sessione con un identificatore vendor_data e non esiste un’entità corrispondente, Didit crea automaticamente l’entità. Questo è il percorso più comune.

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" }'

Un’entità Utente per user-42 viene creata nel momento in cui inizia la sessione.

Pre-creata tramite la Management API

Crea prima l’entità, poi avvia le sessioni collegate. Utile quando vuoi inserire in anticipo segnali di rischio (stato, tag, metadati personalizzati) prima della prima verifica.

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" }'

Creata nella console

Il tuo team di compliance può creare utenti o aziende direttamente dalla Business Console, utile per l’onboarding manuale, le importazioni o i flussi di risoluzione.

Come le entità collegano tutto

Il campo vendor_data è la chiave di collegamento. Quando passi vendor_data in una sessione o transazione, Didit lo instrada verso l’entità corrispondente. Scopri di più nella guida al collegamento tramite vendor_data.

Cosa puoi fare con un’entità

Per ogni entità Utente o Azienda, puoi:

Operazione	Scopo
Creare / aggiornare	Impostare o modificare i dati del profilo dell’entità (nome, paese, metadati personalizzati)
Cambiare stato	Impostare come `ACTIVE`, `FLAGGED` o `BLOCKED`: l’applicazione dei blocchi si propaga alle sessioni e alle transazioni future
Allegare dati biometrici	Caricare un riferimento del volto per la ricerca 1:N, il rilevamento dei duplicati o l’inserimento in blocklist
Consultare la cronologia KYC/KYB	Recuperare ogni sessione collegata all’entità, con i risultati per ogni funzionalità
Consultare la cronologia delle transazioni	Recuperare ogni transazione in cui l’entità è il richiedente o la controparte
Aggiungere a una blocklist	Bloccare le sessioni o transazioni future che coinvolgono questa entità
Importare / esportare	Caricare in blocco entità da CSV o esportarle per strumenti di compliance esterni
Eliminare	Eliminare l’entità (la cronologia viene conservata per l’audit)

Le guide dettagliate si trovano in Utenti e Aziende.

Relazioni tra Utente ↔ Azienda

Un singolo Utente può essere collegato a una o più Aziende. Questo accade in modo naturale durante il KYB:

Un Utente può essere un amministratore di un’Azienda e un UBO di un’altra.
La sessione di Verifica degli utenti (KYC) di un Utente può essere collegata a una sessione di Verifica aziendale (KYB) di un’Azienda tramite il flusso Persone chiave.

Didit conserva queste relazioni: quando esamini un’entità Azienda, puoi vedere ogni Utente collegato, e quando esamini un’entità Utente, puoi vedere ogni Azienda a cui è associato.

Ciclo di vita e stati

Ogni entità ha uno stato che determina se Didit applica i blocchi alle nuove attività:

Stato	Effetto
`ACTIVE`	Normale: sessioni e transazioni procedono come configurato dai workflow e dalle regole
`FLAGGED`	Sessioni e transazioni sono consentite, ma vengono instradate automaticamente alla revisione manuale
`BLOCKED`	Sessioni e transazioni vengono rifiutate automaticamente e non è possibile creare nuove sessioni

Consulta il ciclo di vita completo dell’entità per le transizioni e gli eventi webhook.

Prossimi passi

Ciclo di vita

Stati, transizioni ed eventi del ciclo di vita per ogni entità.

Collegamento vendor_data

Come vendor_data associa sessioni, transazioni ed entità.

Utenti

Approfondimento sulle entità Utente, le operazioni e i flussi della console.

Aziende

Approfondimento sulle entità Azienda, le operazioni e i flussi della console.

Webhook delle entità

Eventi in tempo reale per ogni modifica di un’entità.

Blocklist

Come le voci di blocklist interagiscono con le entità Utente e Azienda.

Panoramica

Prezzi

Workflow e verifica

Revisione e operazioni