秘鲁税务登记验证API (SUNAT) 解析 (ZH)

在秘鲁为用户办理入职手续意味着需要确认他们是否如其所声称。此服务可根据SUNAT验证输入数据。文件或输入的信息仅能证明数据存在，而不能证明其真实性或属于面前的这个人。秘鲁税务登记验证 (SUNAT) 通过将数据与SUNAT进行核对来弥补这一空白。本指南将解释此检查的功能、具体技术细节以及如何在几分钟内完成集成。

主要收获：

• 检查内容 — 秘鲁税务登记验证 (SUNAT) 根据SUNAT验证税务识别信息。
• 返回结果 — 标准化的 match_type 以及字段级别的结果，您可以直接将其导入批准/审查/拒绝逻辑。
• 重要性 — 税务ID验证将申请人与可验证的财政身份关联起来，从而减少合成身份和第一方欺诈。
• 如何使用 — 向Didit的数据库验证端点发送一次 POST 请求，或使用无代码工作流模块。每次确认查询费用为1.79美元，几秒钟即可获得结果。

秘鲁税务登记验证 (SUNAT) 验证什么

验证输入数据是否与SUNAT匹配。Didit通过单个端点公开此服务，因此您可以根据国家税务机关验证提交的数据，并接收结构化、标准化的结果——而不是您必须自行解析的原始注册表转储。

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

为什么它很重要

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

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

技术细节

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

端点

POST /v3/database-validation/

请求参数

参数	类型	必需	描述
issuing_state	字符串	是	ISO 3166-1 alpha-3 国家代码。使用 PER。
services	字符串	是	服务标识符。使用 per_tax_registration。
first_name	字符串	是	名字。
last_name	字符串	是	姓氏。
date_of_birth	字符串	是	出生日期。
personal_number	字符串	是	个人号码。

示例请求

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=PER" \
  -F "services=per_tax_registration" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "date_of_birth=1990-01-01" \
  -F "personal_number=1111111"

示例响应（确认匹配）

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "PER",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "per_tax_registration",
      "service_name": "Peru Tax Registration (SUNAT)",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "full_name": "John Doe",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe",
        "name_match_score": "1.000",
        "verifications": {
          "date_of_birth": true,
          "full_name": true,
          "identification_number": true
        }
      },
      "validation": {
        "date_of_birth": "full_match",
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

性能与计费

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

使用案例

• 金融科技与新兴银行 — 在秘鲁开设钱包或提供信贷之前，确认真实可验证的账户持有人。
• 加密与Web3 — 通过权威来源的身份证明满足VASP入职要求。
• 贷款 — 通过源验证数据减少合成身份和第一方欺诈。
• 市场与零工平台 — 根据权威数据（而非自报表格）验证用户。
• iGaming — 通过可审计的审计路径满足秘鲁玩家的身份和资格检查。

如何与Didit集成

您可以以两种方式运行秘鲁税务登记验证 (SUNAT)：

1. 无代码工作流。 在Didit业务控制台中，打开工作流构建器，添加数据库验证模块，选择秘鲁 → 秘鲁税务登记验证 (SUNAT)，然后激活它。匹配的用户将自动路由——无需工程开发。
2. 直接API。 使用 services=per_tax_registration 调用上面显示的 /v3/database-validation/ 端点。读取 match_type 和每个字段的 validation 块以驱动您的批准/审查/拒绝逻辑。

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

常见问题

秘鲁税务登记验证 (SUNAT) 检查确认什么？

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

如果源系统暂时不可用会发生什么？

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

检查速度有多快？

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

我需要SDK吗？

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

准备好开始了吗？

立即验证您的第一个秘鲁税务识别信息。

• 阅读API参考： 秘鲁税务登记验证 (SUNAT)
• 查看所有数据库验证： 数据库验证定价与覆盖范围
• 开始构建： 创建免费的Didit账户——每月500次免费验证。