博客 · 2026年5月20日

南非欺诈预防筛选验证API (ZH)

通过实时验证南非背景数据与权威背景数据来源，仅对确定性结果收费。此API提供端点、参数、响应模式、定价和集成指南。.

作者：Didit2026年5月20日更新于 2026年5月20日

在南非入职用户意味着要确认他们就是他们所声称的身份。这需要针对南非欺诈预防服务（SAFPS）观察名单对个人进行筛选。文档或输入的详细信息仅能证明数据存在，但无法证明其真实性或是否属于面前的人。南非欺诈预防筛选验证通过对照权威背景数据来源检查数据来弥补这一空白。本指南解释了此检查的功能、具体技术细节以及如何在几分钟内完成集成。

主要收获：

检查内容 — 南非欺诈预防筛选验证对照权威背景数据来源验证背景数据。
获取结果 — 标准化的match_type以及字段级别的结果，您可以直接将其路由到批准/审查/拒绝逻辑中。
重要性 — 背景数据为入职流程增加了广泛的身份和风险信号。
使用方法 — 向Didit的数据库验证端点发送一个POST请求，或使用无代码工作流模块。每次确定性查询0.30美元，几秒钟内出结果。

南非欺诈预防筛选验证内容

针对南非欺诈预防服务（SAFPS）观察名单对个人进行筛选。Didit通过单一端点公开此服务，因此您可以对照权威背景数据来源验证提交的数据，并接收结构化、标准化的结果 — 而不是需要您自行解析的原始注册表转储。

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

重要性

背景数据为入职流程增加了广泛的身份和风险信号。

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

技术细节

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

端点

POST /v3/database-validation/

请求参数

参数	类型	必填	描述
`issuing_state`	string	Yes	ISO 3166-1 alpha-3 国家代码。使用`ZAF`。
`services`	string	Yes	服务标识符。使用`zaf_fraud_prevention`。
`national_id`	string	No	国民身份证号（可选交叉检查）。
`bank_account_number`	string	No	银行账号（可选交叉检查）。
`phone_number`	string	No	电话号码（可选交叉检查）。
`email`	string	No	电子邮件（可选交叉检查）。

请求示例

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_fraud_prevention" \

响应示例（确定性匹配）

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_fraud_prevention",
      "service_name": "South Africa - Fraud Prevention Screening",
      "source_data": {
        "fraud_listings": "sample_value",
        "identification_number": "SAMPLE-ID-12345"
      },
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}

性能和计费

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

用例

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

如何与Didit集成

您可以通过两种方式运行南非欺诈预防筛选验证：

无代码工作流。在Didit业务控制台中，打开工作流构建器，添加数据库验证模块，选择南非 → 南非欺诈预防筛选验证，并激活它。匹配的用户将自动路由 — 无需工程设计。
直接API。使用services=zaf_fraud_prevention调用上面显示的/v3/database-validation/端点。读取match_type和字段级别的validation块以驱动您的批准/审查/拒绝逻辑。

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

常见问题

南非欺诈预防筛选验证检查确认什么？

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

如果源服务器暂时不可用怎么办？

您无需付费。计费仅适用于确定性结果 — 源服务器停机、字段缺失和预源拒绝是免费的。

检查速度有多快？

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

我需要SDK吗？

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

准备好开始了吗？

立即验证您的第一个南非背景数据。

阅读API参考： 南非欺诈预防筛选验证
查看所有数据库验证： 数据库验证定价和覆盖范围
开始构建： 创建免费的Didit账户 — 每月500次免费验证。

继续阅读