巴西税务登记信息验证 API (CPF/CNPJ) (ZH)

在巴西开展业务意味着确认用户身份。通过与 CPF/CNPJ 数据库进行验证。一份文件或手动输入的详细信息只能证明数据的存在，而不能证明其真实性或归属。巴西税务登记信息验证 (CPF/CNPJ) 通过对照 CPF/CNPJ 检查数据，弥合了这一差距。本指南将介绍检查内容、确切的技术细节以及如何在几分钟内完成集成。

主要内容：

• 检查内容 — 巴西税务登记信息验证 (CPF/CNPJ) 验证税务身份信息与 CPF/CNPJ 的一致性。
• 返回结果 — 规范化的 match_type 以及您可以直接路由到审批/审核/拒绝逻辑的字段级结果。
• 重要性 — 税务身份验证将申请人与可验证的财政身份联系起来，从而降低合成身份和第一方欺诈风险。
• 使用方法 — 向 Didit 的数据库验证端点发送一个 POST 请求，或使用无代码工作流模块。每次确定性查询收费 $0.08，结果在几秒钟内返回。

巴西税务登记信息验证 (CPF/CNPJ) 验证内容

验证与 CPF/CNPJ 数据库的一致性。Didit 通过单个端点公开此功能，以便您可以验证提交的数据与国家税务机关的一致性，并接收结构化、规范化的结果，而无需自行解析原始注册信息。

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

重要性

税务身份验证将申请人与可验证的财政身份联系起来，从而降低合成身份和第一方欺诈风险。

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

技术细节

Didit 通过统一的数据库验证端点公开此服务。只需一个 POST 请求，无需 SDK。

端点

POST /v3/database-validation/

请求参数

参数	类型	必需	说明
issuing_state	string	是	ISO 3166-1 alpha-3 国家代码。使用 BRA。
services	string	是	服务标识符。使用 bra_tax_registration。
first_name	string	是	名字。
last_name	string	是	姓氏。
date_of_birth	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_tax_registration" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "date_of_birth=1990-01-01" \
  -F "tax_number=1111111"

示例响应 (确定性匹配)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "BRA",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "bra_tax_registration",
      "service_name": "Brazil Tax Registration (CPF/CNPJ)",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "identification_number": "SAMPLE-ID-12345",
        "name_match_score": "1.000",
        "verifications": {
          "date_of_birth": true,
          "identification_number": true
        }
      },
      "validation": {
        "date_of_birth": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

性能和计费

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

用例

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

如何与 Didit 集成

您可以通过两种方式运行巴西税务登记信息验证 (CPF/CNPJ)：

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

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

常见问题解答

巴西税务登记信息验证 (CPF/CNPJ) 检查确认什么？

它验证提交的数据与 CPF/CNPJ 的一致性，并返回规范化的匹配结果，以便您可以了解税务身份是否在权威来源处存在以及哪些字段匹配。

如果源头暂时不可用会怎样？

您不会被收费。仅对确定性结果收费 — 源头停机、缺少字段和预源拒绝都是免费的。

检查速度有多快？

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

我需要 SDK 吗？

不需要。该检查是一个简单的 HTTPS POST 请求，发送到一个端点。您还可以将其连接到 Business Console 中的无代码工作流。

准备好开始？

立即验证您的第一个巴西税务身份信息。

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