南非国民身份证验证API（DHA） (ZH)
实时验证南非国民身份证信息与DHA数据，仅对确凿结果收费。了解其端点、参数、响应模式、定价及集成方法。.
在南非进行用户入职意味着要确认他们是否如其所声称的身份。它根据南非内政部（DHA）注册信息验证输入数据。一份文件或一个输入的详细信息仅证明数据存在 — 而不能证明它是真实的或属于您面前的人。南非国民身份证验证（DHA）通过与DHA核对数据来弥补这一差距。本指南解释了该检查的功能、确切的技术细节以及如何在几分钟内集成它。
主要收获：
- 检查内容 — 南非国民身份证验证（DHA）根据DHA验证国民身份证。
- 返回内容 — 标准化的
match_type以及字段级别的结果，您可以直接将其路由到批准/审查/拒绝逻辑。 - 重要性 — 文件可能被伪造；注册记录则不能。根据权威政府来源验证身份证件确认持有人真实且身份正确。
- 如何使用 — 向Didit的数据库验证端点发送一个
POST请求，或使用无代码工作流模块。每项确凿查询收费1.10美元，数秒内即可获得结果。
南非国民身份证验证（DHA）验证的内容
根据南非内政部（DHA）注册信息验证输入数据。Didit通过一个单一端点公开此服务，因此您可以根据该国的官方政府身份注册信息验证提交的数据，并收到结构化、标准化的结果 — 而不是需要您自行解析的原始注册信息。
确凿的响应会返回匹配的source_data和一个字段级别的validation块，因此您的风险引擎可以获得清晰、机器可读的判断。
为什么它很重要
文件可能被伪造；注册记录则不能。根据权威政府来源验证身份证件确认持有人真实且身份正确。
对于南非受监管的企业 — 金融科技公司、加密平台、贷款机构、市场和游戏运营商 — 对权威来源进行检查可生成可辩护、可审计的记录，证明身份已在源头确认，而不仅仅是从表格或照片中获取。
技术细节
Didit通过统一的数据库验证端点提供此服务。它是一个单一的POST请求 — 无需SDK。
端点
POST /v3/database-validation/请求参数
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
issuing_state | string | 是 | ISO 3166-1 alpha-3 国家代码。使用 ZAF。 |
services | string | 是 | 服务标识符。使用 zaf_africa_national_id。 |
first_name | string | 是 | 名字。 |
last_name | string | 是 | 姓氏。 |
date_of_birth | string | 是 | 出生日期。 |
national_id | 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_africa_national_id" \
-F "first_name=John" \
-F "last_name=Doe" \
-F "date_of_birth=1990-01-01" \
-F "national_id=1111111"示例响应（确凿匹配）
{
"request_id": "req_01H...",
"status": "Approved",
"issuing_state": "ZAF",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zaf_africa_national_id",
"service_name": "South Africa National ID (DHA)",
"source_data": {
"first_name": "John",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"marital_status": "sample_value"
},
"validation": {
"full_name": "full_match",
"identification_number": "full_match"
}
}
]
}性能和计费
- 延迟：通常只需几秒钟。
- 成本：每项确凿查询1.10美元。仅对确凿结果收费 — 源头停机、字段缺失或源头前拒绝不收取费用。
- 可靠性：在Didit的基础设施上运行，季度正常运行时间目标为99.9%。
使用案例
- 金融科技和数字银行 — 在南非开立钱包或提供信用之前，确认真实的、可验证的账户持有人。
- 加密和Web3 — 通过权威来源的身份证明满足VASP入职要求。
- 借贷 — 通过源头验证的数据减少合成身份和第一方欺诈。
- 市场和零工平台 — 根据权威数据（而不仅仅是自报表格）验证用户。
- iGaming — 为南非玩家满足身份和资格检查，并提供可审计的记录。
如何与Didit集成
您可以通过两种方式运行南非国民身份证验证（DHA）：
- 无代码工作流。在Didit商务控制台中，打开工作流构建器，添加数据库验证模块，选择南非 → 南非国民身份证验证（DHA），并激活它。匹配的用户将自动路由 — 无需工程开发。
- 直接API。使用
services=zaf_africa_national_id调用上面所示的/v3/database-validation/端点。读取match_type和字段级别的validation块，以驱动您的批准/审查/拒绝逻辑。
每个Didit账户每月包含500次免费验证，因此您可以在支付任何查询费用之前测试完整的端到端流程。
常见问题
南非国民身份证验证（DHA）检查确认了什么？
它根据DHA验证提交的数据并返回标准化的匹配结果，因此您可以了解国民身份证是否存在于权威来源以及哪些字段匹配。
如果源头暂时不可用怎么办？
您不收费。仅对确凿结果计费 — 源头停机、字段缺失和源头前拒绝是免费的。
检查速度有多快？
数据库验证通常在几秒钟内返回，因此它适用于实时入职流程。
我需要SDK吗？
不需要。检查是对一个端点进行的单个HTTPS POST请求。您也可以将其连接到商务控制台中的无代码工作流。
准备好开始了吗？
立即验证您的第一个南非国民身份证。
- 阅读API参考： 南非国民身份证验证（DHA）
- 查看所有数据库验证： 数据库验证定价和覆盖范围
- 开始构建： 创建一个免费的Didit账户 — 每月500次免费验证。