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

# Comprovant de domicili amb API: verificació de factures

> Didit verifica adreces residencials amb IA en factures de serveis, extractes bancaris i documents oficials. Pagament per crida $0.20.

La verificació del comprovant de domicili (PoA) et permet verificar l'adreça de residència d'un usuari a partir de documents oficials. Aquesta funcionalitat simplifica el procés de verificació d'adreces, perquè els usuaris puguin capturar o pujar documents que confirmin la seva adreça.

Prompt d'integració del comprovant de domicili
        Copia el prompt al porta-retalls



      
      

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



      
      

Enganxa a

La lliçó de l'Acadèmia sobre com llegir el resultat d'una verificació arriba a la verificació del comprovant de domicili a les 7:20.[Comprovant de domicili — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=440\&rel=0\&playsinline=1)## Com funcionaLa verificació de Comprovant de domicili de Didit ofereix una solució robusta per verificar l'adreça de residència d'un usuari mitjançant documentació oficial. La nostra solució combina IA avançada, visió per computador i controls de seguretat exhaustius per proporcionar una verificació d'adreça ràpida i fiable a escala.**1. Captura intel·ligent de documents**Els usuaris poden verificar la seva adreça mitjançant:| Mètode | Descripció |
| - | - |
| **Captura automàtica** | La nostra IA detecta automàticament la posició òptima del document i el captura de manera automàtica en el moment perfecte |
| **Opció de càrrega** | Els usuaris poden carregar documents existents en diversos formats (PDF, JPG, PNG) |
| **Compatibilitat amb múltiples pàgines** | Gestiona sense problemes documents de diverses pàgines, com ara extractes bancaris |**2. Extracció i verificació avançada de dades**Potents capacitats de processament:- OCR d'alta precisió per extreure la informació de l'adreça
- Classificació intel·ligent de documents per identificar els tipus de document
- Coincidència de noms amb documents d'identitat per a una verificació creuada
- Extracció de la data d'emissió i validació en funció dels requisits configurats
- Concordança de formats i patrons per a tots els camps de l'adreça**3. Validació exhaustiva**El nostre sistema basat en IA realitza comprovacions exhaustives:| Comprovació | Descripció |
| - | - |
| **Autenticitat del document** | Verificació de la legitimitat del document |
| **Detecció de manipulacions** | Anàlisi de la integritat de la imatge per detectar alteracions |
| **Estandardització de l'adreça** | Formatació i normalització dels camps de l'adreça |
| **Geocodificació** | Obtenció de coordenades d'ubicació a partir de l'adreça extreta |
| **Detecció d'idioma** | Identificació i validació de l'idioma del document |**4. Lliurament fluid de resultats**Accedeix als resultats de la verificació a través de diversos canals:- Actualitzacions en temps real al tauler
- Notificacions instantànies per webhook
- Integració amb API RESTful
- Informes complets amb informació detallada sobre la sessió de verificació## Requisits dels documentsPer garantir una verificació de domicili satisfactòria, els documents han de complir aquests criteris:#### Tipus de documents acceptatsLa taula següent llista els tipus de documents acceptats i els seus respectius subtipus. Tots els documents s'han d'haver emès durant els darrers 3 mesos, tret que s'especifiqui el contrari.| Tipus de document | Subtipus |
| - | - |
| **Factura de serveis** | Factura de la llum, Factura de l'aigua, Factura del gas, Factura d'internet, Factura de telèfon, Factura de televisió per cable, Factura de televisió per satèl·lit, Factura de recollida d'escombraries, Factura de clavegueram, Factura de calefacció, Factura combinada de serveis, Factura de serveis municipals |
| **Extracte bancari** | Extracte de compte, Extracte de targeta de crèdit, Carta bancària de confirmació de domicili, Extracte d'hipoteca, Extracte de préstec, Extracte de compte d'estalvi, Extracte de compte corrent, Extracte de compte d'inversió, Extracte de compte d'empresa, Extracte de cooperativa de crèdit, Extracte de targeta de dèbit, Extracte de línia de crèdit |
| **Document emès pel govern** | Liquidació tributària, Targeta de registre de votant, Document d'identitat, Certificat de residència, Carta o notificació governamental, Carta del cens, Certificat de registre individual, Rebut de l'impost sobre béns immobles, Registre del vehicle, Extracte de la Seguretat Social, Carta de prestacions per desocupació, Carta de prestacions per discapacitat, Extracte de pensions, Citació judicial, Notificació per a jurat popular, Permís municipal, Document d'immigració |
| **Altres comprovants de domicili** | Contracte d'arrendament, Contracte de lloguer, Carta de l'ocupador que confirma el domicili, Pòlissa d'assegurança, Carta de matrícula escolar, Declaració jurada notarial de domicili, Carta d'un advocat de confirmació de domicili, Extracte de préstec estudiantil, Document judicial de confirmació de domicili, Pòlissa d'assegurança de la llar (propietaris), Pòlissa d'assegurança de la llar (llogaters), Pòlissa d'assegurança de vehicles, Extracte de l'assegurança mèdica, Factura mèdica, Factura hospitalària, Factura de servei de subscripció, Extracte de la subscripció al gimnàs, Carta d'administració de finques, Extracte de la comunitat de propietaris, Expedient acadèmic universitari, Verificació de matrícula universitària, Nòmina, Carta de verificació laboral, Extracte de compte de jubilació, Extracte de compte de valors |#### Disponibilitat per païsosPer defecte, el Comprovant de domicili admet els mateixos països i territoris que la Verificació d'identitat, incloent-hi les Illes Turks i Caicos (`TCA`) i Tuvalu (`TUV`). Tots els països admesos ofereixen les quatre categories de documents llistades anteriorment. Pots restringir aquesta cobertura predeterminada a la configuració del Comprovant de domicili del teu flux de treball.> [!NOTE]
>
> Si un flux de treball existent no mostra un país admès recentment, obre la seva configuració de Comprovant de domicili i desa-la de nou per actualitzar la configuració de països permesos del flux de treball.![Tipus de documents acceptats per al comprovant de domicili de Didit: factures de serveis, extractes bancaris i documents governamentals](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)#### Requisits generals- Document vàlid emès en els darrers 90 dies
- Físicament intacte (sense danys, ratllades ni taques)
- Informació completa de l'adreça clarament visible
- Nom i logotip de l'emissor del document visibles
- El nom que figura al document ha de coincidir amb la identitat verificada de l'usuari
- Diferent del document d'identitat (no pot ser el mateix document utilitzat per a la verificació d'identitat)#### Requisits de la imatge- Document original capturat en temps real o escaneig d'alta qualitat
- Formats admesos: JPG, JPEG, PNG, TIFF, PDF
- Mida màxima de fitxer: 15MB
- Imatge a tot color amb totes les cantonades visibles
- Sense edició digital ni manipulació
- Totes les pàgines incloses en el cas de documents de diverses pàgines


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