Vai al contenuto principale
Ogni documento caricato da un utente durante la verifica è collegato in modo permanente alla sua entità User. Questa pagina spiega cosa viene raccolto, come recuperarlo e come caricare manualmente documenti aggiuntivi.

​
Cosa raccoglie Didit

Tipi di documento supportati coprono l’intera matrice paese × documento (14,000+ documenti in 220+ paesi).

​
Recupero dei documenti

I documenti sono associati alla sessione che li ha raccolti, non direttamente all’utente. Per elencare tutti i documenti di un utente:
1

Elenca le sessioni dell'utente

2

Recupera la decisione di ogni sessione

La decisione di ogni sessione include gli URL dei documenti raccolti.
Controlla i campi id_verification.document_images, proof_of_address.document_images e liveness.images nella risposta.
3

Usa gli URL firmati

Gli URL delle immagini nella risposta sono URL firmati a breve durata. Memorizzali nella cache lato client per il tempo necessario al loro utilizzo oppure richiedi di nuovo la decisione quando scadono.

​
Generazione di un report PDF

Per un’esportazione leggibile di tutto ciò che è stato raccolto per una sessione, inclusi tutti i documenti, usa: GET /v3/session/{session_id}/generate-pdf/ Restituisce un PDF con i dettagli della sessione, i risultati delle funzionalità e le immagini dei documenti incorporate. È utile per audit di compliance, allegati SAR e pratiche normative.

​
Caricamento dei documenti dalla console

Gli operatori di compliance possono caricare documenti aggiuntivi per un utente o per una sessione attiva:
  1. Vai a Users → [user] → Documents → Upload document.
  2. Scegli un tipo di documento (ID, POA, personalizzato).
  3. Carica un file: per i tipi supportati l’OCR viene eseguito automaticamente.
  4. Il documento viene collegato alla sessione più recente (oppure puoi creare una sessione di remediation).
L’interfaccia di caricamento dei documenti è disponibile solo nella console: non esiste un endpoint API pubblico per collegare direttamente documenti a un utente. Usa le sessioni come punto di partenza per tutte le acquisizioni di documenti.

​
Confronto incrociato dei documenti

Quando una sessione raccoglie più tipi di documento, Didit li confronta tra loro:
  • ID ↔ Rilevamento della vitalità: il volto nel documento d’identità corrisponde al selfie per il rilevamento della vitalità.
  • ID ↔ POA: il nome nella POA corrisponde al nome estratto dal documento d’identità.
  • ID ↔ NFC: i dati MRZ / visivi corrispondono ai dati del chip NFC.
Le incoerenze vengono segnalate come avvisi nella decisione della sessione e possono essere configurate per attivare una revisione manuale.

​
Monitoraggio dei documenti e nuova verifica

Per casi d’uso che richiedono la validità continua dei documenti (ad es. documenti d’identità scaduti):
  • La scadenza del documento viene tracciata per ogni documento d’identità verificato. Interroga la decisione della sessione per il campo expiration_date.
  • Monitoraggio dei documenti: attivo per impostazione predefinita e automatico, non occorre abilitare nulla. Quando la data di scadenza del documento d’identità viene superata, una sessione "Approved" passa a "Kyc Expired", il risultato della verifica dell’ID riceve un avviso DOCUMENT_EXPIRED e viene inviato un webhook status.updated. Nessun avviso viene inviato prima che la data sia superata.
  • Disattivazione: imposta Expiration mode su Allow expired per il paese e il tipo di documento interessati nelle impostazioni della verifica dell’identità. Reject expired, l’impostazione predefinita, è la modalità che attiva il monitoraggio. Un documento accettato con Allow expired non viene mai monitorato.
  • Nuova verifica: avvia una nuova sessione con lo stesso vendor_data per aggiornare i documenti.

​
Geolocalizzazione del documento

Il controllo di geolocalizzazione del documento d’identità confronta la posizione IP di chi invia i dati con il paese di emissione del documento d’identità. I risultati vengono allegati alla decisione della sessione.

​
Privacy e conservazione

  • Tutti i documenti sono cifrati a riposo.
  • L’accesso alle immagini avviene tramite URL firmati a breve durata.
  • La conservazione segue la politica di conservazione dei dati dell’applicazione.
  • Gli utenti hanno il diritto di chiedere la cancellazione: la cancellazione rimuove immagini, estratti OCR e dati NFC.

​
Prossimi passi

Verifica dell'identità

Come funzionano l’acquisizione del documento d’identità e l’OCR.

Prova di residenza

Raccolta dei documenti POA.

Decisione della sessione

Riferimento GET /v3/session//decision/.
Ultima modifica il 7 novembre 2026