巴西CPF身份验证API (ZH)

在巴西，用户入驻意味着要确认他们的身份。Didit通过SERPRO从巴西联邦税务局（Receita Federal）获取CPF状态（正常、暂停、已注销）、姓名和出生日期。证件或手动输入的信息只能证明数据存在，而不能证明其真实性或属于面前的人。巴西CPF状态验证通过与国家税务机关核对数据来弥补这一差距。本指南将解释该验证的功能、确切的技术细节以及如何在几分钟内完成集成。

主要内容：

• 检查内容 — 巴西CPF状态验证对照国家税务机关验证税务识别号。
• 返回内容 — 标准化的match_type以及字段级别的结果，您可以直接将其路由到批准/审查/拒绝逻辑中。
• 重要性 — 税号验证将申请人与可验证的财政身份关联起来，减少合成身份欺诈和第一方欺诈。
• 使用方法 — 向Didit的数据库验证端点发送一个POST请求，或使用无代码工作流模块。每次确凿查询0.20美元，几秒钟内出结果。

巴西CPF状态验证的功能

通过SERPRO从巴西联邦税务局（Receita Federal）返回CPF状态（正常、暂停、已注销）、姓名和出生日期。Didit通过单一端点提供此服务，以便您可以对照国家税务机关验证提交的数据，并接收结构化、标准化的结果——而不是您需要自行解析的原始注册表转储。

确凿的响应会返回匹配的source_data和一个按字段划分的validation块，因此您的风险引擎可以获得清晰、机器可读的判断。

重要性

税号验证将申请人与可验证的财政身份关联起来，减少合成身份欺诈和第一方欺诈。

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

技术细节

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

端点

POST /v3/database-validation/

请求参数

参数	类型	必填	描述
issuing_state	string	是	ISO 3166-1 alpha-3 国家代码。使用BRA。
services	string	是	服务标识符。使用bra_cpf。
tax_number	string	是	税号。
first_name	string	否	名（可选交叉检查）。
last_name	string	否	姓（可选交叉检查）。
date_of_birth	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_cpf" \
  -F "tax_number=1111111"

响应示例（确凿匹配）

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "BRA",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "bra_cpf",
      "service_name": "Brazil - CPF status check",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe",
        "lgpd_minor": "sample_value",
        "minor_under_16": "sample_value",
        "minor_under_18": "sample_value"
      },
      "validation": {
        "date_of_birth": "full_match",
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

性能与计费

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

使用场景

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

如何与Didit集成

您可以通过两种方式运行巴西CPF状态验证：

1. 无代码工作流。在Didit商务控制台，打开工作流构建器，添加数据库验证模块，选择巴西 → 巴西CPF状态验证，并激活。匹配的用户将自动路由——无需工程开发。
2. 直接API。调用上面所示的/v3/database-validation/端点，并将services=bra_cpf。读取match_type和按字段划分的validation块，以驱动您的批准/审查/拒绝逻辑。

每个Didit账户都包含每月500次免费验证，因此您可以在支付任何查询费用之前测试完整的流程。

常见问题

巴西CPF状态验证确认哪些内容？

它对照国家税务机关验证提交的数据，并返回标准化的匹配结果，因此您可以了解税务识别号是否存在于权威来源以及哪些字段匹配。

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

您无需付费。计费仅适用于确凿结果——源系统停机、字段缺失和预源拒绝是免费的。

检查速度如何？

数据库验证通常在几秒钟内返回，因此它适用于实时入驻流程。

我需要SDK吗？

不需要。该检查是一个单一的HTTPS POST请求到一个端点。您也可以将其连接到商务控制台中的无代码工作流。

准备好开始了吗？

立即验证您的第一个巴西税务识别号。

• 阅读API参考： 巴西CPF状态验证
• 查看所有数据库验证： 数据库验证定价与覆盖范围
• 开始构建： 创建免费Didit账户 — 每月500次免费验证。