Cardholder Verification
Cardholder Verification은 카드가 신고된 소지자에게 속하는지 확인합니다 — 시각적 캡처 단계 없이 전적으로 백엔드에서 처리됩니다.
기능 설명
CPF와 제시된 카드가 동일인의 것인지 확인합니다 — 카드 미제시(card-not-present) 소유권 확인입니다. 이 기능은 이전에 검증된 프로세스(해당 id인 referenceProcessId로 참조됨)를 해당 사람의 CPF 및 카드 데이터(bin/last4)와 함께 재사용하여, 새로운 캡처 단계를 실행하지 않고 확인을 바로 수행합니다.
비대면 카드 검증과 다름
이 기능은 비대면 카드 검증 제품과는 다른 통합 인터페이스입니다.
입력값
subject.duiType를 통해 전송되는 문서 유형(현재는DUI_TYPE_BR_CPF만 지원)과subject.code를 통해 전송되는 CPF 값입니다.card:bin(카드의 처음 6자리 또는 8자리)과last4(마지막 4자리),name은 선택 사항입니다.referenceProcessId— 재사용되는, 이전에 검증된 프로세스의 id로, 해당 사람의 신원이 이미 확인된 프로세스입니다(신원 확인 또는 라이브니스). 이 기능의 현재 버전은 재사용 기반으로 동작합니다. 이 필드가 없으면 게이트가 트리거되지 않고, 응답은 기본적으로 표준unsure결과가 됩니다 — 요청 자체가 실패하는 것은 아닙니다.- Cardholder Verification이 포함된 Recipe(API 키)를 사용하여
POST /processes/v1를 통해 트리거됩니다. 이 기능은flow필드가 아니라 Recipe(또는capabilities_enabled)를 통해 API 키별로 활성화됩니다.
가능한 응답
| 응답 | 의미 |
|---|---|
approved | CPF와 카드가 동일인의 것입니다. |
unsure | 재사용할 유효한 프로세스가 없거나, 검증 자체가 결론에 이르지 못했습니다. |
| (생략됨) | 동기 호출 내에서 검증이 완료되지 않았습니다. 프로세스 조회 응답에 cardholderVerification 필드가 없으며, status는 프로세스가 아직 처리 중임을 나타냅니다. |
가용성
| 인터페이스 | 지원 여부 |
|---|---|
| SDK (Android, iOS, Flutter) | ❌ 백엔드 전용 기능, 캡처 단계 없음 |
| Web (iFrame, Redirect) | ❌ 백엔드 전용 기능, 캡처 단계 없음 |
| API (헤드리스, SDK 없음) | ✅ |
유효한 조합
Cardholder Verification은 미리 구성된 flow 카탈로그에 포함되어 있지 않습니다 — 사용 가능한 플로우의 플로우와는 독립적으로, API 키의 Recipe(또는 IDCloud가 아닌 키의 경우 capabilities_enabled)에서 직접 활성화됩니다.
이 기능을 사용하는 제품
이 기능을 참조하는 공개된 사용 사례가 아직 없습니다.