> ## 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 Justificatif de domicile : vérification des factures

> Vérifiez les adresses avec Didit : extraction par IA de factures, relevés bancaires et documents officiels. $0.20 par appel.

La vérification du justificatif de domicile (PoA) vous permet de vérifier l'adresse de résidence d'un utilisateur à partir de documents officiels. Cette fonctionnalité simplifie le processus de vérification d'adresse, en permettant aux utilisateurs de capturer ou de télécharger des documents attestant de leur adresse.

Prompt d'intégration du justificatif de domicile
        Copier le prompt dans le presse-papiers



      
      

\<pre>

\````# Goal
Integrate Didit Proof of Address (utility bill, bank statement, government letter OCR + cross-checks) into your app. Pick ONE mode.

\# Mode A — Session-based
Use this when the user uploads the document in a hosted Didit flow.

1\. Add the PROOF_OF_ADDRESS feature to the workflow (Business Console or POST /v3/workflows/). Configure: poa_languages_allowed, poa_document_age_months, and the per-risk actions (poa_issuer_not_identified_action, poa_name_mismatch_action, poa_address_mismatch_action, poa_document_expired_action, poa_language_not_allowed_action).
2\. Create a session — POST /v3/session/ with { workflow_id, vendor_data, callback }. See /sessions-api/create-session.
3\. Open session.url for the user (or mount the Web/Mobile SDK).
4\. Fetch the decision — GET /v3/session/{sessionId}/decision/ or subscribe to session.status.updated.

Decision surface: `poa_verifications[]` array on the decision payload.

\# Mode B — Standalone API (server-to-server)
Use when you already have the document and want a one-shot check decoupled from a hosted flow.

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

Latency: OCR typically takes 5–15s (up to ~30s for multi-page PDFs). Use a client timeout of **at least 45s**. Max upload 15 MB (PDF, JPG, PNG, TIFF, WebP). Encrypted PDFs require `document_password` or you get HTTP 400 with `code: "encrypted_pdf"`.

curl example:
\```bash
curl -X POST 'https://verification.didit.me/v3/poa/' \
-H "x-api-key: $DIDIT_API_KEY" \
-F "document=@./utility-bill.pdf" \
-F "expected_address=Av. Monseñor Tavella 3396, Salta" \
-F "expected_country=ARG" \
-F "expected_first_name=Sophia" \
-F "expected_last_name=Martinez" \
-F "poa_languages_allowed=en,es" \
-F "vendor_data=user-1234"
\```
Returns: { request_id, poa: { status, parsed_address, document_type, issuer, issue_date, language, document_metadata: { overlay_manipulation }, warnings: [...] } }.

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

\# Warnings (LogWarningChoices.PROOF_OF_ADDRESS)
warnings[] risk codes include:
ISSUER_NOT_IDENTIFIED, LANGUAGE_NOT_ALLOWED, DOCUMENT_EXPIRED, DOCUMENT_TOO_OLD, NAME_MISMATCH, ADDRESS_MISMATCH, COUNTRY_MISMATCH, OVERLAY_MANIPULATION_DETECTED, UNREADABLE_DOCUMENT.
Full catalogue: /core-technology/proof-of-address/warnings-proof-of-address.

\# Failure modes to handle
\- HTTP 400 with `code: "encrypted_pdf"` — the PDF is password-protected (or the password is wrong); supply the right `document_password` or a decrypted copy.
\- HTTP 400 with `code: "document_unreadable"` — the file is corrupt or cannot be opened; ask the user for a different file. Branch on `code`, not on the message text.
\- HTTP 503 with `code: "document_processing_busy"`: too many documents are being processed, so the upload was not processed. Send the same file again after the `Retry-After` seconds.
\- HTTP 403 — out of credits.
\- Client timeout — bump to 45s+ before retrying.
\- status="Declined" with NAME_MISMATCH / ADDRESS_MISMATCH — the extracted fields don't match expected_*; do not approve.
\- OVERLAY_MANIPULATION_DETECTED — PDF forensics caught edits; reject.

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

\</pre>



      
      

Coller dans

La leçon de l'Académie sur la lecture d'un résultat de vérification aborde la vérification du justificatif de domicile à 7:20.[Justificatif de domicile : Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=440\&rel=0\&playsinline=1)## Comment cela fonctionneLa vérification du justificatif de domicile de Didit offre une solution robuste pour vérifier l'adresse de résidence d'un utilisateur au moyen de documents officiels. Notre solution combine une IA avancée, de la vision par ordinateur et des contrôles de sécurité complets pour fournir une vérification d'adresse rapide et fiable à grande échelle.**1. Capture intelligente de documents**Les utilisateurs peuvent vérifier leur adresse grâce à :| Méthode | Description |
| - | - |
| **Capture automatique** | Notre IA détecte automatiquement le positionnement optimal du document et le capture automatiquement au moment parfait |
| **Option de téléversement** | Les utilisateurs peuvent téléverser des documents existants sous différents formats (PDF, JPG, PNG) |
| **Prise en charge multi-pages** | Gestion fluide des documents de plusieurs pages tels que les relevés bancaires |**2. Extraction et vérification avancées des données**Des capacités de traitement puissantes :- OCR de haute précision pour extraire les informations d'adresse
- Classification intelligente des documents pour identifier les types de documents
- Correspondance du nom avec les pièces d'identité pour une vérification croisée
- Extraction de la date d'émission et validation par rapport aux critères configurés
- Correspondance des formats et des modèles pour tous les champs d'adresse**3. Validation complète**Notre système alimenté par l'IA effectue des contrôles approfondis :| Contrôle | Description |
| - | - |
| **Authenticité du document** | Vérification de la légitimité du document |
| **Détection de falsification** | Analyse de l'intégrité de l'image pour détecter les manipulations |
| **Normalisation de l'adresse** | Formatage et normalisation des champs d'adresse |
| **Géocodage** | Fourniture de coordonnées de localisation à partir de l'adresse extraite |
| **Détection de la langue** | Identification et validation de la langue du document |**4. Restitution fluide des résultats**Accédez aux résultats de vérification par le biais de plusieurs canaux :- Mises à jour du tableau de bord en temps réel
- Notifications webhook instantanées
- Intégration par API RESTful
- Rapports complets avec des informations détaillées sur la session de vérification## Exigences relatives aux documentsPour garantir une vérification d'adresse réussie, les documents doivent répondre aux critères suivants :#### Types de documents acceptésLe tableau suivant répertorie les types de documents acceptés et leurs sous-types respectifs. Tous les documents doivent avoir été émis au cours des 3 derniers mois, sauf indication contraire.| Type de document | Sous-types |
| - | - |
| **Facture de service public** | Facture d'électricité, facture d'eau, facture de gaz, facture Internet, facture de téléphone, facture de télévision par câble, facture de télévision par satellite, facture de collecte des ordures ménagères, facture d'assainissement, facture de chauffage, facture combinée de services publics, facture de services municipaux |
| **Relevé bancaire** | Relevé de compte, relevé de carte de crédit, attestation bancaire confirmant l'adresse, relevé de prêt hypothécaire, relevé de prêt, relevé de compte d'épargne, relevé de compte courant, relevé de compte d'investissement, relevé de compte professionnel, relevé d'une coopérative de crédit, relevé de carte de débit, relevé de ligne de crédit |
| **Document émis par le gouvernement** | Avis d'imposition, carte d'électeur, pièce d'identité, certificat de résidence, lettre/notification officielle du gouvernement, lettre de recensement, certificat d'enregistrement individuel, avis de taxe foncière, certificat d'immatriculation du véhicule, relevé de sécurité sociale, attestation de droits aux allocations chômage, attestation de prestations d'invalidité, relevé de pension, assignation en justice, avis de convocation de juré, permis municipal, document d'immigration |
| **Autre justificatif de domicile** | Contrat de bail, contrat de location, attestation de domicile de l'employeur, document de police d'assurance, certificat de scolarité, attestation de domicile notariée, lettre d'un avocat confirmant l'adresse, relevé de prêt étudiant, document judiciaire confirmant l'adresse, police d'assurance habitation du propriétaire, police d'assurance habitation du locataire, police d'assurance automobile, relevé d'assurance maladie, facture médicale, facture d'hôpital, facture de service d'abonnement, attestation d'abonnement à une salle de sport, courrier de la société de gestion immobilière, relevé d'association de copropriétaires, relevé de notes universitaire, attestation d'inscription universitaire, bulletin de paie, attestation d'emploi, relevé de compte de retraite, relevé de compte de courtage |#### Disponibilité par paysPar défaut, Justificatif de domicile prend en charge les mêmes pays et territoires que Vérification d'identité, y compris les îles Turques-et-Caïques (`TCA`) et Tuvalu (`TUV`). Chaque pays pris en charge propose les quatre catégories de documents répertoriées ci-dessus. Vous pouvez restreindre cette couverture par défaut dans les paramètres de Justificatif de domicile de votre workflow.> [!NOTE]
>
> Si un workflow existant n'affiche pas un pays nouvellement pris en charge, ouvrez ses paramètres de Justificatif de domicile et enregistrez-les à nouveau pour actualiser la configuration des pays autorisés de ce workflow.![Types de justificatifs de domicile acceptés par Didit — factures de services publics, relevés bancaires et documents officiels](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/proof-of-address-id-table.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=b065b2bb6f64408442b49d89ab16cb46)#### Exigences générales- Document valide émis il y a moins de 90 jours
- Physiquement intact (sans dommages, rayures ou taches)
- Informations complètes sur l'adresse clairement visibles
- Nom et logo de l'émetteur du document visibles
- Le nom figurant sur le document doit correspondre à l'identité vérifiée de l'utilisateur
- Différent de la pièce d'identité (il ne peut pas s'agir du même document que celui utilisé pour la vérification d'identité)#### Exigences relatives aux images- Document original capturé en temps réel ou numérisé en haute qualité
- Formats pris en charge : JPG, JPEG, PNG, TIFF, PDF
- Taille maximale du fichier : 15 Mo
- Image en couleur avec tous les coins visibles
- Aucune retouche ni manipulation numérique
- Toutes les pages incluses pour les documents comportant plusieurs pages


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