> ## 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)之一。用户无需拍摄证件照片，只需输入其国民身份证号以及几项个人详细信息，Didit 就会对照该国家/地区的权威数据源进行核验。

核验结果包含保证等级 `data_match`：用户提供的详细信息与该数据源保存的记录相匹配。由于未对证件进行检查，因此不对证件的真实性作任何声明。

## 查询的数据源

大多数国家/地区为政府登记库，例如南非内政部、阿根廷 RENAPER、印度 UIDAI、丹麦 CPR 登记库。**也有部分不是。** 在加拿大、法国、印度尼西亚、荷兰、挪威、新加坡、英国和美国，Didit 能够对接的权威记录是征信机构记录、金融服务记录、公用事业记录或居住记录档案，而非国家登记库。

这种区别绝非表面文章。它改变了匹配所证明的内容、查询所适用的同意机制，以及您可以向监管机构陈述的数据来源，因此本页面绝不做概括性表述：下方的**查询的数据源**列列出了每个国家/地区的确切数据源，并且它是唯一可信赖的来源声明。在启用某个国家/地区之前，请务必阅读该内容。

> [!NOTE]
>
> 终端用户永远看不到数据源名称。该信息存在于会话 payload（`id_lookup.source`）、控制台和导出数据中，供您和您的审计员使用。

## 用户的操作流程

1. 在身份证件验证步骤中选择其国家/地区。
2. 输入该国家/地区要求的字段：始终包含标识符，通常包含姓名，有时包含出生日期或地址。
3. 若该国家/地区的查询要求提供自拍照，则拍摄一张自拍照。
4. 获取结果：已验证并继续后续流程、被要求更正号码、重试、转入证件采集，或已拒绝。

整个步骤仅需输入信息，对于五个国家/地区还需要拍摄一张自拍照。无需上传文件，无需对准摄像头取景，也完全不需要证件。

## 自拍、肖像以及后续的人脸比对步骤

查询操作通过记录确立身份。查询留存的内容决定了工作流中后续的[人脸比对](https://docs.didit.me/zh/core-technology/face-match/overview.md)步骤可以将用户的实时采集与什么进行比对。每个数据源遵循三种机制之一，[下表](#覆盖范围与定价)中的**自拍、活体检测和人脸比对**列按国家列出了具体情况：

| 数据源的处理方式 | 后续人脸比对步骤的比对基准 |
| - | - |
| 返回持有人的照片 | 登记照片，前提是工作流保留了 `registry_portrait` 响应字段 |
| 自行比对自拍照与记录中的人脸并返回裁定结果 | 数据源验证过的自拍照 |
| 仅返回数据 | 无 |

如果数据源返回照片，系统会要求用户提供一张自拍照，对其运行[无感活体检测](https://docs.didit.me/zh/core-technology/liveness/overview.md)，并将其与登记肖像进行人脸比对。这三项操作均在查询内部完成并包含在查询价格中：没有单独的活体检测或人脸比对费用。因为查询已经证明了存在与登记照片相符的真人，所以该国家的 `skip_liveness_and_face_match` 开关（默认开启）允许工作流在比对成功后跳过自身的人脸比对和活体检测步骤。将其关闭则无论如何都会运行它们。

如果数据源自行核验自拍照（例如**巴西**、**阿根廷** (RENAPER)、**尼日利亚**和**巴拿马**（Tribunal Electoral 的生物识别服务）），核验将返回裁定结果而非肖像。这不属于活体检测，因此该开关在保存时会规范化为关闭状态，且工作流中的任何活体检测和人脸比对步骤仍会运行。匹配成功时，人脸比对会将实时采集与查询所核验的自拍照进行比对。在**尼日利亚**，用户可以选择证件类型，且无论是 NIN 还是 BVN，自拍照都会与记录中的人脸进行核对。

所有其他数据源均仅返回数据，无需拍摄自拍照的阿根廷数据源也是如此。此时不会拍摄自拍照，且该开关在保存时会规范化为关闭状态。

### 在不提供照片的验证方式后设置人脸比对步骤

仅返回数据的查询不会给人脸比对步骤留下任何可比对的内容，[数字身份钱包](https://docs.didit.me/zh/core-technology/id-verification/digital-id-wallets.md)登录也是如此：即使钱包共享了肖像，它也不会用作人脸比对的基准。以这种方式进入的人脸比对步骤无法自动通过任何人：它处理的每个用户都会进入人工审核或被拒绝。工作流编辑器以及每个客户端使用的图谱验证会在您发布前发出提醒：

* **工作流无法发布**：当针对某个国家，进入人脸比对步骤的所有路径都仅使用不提供照片的方式验证其用户，且离开该身份证件验证步骤的每条路线都通向人脸比对步骤时。即使分支的所有结果最终都导回人脸比对，也不会改变这一状态。请允许该国家进行证件采集、选择一个能返回照片或核验自拍照的数据源，或者移除人脸比对步骤。
* **发出警告**：当这取决于用户的选择时，也就是同时提供了证件采集或提供照片的数据源，或者身份证件验证步骤之后的分支可以将这些用户引导至无需人脸比对的结果。使用纯数据方式完成验证的用户在到达人脸比对时仍将无可比对内容。

在控制台中，只要后续有人脸比对步骤，身份证件验证步骤的**国家**选项卡中每个此类数据源和钱包旁边的说明都会提示相同内容。如果在创建会话时就采集了基准人脸的工作流（生物识别认证，或者带有 `portrait_image` 且可在任何身份证件验证步骤之前运行的人脸比对步骤），则始终有可比对的内容，绝不会被标记。

如果工作流中没有其他步骤提供基准，纯数据匹配后的人脸比对将没有基准可供与实时采集进行比对。
它会报告无法完成比对（`FACE_MATCH_NOT_COMPUTED`，分数为 `null`），而不是自动拒绝。
随后，人脸比对步骤的 `face_match_not_computed_action` 将决定结果：默认为 `In Review`，如果您将其设置为 `DECLINE`，则为 `Declined`。
请参阅[人脸比对警告](https://docs.didit.me/zh/core-technology/face-match/warnings-face-match.md)。

## 覆盖范围与定价

下方价格为每次获得应答的尝试的公开零售美元价格，并于 2026 年 9 月 11 日与匿名的数据库核验定价数据源进行核对。这些价格基于为相应国家/地区配置的服务。价格并不代表生产环境上线公告：请仅启用您的应用目录中所提供的方法。现有的可用性快照独立于本次价格刷新另行保留。

对于使用多个数据源的国家/地区，表格中展示的是所有数据源均应答时的总和。一次获得应答的尝试仅对其计费的数据源响应收费；未应答的数据源不计入费用。尼日利亚采用 **NIN 或 BVN**，而非两者的总和。定制合同费率可能会有所不同，并在您的控制台中显示。这些仅是证件步骤查询的价格，并非该国家/地区所提供的每项其他数据库核验服务的报价。

| 国家/地区 | USD / 尝试 | 代码 | 查询的数据源 | 可用性 | 自拍照、活体检测与人脸比对 | 同意机制 |
| - | - | - | - | - | - | - |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/ar.svg)阿根廷 | \$0.20 | `ARG` | RENAPER | 可用 | 由查询核对自拍照；活体检测与人脸比对仍会运行 | Ley 25.326 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/bo.svg)玻利维亚 | \$0.20 | `BOL` | SEGIP | 可用 | 不适用 — 仅数据 | — |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/br.svg)巴西 | \$0.40 | `BRA` | Receita Federal | 可用 | 由查询核对自拍照；活体检测与人脸比对仍会运行 | LGPD |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/kh.svg)柬埔寨 | \$0.59 | `KHM` | 内政部选民登记名册 | 可用 | 不适用 — 仅数据 | 需要明确同意 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/ca.svg)加拿大 | \$6.59 | `CAN` | 加拿大征信机构记录（FINTRAC 双重流程） | 可用 | 不适用 — 仅数据 | PIPEDA |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/cl.svg)智利 | \$0.20 | `CHL` | Servicio de Registro Civil e Identificación | 可用 | 不适用 — 仅数据 | — |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/cn.svg)中国 | \$0.50 | `CHN` | 全国公民身份证号码查询服务中心（NCIIC） | 可用 | 不适用 — 仅数据 | 需要明确同意 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/co.svg)哥伦比亚 | \$0.20 | `COL` | Registraduría General de la Nación / ANI | 可用 | 不适用 — 仅数据 | — |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/cr.svg)哥斯达黎加 | \$0.20 | `CRI` | Tribunal Supremo de Elecciones | 可用 | 不适用 — 仅数据 | — |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/dk.svg)丹麦 | \$2.32 | `DNK` | CPR 登记处 | 可用 | 不适用 — 仅数据 | — |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/do.svg)多米尼加共和国 | \$0.05 | `DOM` | Junta Central Electoral | 可用 | 不适用 — 仅数据 | — |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/ec.svg)厄瓜多尔 | \$0.20 | `ECU` | Registro Civil del Ecuador | 可用 | 不适用 — 仅数据 | — |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/sv.svg)萨尔瓦多 | \$0.20 | `SLV` | RNPN | 可用 | 不适用 — 仅数据 | — |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/fi.svg)芬兰 | \$3.50 | `FIN` | DVV 人口登记处 | 可用 | 不适用 — 仅数据 | 需要明确同意 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/fr.svg)法国 | \$2.58 | `FRA` | 法国居住与公用事业记录 | 可用 | 不适用 — 仅数据 | GDPR |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/gt.svg)危地马拉 | \$0.20 | `GTM` | RENAP | 可用 | 不适用 — 仅数据 | — |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/hn.svg)洪都拉斯 | \$0.20 | `HND` | CNE | 可用 | 不适用 — 仅数据 | — |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/in.svg)印度 | \$0.42 | `IND` | UIDAI (Aadhaar) | 可用 | 不适用 — 仅数据 | Aadhaar 同意 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/id.svg)印度尼西亚 | \$0.35 | `IDN` | 通过居住记录查询的印度尼西亚人口登记处 | 可用 | 不适用 — 仅数据 | UU PDP |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/ke.svg)肯尼亚 | \$0.75 | `KEN` | IPRS（综合人口登记系统） | 可用 | 不适用 — 仅数据 | — |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/my.svg)马来西亚 | \$0.59 | `MYS` | JPN（国民登记局） | 可用 | 不适用 — 仅数据 | 需要明确同意 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/mx.svg)墨西哥 | \$0.20 | `MEX` | RENAPO | 可用 | 不适用 — 仅数据 | — |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/nl.svg)荷兰 | \$1.50 | `NLD` | 荷兰居民记录 | 可用 | 不适用 — 仅数据 | GDPR |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/ng.svg)尼日利亚 | NIN $0.35 / BVN $0.35 | `NGA` | NIMC / NIBSS | 可用 | 自拍照由查询核验；活体检测与人脸比对仍会运行 | NDPR |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/no.svg)挪威 | \$4.04 | `NOR` | 挪威居民记录 | 可用 | 不适用 — 仅数据 | GDPR |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/pa.svg)巴拿马 | \$1.25 | `PAN` | Tribunal Electoral / SIB | 可用 | 自拍照由查询核验；活体检测与人脸比对仍会运行 | — |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/py.svg)巴拉圭 | \$0.20 | `PRY` | Tribunal Superior de Justicia Electoral | 可用 | 不适用 — 仅数据 | — |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/pe.svg)秘鲁 | \$0.20 | `PER` | RENIEC | 可用 | 不适用 — 仅数据 | — |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/sg.svg)新加坡 | \$7.17 | `SGP` | 新加坡征信机构与公用事业记录 | 可用 | 不适用 — 仅数据 | PDPA |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/za.svg)南非 | \$2.68 | `ZAF` | Department of Home Affairs | 可用 | 包含在查询中 | POPIA |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/se.svg)瑞典 | \$0.59 | `SWE` | Skatteverket 人口登记库 | 可用 | 不适用 — 仅数据 | — |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/th.svg)泰国 | \$0.59 | `THA` | DOPA 公民登记 | 可用 | 不适用 — 仅数据 | 需要明确同意 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/gb.svg)英国 | \$3.09 | `GBR` | 英国征信机构与金融服务记录 | 可用 | 不适用 — 仅数据 | UK GDPR |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/us.svg)美国 | \$0.45 | `USA` | 美国征信机构与金融服务记录 | 可用 | 不适用 — 仅数据 | GLBA 允许用途 |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/uy.svg)乌拉圭 | \$0.20 | `URY` | Dirección Nacional del Registro de Estado Civil | 可用 | 不适用 — 仅数据 | — |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/ve.svg)委内瑞拉 | \$0.20 | `VEN` | CNE | 可用 | 不适用 — 仅数据 | — |
| ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/zm.svg)赞比亚 | \$0.20 | `ZMB` | 赞比亚税务局 | 可用 | 不适用 — 仅数据 | — |

> [!NOTE]
>
> 可用性取决于后端提供的功能目录；如果目录未将相应国家/地区标记为 `Available`，API 将拒绝启用该查询的工作流。标有 **按需报价** 的价格尚未公布 — 非证件核验方式按国家/地区定价，由您的客户团队报价。

## 格式规则

标识符字段在发送任何内容之前都会进行客户端格式检查 — 根据国家/地区的不同，检查长度、纯数字规则、校验和或模式。未通过检查的号码绝不会发送至数据源，这意味着它**绝不会被计费，也绝不计入 `max_attempts`**：系统会向用户显示特定于该国家/地区的消息并提示其更正。

下方的各国/地区表格列出了每个字段的规则。没有规则的字段为自由文本 — 例如姓名、界面收集的日期或拍摄的图像。

只要在您自己的预填充数据中确保格式无误，就无需为拼写错误支付任何费用。

## 各国家/地区字段

#### 阿根廷 (`ARG`)

数据源：**RENAPER**。该核验还会采集一张自拍照，并将其与该身份档案中记录的人脸进行比对；该检查返回的是判定结果，而非肖像照片。这并非活体检测，因此跳过开关保持关闭状态：工作流中的任何活体检测和人脸比对步骤仍会运行，并且人脸比对会将实时捕获的内容与该已核验的自拍照进行比对。

| 请求字段 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| DNI 号码 | `document_number` | 是 | 模式 `[MFmf]?\d{7,8}`；7-9 个字符 |
| 自拍照 | `selfie` | 是 | — |
| DNI 上显示的性别 | `gender` | 是 | `M`、`F`、`X` 之一 |

| 返回字段 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 玻利维亚 (`BOL`)

数据源：**SEGIP**。该数据源仅返回数据，因此没有可用于人脸比对的肖像照片：对于通过此方式验证的用户，工作流中后续的人脸比对步骤将无内容可供比对。

| 请求字段 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 玻利维亚 CI | `document_number` | 是 | 模式 `\d{6,10}(?:[-\s]?\d[A-Za-z])?`；6-13 个字符 |
| 出生日期 | `date_of_birth` | 是 | — |

| 返回字段 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 巴西 (`BRA`)

数据源：**Receita Federal**。该核验还会采集一张自拍照，并将其与该身份档案中记录的人脸进行比对；该检查返回的是判定结果，而非肖像照片。这并非活体检测，因此跳过开关保持关闭状态：工作流中的任何活体检测和人脸比对步骤仍会运行，并且人脸比对会将实时捕获的内容与该已核验的自拍照进行比对。

| 请求字段 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 巴西 CPF | `tax_number` | 是 | 恰好 11 个字符；仅限数字 |
| 出生日期 | `date_of_birth` | 是 | — |
| 自拍照 | `selfie` | 是 | — |

| 返回字段 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 柬埔寨 (`KHM`)

数据源：**内政部选民登记册**。该数据源仅返回数据，因此没有可用于人脸比对的肖像照片：对于通过此方式验证的用户，工作流中后续的人脸比对步骤将无内容可供比对。

| 请求字段 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 名字 | `first_name` | 是 | — |
| 姓氏 | `last_name` | 是 | — |
| 出生日期 | `date_of_birth` | 是 | — |
| 选民身份证号 | `voter_id` | 是 | 模式 `(?:\d{8}\|\d{2}-\d{3}-\d{3})` |

| 返回字段 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 加拿大 (`CAN`)

数据源：**加拿大信用局记录（FINTRAC 双重流程）**。该数据源仅返回数据，因此没有可用于人脸比对的肖像照片：对于通过此方式验证的用户，工作流中后续的人脸比对步骤将无内容可供比对。

| 请求字段 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 名字 | `first_name` | 是 | — |
| 姓氏 | `last_name` | 是 | — |
| 出生日期 | `date_of_birth` | 是 | — |
| 居住地址 | `address` | 是 | — |

| 返回字段 | 字段键 | 必填 |
| - | - | - |
| 姓名匹配（完全匹配、部分匹配或不匹配） | `name_match` | 是 |
| 出生日期匹配 | `date_of_birth_match` | 是 |
| 地址匹配 | `address_match` | 是 |
| 确认该身份的数据源数量 | `sources_confirming` | 是 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 智利 (`CHL`)

数据源：**Servicio de Registro Civil e Identificación**。该数据源仅返回数据，因此没有可用于人脸比对的肖像照片：对于通过此方式验证的用户，工作流中后续的人脸比对步骤将无内容可供比对。

| 请求字段 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 智利 RUT | `personal_number` | 是 | 8-12 个字符 |

| 返回字段 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 中国 (`CHN`)

数据源：**NCIIC（国家公民身份信息中心）**。该数据源仅返回数据，因此没有可用于人脸比对的肖像照片：对于通过此方式验证的用户，工作流中后续的人脸比对步骤将无内容可供比对。

| 请求字段 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 姓名 | `full_name` | 是 | — |
| 出生日期 | `date_of_birth` | 是 | — |
| 身份证号 | `national_id` | 是 | 模式 `(\d{15}\|\d{17}[\dXx])` |

| 返回字段 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 哥伦比亚 (`COL`)

数据源：**Registraduría General de la Nación / ANI**。该数据源仅返回数据，因此没有用于人脸比对的头像照：对于以此方式验证的用户，工作流后续的人脸比对步骤将无可比对的对象。

| 请求项 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 哥伦比亚公民身份证（Cédula） | `personal_number` | 是 | 6-10 个字符；仅限数字 |
| 签发日期 | `date_of_issue` | 是 | — |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 哥斯达黎加 (`CRI`)

数据源：**Tribunal Supremo de Elecciones**。该数据源仅返回数据，因此没有用于人脸比对的头像照：对于以此方式验证的用户，工作流后续的人脸比对步骤将无可比对的对象。

| 请求项 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 哥斯达黎加公民身份证（Cédula） | `personal_number` | 是 | 9-12 个字符；仅限数字 |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 丹麦 (`DNK`)

数据源：**CPR register**。该数据源仅返回数据，因此没有用于人脸比对的头像照：对于以此方式验证的用户，工作流后续的人脸比对步骤将无可比对的对象。

| 请求项 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 名 | `first_name` | 是 | — |
| 姓 | `last_name` | 是 | — |
| 出生日期 | `date_of_birth` | 是 | — |
| 国民身份号码 | `national_id` | 是 | 正则模式 `\d{6}-?\d{4}` |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 多米尼加共和国 (`DOM`)

数据源：**Junta Central Electoral**。该数据源仅返回数据，因此没有用于人脸比对的头像照：对于以此方式验证的用户，工作流后续的人脸比对步骤将无可比对的对象。

| 请求项 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 多米尼加公民身份证（Cédula） | `personal_number` | 是 | 恰好 11 个字符；仅限数字 |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 厄瓜多尔 (`ECU`)

数据源：**Registro Civil del Ecuador**。该数据源仅返回数据，因此没有用于人脸比对的头像照：对于以此方式验证的用户，工作流后续的人脸比对步骤将无可比对的对象。

| 请求项 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 厄瓜多尔公民身份证（Cédula） | `personal_number` | 是 | 恰好 10 个字符；仅限数字 |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 萨尔瓦多 (`SLV`)

数据源：**RNPN**。该数据源仅返回数据，因此没有用于人脸比对的头像照：对于以此方式验证的用户，工作流后续的人脸比对步骤将无可比对的对象。

| 请求项 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 萨尔瓦多唯一身份证明文件（DUI） | `document_number` | 是 | 恰好 9 个字符；仅限数字 |
| 出生日期 | `date_of_birth` | 是 | — |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 芬兰 (`FIN`)

数据源：**DVV population register**。该数据源仅返回数据，因此没有用于人脸比对的头像照：对于以此方式验证的用户，工作流后续的人脸比对步骤将无可比对的对象。

| 请求项 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 名 | `first_name` | 是 | — |
| 姓 | `last_name` | 是 | — |
| 出生日期 | `date_of_birth` | 是 | — |
| 国民身份号码 | `national_id` | 是 | 正则模式 `(?:\d{6}[-+A]\d{3}[0-9A-Z]\|\d{6}\d{3}[0-9A-Z])` |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 法国 (`FRA`)

数据源：**法国居住和公用事业记录**。该数据源仅返回数据，因此没有用于人脸比对的头像照：对于以此方式验证的用户，工作流后续的人脸比对步骤将无可比对的对象。

| 请求项 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 名 | `first_name` | 是 | — |
| 姓 | `last_name` | 是 | — |
| 出生日期 | `date_of_birth` | 是 | — |
| 居住地址 | `address` | 是 | — |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名匹配（完全匹配、部分匹配或不匹配） | `name_match` | 是 |
| 出生日期匹配 | `date_of_birth_match` | 是 |
| 地址匹配 | `address_match` | 是 |
| 确认身份的数据源数量 | `sources_confirming` | 是 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 危地马拉 (`GTM`)

数据源：**RENAP**。该数据源仅返回数据，因此没有可用于人脸比对的肖像照：在工作流中后续的人脸比对步骤对以此方式验证的用户将无可比对的对象。

| 收集项 | 字段键 | 必填 | 格式校验 |
| - | - | - | - |
| 危地马拉 DPI | `document_number` | 是 | 恰好 13 个字符；仅限数字 |
| 出生日期 | `date_of_birth` | 是 | — |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 洪都拉斯 (`HND`)

数据源：**CNE**。该数据源仅返回数据，因此没有可用于人脸比对的肖像照：在工作流中后续的人脸比对步骤对以此方式验证的用户将无可比对的对象。

| 收集项 | 字段键 | 必填 | 格式校验 |
| - | - | - | - |
| 洪都拉斯 DNI | `document_number` | 是 | 恰好 13 个字符；仅限数字 |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 印度 (`IND`)

数据源：**UIDAI (Aadhaar)**。该数据源仅返回数据，因此没有可用于人脸比对的肖像照：在工作流中后续的人脸比对步骤对以此方式验证的用户将无可比对的对象。

| 收集项 | 字段键 | 必填 | 格式校验 |
| - | - | - | - |
| 姓名 | `full_name` | 是 | — |
| 出生日期 | `date_of_birth` | 是 | — |
| 国民身份证号 | `personal_number` | 是 | 恰好 12 个字符；仅限数字 |
| PAN | `pan` | 是 | 模式 `[A-Z]{5}\d{4}[A-Z]`；转换为大写 |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 印度尼西亚 (`IDN`)

数据源：**通过户籍记录查询的印度尼西亚人口登记处**。该数据源仅返回数据，因此没有可用于人脸比对的肖像照：在工作流中后续的人脸比对步骤对以此方式验证的用户将无可比对的对象。

| 收集项 | 字段键 | 必填 | 格式校验 |
| - | - | - | - |
| 名 | `first_name` | 是 | — |
| 姓 | `last_name` | 是 | — |
| 出生日期 | `date_of_birth` | 是 | — |
| 居住地址 | `address` | 是 | — |
| NIK（16 位数字） | `national_id` | 是 | 恰好 16 个字符；仅限数字 |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名匹配（完全匹配、部分匹配或不匹配） | `name_match` | 是 |
| 出生日期匹配 | `date_of_birth_match` | 是 |
| 地址匹配 | `address_match` | 是 |
| 确认身份的数据源数量 | `sources_confirming` | 是 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 肯尼亚 (`KEN`)

数据源：**IPRS（综合人口登记系统）**。该数据源仅返回数据，因此没有可用于人脸比对的肖像照：在工作流中后续的人脸比对步骤对以此方式验证的用户将无可比对的对象。

| 收集项 | 字段键 | 必填 | 格式校验 |
| - | - | - | - |
| 名 | `first_name` | 是 | — |
| 姓 | `last_name` | 是 | — |
| 出生日期 | `date_of_birth` | 是 | — |
| 国民身份证号 | `national_id` | 是 | 模式 `\d{8,9}` |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 马来西亚 (`MYS`)

数据源：**JPN（国民登记局）**。该数据源仅返回数据，因此没有可用于人脸比对的肖像照：在工作流中后续的人脸比对步骤对以此方式验证的用户将无可比对的对象。

| 收集项 | 字段键 | 必填 | 格式校验 |
| - | - | - | - |
| 姓名 | `full_name` | 是 | — |
| 出生日期 | `date_of_birth` | 是 | — |
| 国民身份证号 | `national_id` | 是 | 恰好 12 个字符；仅限数字 |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 墨西哥 (`MEX`)

数据源：**RENAPO**。该数据源仅返回数据，因此没有可用于人脸比对的肖像照：在工作流中后续的人脸比对步骤对以此方式验证的用户将无可比对的对象。

| 收集项 | 字段键 | 必填 | 格式校验 |
| - | - | - | - |
| 墨西哥 CURP | `personal_number` | 是 | 恰好 18 个字符 |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 荷兰 (`NLD`)

数据源：**荷兰户籍记录**。该数据源仅返回数据，因此没有可用于人脸比对的人像照片：对于通过这种方式验证的用户，工作流中后续的人脸比对步骤没有可供比对的对象。

| 请求项 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 名 | `first_name` | 是 | — |
| 姓 | `last_name` | 是 | — |
| 出生日期 | `date_of_birth` | 是 | — |
| 居住地址 | `address` | 是 | — |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名匹配（完全匹配、部分匹配或无匹配） | `name_match` | 是 |
| 出生日期匹配 | `date_of_birth_match` | 是 |
| 地址匹配 | `address_match` | 是 |
| 确认该身份的数据源数量 | `sources_confirming` | 是 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 尼日利亚 (`NGA`)

数据源：**NIMC / NIBSS**。核验还会采集一张自拍照，并将其与该身份存档的人脸进行比对；该项核查返回的是判定结论，而非人像照片。这不是活体检测，因此跳过开关保持关闭状态：工作流中的任何活体检测和人脸比对步骤仍会运行，并且人脸比对会将实时采集的照片与该张已验证的自拍照进行比对。

| 请求项 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 证件类型 | `identifier_type` | 是 | `NIN`、`BVN` 之一 |
| 证件号码本身 | `identifier` | 是 | 恰好 11 个字符；仅限数字 |
| 名 | `first_name` | 是 | — |
| 姓 | `last_name` | 是 | — |
| 自拍照 | `selfie` | 是 | — |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 原籍州 | `state_of_origin` | 否 |
| 电话号码（已掩码） | `phone_number_masked` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 挪威 (`NOR`)

数据源：**挪威户籍记录**。该数据源仅返回数据，因此没有可用于人脸比对的人像照片：对于通过这种方式验证的用户，工作流中后续的人脸比对步骤没有可供比对的对象。

| 请求项 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 名 | `first_name` | 是 | — |
| 姓 | `last_name` | 是 | — |
| 出生日期 | `date_of_birth` | 是 | — |
| 居住地址 | `address` | 是 | — |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名匹配（完全匹配、部分匹配或无匹配） | `name_match` | 是 |
| 出生日期匹配 | `date_of_birth_match` | 是 |
| 地址匹配 | `address_match` | 是 |
| 确认该身份的数据源数量 | `sources_confirming` | 是 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 巴拿马 (`PAN`)

数据源：**Tribunal Electoral / SIB**。核验还会采集一张自拍照，并将其与该身份存档的人脸进行比对；该项核查返回的是判定结论，而非人像照片。这不是活体检测，因此跳过开关保持关闭状态：工作流中的任何活体检测和人脸比对步骤仍会运行，并且人脸比对会将实时采集的照片与该张已验证的自拍照进行比对。

| 请求项 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 巴拿马 Cédula | `personal_number` | 是 | 符合模式 `(?:\d{1,2}(?:-?(?:AV\|PI))?\|PE\|E\|N)[\d-]*`；至少 5 个字符；大写 |
| 自拍照 | `selfie` | 是 | — |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 巴拉圭 (`PRY`)

数据源：**Tribunal Superior de Justicia Electoral**。该数据源仅返回数据，因此没有可用于人脸比对的人像照片：对于通过这种方式验证的用户，工作流中后续的人脸比对步骤没有可供比对的对象。

| 请求项 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 巴拉圭 CI | `document_number` | 是 | 6-10 个字符；仅限数字 |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 秘鲁 (`PER`)

数据源：**RENIEC**。该数据源仅返回数据，因此没有可用于人脸比对的人像照片：对于通过这种方式验证的用户，工作流中后续的人脸比对步骤没有可供比对的对象。

| 请求项 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 秘鲁 DNI | `personal_number` | 是 | 恰好 8 个字符；仅限数字 |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 新加坡 (`SGP`)

数据源：**新加坡征信机构与公用事业记录**。该数据源仅返回数据，因此没有可用于人脸比对的人像照片：对于通过这种方式验证的用户，工作流中后续的人脸比对步骤没有可供比对的对象。

| 请求项 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 名 | `first_name` | 是 | — |
| 姓 | `last_name` | 是 | — |
| 出生日期 | `date_of_birth` | 是 | — |
| 居住地址 | `address` | 是 | — |
| NRIC / FIN | `national_id` | 是 | 模式 `[STFGM]\d{7}[A-Z]`；转为大写 |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名匹配（精确匹配、部分匹配或无匹配） | `name_match` | 是 |
| 出生日期匹配 | `date_of_birth_match` | 是 |
| 地址匹配 | `address_match` | 是 |
| 确认该身份的数据源数量 | `sources_confirming` | 是 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 南非 (`ZAF`)

数据源：**Department of Home Affairs**。该数据源会返回人像照片，因此系统会采集自拍照，对其执行无感活体检测，并在查询过程中将其与该人像照片进行人脸比对。

| 采集项 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 13 位身份证号 | `national_id` | 是 | 恰好 13 个字符；仅限数字；LUHN 校验和 |
| 名 | `first_name` | 是 | — |
| 姓 | `last_name` | 是 | — |
| 自拍照 | `selfie` | 是 | — |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 公民身份 | `citizenship` | 否 |
| 证件状态（有效、已故或已封禁） | `id_status` | 是 |
| 登记人像照片 | `registry_portrait` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 瑞典 (`SWE`)

数据源：**Skatteverket population register**。该数据源仅返回数据，因此没有可用于人脸比对的人像照片：工作流后续的人脸比对步骤对以此方式验证的用户将无可比对对象。

| 采集项 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 名 | `first_name` | 是 | — |
| 姓 | `last_name` | 是 | — |
| 出生日期 | `date_of_birth` | 是 | — |
| 国民身份证号 | `national_id` | 是 | 模式 `(\d{10}\|\d{12})`；仅限数字 |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 泰国 (`THA`)

数据源：**DOPA civil registration**。该数据源仅返回数据，因此没有可用于人脸比对的人像照片：工作流后续的人脸比对步骤对以此方式验证的用户将无可比对对象。

| 采集项 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 名 | `first_name` | 是 | — |
| 姓 | `last_name` | 是 | — |
| 出生日期 | `date_of_birth` | 是 | — |
| 泰国国民身份证号 | `national_id` | 是 | 恰好 13 个字符；仅限数字 |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 英国 (`GBR`)

数据源：**英国征信机构和金融服务记录**。该数据源仅返回数据，因此没有可用于人脸比对的人像照片：工作流后续的人脸比对步骤对以此方式验证的用户将无可比对对象。

| 采集项 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 名 | `first_name` | 是 | — |
| 姓 | `last_name` | 是 | — |
| 出生日期 | `date_of_birth` | 是 | — |
| 居住地址 | `address` | 是 | — |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名匹配（精确匹配、部分匹配或无匹配） | `name_match` | 是 |
| 出生日期匹配 | `date_of_birth_match` | 是 |
| 地址匹配 | `address_match` | 是 |
| 确认该身份的数据源数量 | `sources_confirming` | 是 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 美国 (`USA`)

数据源：**美国征信机构和金融服务记录**。该数据源仅返回数据，因此没有可用于人脸比对的人像照片：工作流后续的人脸比对步骤对以此方式验证的用户将无可比对对象。

| 采集项 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 名 | `first_name` | 是 | — |
| 姓 | `last_name` | 是 | — |
| 出生日期 | `date_of_birth` | 是 | — |
| 居住地址 | `address` | 是 | — |
| 社会安全号（后 4 位或完整号码） | `ssn` | 否 | 4-9 个字符；仅限数字 |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名匹配（精确匹配、部分匹配或无匹配） | `name_match` | 是 |
| 出生日期匹配 | `date_of_birth_match` | 是 |
| 地址匹配 | `address_match` | 是 |
| 确认该身份的数据源数量 | `sources_confirming` | 是 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 乌拉圭 (`URY`)

数据源：**Dirección Nacional del Registro de Estado Civil**。该数据源仅返回数据，因此没有可用于人脸比对的人像照片：工作流后续的人脸比对步骤对以此方式验证的用户将无可比对对象。

| 采集项 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 乌拉圭 CI | `personal_number` | 是 | 7-9 个字符；仅限数字 |
| 出生日期 | `date_of_birth` | 是 | — |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 委内瑞拉 (`VEN`)

数据源：**CNE**。该数据源仅返回数据，因此没有可用于人脸比对的人像照片：工作流后续的人脸比对步骤对以此方式验证的用户将无可比对对象。

| 要求填写项 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 委内瑞拉 Cédula | `document_number` | 是 | 模式 `[VvEe]?-?\d{6,10}`；6-12 个字符 |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

#### 赞比亚 (`ZMB`)

数据源：**Zambia Revenue Authority**。该数据源仅返回数据，因此没有用于人脸比对的肖像照片：通过这种方式验证的用户，工作流后续的人脸比对步骤将无可比对对象。

| 要求填写项 | 字段键 | 必填 | 格式检查 |
| - | - | - | - |
| 国民身份证号 | `national_id` | 是 | 模式 `\d{6}/?\d{2}/?\d`；转为大写 |
| 名 | `first_name` | 是 | — |
| 姓 | `last_name` | 是 | — |

| 返回项 | 字段键 | 必填 |
| - | - | - |
| 姓名 | `full_name` | 是 |
| 出生日期 | `date_of_birth` | 是 |
| 性别 | `gender` | 否 |
| 地址 | `address` | 否 |
| 记录状态 | `record_status` | 否 |
| 数据源名称 | `source_name` | 否 |
| 查询时间 | `queried_at` | 否 |

## 同意

部分数据源只有在获得当事人明确同意后方可进行查询，且各国适用的同意制度各有不同 — 例如南非的 POPIA、尼日利亚的 NDPR、巴西的 LGPD、英国的 UK GDPR、美国 GLBA 规定的允许用途等。适用于各个数据源的合规制度详见上方的覆盖范围表。

您是此类同意的控制者。您需要在自己的流程中收集该同意，或在身份证件步骤之前添加一个[问卷](https://docs.didit.me/zh/core-technology/questionnaires/overview.md)步骤，并保存相关记录 — Didit 仅执行您请求的查询，不会判断您是否有权发起该查询。若某个国家/地区的数据源有其特定的同意措辞要求，验证界面会在执行查询前向用户展示该措辞。

## 尝试次数、结果与计费

每次获得应答的查询均计为一次尝试。`max_attempts` 为 1 到 5，默认值为 1。

| 结果 | 计为一次尝试 | 计费 | 后续操作 |
| - | - | - | - |
| `match` | 是 | 是 | 登记机构的记录将作为身份证件验证结果，工作流继续执行。 |
| `partial_match` | 是 | 是 | 在剩余尝试次数内重试，用尽后执行 `on_partial_match`。 |
| `no_match` | 是 | 是 | 在剩余尝试次数内重试，用尽后执行 `on_no_match`。 |
| `provider_error` | 否 | 否 | 提示用户重试。在该步骤出现三次未应答查询后，执行 `on_provider_error`。 |
| `format_rejected` | 否 | 否 | 提示用户修正该字段。请求从未发送至登记机构。 |

每次计费的已应答尝试都会汇总返回匹配、部分匹配或不匹配的服务零售费率。重试属于新的尝试，可能会产生额外费用。以提供商错误告终的尝试不予计费。格式被拒绝不予计费。

如果查询回退到证件采集，已完成的证件检查将单独计费。停用回退将直接拒绝该会话；但不会退还已完成查询的费用。沙盒场景可以模拟各种结果，不会产生付费的登记机构查询或用量扣费。

## 会话中生成的内容

匹配成功的查询将以与证件读取相同的方式填充身份证件验证结果 — 姓名、出生日期和国民身份标识符 — 并添加一个 `id_lookup` 证据块：

```json theme={null}
{
  "node_id": "feature_ocr_1",
  "status": "Approved",
  "verification_method": "id_lookup",
  "assurance": "data_match",
  "wallet_provider": null,
  "fallback_from": null,
  "id_lookup": {
    "source": "Department of Home Affairs",
    "checked_at": "2026-09-04T09:12:44Z",
    "attempts": 1,
    "max_attempts": 2,
    "outcome": "match",
    "comparison": [
      { "field": "identification_number", "label": "ID number", "provided": "9106155043088", "record": "9106155043088", "result": "match" },
      { "field": "full_name", "label": "Full name", "provided": "Thabo Mokoena", "record": "Thabo Mokoena", "result": "match" },
      { "field": "date_of_birth", "label": "Date of birth", "provided": "1991-06-15", "record": "1991-06-15", "result": "match" }
    ],
    "registry_portrait": "https://<media-host>/registry_portrait.jpg",
    "face_match_score": 96.4,
    "source_errors": []
  },
  "wallet_verification": null
}
```

`comparison` 为每个可比对字段包含一行，`result` 为 `match`、`partial` 或 `no_match`，以便审核员清楚查看哪个字段不一致。各行的名称已标准化 — `identification_number`、`full_name`、`date_of_birth`、`address` — 而非使用该国家/地区请求字段的键，因为名和姓会作为统一的姓名进行比对，各类标识符别名也会作为统一的编号进行比对。

当前的预发布环境响应将数据源失败保存在单独的 `source_errors` 数组中。如果数据源提供了相关信息，其条目可包含 `service_id`、`code`、`message`、`details` 和 `outcome_detail`。请将这些信息视为查询诊断信息，而非身份不匹配。早期版本可能会将数据源失败表示为 `result: "error"` 的 `comparison` 行；请确认您目标环境中部署的接口契约。

仅当数据源返回肖像照片且选定的响应字段保留了该照片时，才会包含 `registry_portrait`；此时 `face_match_score` 为自拍照与该肖像照片的比对分数。自行核验自拍照的数据源（如阿根廷 RENAPER、尼日利亚）不会返回肖像照片，`face_match_score` 为其自身核验所报告的分数。

完整的字段类型请参阅[身份证件验证数据模型](https://docs.didit.me/zh/reference/data-models.md#身份证件验证)。

## 数据保留

产生匹配的数据源记录将作为身份证件验证结果保存，并遵循您组织的[数据保留](https://docs.didit.me/zh/console/data-retention.md)设置，与证件读取完全相同。删除会话即可将其删除；详见[删除会话](https://docs.didit.me/zh/sessions-api/delete-session.md)。

> [!WARNING]
>
> 当前的预发布环境实现将 `id_lookup.response_fields` 应用于比对输出、可选的性别以及保留的登记机构肖像照片。必填身份字段仍保留在验证记录中。这并不能保证所有中间提供商 payload 均从处理流程中排除。尚未验证此项变更在生产环境中的发布；在依赖字段选择以满足数据保留要求之前，请确认您目标环境中的具体表现。

## 相关内容

* [身份证件验证方式](https://docs.didit.me/zh/core-technology/id-verification/verification-methods.md) — 三种方式、回退与计费
* [数字身份钱包](https://docs.didit.me/zh/core-technology/id-verification/digital-id-wallets.md) — 基于密码学的方式
* [数据库核验](https://docs.didit.me/zh/core-technology/database-validation/overview.md) — 用于将已采集证件与数据源比对的独立功能
* [工作流功能配置](https://docs.didit.me/zh/management-api/workflows/feature-configs.md#ocr-/-身份证件验证) — `methods` 键参考指南


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