跳转到主要内容
身份证件验证步骤在工作流中有一个国家/地区标签页。您可以在这里逐个国家/地区决定，允许用户使用三种方式中的哪些，以及非证件方式未能完成核验时会发生什么。该标签页上的所有设置都会写入身份证件验证节点上的 methods 键。控制台与管理 API 只是同一对象的两种视图。

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

打开一个工作流，选择 身份证件验证 节点，然后点击国家/地区。每个国家/地区对应的行都会显示该国家/地区接受的方式。选择一个国家/地区即可打开其编辑器。 如果某个国家/地区没有证件采集，在以下情况下回退到证件采集…中的开关将始终关闭，因为没有可回退的方式。 若要使用这些开关，请先为该国家/地区开启证件采集。 如果某个国家/地区关闭了所有方式，保存时会被拒绝，并显示 未启用任何方式 — 无人可在此完成验证，因为这样的配置无法核验任何人。

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

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

​
可用性由服务端决定

该标签页读取 API 验证所依据的同一份能力目录，因此只会提供平台实际支持的选项：
  • 目录中某国家/地区未提供的方式，不会作为选项显示。
  • 目录标记为即将推出的来源或钱包会列出，方便您了解路线图，但无法开启。
  • 钱包登录按环境开启。在其关闭期间，无论目录如何标注，所有钱包都显示为即将推出。

​
启用 Smart-ID 或 Mobile-ID

Smart-ID 和 Mobile-ID 在其支持的国家/地区可用。 国家/地区覆盖范围请参见钱包目录。 修改工作流之前，请先确认当前环境中显示的可用性。
  1. 打开工作流，选择该工作流及其身份证件验证节点，然后打开国家/地区。
  2. 打开国家/地区编辑器，找到接受的钱包。
  3. 仅在可用时选择 Smart-ID 或 Mobile-ID；如果希望保留备用方式，请保持证件采集开启。
  4. 选择钱包登录失败时的处理方式，然后保存并发布工作流。
  5. 使用该工作流启动一个新的验证会话，并查看已完成会话中的凭据卡片。
Smart-ID 和 Mobile-ID 集成指南列出了支持的国家代码，以及用户看到的比对码流程。 在暂存或沙盒环境中测试成功，并不会在生产环境中启用该钱包。

​
预期请求与响应

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

​
批量开关

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

​
选项卡上的价格

证件采集显示其价格：每次检查 $0.15。非证件查询按国家/地区显示价格。定价目录尚未公布的价格会在选项卡上标注为占位价格，而不会当作报价展示。钱包行会显示钱包、其覆盖范围和可用性。 选项卡还会说明每个查询回退开关的计费后果，以便您在保存配置前了解配置成本：
  • 已应答的登记源会对该查询计费，匹配和不匹配都计费。用户回退时，证件采集再另行计费。
  • 未返回结果的查询不计费，因此一次服务中断只需支付证件价格。
  • 关闭回退后，这些用户会被置为已拒绝，且不再产生任何费用。

​
查看会话

会话详情中的 身份证件验证 模块会显示生成该结果的方法标签，以及其保障等级标签：证件 / 证件类、非证件查询 / 数据匹配，或钱包名称加 密码学。
从非证件方法回退到证件采集的会话，会显示为 证件 / 证件类 会话。该身份证件验证中的 fallback_from 会说明最先尝试的方法以及它结束的原因（例如 wallet 和 cancelled），并带有 action: "fallback_to_document"。
在标签下方，每种方法都会显示各自的证据：
  • 证件：保持不变，包括正面、背面和自拍照图片、质量分数、提取的字段和警告。
  • 非证件查询：显示 登记比对，列出每个被比对的字段、用户提供的内容、数据源所持有的内容，以及 匹配、部分匹配 或 不匹配 的结果，还包括数据源名称、核验时间和尝试次数。未应答的数据源会作为单独一行显示，并附带错误信息，而不是字段判定结果。若数据源返回了人像，该人像会与用户的自拍照并排显示，并附带人脸分数。
  • 钱包：显示 凭据 卡片，包括钱包、其签发机构、凭据类型、它声明的保障等级、核验时间、签名是否通过验证，以及钱包共享的属性。
如果数据源或钱包没有提供人像，面板会明确说明，而不会留下空白框：没有可用于人脸比对的内容。如果工作流包含活体检测和人脸比对，它们会作为独立步骤运行。

​
相关内容

最后修改于 2026年11月7日