南非内政部指纹匹配验证API (ZH)

在南非进行用户入驻意味着确认他们是其声称的身份。本服务将所提供的指纹图像与内政部指纹登记册进行核对。文档或输入的详细信息仅能证明数据存在 — 而不能证明其真实性或属于面前之人。南非内政部指纹匹配验证通过对照权威政府数据源检查数据，弥补了这一空白。本指南解释了该检查的功能、确切的技术细节以及如何在几分钟内完成集成。

主要收获：

• 检查内容 — 南非内政部指纹匹配验证对照权威政府数据源验证政府记录。
• 返回内容 — 规范化的match_type以及字段级结果，您可以直接将其路由到批准/审查/拒绝逻辑中。
• 重要意义 — 政府持有的记录是确认个人身份最强的权威来源。
• 使用方法 — 向Didit的数据库验证端点发送一个POST请求。每次确凿查询费用为1.10美元，几秒内即可获得结果。

南非内政部指纹匹配验证的内容

验证所提供的指纹图像与内政部指纹登记册。Didit通过单一端点暴露此服务，因此您可以对照权威政府数据源验证提交的数据，并接收结构化、规范化的结果 — 而不是您必须自行解析的原始注册表转储。

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

重要意义

政府持有的记录是确认个人身份最强的权威来源。

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

技术细节

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

端点

POST /v3/database-validation/

请求参数

参数	类型	必需	描述
issuing_state	string	是	ISO 3166-1 alpha-3 国家代码。使用 ZAF。
services	string	是	服务标识符。使用 zaf_dha_fingerprint_match。
national_id	string	是	国民身份证号。
right_thumb	string	是	右拇指。
left_thumb	string	是	左拇指。

示例请求

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_dha_fingerprint_match" \
  -F "national_id=1111111" \
  -F "right_thumb=sample_value" \
  -F "left_thumb=sample_value"

示例响应（确凿匹配）

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_dha_fingerprint_match",
      "service_name": "South Africa - DHA Fingerprint Match",
      "source_data": {
        "identification_number": "SAMPLE-ID-12345"
      },
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}

性能与计费

• 延迟： 通常几秒钟。
• 费用： 每次确凿查询1.10美元。您仅对确凿结果付费 — 源系统停机、缺少字段或源系统前拒绝不收费。
• 可靠性： 运行在Didit的基础设施上，季度正常运行时间目标为99.9%。
• 同意： 此服务需要记录最终用户同意。在调用端点之前捕获并存储它。

使用场景

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

如何与Didit集成

您可以通过两种方式运行南非内政部指纹匹配验证：

1. 仅限直接API。 此服务通过API运行，而不是无代码工作流构建器。
2. 直接API。 使用services=zaf_dha_fingerprint_match调用上面显示的/v3/database-validation/端点。读取match_type和字段级validation块以驱动您的批准/审查/拒绝逻辑。

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

常见问题

南非内政部指纹匹配验证检查确认什么？

它对照权威政府数据源验证提交的数据，并返回规范化的匹配结果，因此您可以了解政府记录是否存在于权威来源以及哪些字段匹配。

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

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

检查速度有多快？

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

我需要SDK吗？

不需要。检查是对一个端点的单一HTTPS POST请求。

准备好开始了吗？

立即验证您的第一个南非政府记录。

• 阅读API参考： 南非内政部指纹匹配验证
• 查看所有数据库验证： 数据库验证定价与覆盖范围
• 开始构建： 创建一个免费的Didit账户 — 每月500次免费验证。