> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# API di verifica dell'identità: oltre 14.000 documenti

> Verifica dell'identità con Didit: 220+ paesi, 14.000+ documenti, 54 lingue con IA. $0.15 per controllo, $10 gratis/mese, inferenza sub-2s.

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](#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.[Verifica dell'identità: l'autenticità prima dei dati — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=227\&rel=0\&playsinline=1)

Prompt di integrazione per la Verifica dell'identità
        Copia il prompt negli appunti



      
      

\<pre>

\````# Goal
Integrate Didit ID Verification (OCR + document authenticity) into your app. Pick ONE of the two delivery modes below.

\# Mode A — Session-based (recommended for user-facing flows)
Use this when the user uploads / photographs their document in a hosted Didit flow. The feature is configured on a workflow and runs as part of /v3/session/.

1\. Create a workflow with the ID_VERIFICATION feature (Business Console or POST /v3/workflows/). Canonical feature enum: "OCR" (legacy) or "ID_VERIFICATION".
2\. Create a session — POST /v3/session/ with { workflow_id, vendor_data, callback }. See /sessions-api/create-session.
3\. Open the returned session.url for the user OR mount the Web/Mobile SDK.
4\. After completion fetch the decision — GET /v3/session/{sessionId}/decision/ (or subscribe to the session.status.updated webhook).

The decision response surfaces the result under the plural array `id_verifications[]` (one entry per document collected in the workflow).

\# Mode B — Standalone API (server-to-server)
Use when you already have one or two document images and want a one-shot OCR + checks call.

POST https://verification.didit.me/v3/id-verification/
multipart/form-data — x-api-key: YOUR_API_KEY

Required: front_image. Required for dual-sided docs (ID cards, driver licences): back_image.
Allowed extensions: tiff/jpg/jpeg/png/webp/pdf. Max 5 MB per file. Images must be uncropped — all 4 corners visible.

curl example:
\```bash
curl -X POST 'https://verification.didit.me/v3/id-verification/' \
-H 'x-api-key: YOUR_API_KEY' \
-F 'front_image=@./id_front.jpg' \
-F 'back_image=@./id_back.jpg' \
-F 'perform_document_liveness=true' \
-F 'minimum_age=18' \
-F 'expiration_date_not_detected_action=DECLINE' \
-F 'invalid_mrz_action=DECLINE' \
-F 'inconsistent_data_action=DECLINE' \
-F 'preferred_characters=latin' \
-F 'save_api_request=true' \
-F 'vendor_data=user-123'
\```
Returns: { request_id, id_verification: { status, full_name, document_type, document_number, date_of_birth, expiration_date, parsed_address, mrz, barcodes, portrait_image, front_document_image, back_document_image, warnings: [...] } }.

\# Status enum (per id_verifications[].status)
"Not Started" | "In Progress" | "Approved" | "In Review" | "Declined" | "Abandoned" | "Kyc Expired"

\# Warnings (LogWarningChoices.ID_VERIFICATION)
The warnings[] array on each id_verification carries risk codes including:
DOCUMENT_EXPIRED, INVALID_MRZ, INCONSISTENT_DATA, COULD_NOT_RECOGNIZE_DOCUMENT, DOCUMENT_LIVENESS_FAILED, MIN_AGE_NOT_REACHED, MAX_AGE_EXCEEDED, EXPIRATION_DATE_NOT_DETECTED, DUPLICATED_DOCUMENT, FRAUD_RISK_FROM_OCR, COUNTRY_NOT_ALLOWED, DOCUMENT_TYPE_NOT_ALLOWED.
Full catalogue: /core-technology/id-verification/warnings-id-verification.

\# Failure modes to handle
\- HTTP 403 "You don't have enough credits..." — insufficient balance.
\- HTTP 400 with multipart validation errors (missing back_image on dual-sided docs, file > 5 MB, unsupported extension).
\- status="Declined" with one or more terminal warnings (DOCUMENT_EXPIRED, DOCUMENT_LIVENESS_FAILED, COULD_NOT_RECOGNIZE_DOCUMENT, etc.) — surface the first warning's long_description to the user and stop the flow.
\- status="In Review" with a DOCUMENT_LIVENESS_NOT_COMPUTED warning — the requested forgery check produced no usable score (provider error or crash); treat the document as unchecked and route it to your manual-review queue.
\- status="In Review" — route to your manual-review queue; do not approve the user.

\# See also
\- Canonical schema: /reference/data-models#id-verification
\- Full integration playbook: /integration/integration-prompt
\- Risk catalogue: /core-technology/id-verification/warnings-id-verification
\- Per-feature report: /core-technology/id-verification/report-id-verification````

\</pre>



      
      

Incolla in

![Fasi della verifica dell'identità di Didit dall'acquisizione del documento all'analisi e decisione basate su IA](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/id-verification-steps.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=42c64546f3495000d7ea3b10c4b5fa50)**1. Acquisizione intelligente**Avvia la procedura di verifica in modo semplice grazie al nostro intuitivo sistema di acquisizione basato su IA. Gli utenti caricano o fotografano i propri documenti d'identità con un'assistenza in tempo reale:* **Rilevamento automatico** del tipo di documento e del paese di emissione
* **Indicatori visivi in tempo reale** per un posizionamento, un'illuminazione e una messa a fuoco ottimali
* **Acquisizione automatica** quando le condizioni sono ideali — nessun nuovo tentativo manuale necessario
* Supporto per **passaporti**, **patenti di guida**, **carte d'identità nazionali** e **permessi di soggiorno**> [!NOTE]
>
> *Perché è importante*: la nostra acquisizione intelligente riduce le frizioni per l'utente e garantisce invii di alta qualità al primo tentativo, aumentando i tassi di conversione e la fiducia.**2. Elaborazione avanzata dei dati**Estrai e convalida i dati di identità con una precisione senza pari.**Estrazione dei dati** — Una tecnologia all'avanguardia elabora tutti i campi chiave:| Funzionalità | Dettagli |
| - | - |
| **Estrazione dei campi** | Nome completo, data di nascita, numero del documento, date di emissione/scadenza, nazionalità e altro |
| **OCR** | Riconoscimento del testo ad alta precisione |
| **Parsing MRZ** | Decodifica della zona leggibile dalla macchina (MRZ) |
| **Decodifica codici a barre** | Estrazione automatica dei dati dai codici a barre |**Convalida dei dati**:* Controllo incrociato dei dati tra zone visive, MRZ e codici a barre per garantirne la coerenza
* Verifica crittografica dei codici a barre firmati dall'emittente, laddove l'autorità di emissione pubblichi i certificati necessari per verificarli. Le carte d'identità nazionali francesi sono supportate oggi: il loro codice a barre 2D-Doc ANTS viene verificato a fronte di un certificato di firma che risale alla lista di attendibilità ANTS, così da rilevare un codice a barre non firmato dall'autorità anche quando i suoi contenuti appaiono coerenti
* Verifica dei formati e dei pattern per rilevare anomalie
* Interrogazioni in tempo reale ai database governativi (ove consentito) per una verifica autorevole> [!NOTE]
>
> *Perché è importante*: un'elaborazione completa dei dati garantisce accuratezza ed elimina gli errori, dandoti piena sicurezza in ogni verifica.**3. Analisi avanzata**Il nostro sistema basato su IA esegue controlli completi per garantire l'integrità e l'autenticità dei documenti:- Verifica dell'**autenticità del documento**
- **Rilevamento delle manomissioni** e analisi dell'integrità delle immagini
- **Rilevamento della vitalità del documento** per prevenire frodi dovute a:
  * Screenshot di documenti digitali
  * Foto di documenti visualizzati su schermi
  * Copie stampate di documenti
  * Documenti manipolati con ritratti alterati
- **Convalida degli elementi di sicurezza** (ologrammi, filigrane, ecc.)
- **Corrispondenza dei modelli** a fronte di un database certificato**4. Risultati e integrazione senza interruzioni**Ottieni informazioni operative istantanee con opzioni di consegna flessibili.**Risultati in tempo reale**:- Aggiornamenti immediati tramite un'intuitiva dashboard
- Notifiche webhook istantanee per workflow automatizzati
- API RESTful per un'integrazione perfetta nei tuoi sistemi esistenti**Reportistica completa**:* Report PDF dettagliati con esiti della verifica ed evidenze
* Registri di audit per la compliance e l'archiviazione
* Opzioni personalizzabili per allinearsi alle tue esigenze operative> [!NOTE]
>
> *Perché è importante*: risultati rapidi e accessibili consentono al tuo team di agire tempestivamente, mantenendo un processo sicuro e sottoponibile ad audit.***## Tre modi per verificareUn documento fotografato è uno dei tre [metodi di Verifica dell'identità](https://docs.didit.me/it/core-technology/id-verification/verification-methods.md). In base al paese puoi anche consentire alle persone di dimostrare la propria identità senza alcun documento:- **[Consultazione non basata su documenti](https://docs.didit.me/it/core-technology/id-verification/non-doc-lookup.md)** — 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](https://docs.didit.me/it/core-technology/id-verification/digital-id-wallets.md)** — 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 documentoPer 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 documentoConfigura 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.![Pannello delle impostazioni aggiuntive per la verifica dell'identità di Didit per le regole di scadenza e accettazione per paese](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/id-additional-settings.jpeg?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=4238b10a404795a61926fbdf1a3adc20)* **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](https://docs.didit.me/it/core-technology/id-verification/document-monitoring-id-verification.md).
  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 paeseApplica 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.### ConfigurazioneLe restrizioni di età vengono configurate come una tabella per paese direttamente dalla console:| Colonna | Descrizione |
| - | - |
| **Paese** | Il paese di emissione del documento (ISO 3166-1 alpha-3). Vengono mostrati solo i paesi abilitati nell'elenco dei documenti consentiti. |
| **Età minima** | Età minima richiesta. Gli utenti di età inferiore a questo valore fanno scattare l'azione configurata (Rifiuto o revisione). |
| **Età massima** | Età massima consentita. Gli utenti di età superiore a questo valore fanno scattare l'azione configurata. Lascia vuoto per non impostare un limite superiore. |
| **Sovrascritture per stato/regione** | Per i paesi con variazioni di età a livello subnazionale (es. Stati Uniti, Messico), apri l'icona delle impostazioni per configurare età minime e massime per stato che sovrascrivono i valori predefiniti a livello di paese. |### 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/regioneAlcuni 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 configurabiliQuando 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.> [!NOTE]
>
> Le restrizioni di età per paese funzionano anche con i workflow di **Verifica Età Adattiva**. Quando un caso limite attiva il fallback alla verifica dell'identità, il controllo dell'età utilizza queste impostazioni per paese per prendere la decisione finale in base al paese di emissione e alla regione del documento.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.