> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# 在控制台中配置身份证件验证方式

> 在 Didit 控制台中为每个国家/地区选择可用的三种身份证件验证方式，设置回退开关，并查看每次会话实际使用的验证方式。

[身份证件验证](https://docs.didit.me/zh/core-technology/id-verification/verification-methods.md)步骤在工作流中有一个**国家/地区**标签页。您可以在这里逐个国家/地区决定，允许用户使用三种方式中的哪些，以及非证件方式未能完成核验时会发生什么。该标签页上的所有设置都会写入身份证件验证节点上的 [`methods`](https://docs.didit.me/zh/management-api/workflows/feature-configs#ocr-/-身份证件验证) 键。控制台与管理 API 只是同一对象的两种视图。

## 国家/地区和允许的身份验证方式

打开一个工作流，选择 **身份证件验证** 节点，然后点击**国家/地区**。每个国家/地区对应的行都会显示该国家/地区接受的方式。选择一个国家/地区即可打开其编辑器。

| 部分 | 控制内容 | 写入的配置 |
| - | - | - |
| **证件采集** | 是否接受拍摄的证件，以及该国家/地区的证件类型、子类型和采集规则 | `document.enabled`、`documents_allowed` |
| **无证件核验** | 是否提供非证件核验、用户可作答的次数上限，以及在基于人像的匹配成功后是否跳过工作流中后续的活体检测和人脸比对步骤 | `id_lookup.enabled`、`id_lookup.max_attempts`、`id_lookup.skip_liveness_and_face_match` |
| **接受的钱包** | 该国家/地区提供哪些数字身份钱包。这是接受列表，不是排序，最终用户从您勾选的选项中选择 | `wallet.enabled`、`wallet.providers` |
| **在以下情况下回退到证件采集…** | 每种失败情形对应一个开关 | `id_lookup.on_partial_match`、`id_lookup.on_no_match`、`id_lookup.on_provider_error`、`wallet.on_failure` |

如果某个国家/地区没有证件采集，**在以下情况下回退到证件采集…**中的开关将始终关闭，因为没有可回退的方式。
若要使用这些开关，请先为该国家/地区开启**证件采集**。

如果某个国家/地区关闭了所有方式，保存时会被拒绝，并显示 **未启用任何方式 — 无人可在此完成验证**，因为这样的配置无法核验任何人。

### 仅在回退时提供证件采集

打开某个国家/地区，然后选择**用户在此如何验证**：

| 选项 | 用户看到的内容 |
| - | - |
| **先使用钱包，失败后使用证件** | 仅显示钱包（未选择钱包时则显示 ID 查询）。只有在登录被取消、超时或失败，或查询未匹配时，才会提供证件采集。 |
| **仅使用钱包，不使用证件** | 仅显示钱包（或 ID 查询）。该国家/地区关闭证件采集，未完成的登录可以重试：用户停留在钱包步骤，显示“再次尝试 {wallet}”，会话保持打开，直到用户完成操作或会话过期。 |
| **用户选择钱包或证件** | 钱包或查询，与证件采集并列显示。 |
| **仅使用证件** | 仅证件采集。不提供钱包或查询。 |

**先使用钱包，失败后使用证件**会一次性写入 `document.fallback_only` 以及对应的回退开关（`wallet.on_failure`，启用查询时还包括查询相关开关）。**仅使用钱包，不使用证件**会将 `document.enabled` 设为 `false`，并将 `wallet.on_failure` 设为 `retry`：未完成的登录可以重试，会话保持打开，直到用户完成操作或会话过期。
这一设置对任何国家/地区的任何钱包都以相同方式生效。
在您选择一个已上线的钱包（或启用一项查询）之前，这两个选项均不可用。
标记为**即将推出**的钱包不能作为首选方式：只要某个国家/地区的所有钱包都即将推出，证件采集就仍然排在首位。
国家/地区列表会在使用**先使用钱包，失败后使用证件**的每个国家/地区下方显示“先钱包，后证件”，而预览只显示钱包。

在“钱包”和“无证件核验”页面的**其他设置**下，同样可以找到该设置，名为开关**仅在回退时提供证件采集**。
两处控件编辑的是同一份配置。

### 可用性由服务端决定

该标签页读取 API 验证所依据的同一份能力目录，因此只会提供平台实际支持的选项：

* 目录中某国家/地区未提供的方式，不会作为选项显示。
* 目录标记为**即将推出**的来源或钱包会列出，方便您了解路线图，但无法开启。
* 钱包登录按环境开启。在其关闭期间，无论目录如何标注，所有钱包都显示为**即将推出**。

### 启用 Smart-ID 或 Mobile-ID

Smart-ID 和 Mobile-ID 在其支持的国家/地区可用。
国家/地区覆盖范围请参见[钱包目录](https://docs.didit.me/zh/core-technology/id-verification/digital-id-wallets.md)。
修改工作流之前，请先确认当前环境中显示的可用性。

1. 打开**工作流**，选择该工作流及其**身份证件验证**节点，然后打开**国家/地区**。
2. 打开国家/地区编辑器，找到**接受的钱包**。
3. 仅在可用时选择 **Smart-ID** 或 **Mobile-ID**；如果希望保留备用方式，请保持证件采集开启。
4. 选择钱包登录失败时的处理方式，然后保存并发布工作流。
5. 使用该工作流启动一个新的验证会话，并查看已完成会话中的**凭据**卡片。

[Smart-ID 和 Mobile-ID 集成指南](https://docs.didit.me/zh/core-technology/id-verification/smart-id-mobile-id.md)列出了支持的国家代码，以及用户看到的比对码流程。
在暂存或沙盒环境中测试成功，并不会在生产环境中启用该钱包。

### 预期请求与响应

对某个无证件核验来源或钱包点击**查看详情**，即可查看预期的请求与响应：用通俗语言说明最终用户需要提供什么，以及该来源返回什么。每个查询来源都有明确的名称，多数国家/地区是政府登记系统，部分是征信机构或住址记录档案，因为名称决定了数据来源和同意机制。最终用户看不到响应字段、来源名称或价格。

### 批量开关

**全局设置**会在所有支持该方式的国家/地区开启它，因此您无需手动逐个设置 36 个国家/地区。单个国家/地区的编辑器优先级更高：您可以先全局开启某种方式，再为不希望使用它的那个国家/地区单独关闭。

## 选项卡上的价格

**证件**采集显示其价格：每次检查 \$0.15。**非证件查询**按国家/地区显示价格。定价目录尚未公布的价格会在选项卡上标注为占位价格，而不会当作报价展示。钱包行会显示钱包、其覆盖范围和可用性。

选项卡还会说明每个查询回退开关的计费后果，以便您在保存配置前了解配置成本：

* 已应答的登记源会对该查询计费，匹配和不匹配都计费。用户回退时，**证件**采集再另行计费。
* 未返回结果的查询不计费，因此一次服务中断只需支付证件价格。
* 关闭回退后，这些用户会被置为已拒绝，且不再产生任何费用。

## 查看会话

会话详情中的 **身份证件验证** 模块会显示生成该结果的方法标签，以及其[保障等级](https://docs.didit.me/zh/core-technology/id-verification/verification-methods.md#保证等级)标签：**证件 / 证件类**、**非证件查询 / 数据匹配**，或钱包名称加 **密码学**。

> [!NOTE]
>
> 从非证件方法回退到证件采集的会话，会显示为 **证件 / 证件类** 会话。该身份证件验证中的 [`fallback_from`](https://docs.didit.me/zh/reference/data-models#身份证件验证) 会说明最先尝试的方法以及它结束的原因（例如 `wallet` 和 `cancelled`），并带有 `action: "fallback_to_document"`。

在标签下方，每种方法都会显示各自的证据：

* **证件**：保持不变，包括正面、背面和自拍照图片、质量分数、提取的字段和警告。
* **非证件查询**：显示 **登记比对**，列出每个被比对的字段、用户提供的内容、数据源所持有的内容，以及 **匹配**、**部分匹配** 或 **不匹配** 的结果，还包括数据源名称、核验时间和尝试次数。未应答的数据源会作为单独一行显示，并附带错误信息，而不是字段判定结果。若数据源返回了人像，该人像会与用户的自拍照并排显示，并附带人脸分数。
* **钱包**：显示 **凭据** 卡片，包括钱包、其签发机构、凭据类型、它声明的保障等级、核验时间、签名是否通过验证，以及钱包共享的属性。

如果数据源或钱包没有提供人像，面板会明确说明，而不会留下空白框：没有可用于人脸比对的内容。如果工作流包含活体检测和人脸比对，它们会作为独立步骤运行。

## 相关内容

* [身份证件验证方法](https://docs.didit.me/zh/core-technology/id-verification/verification-methods.md)：三种方法、回退和计费
* [非证件查询](https://docs.didit.me/zh/core-technology/id-verification/non-doc-lookup.md)：各国家/地区的字段和同意
* [数字身份钱包](https://docs.didit.me/zh/core-technology/id-verification/digital-id-wallets.md)：每个钱包的属性和保障等级
* [工作流](https://docs.didit.me/zh/console/workflows.md)：构建和发布工作流
* [工作流功能配置](https://docs.didit.me/zh/management-api/workflows/feature-configs.md#ocr-/-身份证件验证)：通过 API 进行相同的设置


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.