---
title: Cardholder Verification
description: カードが申告された保有者のものであることを、以前に検証済みのプロセスと本人のCPFおよびカード情報を組み合わせて再利用することで確認するケイパビリティ。
canonical: https://developer.unico.io/ja/dual-api/capabilities/cardholder-verification
locale: ja
generated_by: markdown-export
---

Cardholder Verificationは、カードが申告された保有者のものであることを確認します — 完全にバックエンドで処理され、視覚的なキャプチャステップはありません。

### 機能の概要

提示されたCPFとカードが同一人物のものであることを確認します — カード非提示のオーナーシップチェックです。以前に検証済みのプロセス（idで参照、`referenceProcessId`）と本人のCPFおよびカード情報（`bin`/`last4`）を組み合わせて、新たなキャプチャステップを実行せずにチェックへ直接回答します。

:::note[カード非提示認証とは異なります]
このケイパビリティは、[カード非提示認証](/products/regional-solutions/card-not-present-verification/index)製品とは異なるインテグレーション方式です。
:::

### 入力

- ドキュメントタイプを`subject.duiType`で送信します（現在は`DUI_TYPE_BR_CPF`のみ）。CPFの値は`subject.code`で送信します。
- `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)経由でトリガーされます。これはAPIキーごとにRecipe（または`capabilities_enabled`）を通じて有効化され、`flow`フィールドでは有効化されません。

### 考えられるレスポンス

| レスポンス | 意味 |
|---|---|
| `approved` | CPFとカードが同一人物のものである場合。 |
| `unsure` | 再利用できる有効なプロセスがない場合、または検証自体が結論に至らなかった場合。 |
| _(省略)_ | 同期呼び出し内で検証が完了しなかった場合。[Get Process](/dual-api/developers/api-reference/api/get-process)のレスポンスに`cardholderVerification`フィールドが存在せず、`status`はプロセスが処理中であることを示します。 |

### 利用可能なサーフェス

| サーフェス | 対応 |
|---|:-:|
| **SDK**（Android、iOS、Flutter） | ❌ バックエンド専用のケイパビリティで、キャプチャステップがありません |
| **Web**（iFrame、リダイレクト） | ❌ バックエンド専用のケイパビリティで、キャプチャステップがありません |
| **API**（ヘッドレス、SDK不使用） | ✅ |

### 有効な組み合わせ

Cardholder Verificationは事前構成された`flow`カタログには含まれません — APIキーのRecipe（非IDCloudキーの場合は`capabilities_enabled`）上で直接有効化され、[利用可能なフロー](/dual-api/capabilities/available-flows)のフローとは独立しています。

### このケイパビリティを使用するユースケース

このケイパビリティを参照する公開済みのユースケースはまだありません。