Vai al contenuto principale
Business Verification tiene lo stato a più livelli: la sessione, le singole funzionalità, la ricerca nel registro e il risultato AML. Questa pagina è il riferimento per ogni stato. L’API restituisce i valori di stato come etichette esatte che distinguono tra maiuscole e minuscole, come "In Progress" e "Not Finished", le stesse stringhe che i webhook trasmettono. Confronta queste stringhe così come sono, non sui nomi in maiuscolo.

​
Stato della sessione

Lo stato complessivo di una sessione di Business Verification (KYB), il campo che più spesso userai per decidere il comportamento dell’applicazione.
"Awaiting User" è uno stato transitorio: non devi spostare manualmente le sessioni fuori da questo stato. Appena l’utente finale completa l’azione in sospeso (ad esempio invia l’elenco delle persone chiave o ricarica un documento richiesto), Didit rivaluta la sessione e la porta automaticamente a "In Review", "Approved" o "Declined", in base all’esito.

​
Stato della funzionalità

Ogni funzionalità KYB ha un proprio stato, che confluisce nello stato della sessione.

​
Nomi delle funzionalità KYB

Questi sono i valori di features in una sessione KYB e nei webhook:
  • KYB_REGISTRY: ricerca nel registro delle imprese.
  • AML: screening AML a livello aziendale.
  • KYB_DOCUMENTS: raccolta dei documenti e OCR.
  • KYB_KEY_PEOPLE: persone chiave, ossia titolari effettivi, azionisti, amministratori, rappresentanti e altri dirigenti.

​
Stato del registro (dal fornitore)

Lo stato ufficiale dell’azienda, ottenuto da fonti di registro autorevoli. Riflette la posizione giuridica o normativa del soggetto, come riportata dal registro della specifica giurisdizione, quindi i valori esatti variano in base alla fonte. Viene esposto nella decisione KYB in company.registry_status.
Poiché registry_status riflette i valori grezzi del registro, usa verification_status qui sotto quando ti serve un indicatore coerente tra giurisdizioni per guidare la logica del prodotto.

​
Stato di verifica dell’azienda

Uno stato standardizzato, rivolto alle aziende, per ogni risultato relativo a un’azienda. Normalizza i diversi stati del registro e dell’azienda, che variano tra paesi e fonti, in un unico indicatore coerente che può essere interpretato direttamente all’interno del tuo prodotto. Viene esposto nella decisione KYB in company.verification_status.

​
Stato di recupero dei dati dell’azienda

Indica l’avanzamento del recupero dei dati per una specifica scheda aziendale da registri esterni o ufficiali. Usalo per capire quanto siano complete le informazioni recuperate per una data azienda. Viene esposto nella decisione KYB in company.fetch_status.

​
Stato della verifica AML

Restituito per ogni screening (azienda o persona).

​
Come si spiega una decisione

La decisione KYB non include un’unica stringa di codice motivo. Ogni array di funzionalità (registry_checks[], document_verifications[], key_people_checks[], aml_screenings[]) contiene warnings[] con tag KYB_* e tag AML, e decision_trace registra come è stata raggiunta la decisione. Leggi i tag in avvisi KYB e registrali insieme allo stato della sessione. Quando un revisore imposta lo stato manualmente, in contrasto con l’aggregazione della piattaforma, la decisione include status_override con l’orario overridden_at e il valore automatic_status che la piattaforma avrebbe impostato. Consulta lo schema della risposta.

​
Passaggi successivi

Schema della risposta

Dove compare ogni stato nel payload.

Valutazione del rischio

Che cosa determina l’esito di una verifica KYB.

Webhook

Eventi che si attivano al cambiamento di stato.
Ultima modifica il 7 novembre 2026