Cardholder Verification

Cardholder Verification memastikan bahwa sebuah kartu adalah milik pemegang yang dinyatakan — seluruhnya back-end, tanpa langkah pengambilan visual.

Apa yang dilakukannya

Memastikan bahwa CPF dan kartu yang disajikan adalah milik orang yang sama — sebuah pemeriksaan kepemilikan kartu tanpa kehadiran fisik (card-not-present). Kemampuan ini menggunakan kembali proses yang telah divalidasi sebelumnya (dirujuk melalui id-nya, referenceProcessId) bersama dengan CPF dan data kartu (bin/last4) orang tersebut untuk menjawab pemeriksaan secara langsung, tanpa menjalankan langkah pengambilan baru.

Bukan hal yang sama dengan Verifikasi Kartu Tidak Hadir

Kemampuan ini adalah integration surface yang berbeda dari produk Verifikasi Kartu Tidak Hadir.

Input

• Jenis dokumen, dikirim melalui subject.duiType (saat ini hanya DUI_TYPE_BR_CPF), dan nilai CPF melalui subject.code.
• card: bin (6 atau 8 digit pertama kartu) dan last4 (4 digit terakhir), name bersifat opsional.
• referenceProcessId — id dari proses yang telah divalidasi sebelumnya yang digunakan kembali, di mana identitas orang ini sudah dikonfirmasi (Verifikasi Identitas atau Deteksi Kehidupan). Versi kemampuan ini saat ini berbasis penggunaan kembali: tanpa field ini, gate tidak akan pernah dipicu dan respons akan default ke hasil unsure standar — permintaan itu sendiri tidak akan pernah gagal.
• Dipicu melalui POST /processes/v1 dengan Recipe (API key) yang menyertakan Cardholder Verification. Kemampuan ini diaktifkan per API key melalui Recipe (atau capabilities_enabled), bukan melalui field flow.

Kemungkinan respons

Respons	Arti
approved	CPF dan kartu adalah milik orang yang sama.
unsure	Tidak ada proses valid yang dapat digunakan kembali, atau verifikasinya sendiri tidak konklusif.
(dihilangkan)	Verifikasi tidak selesai dalam panggilan sinkron. Field cardholderVerification tidak ada dalam respons Dapatkan Proses, dan status menunjukkan bahwa proses masih diproses.

Ketersediaan

Permukaan	Didukung
SDK (Android, iOS, Flutter)	❌ Kemampuan khusus backend, tanpa langkah pengambilan
Web (iFrame, Redirect)	❌ Kemampuan khusus backend, tanpa langkah pengambilan
API (headless, tanpa SDK)	✅

Kombinasi yang valid

Cardholder Verification bukan bagian dari katalog flow yang telah dikomposisikan sebelumnya — kemampuan ini diaktifkan langsung pada Recipe API key (atau capabilities_enabled, untuk key non-IDCloud), secara independen dari alur-alur di Alur yang tersedia.

Kasus penggunaan yang menggunakan kemampuan ini

Belum ada kasus penggunaan yang dipublikasikan yang merujuk pada kemampuan ini.