Lewati ke konten utama

Verifikasi Senyap

Verifikasi Senyap memungkinkan identitas yang kembali dan telah tervalidasi sebelumnya menyelesaikan transaksi Verifikasi Kartu Tidak Hadir tanpa layar capture yang terlihat. Alih-alih meminta selfie baru dari pengguna, teknologi Unico mengevaluasi sinyal dan rekurensi di latar belakang untuk memutuskan apakah transaksi dapat disetujui secara senyap.

Verifikasi Senyap bukan produk terpisah — ini adalah langkah tambahan di atas alur pembuatan transaksi yang sama yang dijelaskan di Transaksi pembayaran dan Onboarding kartu kredit. Mengumpulkan sinyal konteks dengan SDK dan mengirim kunci eksternal yang sama saat membuat transaksi adalah yang memungkinkan persetujuan senyap.

Kapan ini berlaku
  • Verifikasi Senyap berlaku ketika ada cukup riwayat bagi teknologi Unico untuk mengevaluasi identitas melalui sinyal.
  • Ketika evaluasi tersebut tidak memungkinkan — karena kurangnya riwayat atau alasan lain — transaksi akan kembali ke alur visual standar. Ini dapat terjadi, misalnya, saat identitas tertentu terlihat untuk pertama kalinya di jaringan.
1. Kumpulkan metadata perangkat dengan SDK

Instal dan inisialisasi Capture SDK untuk platform Anda seperti biasa — Verifikasi Senyap tidak mengubah pengaturan tersebut. Ikuti panduan Pengumpulan Data Monitoring platform untuk mengirim externalUserId:

informasi

Flutter belum didukung untuk Verifikasi Senyap.

Ini bukan hanya metadata observabilitas di sini

Panduan Pengumpulan Data Monitoring menjelaskan externalUserId sebagai telemetri opsional yang "tidak mengubah perilaku capture SDK atau respons API." Itu benar untuk SDK itu sendiri. Di Verifikasi Kartu Tidak Hadir, field yang sama ini adalah yang digunakan backend untuk memutuskan apakah transaksi dapat disetujui secara diam-diam. Mengirimnya adalah yang mengaktifkan Verifikasi Senyap untuk transaksi tersebut — field ini tidak pasif di sini.

Dua penyesuaian pada pengaturan capture standar diperlukan untuk menjaga alur tetap senyap:

  • Mobile (Android / iOS): gunakan overload prepareCamera / prepareSelfieCamera yang menerima objek PrepareInfo dengan externalUserId, dan jangan memanggil metode pembuka kamera di dalam success callback — kecuali Anda memang menginginkan alur visual penuh untuk sesi tersebut.
unicoCheckCamera.prepareCamera(unicoConfig, object : CameraListener {
override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Camera?) {
// Tidak perlu memanggil cameraOpener?.open() di sini — pengumpulan latar belakang sudah dimulai.
}
override fun onCameraFailed(message: String?) { /* handle error */ }
}, PrepareInfo("YOUR_EXTERNAL_USER_ID"))
  • Web: panggil setSilentInfo(externalUserId, useCase) pada instance UnicoCheckBuilder sebelum memanggil prepareCamera / prepareSelfieCamera, dan demikian pula lewati pembukaan kamera di success callback.
unicoCamera.setSilentInfo("YOUR_EXTERNAL_USER_ID");
await unicoCamera.prepareSelfieCamera(config, SelfieCameraTypes.SMART);
// Tidak perlu membuka kamera di sini — pengumpulan latar belakang sudah dimulai.
Jendela waktu

SDK mengumpulkan data di latar belakang, sehingga harus ada jeda minimum sebelum Anda membuat transaksi:

  • Mulai persiapan SDK minimal 4 detik sebelum memanggil API transaksi — terlalu cepat, dan pengumpulan mungkin belum selesai.
  • Data yang dikumpulkan valid selama hingga 5 menit — terlalu lama, dan data tersebut akan kedaluwarsa saat transaksi dibuat.
2. Buat transaksi dengan externalUserID yang sama

externalUserID bersifat opsional — tetapi tanpanya, Verifikasi Senyap tidak dapat terjadi untuk transaksi tersebut. Saat membuat transaksi — melalui Transaksi pembayaran atau Onboarding kartu kredit — kirim externalUserID yang sama persis dengan yang digunakan di SDK, di dalam additionalInfo:

{
"additionalInfo": {
"externalUserID": "YOUR_EXTERNAL_USER_ID"
}
}

Menghilangkannya tidak menyebabkan kesalahan apa pun — transaksi tetap dibuat secara normal, hanya saja selalu mengikuti alur standar dengan friksi visual.

3. Tangani respons

Jika transaksi memenuhi syarat dan disetujui secara diam-diam, tidak ada tindakan lebih lanjut yang diperlukan:

{
"id": "6ab1771e-dfab-4e47-8316-2452268e5481",
"status": "approved"
}

Jika tidak, respons akan menyertakan link untuk menyelesaikan alur visual standar, persis seperti transaksi yang dibuat tanpa Verifikasi Senyap:

{
"id": "6ab1771e-dfab-4e47-8316-2452268e5481",
"status": "waiting",
"link": "https://aces.so/example",
"token": "eyJhbGciOiJIUzI1NiIsInR5cC[...]Ok6yJV_adQssw5c"
}

Untuk status lainnya, ikuti alur standar menggunakan link yang dikembalikan — lihat Mengendalikan pengalaman dan Enumerasi untuk daftar lengkap status.