Cara membaca hasil verifikasi
Hasil sebuah session adalah sebuah status ditambah hasil per pemeriksaan ditambah daftar warning - warning adalah bagian yang memberi tahu Anda apa yang sebenarnya terjadi.
Baca dengan urutan ini: status keseluruhan, lalu status per pemeriksaan, lalu warning. Warning adalah satu-satunya bagian yang memberi tahu Anda mengapa - segala sesuatu yang lain hanya memberi tahu Anda apa.
Buka session mana pun dari Verifications di Konsol Bisnis dan Anda mendapatkan tiga lapisan yang sama, baik Anda melihat konsol, sebuah payload webhook, atau respons API.
- Mulai dari sini: decision, dan pemeriksaan yang menghasilkannya.
- Liveness menampung hasil swafoto dan skor pencocokan wajah.
- Tab dokumen menunjukkan apa yang diekstrak dan field mana yang cocok.
- Events menjelaskan bagaimana session mencapai statusnya saat ini.
#Lapisan 1 - status keseluruhan
Putusan tunggal untuk session tersebut: Approved, Declined, In Review, dan seterusnya. Inilah yang paling sering menjadi dasar tindakan integrasi Anda. Ini adalah agregat: berasal dari menggabungkan hasil setiap pemeriksaan sesuai konfigurasi workflow Anda, sehingga tidak pernah memberi tahu Anda pemeriksaan mana yang menjadi penyebabnya.
#Lapisan 2 - satu hasil per pemeriksaan
Setiap pemeriksaan yang dijalankan memiliki status dan datanya sendiri. Yang paling sering Anda lihat:
| Pemeriksaan | Apa yang perlu dilihat |
|---|---|
| ID verification | Field yang diekstrak (nama, nomor dokumen, tanggal), jenis dokumen dan negara, serta apakah MRZ tervalidasi |
| Passive / active liveness | Apakah manusia hidup terdeteksi, dan sinyal serangan apa pun |
| Face match 1:1 | Skor kemiripan antara swafoto dan foto dokumen |
| Face search 1:N | Apakah wajah ini cocok dengan pengguna yang sudah terverifikasi atau entri blocklist |
| AML screening | Hit-nya, masing-masing dengan skor kecocokan dan skor risiko |
| Device and IP analysis | Negara, sinyal VPN atau proxy, alamat yang masuk blocklist |
| Proof of address | Alamat yang diekstrak dan seberapa cocok dengan yang Anda berikan |
| NFC | Apakah chip berhasil dibaca dan apakah tanda tangannya terhubung ke penerbit yang tepercaya |
| Phone / email | Apakah OTP terkonfirmasi, ditambah sinyal risiko pada nomor atau alamat tersebut |
Sebuah pemeriksaan bisa Approved sementara session-nya Declined, dan sebaliknya. Itu normal - status session adalah gabungan, bukan skenario terburuk.
#Lapisan 3 - warning
Warning adalah lapisan yang benar-benar menjelaskan hasilnya. Setiap warning adalah kode bernama spesifik yang melekat pada pemeriksaan yang memunculkannya - misalnya:
DOCUMENT_EXPIRED- tanggal kedaluwarsa ID sudah lewat.MRZ_VALIDATION_FAILED- checksum zona terbaca-mesin tidak cocok. Sinyal pemalsuan yang kuat.LOW_FACE_MATCH_SIMILARITY- swafoto dan foto dokumen mendapat skor di bawah ambang batas Anda.LIVENESS_FACE_ATTACK- serangan presentasi terdeteksi selama pengambilan swafoto.POSSIBLE_MATCH_FOUND- AML menemukan kandidat hit yang perlu diselesaikan.NFC_DATA_DOES_NOT_MATCH_OCR- chip dan data cetak tidak sesuai.IP_ADDRESS_IN_BLOCKLIST- koneksi berasal dari alamat yang Anda blokir.
Ketika Anda sedang men-debug satu session tertentu, langsung saja ke warning-nya. Status memberi tahu Anda kesimpulannya; warning memberi tahu Anda buktinya. Setiap katalog warning per feature didokumentasikan di core technology.
#Data yang diekstrak vs. apa yang Anda harapkan
Jika Anda mengirim expected_details saat membuat session - sebuah nama, tanggal lahir, nomor dokumen yang sudah Anda miliki - hasilnya juga memberi tahu Anda apakah dokumen tersebut sesuai dengannya. Ketidaksesuaian di sana biasanya adalah masalah kesalahan input data di sisi Anda, bukan dokumen palsu, jadi sebaiknya diperiksa dulu sebelum Anda menolak siapa pun.
Nama yang diekstrak bisa ditransliterasikan. Dokumen dalam aksara Cyrillic, Arab, atau Yunani menghasilkan nama beraksara Latin yang mungkin tidak cocok dengan catatan Anda karakter demi karakter meskipun itu orang yang sama. Bandingkan juga dengan nomor dokumen atau tanggal lahir sebelum menganggap ketidakcocokan nama sebagai penipuan.
#Hasil sandbox terlihat sedikit berbeda
Dalam sebuah session sandbox, konsol menandai bagian data yang diekstrak dengan chip Simulated data. Media benar-benar direkam, tetapi field dan hasilnya berasal dari skenario yang Anda pilih - jadi jangan menyimpulkan apa pun dari nilai-nilainya sendiri. Lihat menguji di sandbox.
#Mendapatkan hal yang sama secara terprogram
Payload webhook dan GET /v3/session/{id}/decision/ membawa ketiga lapisan tersebut dalam satu objek decision. Perlakukan webhook sebagai sumber kebenaran Anda dan lakukan polling hanya untuk rekonsiliasi - beberapa event, seperti perubahan data yang dilakukan reviewer, hanya pernah tiba lewat webhook. Lihat mendapatkan hasil dengan webhook.
#Mendapatkan salinan untuk catatan Anda
Untuk audit dan pengajuan regulasi, unduh session sebagai PDF - laporan ini menggabungkan setiap langkah, data yang diekstrak, skor biometrik, hasil AML, dan keputusan akhir. Lihat mengunduh laporan verifikasi.