尼日利亚银行验证码 (BVN) 验证 API (ZH)

在尼日利亚注册用户意味着要确认他们是否名副其实。此服务将输入数据与尼日利亚银行业数据库进行核对。一份文件或手动输入的详细信息只能证明数据存在，而不能证明其真实性或属于您面前的人。尼日利亚银行验证码 (BVN) 验证通过将数据与 BVN 进行核对来弥补这一差距。本指南解释了此检查的功能、具体技术细节以及如何在几分钟内完成集成。

主要收获：

• 检查内容 — 尼日利亚银行验证码 (BVN) 验证银行账户与 BVN 信息。
• 返回内容 — 标准化的 match_type 以及字段级结果，您可以将其直接导入批准/审核/拒绝逻辑。
• 重要意义 — 确认账户持有人的身份可以防止支付欺诈，并支持支付和工资单的入职流程。
• 如何使用 — 向 Didit 的数据库验证端点发送一个 POST 请求。每次确凿查询0.80美元，几秒内即可出结果。

尼日利亚银行验证码 (BVN) 验证内容

此服务将输入数据与尼日利亚银行业数据库进行核对。Didit 通过单个端点提供此服务，因此您可以根据国家银行/账户所有权网络验证提交的数据，并接收结构化、标准化的结果 — 而非需要您自行解析的原始注册表转储。

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

重要意义

确认账户持有人的身份可以防止支付欺诈，并支持支付和工资单的入职流程。

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

技术细节

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

端点

POST /v3/database-validation/

请求参数

参数	类型	必填	描述
issuing_state	string	是	ISO 3166-1 alpha-3 国家代码。使用 NGA。
services	string	是	服务标识符。使用 nga_bank_verification_number。
first_name	string	是	名字。
last_name	string	是	姓氏。
bvn	string	是	BVN。
date_of_birth	string	否	出生日期（可选交叉核对）。

请求示例

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=NGA" \
  -F "services=nga_bank_verification_number" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "bvn=11111111111"

响应示例（确凿匹配）

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "NGA",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "nga_bank_verification_number",
      "service_name": "Nigeria Bank Verification Number (BVN)",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "last_name": "Doe"
      },
      "validation": {
        "full_name": "full_match"
      }
    }
  ]
}

性能与计费

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

使用场景

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

如何与 Didit 集成

您可以通过两种方式运行尼日利亚银行验证码 (BVN) 验证：

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

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

常见问题

尼日利亚银行验证码 (BVN) 检查确认什么？

它根据 BVN 验证提交的数据并返回标准化的匹配结果，以便您了解银行账户是否存在于权威来源以及哪些字段匹配。

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

不收费。计费仅适用于确凿结果 — 源系统停机、字段缺失和源系统前拒绝是免费的。

检查速度如何？

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

我需要 SDK 吗？

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

准备好开始了吗？

立即验证您的第一个尼日利亚银行账户。

• 阅读 API 参考： 尼日利亚银行验证码 (BVN)
• 查看所有数据库验证： 数据库验证定价和覆盖范围
• 开始构建： 创建一个免费的 Didit 账户 — 每月500次免费验证。