> ## 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 de prueba de domicilio con facturas de servicios

> Didit verifica domicilios con extracción por IA de facturas de servicios, extractos bancarios y documentos oficiales. $0.20 por llamada, sin mínimos.

La verificación de prueba de domicilio (PoA) de Didit permite comprobar el domicilio residencial de un usuario mediante documentos oficiales. Esta función simplifica el proceso de verificación de dirección, ya que los usuarios pueden capturar o subir documentos que confirman su domicilio.

Prompt de integración de la prueba de domicilio
        Copy prompt to clipboard



      
      

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



      
      

Paste into

La lección de Academy sobre cómo leer el resultado de una verificación llega a la comprobación de prueba de domicilio en el minuto 7:20.[Prueba de domicilio — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=440\&rel=0\&playsinline=1)## Cómo funcionaLa verificación de prueba de domicilio de Didit ofrece una solución sólida para verificar el domicilio residencial de un usuario mediante documentación oficial. Nuestra solución combina IA avanzada, visión por computadora y comprobaciones de seguridad exhaustivas para ofrecer una verificación de dirección rápida y fiable a escala.**1. Captura inteligente del documento**Los usuarios pueden verificar su domicilio mediante:| Método | Descripción |
| - | - |
| **Captura automática** | Nuestra IA detecta la posición óptima del documento y lo captura automáticamente en el momento perfecto |
| **Opción de subida** | Los usuarios pueden subir documentos existentes en varios formatos (PDF, JPG, PNG) |
| **Compatibilidad con varias páginas** | Gestiona sin problemas documentos de varias páginas, como los extractos bancarios |**2. Extracción y verificación avanzadas de datos**Capacidades de procesamiento potentes:- OCR de alta precisión para extraer la información de la dirección
- Clasificación inteligente de documentos para identificar su tipo
- Comparación del nombre con los documentos de identidad para una verificación cruzada
- Extracción de la fecha de emisión y validación frente a los requisitos configurados
- Coincidencia de formato y patrones en todos los campos de la dirección**3. Validación completa**Nuestro sistema basado en IA realiza comprobaciones exhaustivas:| Comprobación | Descripción |
| - | - |
| **Autenticidad del documento** | Verificación de la legitimidad del documento |
| **Detección de manipulación** | Análisis de la integridad de la imagen para detectar alteraciones |
| **Normalización de direcciones** | Formateo y normalización de los campos de la dirección |
| **Geocodificación** | Obtención de las coordenadas de ubicación a partir de la dirección extraída |
| **Detección de idioma** | Identificación y validación del idioma del documento |**4. Entrega fluida de resultados**Accede a los resultados de la verificación por varios canales:- Actualizaciones del panel en tiempo real
- Notificaciones instantáneas por webhook
- Integración con una API RESTful
- Informes completos con información detallada de la sesión de verificación## Requisitos del documentoPara asegurar una verificación de dirección correcta, los documentos deben cumplir estos criterios:#### Tipos de documento aceptadosLa siguiente tabla enumera los tipos de documento aceptados y sus subtipos. Todos los documentos deben haberse emitido en los últimos 3 meses, salvo que se indique lo contrario.| Tipo de documento | Subtipos |
| - | - |
| **Factura de servicios** | Factura de electricidad, factura de agua, factura de gas, factura de internet, factura de teléfono, factura de televisión por cable, factura de televisión por satélite, factura de recogida de residuos, factura de alcantarillado, factura de calefacción, factura combinada de servicios, factura de servicios municipales |
| **Extracto bancario** | Extracto de cuenta, extracto de tarjeta de crédito, carta del banco que confirma la dirección, extracto de hipoteca, extracto de préstamo, extracto de cuenta de ahorros, extracto de cuenta corriente, extracto de cuenta de inversión, extracto de cuenta empresarial, extracto de cooperativa de crédito, extracto de tarjeta de débito, extracto de línea de crédito |
| **Documento emitido por el gobierno** | Liquidación de impuestos, tarjeta de registro electoral, documento de identidad, certificado de residencia, carta o notificación del gobierno, carta del censo, certificado de inscripción individual, factura del impuesto sobre bienes inmuebles, permiso de circulación del vehículo, extracto de la seguridad social, carta de prestaciones por desempleo, carta de prestaciones por discapacidad, extracto de pensión, citación judicial, notificación de jurado, permiso municipal, documento de inmigración |
| **Otra prueba de domicilio** | Contrato de arrendamiento, contrato de alquiler, carta del empleador que confirma la dirección, documento de póliza de seguro, carta de matriculación escolar, declaración notarial de domicilio, carta de un abogado que confirma la dirección, extracto de préstamo estudiantil, documento judicial que confirma la dirección, póliza de seguro del hogar para propietarios, póliza de seguro del hogar para inquilinos, póliza de seguro de automóvil, extracto del seguro de salud, factura médica, factura hospitalaria, factura de servicio de suscripción, extracto de membresía de gimnasio, carta de la administración de la propiedad, extracto de la comunidad de propietarios, expediente académico universitario, verificación de matrícula universitaria, nómina, carta de verificación de empleo, extracto de cuenta de jubilación, extracto de cuenta de corretaje |#### Disponibilidad por paísDe forma predeterminada, la prueba de domicilio admite los mismos países y territorios que la verificación de identidad, incluidas las Islas Turcas y Caicos (`TCA`) y Tuvalu (`TUV`). Todos los países admitidos ofrecen las cuatro categorías de documento indicadas arriba. Puedes restringir esta cobertura predeterminada en los ajustes de prueba de domicilio de tu flujo.> [!NOTE]
>
> Si un flujo existente no muestra un país recién admitido, abre sus ajustes de prueba de domicilio y guárdalos de nuevo para actualizar la configuración de países permitidos del flujo.![Tipos de documento aceptados por la prueba de domicilio de Didit: facturas de servicios, extractos bancarios y documentos del gobierno](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)#### Requisitos generales- Documento válido, con una fecha de emisión de menos de 90 días
- Físicamente intacto (sin daños, arañazos ni manchas)
- Información completa de la dirección claramente visible
- Nombre y logotipo del emisor del documento visibles
- El nombre del documento debe coincidir con la identidad verificada del usuario
- Distinto del documento de identidad (no puede ser el mismo documento usado para la verificación de identidad)#### Requisitos de la imagen- Documento original capturado en tiempo real o escaneado en alta calidad
- Formatos admitidos: JPG, JPEG, PNG, TIFF, PDF
- Tamaño máximo de archivo: 15MB
- Imagen a todo color con todas las esquinas visibles
- Sin edición ni manipulación digital
- Todas las páginas incluidas en los documentos de varias páginas


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