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

# Documents utilisateur : ID, justificatif de domicile

> Pièces d'identité, justificatifs de domicile et fichiers de support des entités utilisateur Didit : collecte, récupération et import depuis la console.



Prompt des documents utilisateur
        Copier le prompt dans le presse-papiers



      
      

\<pre>

\````# Goal — retrieve user documents and generate compliance PDFs

Documents (ID images, MRZ data, selfies, proof-of-address scans, NFC chip reads) are attached to the **session** that captured them, not directly to the User entity. There is no public "upload document to user" API — capture flows through sessions. You can however list sessions for the user, retrieve each session's decision, and pull signed URLs to the document images.

\## Pattern — list sessions for a user, then read each decision

\```bash
\# 1) List sessions tied to the User entity
curl -G https://verification.didit.me/v3/sessions/ \
-H "x-api-key: $DIDIT_API_KEY" \
\--data-urlencode "vendor_data=user-42" \
\--data-urlencode "page_size=50"

\# 2) For each session, retrieve the full decision (V3 plural arrays)
curl https://verification.didit.me/v3/session/$SESSION_ID/decision/ \
-H "x-api-key: $DIDIT_API_KEY"
\```

\## Where documents appear in the V3 decision

Inspect these plural arrays (every per-feature result is plural in V3):

\| Array | Contains |
\|---|---|
\| `id_verifications[]` | Government ID images, OCR fields, MRZ, expiry, issuing country |
\| `liveness_checks[]` | Selfie frames, passive liveness score |
\| `nfc_verifications[]` | NFC chip data, ICAO certificate chain |
\| `proof_of_address_checks[]` | POA document images, extracted address |

Image URLs are short-lived signed URLs — cache the bytes if you need them long-term, or re-fetch the decision when they expire.

\## Generate a PDF report

For a human-readable compliance export (used for SARs, audits, regulator requests):

\```bash
curl https://verification.didit.me/v3/session/$SESSION_ID/generate-pdf/ \
-H "x-api-key: $DIDIT_API_KEY" \
-o session-report.pdf
\```

The PDF includes session details, per-feature results, and embedded document images.

\## Re-verification / new document collection

To collect fresh documents (e.g. expired ID), create a new session for the same `vendor_data` — the new session attaches to the existing User entity:

\```bash
curl -X POST https://verification.didit.me/v3/session/ \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"workflow_id": "$WORKFLOW_ID", "vendor_data": "user-42"}'
\```

\## Failure modes

\- `404` — wrong `session_id` or wrong `vendor_data` casing.
\- Expired signed image URL — re-fetch the decision to get fresh URLs.
\- `403` on PDF — your API key's role lacks PDF export permission.
\- Document monitoring is on by default and sends no warning before a document expires: when the ID's expiry date passes, the Approved session moves to "Kyc Expired" — see /core-technology/id-verification/document-monitoring-id-verification.

\## Response shape

See /reference/data-models for the full per-feature schema. Each plural-array item carries its own `status`, `document_images[]`, OCR extract, and decision metadata.

\## Sources of truth

\- /sessions-api/retrieve-session — decision schema
\- /reference/data-models — V3 plural-array contract
\- /core-technology/id-verification/overview — ID capture behaviour
\- /core-technology/proof-of-address/overview — POA capture
\- /integration/integration-prompt — canonical end-to-end prompt````

\</pre>



      
      

Coller dans

Chaque document qu'un utilisateur téléverse pendant la vérification est lié de façon permanente à son entité User. Cette page explique ce qui est collecté, comment le récupérer et comment téléverser manuellement des documents supplémentaires.## Ce que Didit collecte| Type de document | Moment de la collecte | Champs extraits |
| - | - | - |
| **Pièce d'identité officielle** (passeport, carte d'identité nationale, permis de conduire, titre de séjour) | Étape [vérification d'identité](https://docs.didit.me/fr/core-technology/id-verification/overview.md) | Nom, date de naissance, numéro du document, pays de délivrance, date d'expiration, MRZ le cas échéant |
| **Selfie / images de détection du vivant** | Étape [détection du vivant](https://docs.didit.me/fr/core-technology/liveness/overview.md) | Plus grand recadrage du visage, score de détection passive du vivant |
| **Justificatif de domicile (POA)** | Étape [POA](https://docs.didit.me/fr/core-technology/proof-of-address/overview.md) | Nom, adresse, émetteur, date du document |
| **Lecture de la puce NFC** | Étape [vérification NFC](https://docs.didit.me/fr/core-technology/nfc-verification/overview.md) | Données de la puce, chaîne de certificats ICAO, correspondance avec l'OCR |
| **Documents supplémentaires** | Demande d'un analyste ou étapes de workflow personnalisées | OCR lorsque c'est applicable, sinon stockés tels quels |[Types de documents pris en charge](https://docs.didit.me/fr/core-technology/id-verification/supported-documents-id-verification.md) couvrent l'ensemble de la matrice pays × documents (14,000+ documents dans 220+ pays).## Récupérer les documentsLes documents sont associés à la **session** qui les a collectés, et non directement à l'utilisateur. Pour lister tous les documents d'un utilisateur :**1. Lister les sessions de l'utilisateur**```bash theme={null}
curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=user-42"
```**2. Récupérer la décision de chaque session**Chaque décision de session contient des URL vers les documents collectés.```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"
```Inspectez les champs `id_verification.document_images`, `proof_of_address.document_images` et `liveness.images` de la réponse.**3. Utiliser les URL signées**Les URL des images dans la réponse sont des URL signées de courte durée. Mettez-les en cache côté client pendant leur utilisation, ou récupérez à nouveau la décision lorsqu'elles expirent.## Générer un rapport PDFPour un export lisible de tout ce qui a été collecté pour une session, y compris tous les documents, utilisez :**`GET /v3/session/{session_id}/generate-pdf/`**Renvoie un PDF contenant les détails de la session, les résultats des fonctionnalités et les images des documents intégrées. Utile pour les audits de conformité, les pièces jointes de déclarations d'activité suspecte (SAR) et les dépôts réglementaires.## Téléverser des documents depuis la consoleLes opérateurs de conformité peuvent téléverser des documents supplémentaires pour un utilisateur ou une session active :1. Accédez à *Users → \[user] → Documents → Upload document*.
2. Choisissez un type de document (ID, POA, personnalisé).
3. Téléversez un fichier ; l'OCR s'exécute automatiquement pour les types pris en charge.
4. Le document est rattaché à la session la plus récente (ou vous pouvez créer une session de remédiation).> [!NOTE]
>
> L'interface de téléversement de documents n'est disponible que dans la console : il n'existe aucun point d'accès API public permettant de rattacher directement un document à un utilisateur. Utilisez les sessions comme point d'entrée pour toute capture de document.## Recoupement des documentsLorsqu'une session collecte plusieurs types de documents, Didit les recoupe :- **ID ↔ Détection du vivant** : le visage de la pièce d'identité correspond au selfie de détection du vivant.
- **ID ↔ POA** : le nom figurant sur le justificatif de domicile correspond au nom extrait de la pièce d'identité.
- **ID ↔ NFC** : les données MRZ ou visuelles correspondent aux données de la puce NFC.Les incohérences sont signalées sous forme d'avertissements dans la décision de session et peuvent être configurées pour déclencher un examen manuel.## Surveillance des documents et revérificationPour les cas d'usage qui exigent une validité continue des documents (par exemple, les pièces d'identité expirées) :- **L'expiration du document** est suivie pour chaque pièce d'identité vérifiée. Interrogez la décision de session pour le champ `expiration_date`.
- **Surveillance des documents** : activée par défaut et automatique, rien n'a besoin d'être activé. Lorsque la date d'expiration de la pièce d'identité est dépassée, une session `"Approved"` passe à `"Kyc Expired"`, le résultat de la vérification d'identité reçoit un avertissement `DOCUMENT_EXPIRED` et un webhook `status.updated` est déclenché. Aucun avertissement n'est envoyé avant la date d'expiration.
- **Pour la désactiver**, définissez **Expiration mode** sur **Allow expired** pour ce pays et ce type de document dans les [paramètres de vérification d'identité](https://docs.didit.me/fr/core-technology/id-verification/overview.md). **Reject expired**, valeur par défaut, est le mode qui active la surveillance. Un document accepté avec **Allow expired** n'est jamais surveillé.
- **Revérification** : lancez une nouvelle session avec le même `vendor_data` pour actualiser les documents.## Géolocalisation du documentLa vérification de [géolocalisation du document d'identité](https://docs.didit.me/fr/core-technology/id-verification/document-geolocation-id-verification.md) compare la localisation IP de la personne qui soumet le document au pays de délivrance de la pièce d'identité. Les résultats sont joints à la décision de session.## Confidentialité et conservation- Tous les documents sont chiffrés au repos.
- L'accès aux images se fait via des URL signées de courte durée.
- La conservation suit la politique de [conservation des données](https://docs.didit.me/fr/console/data-retention.md) de l'application.
- Les utilisateurs ont le droit de demander la suppression ; la suppression efface les images, les extraits OCR et les données NFC.## Prochaines étapes> [card] [Vérification d'identité](https://docs.didit.me/fr/core-technology/id-verification/overview.md)
>
> Fonctionnement de la capture de la pièce d'identité et de l'OCR.> [card] [Justificatif de domicile](https://docs.didit.me/fr/core-technology/proof-of-address/overview.md)
>
> Collecte des justificatifs de domicile.> [card] [Décision de session](https://docs.didit.me/fr/sessions-api/retrieve-session.md)
>
> Référence de GET /v3/session/{id}/decision/.


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