> ## 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：水电费账单验证

> Didit 地址证明功能利用 AI 从水电费账单、银行流水对账单和政府证件中提取并核验居住地址。按调用付费，每次 $0.20。

地址证明（PoA）验证允许您通过官方证件核实用户的居住地址。该功能简化了地址核验流程，使用户能够拍摄或上传可确认其地址的证件。

地址证明集成提示
        将提示词复制到剪贴板



      
      

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



      
      

粘贴到

Didit Academy 课程中关于如何解读验证结果的内容，在 7:20 处介绍了地址证明检查。[Didit Academy 中的地址证明](https://www.youtube.com/embed/7htTWCWsl60?start=440\&rel=0\&playsinline=1)## 工作原理Didit 的地址证明验证提供了一个强大的解决方案，通过官方证件核验用户的居住地址。我们的方案融合了先进的人工智能、计算机视觉和全面的安全检查，以实现大规模、快速且可靠的地址验证。**1. 智能证件采集**用户可以通过以下方式验证其地址：| 方式 | 描述 |
| - | - |
| **自动采集** | 我们的 AI 会自动检测最佳证件摆放位置，并在理想时刻自动完成拍摄 |
| **上传选项** | 用户可以上传各种格式（PDF、JPG、PNG）的现有证件 |
| **多页支持** | 无缝处理银行流水等多页证件 |**2. 高级数据提取与验证**强大的处理能力：- 用于提取地址信息的高精度 OCR
- 用于识别证件类型的智能证件分类
- 与身份证件进行姓名比对以实现交叉核验
- 签发日期提取并根据配置的要求进行验证
- 所有地址字段的格式与模式匹配**3. 全面核验**我们的 AI 驱动系统执行多项深入检查：| 检查项目 | 描述 |
| - | - |
| **证件真实性** | 验证证件的合法性 |
| **篡改检测** | 图像完整性分析以检测是否遭到篡改 |
| **地址标准化** | 格式化并规范化地址字段 |
| **地理编码** | 根据提取的地址提供位置坐标 |
| **语言检测** | 识别并验证证件语言 |**4. 无缝结果投递**通过多种渠道获取验证结果：- 仪表板实时更新
- 即时 Webhook 通知
- RESTful API 集成
- 包含详细验证会话信息的全面报告## 文件要求为确保地址验证成功，文件应符合以下标准：#### 支持的文件类型下表列出了支持的文件类型及其各自的子类型。除非另有说明，所有文件必须在过去 3 个月内签发。| 文件类型 | 子类型 |
| - | - |
| **公用事业账单** | 电费账单、水费账单、燃气费账单、网络费账单、电话费账单、有线电视账单、卫星电视账单、垃圾清运费账单、排污费账单、暖气费账单、综合公用事业账单、市政服务账单 |
| **银行对账单** | 账户对账单、信用卡对账单、确认地址的银行信函、抵押贷款对账单、贷款对账单、储蓄账户对账单、活期账户对账单、投资账户对账单、商业账户对账单、信用社对账单、借记卡对账单、信用额度对账单 |
| **政府签发文件** | 税务评估单、选民登记卡、身份证件、居住证明、政府信函/通知、人口普查信函、个人登记证明、房产税账单、车辆行驶证、社会保障对账单、失业救济金信函、残疾救济金信函、养老金对账单、法院传票、陪审员通知、市政许可证、移民文件 |
| **其他地址证明** | 租赁协议、租房合同、确认地址的雇主信函、保单文件、学校入学信、公证地址宣誓书、确认地址的律师信函、学生贷款对账单、确认地址的法院文件、房主保单、租客保单、汽车保单、健康保险对账单、医疗账单、医院账单、订阅服务账单、健身房会员对账单、物业管理信函、业主协会对账单、大学成绩单、大学在读证明、工资单、雇佣证明信、退休账户对账单、证券账户对账单 |#### 支持的国家/地区默认情况下，地址证明支持与身份证件验证相同的国家和地区，包括特克斯和凯科斯群岛（`TCA`）和图瓦卢（`TUV`）。每个受支持的国家/地区都提供上述四类文件。您可以在工作流的地址证明设置中限制此默认覆盖范围。> [!NOTE]
>
> 如果现有工作流未显示新支持的国家/地区，请打开其地址证明设置并重新保存，以刷新该工作流允许的国家/地区配置。![Didit 地址证明支持的文件类型：公用事业账单、银行和政府对账单](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)#### 通用要求- 签发日期起 90 天内的有效文件
- 实体完好无损（无破损、划痕或污渍）
- 完整的地址信息清晰可见
- 文件签发机构名称和徽标清晰可见
- 文件上的姓名应与用户已验证的身份信息一致
- 与身份证件不同（不能与用于身份证件验证的证件相同）#### 图像要求- 实时拍摄的原始文件或高质量扫描件
- 支持的格式：JPG、JPEG、PNG、TIFF、PDF
- 最大文件大小：15MB
- 四角完整的全彩图像
- 无数字化编辑或篡改
- 多页文件需包含所有页面


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