API di verifica dell'identità: oltre 14.000 documenti

La Verifica dell’identità di Didit legge e autentica documenti d’identità rilasciati da autorità governative, come passaporti, carte d’identità, patenti di guida e permessi di soggiorno, in 220+ paesi e per 14,000+ tipi di documento. Verifica che il documento non presenti manomissioni o frodi, quindi ne estrae i dati tramite OCR basato su IA; ove consentito dal paese, gli utenti possono verificare la propria identità senza documento tramite una consultazione su database o un wallet di identità digitale (tre modi per verificare). La lezione dell’Academy sulla lettura del risultato di verifica affronta la verifica dell’identità al minuto 3:47 e spiega perché i controlli di autenticità precedono i dati estratti.

---

​

Tre modi per verificare

Un documento fotografato è uno dei tre metodi di Verifica dell’identità. In base al paese puoi anche consentire alle persone di dimostrare la propria identità senza alcun documento:

• Consultazione non basata su documenti — l’utente inserisce il proprio numero identificativo nazionale e alcuni dati personali, che verifichiamo a fronte di un registro governativo o un’altra fonte autorevole, indicata per ciascun paese. Se tale fonte restituisce una foto, sono inclusi selfie, rilevamento passivo della vitalità e confronto facciale.
• Wallet di identità digitale — l’utente accede con un’identità digitale bancaria o governativa come MitID, BankID o itsme, e il wallet condivide un insieme firmato di attributi.

Tutto ciò che è descritto in questa pagina riguarda l’acquisizione di documenti, che rimane invariata: un workflow in cui non sono specificati i metodi resta limitato alla sola acquisizione di documenti.

---

​

Requisiti del documento

Per massimizzare la probabilità di successo della verifica, i documenti devono soddisfare i seguenti standard:

​

Requisiti generali

• Rilasciato da un’autorità governativa e valido entro il periodo di validità configurato
• Fisicamente intatto (nessun danno, graffio o macchia che nasconda i dettagli)
• Tutte le informazioni critiche (nome completo, data di nascita, MRZ, ecc.) chiaramente leggibili
• Dati coerenti su tutti i documenti inviati

​

Requisiti delle immagini

• Foto originale scattata in tempo reale (nessuno screenshot, scansione o copia digitale)
• Formati supportati: JPG, JPEG, PNG, PDF
• Dimensione massima del file: 5MB
• Immagine a colori con tutti gli angoli del documento visibili
• Priva di riflessi, ombre, modifiche digitali o manipolazioni
• Documenti fisici obbligatori (i documenti d’identità digitali sono supportati solo in aree geografiche selezionate dove sono ufficialmente riconosciuti)

​

Impostazioni aggiuntive per paese e tipo di documento

Configura regole granulari per paese e tipo di documento direttamente dalla console. Questi controlli ti consentono di adattare i criteri di accettazione e le preferenze di trascrizione alle tue esigenze di compliance.

• Modalità di scadenza: scegli come gestire i documenti con date di scadenza passate.
  • Rifiuta i documenti scaduti: se la data di scadenza del documento è precedente a quella odierna, contrassegnalo come scaduto e rifiuta.
  • Consenti i documenti scaduti: non contrassegnare né bloccare i documenti con una data di scadenza passata.
  Questa impostazione controlla anche il monitoraggio post-approvazione, attivo per impostazione predefinita: con Rifiuta i documenti scaduti, una sessione approvata passa a "Kyc Expired" quando la data di scadenza del documento viene successivamente superata e viene attivato status.updated; con Consenti i documenti scaduti rimane approvata e non viene mai monitorata. Consulta il monitoraggio dei documenti. Nell’API del workflow, l’impostazione del documento per paese expiration_check_mode accetta strict (Rifiuta i documenti scaduti), allow_expired (Consenti i documenti scaduti) e local_regulation. local_regulation segue la regola specifica del paese laddove Didit ne prevede una, e rifiuta i documenti scaduti in tutti gli altri casi. Qualsiasi altro valore viene rifiutato.
• Formato dei caratteri preferito: seleziona la modalità di normalizzazione dei nomi e dei campi estratti.
  • Preferisci i caratteri latini (A–Z): esempio: “Mohammed”
  • Preferisci il sistema di scrittura originale (non latino): esempio: “محمد”
• Supporto regionale e sottotipi: abilita i documenti per regione e specifica i sottotipi accettabili quando un tipo di documento contiene molte varianti.
  • Esempio: per le patenti di guida degli Stati Uniti, seleziona i sottotipi esatti che accetti (es. Arizona Commercial Driver License, Indiana Operator License (REAL ID), New York Enhanced Driver License, ecc.).
  • Utilizza il controllo “Sottotipi accettati” per includere o escludere rapidamente molte varianti (es. “128 selected”).

Suggerimento: queste impostazioni si applicano per paese e tipo di documento, permettendoti di essere rigoroso in alcuni mercati e più permissivo in altri.

​

Restrizioni di età per paese

Applica requisiti di età minima e massima in base al paese durante la verifica dell’identità. Il sistema estrae la data di nascita dell’utente dal documento presentato e la confronta con i limiti di età configurati per il paese di emissione del documento.

​

Configurazione

Le restrizioni di età vengono configurate come una tabella per paese direttamente dalla console:

​

Valori predefiniti per la maggiore età

La console include un pulsante “Applica la maggiore età” che compila automaticamente l’età minima di ciascun paese con la maggiore età legale nota (18 nella maggior parte dei paesi, con eccezioni come 19 in Corea del Sud, 21 negli Emirati Arabi Uniti, 20 in Nuova Zelanda, ecc.). Puoi quindi modificare singoli paesi o aggiungere sovrascritture a livello statale in base alle esigenze.

​

Sovrascritture per stato/regione

Alcuni paesi prevedono diverse soglie legali di età a seconda dello stato o della regione. Quando un documento viene scansionato, il sistema OCR estrae la regione (es. “Mississippi”, “Alabama”, “Jalisco”) dal documento. Se per tale regione è configurata una sovrascrittura statale, questa ha la precedenza sull’impostazione di età a livello di paese. Ad esempio, se gli Stati Uniti hanno un’età minima di 18 anni, ma il Mississippi ha una sovrascrittura statale di 21 anni, un utente che presenta una patente di guida del Mississippi verrà verificato rispetto all’età minima di 21 anni.

​

Azioni configurabili

Quando l’età di un utente non rientra nell’intervallo configurato per il paese (o stato) del suo documento, puoi scegliere l’azione:

• Rifiuta: la sessione viene automaticamente rifiutata.
• Revisione: la sessione viene contrassegnata per la revisione manuale.