メインコンテンツへスキップ

Cardholder Verification

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

機能の概要​

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

カード非提示認証とは異なります

このケイパビリティは、カード非提示認証製品とは異なるインテグレーション方式です。

入力​

  • ドキュメントタイプを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経由でトリガーされます。これはAPIキーごとにRecipe（またはcapabilities_enabled）を通じて有効化され、flowフィールドでは有効化されません。

考えられるレスポンス​

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

利用可能なサーフェス​

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

有効な組み合わせ​

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

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

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

最終更新 に