数据库验证 - 开通服务与计费规则

数据库验证将提取出的身份数据与政府或权威登记库进行核对。本文解释为什么某个服务显示"需要开通"、为什么返回403或空结果，以及哪些查询会计费。

Didit 支持团队撰写 · 更新于 2026年9月15日

读取证件告诉您上面印了什么。数据库验证告诉您权威来源是否认可这些信息：民政登记库、税务机关、征信机构、驾照数据库等。每个国家提供一个或多个服务，各自有独立的价格、输入项和同意规则。请参阅支持的国家和服务和各服务价格。

#它在证件步骤之后静默运行

不存在数据库验证的界面。这一步取出从证件提取的数据（或您创建会话时传入的数据），发送给登记库，并把回应保存在会话报告中。由此引出两点：

• 如果证件步骤提取了错误的号码或姓名，登记库就会用错误的值被查询，核验会失败或返回无法判定。请先修正提取结果。参阅修正被读错的姓名或字段。
• 您无法像重新提交证件或自拍那样让用户"重新提交"数据库验证，因为用户没有任何可以重做的内容。请求重新提交DATABASE_VALIDATION会返回错误，说明该功能不属于此会话可重新提交的步骤。若要再次运行，请使用修正后的数据调用独立数据库验证API。该调用与其他查询一样按次计费。

#为什么没有运行

按以下顺序排查。这几乎能解释所有"数据库验证什么也没做"的反馈。

1. 您的组织充值过吗？

   数据库验证（以及电话验证）只在首次充值后才会启用。欢迎赠金（包括新账户的10美元）不算充值。在此之前该步骤会被跳过，会话可能在核验根本没执行的情况下返回已批准，直接调用POST /v3/database-validation/会返回403。参阅充值、发票和支付方式。

2. 服务是否标记为需要开通？

   在工作流的数据库验证步骤中，部分服务显示**"需要开通。请联系 Didit 支持团队以启用。"** 该服务可见，但在Didit为您的组织激活前处于禁用状态。这不是故障，也没有自助开关：请提交支持工单并注明服务和国家，团队会启动开通流程。

3. 该国家是否已配置？

   对工作流中从未选择的国家发起API调用，或对未启用的服务发起独立调用，会针对该国家返回"No database validation services configured"。请把服务添加到步骤中，或传入该国家页面上准确的service_id。

4. 余额是否为正？

   数据库验证从不包含在免费额度内。余额为零或负数时会返回insufficient_credits，与任何付费功能相同。参阅解决"余额不足"错误。

#需要在提供商处开通的服务

少数政府数据源要求Didit将您的组织在提供商处登记，而不只是打开一个开关。目前涉及：

• 澳大利亚（DVS：驾照、护照、签证、Medicare及其他DVS服务）
• 新西兰（DIA：护照、公民身份、出生与死亡记录、驾照）
• 加拿大（征信机构及FINTRAC类型的比对服务）

对于这些服务，支持团队会把提供商的表格发给您填写，提供商为您的账户签发凭据，开通通常需要最多两周。澳大利亚和新西兰历来还要求最低服务协议（一次性预付款，目前为5,000美元，以永不过期的额度形式进入您的余额）。该要求仅适用于这两个国家的登记库访问，不涉及Didit的其他功能，并且随着Didit完成自身在澳大利亚体系中的认证正在调整中，因此在据此规划之前请向支持团队确认当前条款。

#计费规则

您按服务、按登记库作出回应的每次查询付费，价格见该服务的页面。请理解为"登记库被查询并作出了回应"，而不是"回应是您想要的结果"：

一个会话若运行多个服务，可能产生多次计费查询；每次查询按服务计费一次，而非按国家。完整说明：数据库验证价格和结果代码。

#返回的内容

每个服务返回一个标准结果代码，并在数据源允许的范围内附上登记库自身的数据：哪些字段匹配、登记库以评分而非是/否作答时的匹配分数，以及生物特征类服务（阿根廷RENAPER、尼日利亚BVN、巴拿马）中与登记库人像的面部比对。Didit从该回应中保存哪些内容，由该步骤的返回的数据设置决定。参阅选择验证返回哪些数据和数据库验证报告。

#上线前测试

沙盒应用永远不会触达真实登记库，也不消耗额度：像decline_database_no_match这样的沙盒场景可以强制产生您想演练的结果。沙盒无法告诉您的是某个具体服务是否已为您的正式组织开通，这需要首次充值和一次真实调用。参阅在沙盒中测试。