墨西哥专属能力。使用用户的 CURP 查询国家人口登记处 RENAPO,并在 idGov 块中返回登记记录。
功能说明
该能力使用用户的 CURP 查询墨西哥国家人口登记处 RENAPO,并在 idGov 块中返回登记记录。该块仅为数据,不会取代或更改身份验证结果。
输入项
| 所需集成组件 | CURP 的传入位置 |
|---|---|
| API Web or SDK | person.duiType: "DUI_TYPE_MX_CURP"(墨西哥 CURP,请参见 duiType 取值)和 person.duiValue |
您还需要一个包含 RENAPO Verification 的配方,并且租户需预先开通该能力(需与 Unico Onboarding 团队协商)。
可能的响应
当 RENAPO 返回的字段为空时,下方所有字符串值都可能为空。
| 字段 | 类型 | 描述 |
|---|---|---|
government_valid | boolean | RENAPO 对该 CURP 的答复。并非生物特征结果。 |
curp | string | 18 个字符。 |
government_name | string | 登记的全名。 |
date_of_birth | string | YYYY-MM-DD。 |
age | integer | 在查询时计算。请勿将其作为固定属性存储。 |
gender | string | F 或 M。CURP 第 11 位使用 H/M(hombre/mujer,即男/女),因此女性记录在此处显示为 F,而在 CURP 内部显示为 M。 |
deceased | boolean | |
is_mexican | boolean | |
citizenship | string | |
state_of_birth | string | |
state_iso | string | ISO 3166-2,例如 MX-CMX。 |
issuing_entity_code | string | RENAPO 目录代码,两个字母。墨西哥城为 DF,因此按设计与 state_iso 不一致。 |
municipality_registration | string | 登记所在市的代码。可能为空。 |
空块并非否定答复
当 RENAPO 未响应时,idGov 返回 {}。请将其视为“未验证”,而不是 government_valid: false。
RENAPO Verification 不决定流程结果
government_valid 与身份验证结果是相互独立的答复。CURP 有效并不意味着自拍中的人就是其持有人。
可用性
| 所需集成组件 |
|---|
| API Web or SDK |
需要开通权限
即使在支持的接入方式上,租户也需要开通 RENAPO Verification。如果您的业务尚未获得访问权限,请联系 Unico 的 Onboarding 团队。
有效组合
RENAPO Verification 仅在同时运行身份验证的配方中返回。它不单独销售。
| 配方 | 所需集成组件 |
|---|---|
id_r2-idgov-r2 | API Web or SDK |
idtrust_r2-idgov | API Web or SDK |
idtrustdocs_r2-idgov | API Web or SDK |
配方名称可能变更
使用 RENAPO Verification 的配方名称为暂定名称。在配置集成之前,请先与 Unico Onboarding 团队确认名称。
完整矩阵请参阅可用流程。