Verifica aziendale (KYB) API: registro e UBO

La Verifica aziendale (KYB) di Didit ti consente di verificare aziende ed entità giuridiche prima di eseguirne l’onboarding sulla tua piattaforma. Il sistema automatizza le ricerche nei registri delle imprese, identifica i titolari effettivi e i dirigenti, sottopone tutte le parti a screening rispetto alle watchlist AML e raccoglie i documenti a supporto, il tutto all’interno di un unico workflow. Ogni azienda verificata viene tracciata come profilo aziendale, che aggrega i risultati di tutte le sessioni. Questa lezione di Didit Academy segue una verifica aziendale dall’inizio alla fine: la dashboard KYB, il controllo nel registro, azionisti e UBO, lo screening AML e ciò che il rappresentante dell’azienda vede dal proprio lato. Se non conosci ancora il KYB di Didit, inizia con la guida rapida per un percorso completo di circa 10 minuti, poi leggi la guida all’integrazione per le modalità da usare in produzione. Per il modello dell’entità Business sottostante (con i collegamenti a Users, blocklist, importazione ed esportazione), consulta Aziende.

Come funziona

Crea una sessione aziendale

Avvia una verifica aziendale creando una sessione con un workflow KYB. Quando il tipo di workflow è KYB, Didit crea automaticamente una sessione aziendale:

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "your-kyb-workflow-id",
    "vendor_data": "company-123"
  }'

Il tipo di sessione è determinato dal workflow, quindi non servono campi aggiuntivi. I workflow KYB creano automaticamente sessioni aziendali con le funzionalità specifiche per le aziende attivate.

Ricerca nel registro delle imprese

Didit interroga i registri ufficiali delle imprese ai livelli Lite, Shareholders o UBOs, ciascuno con un prezzo per paese: vedi prezzi del registro. Il livello Lite recupera:

Dati	Descrizione
Nome azienda	Ragione sociale registrata
Numero di registrazione	Numero ufficiale di registrazione dell’azienda
Paese	Paese di costituzione
Stato	Attiva, sciolta, cancellata, ecc.
Tipo azienda	Ltd, LLC, PLC, SA, GmbH, ecc.
Data di costituzione	Data di registrazione dell’azienda
Sede legale	Indirizzo ufficiale della sede legale
Codice fiscale	Codice di identificazione fiscale (ove disponibile)

I dati del registro vengono confrontati con le informazioni fornite per rilevare eventuali incoerenze.

Persone chiave: UBO, azionisti, amministratori e rappresentanti

Il sistema identifica ogni persona ed entità giuridica collegata all’azienda nel modello unificato Persone Chiave:

UBO: persone fisiche che possiedono o controllano in ultima istanza l’azienda, con le relative percentuali dell’assetto proprietario e di voto
Azionisti (persone fisiche e giuridiche): ciascuno con la propria percentuale dell’assetto proprietario
Amministratori, rappresentanti, segretari, firmatari autorizzati e altri ruoli di responsabilità: con il relativo tag di ruolo specifico
Livelli di assetto proprietario: società madri nella catena di proprietà, con KYB annidato facoltativo

Una stessa persona può avere più tag di ruolo (ad esempio amministratore e azionista). Ogni ruolo viene configurato singolarmente nel workflow: quali ruoli richiedono KYC, quale workflow KYC utilizzare e se l’utente finale può saltare la verifica. Per saperne di più, consulta Persone chiave e Assetto proprietario.

Screening AML

Tutte le parti identificate vengono sottoposte automaticamente a screening rispetto alle watchlist AML globali:

AML Azienda: sottopone l’entità aziendale a screening rispetto a sanzioni, notizie negative e liste di provvedimenti delle autorità di vigilanza
AML persona: sottopone individualmente ogni persona chiave (UBO, azionista, amministratore, rappresentante, ecc.)
Utilizza lo stesso sistema di rischio a due punteggi (punteggio di corrispondenza + punteggio di rischio) della verifica degli utenti

Raccolta dei documenti

Raccogli e verifica i documenti a supporto:

Tipo di documento	Esempi
Atto costitutivo	Certificato di costituzione della società
Statuto sociale	Statuto, atto costitutivo
Prova di residenza	Bollette delle utenze ed estratti conto bancari per la sede legale
Libro dei soci	Registro ufficiale dei soci
Bilanci	Bilanci annuali, relazioni di revisione
Certificati fiscali	Certificati di registrazione fiscale o di conformità fiscale
Documenti personalizzati	Eventuali documenti aggiuntivi richiesti dal tuo processo di compliance

Gli analisti possono richiedere all’azienda documenti aggiuntivi durante il processo di revisione.

Revisione e decisione

La sessione aziendale riceve uno stato complessivo basato su tutti i controlli:

Stato	Significato
Approvata	Tutti i controlli superati: l’azienda è verificata
In revisione	Uno o più controlli richiedono una revisione manuale
Rifiutata	Un controllo critico non superato (ad esempio azienda sciolta o entità sanzionata)

Gli analisti possono esaminare tutti i dati raccolti nella Business Console, aggiungere commenti, richiedere documenti aggiuntivi e prendere una decisione finale.

Ciclo di vita della sessione aziendale

Ogni verifica aziendale viene eseguita all’interno di una sessione aziendale che traccia l’avanzamento attraverso i seguenti stati:

Stato	Descrizione
`"Not Started"`	Sessione creata, ma la verifica non è ancora iniziata
`"In Progress"`	Verifica in corso: ricerche nel registro, screening AML o raccolta dei documenti in svolgimento
`"Approved"`	Tutti i controlli superati: l’azienda è verificata
`"Declined"`	Un controllo critico non è stato superato (ad esempio, società sciolta o entità sanzionata)
`"In Review"`	Uno o più controlli richiedono una revisione manuale da parte di un analista
`"Resubmitted"`	Sessione precedentemente rifiutata e reinviata con dati aggiornati

Ogni sessione ha un session_id univoco, un session_number progressivo e un session_token per il link di verifica ospitato. Quando una sessione viene creata con un identificativo vendor_data, Didit la collega automaticamente al corrispondente profilo aziendale.

Stati delle funzionalità

La verifica aziendale monitora lo stato di ciascuna componente in modo indipendente:

Funzionalità	Descrizione
Controllo registro	Ricerca nel registro delle imprese ed estrazione dei dati
AML Azienda	Screening AML a livello aziendale rispetto a sanzioni e watchlist
Documenti	Raccolta dei documenti, OCR e verifica incrociata
Persone chiave	Identificazione di titolari effettivi e dirigenti, AML e KYC

Ogni funzionalità può essere: "Not Finished", "Approved", "Declined", "In Review" o "Resub Requested". Lo stato generale della sessione aggrega gli stati delle singole funzionalità: la sessione è "Approved" solo quando tutte le funzionalità richieste sono superate.

Eventi webhook

Le sessioni aziendali generano i seguenti eventi webhook:

Evento	Evento scatenante
`status.updated`	Lo stato della sessione è cambiato. Il payload contiene `session_kind: "business"` per le sessioni KYB.
`data.updated`	Un revisore ha modificato i dati del registro o Persone chiave nella console, oppure il registro ha segnalato una modifica. Il payload contiene `session_kind: "business"`. Per l’avanzamento segui `status.updated`.
`business.status.updated`	È cambiato lo stato dell’entità aziendale collegata (`ACTIVE` / `FLAGGED` / `BLOCKED`).
`business.data.updated`	Sono cambiati i campi del profilo o i contatori aggregati dell’entità aziendale collegata.

I payload webhook includono session_kind: "business" e il business_session_id per distinguerli dagli eventi di verifica utente. Per la verifica della firma e i dettagli di consegna consulta Webhook.

Funzionalità principali

Capacità	Descrizione
Ricerche automatiche nel registro	Interroga i registri ufficiali delle imprese nei paesi supportati al livello Lite, Shareholders o UBOs, con prezzi per paese
Identificazione degli UBO	Estrazione automatica delle strutture di titolarità effettiva con le percentuali
Screening dei dirigenti	Identificazione e verifica di amministratori, segretari e altri dirigenti
AML Azienda	Screening dell’entità aziendale rispetto a sanzioni e watchlist
AML Persona	Screening individuale di tutti gli UBO e i dirigenti identificati
Collegamento KYC	Collegamento di ogni persona identificata a una sessione di Verifica degli utenti (KYC) per la verifica dell’identità
Raccolta dei documenti	Richieste di documenti strutturate con monitoraggio dei caricamenti
Controllo incrociato OCR	Estrazione dei dati dai documenti caricati e confronto con i dati del registro
Profili aziendali	Creazione automatica del profilo e aggregazione delle sessioni per ogni azienda verificata
Stati a livello di funzionalità	Monitoraggio indipendente dello stato per registro, AML, documenti e persone chiave
Valutazione del rischio	Tag di avviso su ogni controllo e azioni del workflow che trasformano lo stato dell’azienda, i risultati AML e i risultati sull’assetto proprietario in un esito
Webhook	Ricezione in tempo reale degli eventi del ciclo di vita della sessione e degli aggiornamenti dei dati tramite webhook

Sessioni aziendali e sessioni utente

Funzionalità	Sessione utente	Sessione aziendale
Obiettivo	Singola persona	Azienda o entità giuridica
Tipo di sessione	`user` (predefinito)	`business`
Controlli principali	ID, rilevamento della vitalità, confronto facciale, AML	Ricerca nel registro, UBO, dirigenti, AML Azienda
Controlli aggiuntivi	Telefono, email, prova di residenza, NFC	Raccolta dei documenti, AML Persona, collegamento KYC
Payload webhook	Eventi di sessione standard	Includono `session_kind: "business"` e `business_session_id`

Prossimi passi

Profili aziendali

Monitora le aziende tra una sessione e l’altra con profili, tag e operazioni in blocco.

Dati aziendali

Ricerche nel registro, stato dell’azienda e confronto incrociato dei dati.

Struttura proprietaria

Identificazione degli UBO, azionisti aziendali e catene di titolarità.

Dirigenti e amministratori

Identificazione degli amministratori, ruoli e collegamento KYC.

Screening AML

Controlli AML a livello aziendale e individuale.

Documenti

Raccolta dei documenti, richieste e verifica OCR.

Primi passi

Funzionalità

Profili aziendali

Riferimento

Console

Verifica aziendale (KYB) API: registro e UBO

Come funziona

Ciclo di vita della sessione aziendale

Stati delle funzionalità

Eventi webhook

Funzionalità principali

Sessioni aziendali e sessioni utente

Prossimi passi

Profili aziendali

Dati aziendali

Struttura proprietaria

Dirigenti e amministratori

Screening AML

Documenti

​Come funziona

​Ciclo di vita della sessione aziendale

​Stati delle funzionalità

​Eventi webhook

​Funzionalità principali

​Sessioni aziendali e sessioni utente

​Prossimi passi

Profili aziendali

Dati aziendali

Struttura proprietaria

Dirigenti e amministratori

Screening AML

Documenti

Come funziona

Ciclo di vita della sessione aziendale

Stati delle funzionalità

Eventi webhook

Funzionalità principali

Sessioni aziendali e sessioni utente

Prossimi passi