Vai al contenuto principale
Ogni entità User e Business in Didit attraversa un ciclo di vita prevedibile. Comprendere questo ciclo è fondamentale per progettare i flussi di onboarding, di monitoraggio continuo e di intervento correttivo.

​
Diagramma del ciclo di vita

​
Dettaglio degli stati

Modificare lo stato tramite PATCH /v3/users/{vendor_data}/update-status/ oppure PATCH /v3/businesses/{vendor_data}/update-status/ emette un webhook (user.status.updated / business.status.updated), così i sistemi a valle possono reagire in tempo reale.

​
Fasi del ciclo di vita

Creazione

Un’entità viene creata in uno di tre modi:
  • Creata automaticamente quando avvii una sessione con un nuovo vendor_data. L’entità viene creata con stato ACTIVE.
  • Pre-creata tramite API usando POST /v3/users/create/ oppure POST /v3/businesses/create/. Lo stato predefinito è ACTIVE.
  • Creata nella console da un operatore di compliance: lo stato iniziale è ACTIVE, salvo diversa indicazione dell’operatore.
Ogni entità riceve un uuid generato da Didit e un identificatore vendor_data di proprietà del cliente.

Verifica

Le sessioni vengono associate all’entità tramite vendor_data. Ogni sessione viene eseguita tramite il workflow configurato: verifica dell’identità, rilevamento della vitalità, confronto facciale, AML, documenti, ricerca nel registro per KYB, e così via.Le sessioni completate aggiornano i contatori aggregati dell’entità:
  • session_count, approved_count, declined_count, in_review_count
  • mappa features: lo stato più recente di ciascuna funzionalità in tutte le sessioni (ad esempio { "id_verification": "APPROVED", "aml": "IN_REVIEW" })
  • I campi del profilo vengono propagati dalla sessione approvata più recente (ad esempio full_name, date_of_birth, portrait_image).

Utilizzo attivo

Quando un’entità ha una o più sessioni approvate, puoi:
  • Inviare transazioni che fanno riferimento all’entità tramite vendor_data nel payload della transazione
  • Eseguire il monitoraggio AML continuo: nuove scansioni periodiche delle liste di sanzioni / PEP / notizie negative
  • Rieseguire la verifica secondo una pianificazione: creare nuove sessioni per lo stesso vendor_data a intervalli regolari
  • Aggregare i segnali di rischio tra sessioni e transazioni

Transizioni di stato

Il cambio di stato dell’entità avviene in modo automatico o manuale.Transizioni automatiche
  • ACTIVE → FLAGGED quando una transazione supera la soglia di revisione oppure una regola aggiunge l’entità a una watchlist.
  • ACTIVE → BLOCKED quando una biometria facciale corrisponde a una voce della blocklist.
Una sessione rifiutata non inserisce l’entità in blocklist, quindi lo stato non cambia. Inserire in blocklist un soggetto rifiutato è un passaggio manuale: aggiungi la voce dalla pagina Blocklist oppure tramite la Lists API. Una voce di tipo USER (il vendor_data) imposta lo stato su BLOCKED.Le transizioni manuali avvengono quando un analista modifica lo stato dalla console oppure quando chiami l’endpoint update-status.Ogni transizione emette un webhook user.status.updated oppure business.status.updated.

Eliminazione

Le entità si eliminano tramite POST /v3/users/delete/ oppure POST /v3/businesses/delete/ (in batch). Il record dell’entità viene rimosso in modo permanente. Eliminare un User rimuove anche ogni modello biometrico conservato per lui dopo l’eliminazione delle sessioni, così la persona non produce più corrispondenze nel rilevamento dei duplicati e nella Ricerca facciale.Questi endpoint non coprono le sessioni di verifica, né le transazioni. Elimina le sessioni con Delete Session oppure Batch Delete Sessions; le transazioni si eliminano dalla Console.

​
Timestamp delle attività

Le entità tengono traccia dell’attività per aiutarti a individuare profili inattivi o attivi: Usa questi timestamp per filtrare le entità inattive, pianificare le nuove verifiche o avviare il monitoraggio continuo.

​
Eventi emessi durante il ciclo di vita

Per il formato dei payload e la semantica di consegna, consulta i webhook delle entità.

​
Passaggi successivi

Collegamento dei dati del fornitore

Come vendor_data collega tra loro sessioni, transazioni ed entità.

Operazioni sulle entità User

Creare, aggiornare, cambiare lo stato ed eliminare le entità User.

Operazioni sulle entità Business

Creare, aggiornare, cambiare lo stato ed eliminare le entità Business.
Ultima modifica il 7 novembre 2026