Vai al contenuto principale
GET
cURL

Supporto KYC e KYB

Funziona sia per le sessioni di Verifica degli utenti (KYC) sia per quelle di Verifica aziendale (KYB). Didit sceglie automaticamente il modello PDF appropriato:
  • Sessione di Verifica degli utenti (KYC) → report con verifica dell’identità, rilevamento della vitalità, confronto facciale, AML, sezioni POA.
  • Sessione di Verifica aziendale (KYB) → report con registro delle imprese, persone chiave (UBO/amministratori), documenti, AML, questionario, telefono, email e sezioni di analisi IP, quando queste funzionalità fanno parte del workflow.
Entrambi usano la stessa pipeline di generazione PDF e supportano la personalizzazione White label (logo, URL dell’informativa sulla privacy).

Convenzione per il nome del file

Viene restituito tramite l’intestazione Content-Disposition: attachment; filename=....

Requisito di stato

La sessione deve trovarsi in APPROVED, DECLINED o IN_REVIEW per generare un PDF. Le sessioni in corso o non ancora avviate restituiscono 403.

Esempi

White label

Quando per l’applicazione è attiva la personalizzazione White label, il PDF usa il tuo logo e l’URL dell’informativa sulla privacy. Configurala in Console → Customization.

Permesso

Richiede read:sessions. Stessa autorizzazione per entrambi i tipi.

Correlati

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Parametri del percorso

sessionId
string<uuid>
obbligatorio

UUID della sessione di Verifica degli utenti (KYC) o Verifica aziendale (KYB) da visualizzare — il session_id restituito da POST /v3/session/. Lo stesso percorso funziona per entrambi i tipi di sessione; usa il nome file nell'intestazione Content-Disposition della risposta per verificare quale tipo di report hai ricevuto.

Deve essere un UUID ben formato e in caratteri minuscoli. Il percorso accetta solo UUID validi, quindi un valore non corretto viene rifiutato dal router degli URL prima che venga eseguito il codice dell'applicazione e la risposta è una pagina HTML 404 invece dell'envelope JSON {"detail": ...} mostrato sotto. Il convertitore di UUID del percorso accetta solo il formato canonico in minuscolo — gli UUID esadecimali in maiuscolo vengono rifiutati con l'errore HTML 404.

Esempio:

"11111111-2222-3333-4444-555555555555"

Risposta

Il documento PDF renderizzato, restituito direttamente come binario application/pdf — non sono presenti wrapper JSON né reindirizzamenti tramite URL di download. Il corpo inizia con i byte magici %PDF (PDF 1.7). Salvalo in un file .pdf o trasmettilo in streaming al tuo chiamante.

The response is of type file.

Ultima modifica il 7 novembre 2026