> ## 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.

# Verificació d'identitat API: 14,000+ documents

> Verificació d'identitat amb IA de Didit: 220+ països, 14,000+ documents, 54 idiomes. $0.15 per verificació, $10 gratis al mes, inferència sub-2s.

La verificació d'identitat de Didit llegeix i autentica documents d'identitat emesos pels governs, com ara passaports, targetes d'identitat, permisos de conduir i permisos de residència, en 220+ països i 14,000+ tipus de document. Comprova si el document ha estat manipulat o és fraudulent i després n'extreu les dades amb OCR d'IA; quan un país ho permet, les persones poden verificar-se sense document mitjançant una consulta a una base de dades o una cartera d'identitat digital ([tres maneres de verificar](#tres-maneres-de-verificar)).La lliçó de l'Academy sobre com llegir un resultat de verificació arriba a la verificació d'identitat al minut 3:47 i mostra per què les comprovacions d'autenticitat van abans que les dades extretes.[Verificació d'identitat: l'autenticitat abans que les dades. Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=227\&rel=0\&playsinline=1)

Prompt d'integració de la verificació d'identitat
        Copia el prompt al porta-retalls



      
      

\<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>



      
      

Enganxa a

![Passos de la verificació d'identitat de Didit, des de la captura del document fins a l'anàlisi i la decisió basades en 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. Captura intel·ligent**Comença el procés de verificació sense esforç amb el nostre sistema de captura intuïtiu i impulsat per IA. Els usuaris pugen o fotografien els seus documents d'identitat amb ajuda en temps real:* **Detecció automàtica** del tipus de document i del país emissor
* **Indicacions visuals en temps real** per a una posició, una il·luminació i un enfocament òptims
* **Captura automàtica** quan les condicions són ideals: no cal reintentar-ho manualment
* Admet **passaports**, **permisos de conduir**, **targetes d'identitat nacionals** i **permisos de residència**> [!NOTE]
>
> *Per què importa*: La nostra captura intel·ligent redueix la fricció per a l'usuari i garanteix enviaments d'alta qualitat al primer intent, cosa que millora les taxes de conversió i la confiança.**2. Processament avançat de dades**Extreu i valida les dades d'identitat amb una precisió sense parangó.**Extracció de dades**: una tecnologia d'última generació processa tots els camps clau:| Capacitat | Detalls |
| - | - |
| **Extracció de camps** | Nom complet, data de naixement, número de document, dates d'emissió i de caducitat, nacionalitat i més |
| **OCR** | Reconeixement de text d'alta precisió |
| **Anàlisi de la MRZ** | Descodificació de la zona llegible per màquina |
| **Descodificació de codis de barres** | Extracció automàtica de les dades del codi de barres |**Validació de dades**:* Creua les dades entre les zones visuals, la MRZ i els codis de barres per garantir la coherència
* Verificació criptogràfica dels codis de barres signats per l'emissor, quan l'autoritat emissora publica els certificats necessaris per comprovar-los. Actualment hi ha cobertura per a les targetes d'identitat nacionals franceses: el seu codi de barres ANTS 2D-Doc es verifica amb un certificat del signant que forma una cadena fins a la llista de confiança de l'ANTS, de manera que es detecta un codi de barres que l'autoritat no ha signat, fins i tot quan el seu contingut sembla coherent
* Comparació de formats i patrons per detectar anomalies
* Consultes en temps real a bases de dades governamentals (quan estan permeses) per a una verificació basada en una font autoritzada> [!NOTE]
>
> *Per què importa*: El processament complet de dades garanteix la precisió i elimina els errors, i et dóna confiança en cada verificació.**3. Anàlisi avançada**El nostre sistema basat en IA fa comprovacions exhaustives per garantir la integritat i l'autenticitat del document:- **Verificació de l'autenticitat del document**
- **Detecció de manipulacions** i anàlisi de la integritat de la imatge
- **Prova de vida del document** per evitar el frau derivat de:
  * Captures de pantalla de documents digitals
  * Fotografies de documents mostrats en pantalles
  * Còpies impreses de documents
  * Documents manipulats amb retrats alterats
- **Validació de les mesures de seguretat** (hologrames, filigranes, etc.)
- **Coincidència de plantilles** amb una base de dades certificada**4. Resultats i integració fluids**Obté informació útil per actuar a l'instant amb opcions de lliurament flexibles.**Resultats en temps real**:- Actualitzacions immediates a través d'un tauler intuïtiu
- Notificacions webhook instantànies per als fluxos de treball automatitzats
- API RESTful per a una integració sense friccions amb els teus sistemes existents**Informes exhaustius**:* Informes PDF detallats amb els resultats de la verificació i les evidències
* Registres d'auditoria per al compliment normatiu i la conservació de registres
* Opcions personalitzables per adaptar-les a les teves necessitats operatives> [!NOTE]
>
> *Per què importa*: Els resultats ràpids i accessibles permeten al teu equip actuar amb rapidesa i mantenir un procés segur i auditable.***## Tres maneres de verificarUn document fotografiat és un dels tres [mètodes de verificació d'identitat](https://docs.didit.me/ca/core-technology/id-verification/verification-methods.md). Per a cada país, també pots permetre que les persones demostrin qui són sense cap document:- **[Consulta sense document](https://docs.didit.me/ca/core-technology/id-verification/non-doc-lookup.md)**: l'usuari introdueix el seu número d'identificació nacional i algunes dades personals, i les comprovem amb un registre governamental o amb una altra font fiable, indicada per país. Quan aquesta font retorna un retrat, s'hi inclouen una selfie, una prova de vida passiva i una coincidència facial.
- **[Carteres d'identitat digital](https://docs.didit.me/ca/core-technology/id-verification/digital-id-wallets.md)**: l'usuari inicia sessió amb una identitat digital governamental o bancària, com MitID, BankID o itsme, i la cartera comparteix un conjunt signat d'atributs.Tot el que hi ha en aquesta pàgina descriu la captura de documents, que no canvia: un flux de treball que no diu res sobre els mètodes continua essent només captura de documents.***## Requisits dels documentsPer assolir la màxima taxa d'èxit en la verificació, els documents han de complir aquests estàndards:#### Requisits generals- Emesos pel govern i vigents dins del seu període de validesa configurat
- Físicament intactes (sense danys, ratllades ni taques que n'oculten els detalls)
- Tota la informació crítica (nom complet, data de naixement, MRZ, etc.) clarament llegible
- Dades coherents en tots els documents enviats#### Requisits de la imatge- Fotografia original, en temps real (no captures de pantalla, escanejos ni còpies digitals)
- Formats admesos: JPG, JPEG, PNG, PDF
- Mida màxima del fitxer: 5MB
- Imatge a tot color amb totes les cantonades del document visibles
- Sense reflexos, ombres, edicions digitals ni manipulacions
- Calen documents físics (els documents d'identitat digitals només s'admeten en regions concretes on estan reconeguts oficialment)## Configuració addicional per país i tipus de documentConfigura regles detallades per país i tipus de document directament des de la consola. Aquests controls et permeten ajustar els criteris d'acceptació i les preferències de transcripció a les necessitats de compliment.![Panell de configuració addicional de la verificació d'identitat de Didit per a les regles de caducitat i acceptació per país](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)* **Mode de caducitat**: Tria com gestionar els documents amb una data de caducitat passada.

  * **Rebutja els caducats**: Si la data de caducitat del document és anterior a avui, marca'l com a caducat i rebutja'l.
  * **Permet els caducats**: No marquis ni bloquegis els documents amb una data de caducitat passada.

  Aquest paràmetre controla també el monitoratge posterior a l'aprovació, que està activat per defecte: amb **Rebutja els caducats**, una sessió aprovada passa a `"Kyc Expired"` quan després venç la data de caducitat del document, i es dispara `status.updated`; amb **Permet els caducats**, la sessió es manté aprovada i mai no es monitoritza. Consulta [monitoratge de documents](https://docs.didit.me/ca/core-technology/id-verification/document-monitoring-id-verification.md).
  A l'API de workflow, la configuració per país i document `expiration_check_mode` accepta `strict` (**Rebutja els caducats**), `allow_expired` (**Permet els caducats**) i `local_regulation`.
  `local_regulation` segueix la norma pròpia del país quan Didit en té una, i rebutja els documents caducats a la resta de països.
  Qualsevol altre valor es rebutja.
* **Format de caràcters preferit**: Selecciona com s'han de normalitzar els noms i els camps extrets.
  * **Prefereix els caràcters llatins (A–Z)**: Exemple: "Mohammed"
  * **Prefereix el sistema d'escriptura original (no llatí)**: Exemple: "محمد"
* **Compatibilitat regional i subtipus**: Activa documents per regió i especifica els subtipus acceptats quan un tipus de document té moltes variants.
  * Exemple: per a les llicències de conducció dels Estats Units, selecciona els subtipus exactes que acceptes (p. ex., llicència de conducció comercial d'Arizona, llicència d'operador d'Indiana (REAL ID), llicència de conducció millorada de Nova York, etc.).
  * Fes servir el control "Subtipus acceptats" per incloure o excloure ràpidament moltes variants (p. ex., "128 selected").> Consell: Aquests paràmetres s'apliquen per país i tipus de document, de manera que pots ser més estricte en alguns mercats i més permissiu en altres.## Restriccions d'edat per paísAplica límits d'edat mínima i màxima per país durant la verificació d'identitat. El sistema extreu la data de naixement de l'usuari del document presentat i la comprova amb els límits d'edat configurats per al país emissor del document.### ConfiguracióLes restriccions d'edat es configuren com a taula per país directament des de la consola:| Columna | Descripció |
| - | - |
| **País** | El país emissor del document (ISO 3166-1 alpha-3). Només es mostren els països habilitats a la llista de documents permesos. |
| **Edat mín.** | Edat mínima requerida. Els usuaris més joves que aquest valor activen l'acció configurada (Rebutjar o Revisió). |
| **Edat màx.** | Edat màxima permesa. Els usuaris més grans que aquest valor activen l'acció configurada. Deixa el camp buit si no vols cap límit superior. |
| **Sobreescriptures d'estat/regió** | Per als països amb variacions d'edat a escala subnacional (p. ex., Estats Units, Mèxic), obre la icona de configuració per definir les edats mínimes i màximes per estat, que substitueixen els valors per defecte del país. |### Edats de majoria per defecteLa consola inclou un botó **"Apply age of majority"** que omple automàticament l'edat mínima de cada país amb l'edat legal de majoria coneguda (18 a la majoria de països, amb excepcions com 19 a Corea del Sud, 21 als Emirats Àrabs Units, 20 a Nova Zelanda, etc.). Després pots ajustar països individuals o afegir sobreescriptures a nivell d'estat segons calgui.### Sobreescriptures d'estat i regióAlguns països tenen llindars d'edat legals diferents segons l'estat o la regió. Quan s'escaneja un document, el sistema OCR extreu la regió (p. ex., "Mississippi", "Alabama", "Jalisco") del document. Si hi ha una sobreescriptura d'estat configurada per a aquella regió, aquesta té prioritat sobre la configuració d'edat del país.Per exemple, si els Estats Units tenen una edat mínima de 18, però Mississippi té una sobreescriptura d'estat de 21, un usuari que presenti una llicència de conducció de Mississippi es comprovarà amb l'edat mínima de 21.### Accions configurablesQuan l'edat d'un usuari queda fora del rang configurat per al país (o estat) del seu document, pots triar l'acció:* **Rebutjar**: la sessió es rebutja automàticament.
* **Revisió**: la sessió es marca per a revisió manual.> [!NOTE]
>
> Les restriccions d'edat per país també funcionen amb els fluxos de treball de la **Verificació d'edat adaptativa**. Quan un cas límit activa la verificació d'identitat com a alternativa, la comprovació d'edat fa servir aquests paràmetres per país per prendre la decisió final, segons el país emissor i la regió del document.


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