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

Source: https://help.didit.me/zh/documents-coverage/database-validation
Updated: 2026-09-15

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

数据库验证在**后台**针对官方登记库运行，用户完全看不到它。它只在您的组织**首次充值**后才会启用，
部分服务在Didit为您开通前会额外显示**"需要开通"**，并且登记库实际作出回应的每一次查询都会计费，
**包括不匹配的结果**。

[Video: 政府数据库核验 - Didit Academy](https://www.youtube.com/watch?v=OksmtyKHe48&t=18)

读取证件告诉您上面印了什么。数据库验证告诉您权威来源是否认可这些信息：民政登记库、税务机关、征信机构、驾照数据库等。每个国家提供一个或多个**服务**，各自有独立的价格、输入项和同意规则。请参阅[支持的国家和服务](https://docs.didit.me/core-technology/database-validation/database-validation-supported-countries)和[各服务价格](https://docs.didit.me/getting-started/database-validation-pricing)。

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

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

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

## 为什么没有运行

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

1. **您的组织充值过吗？**

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

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

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

3. **该国家是否已配置？**

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

4. **余额是否为正？**

   数据库验证从不使用免费套餐额度支付。余额为零或负数时会返回`insufficient_credits`，与任何付费功能相同。参阅[解决"余额不足"错误](https://help.didit.me/zh/billing-credits/not-enough-credits)。

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

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

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

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

> **Note:** 部分服务在发送查询前还要求**最终用户的明确同意**（例如新西兰DIA护照核验）。工作流步骤会标记
> 这些服务，您需要在自己的流程中先收集同意，核验才能运行。

## 计费规则

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

| 结果 | 计费？ |
|---|---|
| 匹配、部分匹配、不匹配 | 是 |
| 无法判定、生物特征图像不可用 | 是 |
| 证件格式无效、输入无效（被登记库拒绝） | 是 |
| `REGISTRY_UNAVAILABLE`、`REGISTRY_ERROR`（登记库从未回应） | 否 |
| 请求在到达登记库前被拒绝（独立API返回400，或因字段缺失或格式错误而跳过工作流步骤） | 否 |

一个会话若运行多个服务，可能产生多次计费查询；每次查询按服务计费一次，而非按国家。完整说明：[数据库验证价格](https://docs.didit.me/getting-started/database-validation-pricing)和[结果代码](https://docs.didit.me/core-technology/database-validation/database-validation-outcome-codes)。

> **Warning:** **空**结果不等于不匹配。如果某个服务什么也没返回，而不是返回`NO_MATCH`结果，常见原因是首次充值
> 规则、服务仍在等待开通，或登记库故障。在调试您的集成之前请先排除这些。参阅[API错误及其含义](https://help.didit.me/zh/integration/api-errors)。

## 返回的内容

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

## 上线前测试

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