멕시코 전용 기능입니다. 국가 인구 등록부인 RENAPO에 사용자의 CURP로 조회하여 idGov 블록으로 등록부 기록을 반환합니다.
기능 설명
이 기능은 멕시코의 국가 인구 등록부인 RENAPO에 사용자의 CURP로 조회하여 idGov 블록으로 등록부 기록을 반환합니다. 이 블록은 데이터이며, 신원 확인 결과를 대체하거나 변경하지 않습니다.
입력값
| 계약 | CURP를 전달하는 위치 |
|---|---|
| API | subject.duiType: 2(멕시코 CURP, duiType 값 참조) 및 subject.code |
| Web & SDK | person.duiType: "DUI_TYPE_MX_CURP" 및 person.duiValue |
또한 RENAPO Verification이 포함된 레시피와 테넌트에 대한 사전 활성화가 필요하며, 이는 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 카탈로그 코드, 두 글자. 멕시코시티는 DF이므로 설계상 state_iso와 일치하지 않습니다. |
municipality_registration | string | 등록 지방자치단체 코드. 비어 있을 수 있습니다. |
RENAPO가 응답하지 않으면 idGov는 {}를 반환합니다. 이를 government_valid: false가 아니라 "검증되지 않음"으로 처리하세요.
government_valid와 신원 확인 결과는 별개의 응답입니다. 유효한 CURP라고 해서 셀피 속 인물이 그 소유자라는 뜻은 아닙니다.
가용성
| 인터페이스 | 지원 여부 |
|---|---|
| SDK | ✅ |
| Web | ✅ |
| API | ✅ |
지원되는 환경에서도 테넌트가 RENAPO Verification에 대해 활성화되어 있어야 합니다. 해당 기능에 대한 접근 권한이 없는 경우 Unico Onboarding 팀에 문의하세요.
유효한 조합
RENAPO Verification은 신원 확인도 함께 실행하는 레시피에서만 반환됩니다. 단독으로 판매되지 않습니다.
| 레시피 | 계약 |
|---|---|
unico-id-idgov-trust-decision | API |
idtrust_r2-idgov | Web & SDK |
idtrustdocs_r2-idgov | Web & SDK |
RENAPO Verification이 포함된 레시피의 이름은 임시입니다. 통합을 구성하기 전에 Unico Onboarding 팀에 이름을 확인하세요.
전체 매트릭스는 사용 가능한 플로우를 참조하세요.