巴西住址信息验证 API (ZH)

在巴西开展业务意味着确认用户身份。验证数据与选民登记数据库相结合。提交的文档或手动输入的信息只能证明数据的存在，而不能证明其真实性或是否属于您面前的人。巴西住址信息验证通过将数据与权威的居住和消费者数据源进行核对，弥补了这一差距。本指南将介绍该验证的功能、详细的技术信息以及如何在几分钟内完成集成。

关键要点：

• 验证内容 — 巴西住址信息验证会对照权威的居住和消费者数据源验证地址和居住数据。
• 返回结果 — 规范化的 match_type 以及您可以直接导入审批/审核/拒绝逻辑的字段级结果。
• 重要意义 — 对权威数据的地址验证确认申请人确实居住在他们声称的地址，这是反欺诈和合规性的核心信号。
• 使用方法 — 向 Didit 的数据库验证端点发送一个 POST 请求，或使用无代码工作流模块。每次明确查询 0.14 美元，结果将在几秒钟内返回。

巴西住址信息验证验证内容

验证数据与选民登记数据库相结合。Didit 通过一个端点暴露该功能，您可以验证提交的数据，并对照权威的居住和消费者数据源获得结构化、规范化的结果，而无需自行解析原始注册信息。

明确的响应会返回匹配的 source_data 和每个字段的 validation 块，以便您的风险引擎获得清晰、机器可读的结论。

重要意义

对权威数据的地址验证确认申请人确实居住在他们声称的地址，这是反欺诈和合规性的核心信号。

对于巴西的受监管企业（例如金融科技公司、加密平台、贷款机构、市场平台和游戏运营商），对照权威来源进行验证可以生成可防御、可审计的记录，证明身份已在源头确认，而不仅仅是从表格或照片中获取。

技术细节

Didit 通过统一的数据库验证端点提供此服务。它是一个 POST 请求，无需 SDK。

端点

POST /v3/database-validation/

请求参数

参数	类型	必需	描述
issuing_state	string	是	ISO 3166-1 alpha-3 国家/地区代码。使用 BRA。
services	string	是	服务标识符。使用 bra_residential。
first_name	string	是	名字。
last_name	string	是	姓氏。
date_of_birth	string	是	出生日期。
address	string	是	地址。
tax_number	string	是	税号。

示例请求

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=BRA" \
  -F "services=bra_residential" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "date_of_birth=1990-01-01" \
  -F "address=123 Sample Street, Sample City, 10001" \
  -F "tax_number=1111111"

示例响应（明确匹配）

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "BRA",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "bra_residential",
      "service_name": "Brazil Residential",
      "source_data": {
        "address": "123 Sample Street",
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe"
      },
      "validation": {
        "address": "full_match",
        "date_of_birth": "full_match",
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

性能和计费

• 延迟：通常为几秒钟。
• 费用：每次明确查询 0.14 美元。仅对明确结果计费，源端停机、缺少字段或源前拒绝不收费。
• 可靠性：在 Didit 的基础设施上运行，季度正常运行时间目标为 99.9%。

用例

• 金融科技和新银行 — 在巴西开设钱包或提供信贷之前，确认真实的、可验证的账户持有人身份。
• 加密货币和 Web3 — 满足 VASP 入职要求，并提供权威来源的身份证明。
• 贷款 — 通过验证来源的数据，减少合成身份和第一方欺诈。
• 市场和零工平台 — 验证用户身份，而不仅仅是自我报告的表格。
• iGaming — 满足巴西玩家的身份和资格检查，并提供可审计的记录。

如何与 Didit 集成

您可以通过以下两种方式运行巴西住址信息验证：

1. 无代码工作流。 在 Didit Business Console 中，打开 Workflow Builder，添加 Database Validation 模块，选择 Brazil → Brazil Residential Verification，然后激活它。匹配的用户将自动路由 — 无需工程。
2. 直接 API。 使用 services=bra_residential 调用上述 /v3/database-validation/ 端点。读取 match_type 和每个字段的 validation 块，以驱动您的审批/审核/拒绝逻辑。

每个 Didit 帐户均包含 每月 500 次免费验证，因此您可以在付费进行单个查询之前测试完整的端到端流程。

常见问题解答

巴西住址信息验证检查确认什么？

它将提交的数据与权威的居住和消费者数据源进行验证，并返回规范化的匹配结果，因此您可以了解地址和居住数据是否存在于权威来源，以及哪些字段匹配。

如果来源暂时不可用怎么办？

您不会被收费。计费仅适用于明确的结果 — 来源停机、缺少字段和源前拒绝都是免费的。

检查速度有多快？

数据库验证通常在几秒钟内返回结果，因此适合实时入职流程。

我需要 SDK 吗？

不需要。该检查是对一个 HTTPS POST 到一个端点的操作。您也可以将其连接到 Business Console 中的无代码工作流。

准备好开始了吗？

立即验证您的第一个巴西地址和居住数据。

• 阅读 API 参考： 巴西住址信息验证
• 查看所有数据库验证： 数据库验证定价和覆盖范围
• 开始构建： 创建免费的 Didit 帐户 — 免费每月 500 次验证。