---
title: Cardholder Verification
description: 이전에 검증된 프로세스를 해당 사람의 CPF 및 카드 데이터와 함께 재사용하여 카드가 신고된 소지자에게 속하는지 확인하는 기능입니다.
canonical: https://developer.unico.io/ko/dual-api/capabilities/cardholder-verification
locale: ko
generated_by: markdown-export
---

Cardholder Verification은 카드가 신고된 소지자에게 속하는지 확인합니다 — 시각적 캡처 단계 없이 전적으로 백엔드에서 처리됩니다.

### 기능 설명

CPF와 제시된 카드가 동일인의 것인지 확인합니다 — 카드 미제시(card-not-present) 소유권 확인입니다. 이 기능은 이전에 검증된 프로세스(해당 id인 `referenceProcessId`로 참조됨)를 해당 사람의 CPF 및 카드 데이터(`bin`/`last4`)와 함께 재사용하여, 새로운 캡처 단계를 실행하지 않고 확인을 바로 수행합니다.

:::note[비대면 카드 검증과 다름]
이 기능은 [비대면 카드 검증](/products/regional-solutions/card-not-present-verification/index) 제품과는 다른 통합 인터페이스입니다.
:::

### 입력값

- `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`](/dual-api/developers/api-reference/api/post-processes)를 통해 트리거됩니다. 이 기능은 `flow` 필드가 아니라 Recipe(또는 `capabilities_enabled`)를 통해 API 키별로 활성화됩니다.

### 가능한 응답

| 응답 | 의미 |
|---|---|
| `approved` | CPF와 카드가 동일인의 것입니다. |
| `unsure` | 재사용할 유효한 프로세스가 없거나, 검증 자체가 결론에 이르지 못했습니다. |
| _(생략됨)_ | 동기 호출 내에서 검증이 완료되지 않았습니다. [프로세스 조회](/dual-api/developers/api-reference/api/get-process) 응답에 `cardholderVerification` 필드가 없으며, `status`는 프로세스가 아직 처리 중임을 나타냅니다. |

### 가용성

| 인터페이스 | 지원 여부 |
|---|:-:|
| **SDK** (Android, iOS, Flutter) | ❌ 백엔드 전용 기능, 캡처 단계 없음 |
| **Web** (iFrame, Redirect) | ❌ 백엔드 전용 기능, 캡처 단계 없음 |
| **API** (헤드리스, SDK 없음) | ✅ |

### 유효한 조합

Cardholder Verification은 미리 구성된 `flow` 카탈로그에 포함되어 있지 않습니다 — [사용 가능한 플로우](/dual-api/capabilities/available-flows)의 플로우와는 독립적으로, API 키의 Recipe(또는 IDCloud가 아닌 키의 경우 `capabilities_enabled`)에서 직접 활성화됩니다.

### 이 기능을 사용하는 제품

이 기능을 참조하는 공개된 사용 사례가 아직 없습니다.