メキシコに特化したCapability。ユーザーのCURPを使って国民人口登録機関であるRENAPOに照会し、登録レコードを idGov ブロックで返します。
機能概要
このCapabilityは、ユーザーのCURPを使ってメキシコの国民人口登録機関であるRENAPOに照会し、登録レコードを idGov ブロックで返します。このブロックはデータであり、本人確認の結果を置き換えたり変更したりするものではありません。
入力
| コントラクト | CURPを設定する場所 |
|---|---|
| API | subject.duiType: 2(メキシコのCURP、duiType の値を参照)および subject.code |
| Web & SDK | person.duiType: "DUI_TYPE_MX_CURP" および person.duiValue |
また、RENAPO検証を含むレシピと、テナントに対する事前の有効化(Unico Onboardingチームとの協議が必要)も必要です。
返却される可能性のあるレスポンス
以下の文字列値は、RENAPOがフィールドを空で返した場合、空になることがあります。
| フィールド | 型 | 説明 |
|---|---|---|
government_valid | boolean | CURPに対するRENAPOの回答。バイオメトリクスの結果ではありません。 |
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のカタログコード(2文字)。メキシコシティは DF のため、仕様上 state_iso とは一致しません 。 |
municipality_registration | string | 登録地の市区町村コード。空の場合があります。 |
空のブロックは否定的な回答ではありません
RENAPOが応答しない場合、idGov は {} を返します。これは government_valid: false ではなく「未検証」として扱ってください。
RENAPO検証はプロセスの判定を行いません
government_valid と本人確認の結果は別個の回答です。CURPが有効であっても、セルフィーに写っている人物がその所有者であることを意味しません。
対応状況
| サーフェス | 対応 |
|---|---|
| SDK | ✅ |
| Web | ✅ |
| API | ✅ |
有効化が必要
対応サーフェスであっても、テナントがRENAPO検証に対して有効化されている必要があります。まだアクセスできない場合は、UnicoのOnboardingチームにお問い合わせください。
有効な組み合わせ
RENAPO検証は、本人確認も実行するレシピでのみ返されます。単独では提供されていません。
| レシピ | コントラクト |
|---|---|
unico-id-idgov-trust-decision | API |
idtrust_r2-idgov | Web & SDK |
idtrustdocs_r2-idgov | Web & SDK |
レシピ名は変更される可能性があります
RENAPO検証を含むレシピの名称は暫定です。統合を設定する前に、Unico Onboardingチームに名称をご確認ください。
完全なマトリクスについては、利用可能なフローを参照してください。