Pengambilan dokumen tidak berubah. Semua yang sudah Anda konfigurasikan melalui
documents_allowed — jenis yang diterima, subjenis, aturan pengambilan, ambang batas, peringatan — tetap berfungsi persis seperti sebelumnya, dan alur kerja yang tidak menentukan apa pun tentang metode akan tetap hanya menggunakan pengambilan dokumen.
Cara kerja setiap metode
Pengambilan dokumen
Hal yang didokumentasikan di sisa bagian ini: pengguna memotret dokumen, Didit membacanya, memeriksa keasliannya, dan mengembalikan kolom yang diekstraksi. Tersedia di setiap negara yang didukung Didit, seharga $0.15 per pemeriksaan. Mulai dari ringkasan Verifikasi Identitas.Pencarian tanpa dokumen
Pengguna mengetik nomor identitas nasional mereka dan beberapa detail pribadi, lalu Didit memeriksanya terhadap sumber otoritatif untuk negara tersebut. Tidak ada pemotretan dokumen yang terlibat. Sumber tersebut adalah registri pemerintah di sebagian besar negara, tetapi tidak di semuanya: di Kanada, Prancis, Indonesia, Belanda, Norwegia, Singapura, Inggris Raya, dan Amerika Serikat, sumber tersebut merupakan berkas biro kredit, layanan keuangan, utilitas, atau catatan tempat tinggal. Karena asal-usul data dan rezim persetujuan yang berlaku berbeda-beda, sumber pastinya disebutkan per negara pada tabel di bawah dan pada Pencarian tanpa dokumen — tidak pernah digeneralisasi. Jika sumber mengembalikan foto potret — Afrika Selatan, Nigeria, Argentina, dan Panama saat ini, keempatnya adalah registri pemerintah — pengguna juga diminta untuk mengambil swafoto. Deteksi liveness pasif dijalankan pada swafoto tersebut dan wajahnya dicocokkan dengan foto potret dari registri, semuanya di dalam proses pencarian dan seluruhnya termasuk dalam harga pencarian. Jika sumber hanya mengembalikan data, tidak ada yang dapat dicocokkan wajahnya, sehingga tidak ada swafoto yang diambil; jalankan Liveness dan Pencocokan Wajah sebagai langkah alur kerja tersendiri jika Anda membutuhkannya. Kolom permintaan lengkap per negara, aturan format, dan rezim persetujuan tercantum di Pencarian tanpa dokumen.Dompet
Pengguna masuk menggunakan identitas digital yang sudah mereka miliki, seperti eID nasional atau identitas bank. Dompet mengautentikasi mereka, lalu membagikan atribut identitas yang telah ditandatangani kepada Didit. Bergantung pada dompetnya, pengguna mungkin memasukkan kode identifikasi pribadi atau nomor telepon; tidak diperlukan foto dokumen untuk pemeriksaan dompet. Pengalaman masuk bergantung pada dompet yang digunakan: pengalihan aplikasi, kode QR, atau kode perbandingan yang dikonfirmasi di ponsel pengguna. Smart-ID dan Mobile-ID menggunakan kode perbandingan. Atribut untuk setiap dompet, ketersediaan di lingkungan produksi, dan semantik kegagalan tercantum di Dompet ID digital.Tingkat jaminan
Setiap hasil Verifikasi Identitas memuat tingkat jaminan yang diturunkan dari metode yang menghasilkannya. Tingkat ini merupakan deskripsi jujur tentang apa yang sebenarnya dibuktikan, bukan sebuah pemeringkatan:Tingkat jaminan adalah label yang ditujukan untuk admin. Label ini muncul pada payload sesi, di konsol, dan di ekspor. Pengguna akhir tidak pernah melihat tingkat jaminan, harga, atau nama sumber yang digunakan untuk kueri.
Mengonfigurasi metode per negara
Metode berada di bawah kuncimethods pada konfigurasi fitur Verifikasi Identitas (OCR), yang menggunakan kode negara ISO 3166-1 alpha-3 sebagai kuncinya. Jika Anda menghilangkan kunci tersebut, menghilangkan suatu negara, atau menghilangkan metode di dalam suatu negara, negara tersebut hanya akan menggunakan pengambilan dokumen.
available untuk pencarian di katalog yang dipublikasikan.
Contoh ini membiarkan dompet dinonaktifkan sehingga tidak bergantung pada dompet yang diaktifkan di lingkungan Anda.
Alur kerja yang mengaktifkan dompet bertanda Segera hadir akan ditolak, termasuk konfigurasi lain yang disimpan bersamanya.
Setelah katalog menandai dompet sebagai available di suatu negara, blok dompet untuk negara tersebut akan terlihat seperti ini:
- Ketersediaan ditentukan oleh server. Metode atau dompet yang tidak ditandai
availableoleh katalog kemampuan untuk negara tersebut akan ditolak. Baca katalog terlebih dahulu — melalui tab Negara di konsol, atau dengan alat MCPdidit_workflow_get_id_verification_methods_catalog. - Dompet adalah daftar yang diizinkan, bukan pemeringkatan.
providersmenentukan dompet mana yang boleh ditawarkan suatu negara. Urutan yang Anda kirimkan tidak memiliki arti dan dinormalisasi; pengguna akhirlah yang memilih.
Fallback: apa yang terjadi jika metode non-dokumen tidak berhasil
Empat switch menentukan apa yang terjadi selanjutnya. Masing-masing bernilai antarafallback_to_document (mengarahkan pengguna ke pengambilan dokumen) atau decline (mengakhiri sesi dengan Verifikasi Identitas yang ditolak); wallet.on_failure juga menerima retry, yang dijelaskan di bawah ini. Keempatnya memiliki nilai default fallback_to_document.
wallet.on_failure juga menerima nilai ketiga, retry, untuk negara yang hanya menerima dompet (pengambilan dokumen nonaktif):
retry hanya untuk dompet: switch pencarian menerima fallback_to_document atau decline, karena registri yang merespons “no match” tidak memiliki apa pun untuk dicoba lagi.
Nilai ini ditolak jika digabungkan dengan document.fallback_only, yang memerlukan kegagalan untuk dialihkan ke pengambilan dokumen.
Dompet yang berhasil masuk dan mengembalikan data yang gagal dalam pemeriksaan alur kerja Anda (usia, kecocokan nama, dan sebagainya) adalah proses masuk yang terverifikasi: aturan alur kerja yang menentukan, wallet.on_failure tidak berlaku.
Proses masuk yang tokennya asli tetapi tidak dapat diterima (tingkat jaminan yang salah, tanda tangan tidak valid, klaim wajib hilang) dihitung sebagai kegagalan dan mengikuti wallet.on_failure.
id_lookup.max_attempts (1 hingga 5, default 1) adalah jumlah pencarian yang mendapat respons yang dapat dilakukan pengguna sebelum switch terpicu. Nomor yang gagal dalam pemeriksaan format di sisi klien tidak pernah sampai ke registri, sehingga tidak menghabiskan kesempatan - pengguna hanya diminta untuk memperbaikinya.
Dompet atau pencarian hanya dapat melakukan fallback ke pengambilan dokumen jika pengambilan dokumen diaktifkan untuk negara tersebut dan setidaknya satu jenis dokumen diterima di sana.
Jika pengambilan dokumen nonaktif, atau tidak ada jenis dokumen yang diterima untuk negara tersebut, proses masuk yang gagal atau pencarian yang tidak cocok akan menolak sesi, bahkan jika switch menyatakan fallback_to_document. Pengecualiannya adalah wallet.on_failure: retry, yang tidak pernah menolak: pengguna tetap berada pada langkah dompet.
Tidak ada tempat untuk melakukan fallback.
Metode yang menghasilkan hasil: fallback_from
verification_method selalu menyebutkan metode yang menghasilkan hasil terverifikasi: wallet, id_lookup, atau document.
fallback_from menjelaskan alasan metode non-dokumen tidak menyelesaikan langkah identitas, pada kedua hasil:
- Fallback dilakukan. Pengguna diarahkan ke pengambilan dokumen. Verifikasi dokumen setelahnya memiliki
verification_method: "document"danfallback_fromyang menyebutkan metode yang gagal, misalnya{ "method": "wallet", "reason": "cancelled", "action": "fallback_to_document" }. Sesi yang diverifikasi oleh dompet memilikiverification_method: "wallet"danfallback_from: null. - Penolakan. Switch bernilai
decline, atau tidak ada dokumen tujuan untuk fallback. Verifikasi Identitas yang ditolak memilikifallback_fromdengan"action": "decline".
method bernilai wallet atau id_lookup, dan reason adalah hasil yang mengakhirinya (cancelled, timeout, no_match, provider_error, dan sebagainya).
Kolom yang sama disertakan dalam keputusan sesi dan pada webhook status.updated.
Registri yang tidak merespons (waktu habis atau gangguan) adalah pengecualian: registri tersebut tidak pernah menolak pengguna secara sepihak.
Pencarian tidak ditagih dan tidak ada kesempatan yang terpakai; pengguna diminta untuk mencoba lagi.
Setelah tiga kali pencarian tanpa respons pada langkah tersebut, id_lookup.on_provider_error berlaku: decline akan menolak, dan fallback_to_document akan mengarahkan pengguna ke pengambilan dokumen.
Ketika switch tersebut bernilai fallback_to_document tetapi negara tersebut tidak memiliki dokumen tujuan fallback, pencarian tetap terbuka dan pengguna dapat terus mencoba; sesi tidak ditolak.
Tawarkan pengambilan dokumen hanya sebagai fallback
Secara default, negara yang menawarkan dompet atau pencarian identitas bersamaan dengan pengambilan dokumen akan menampilkannya berdampingan di layar pertama. Aturdocument.fallback_only ke true untuk tetap mengaktifkan pengambilan dokumen bagi negara tersebut tanpa menawarkannya di awal.
Pengguna memulai dengan dompet atau pencarian identitas negara tersebut.
Dengan dompet tunggal, pengguna langsung diarahkan ke dompet tersebut.
Hanya pengguna yang proses masuk ke dompetnya gagal, dibatalkan, atau mengalami waktu habis, atau yang pencariannya tidak cocok, yang akan diarahkan ke pengambilan dokumen.
Hasil mana dari kemungkinan tersebut yang mengarah ke pengambilan dokumen tetap ditentukan oleh switch di atas, sehingga setidaknya salah satunya harus bernilai fallback_to_document.
fallback_only bersifat opsional dan memiliki nilai default false.
Pengaturan ini ditolak kecuali document.enabled bernilai true dan setidaknya satu dompet atau pencarian identitas di negara tersebut melakukan fallback ke pengambilan dokumen.
Aktifkan jenis dokumen yang harus ditawarkan oleh fallback di documents_allowed, misalnya paspor dan kartu identitas untuk Finlandia.
Biaya setiap metode
Ini adalah harga katalog: diskon paket Anda berlaku untuk kedua metode. Pencarian menggunakan tarif ritel publik Validasi Database untuk layanan yang dijalankannya; beberapa layanan dapat berkontribusi pada satu upaya. Nigeria memilih NIN atau BVN. Tabel negara menampilkan harga lengkap untuk upaya yang dikonfigurasi, dengan setiap percobaan ulang yang mendapat jawaban ditagih secara terpisah.
Aturan penagihan
- Registri yang menjawab akan menagih pencarian. Cocok, cocok sebagian, dan tidak cocok semuanya dihitung — kueri telah dijalankan dan jawabannya adalah produknya.
- Registri yang tidak pernah menjawab tidak ditagih. Kesalahan dari penyedia tidak dikenakan biaya.
- Nomor yang gagal dalam pemeriksaan format di sisi klien tidak pernah ditagih dan tidak pernah dihitung dalam
max_attempts, karena nomor tersebut tidak pernah sampai ke registri. - Pengambilan dokumen ditagih sebagai biaya tambahan saat pengguna beralih ke pengambilan dokumen. Pencarian yang telah dijawab lalu dialihkan ke dokumen akan dikenakan dua biaya, karena dua pemeriksaan telah dijalankan.
Cakupan
Pengambilan dokumen tersedia di setiap negara yang didukung Didit dan tidak dicantumkan berulang di bawah ini: $0.15 per pemeriksaan. Tabel ini hanya mencantumkan negara-negara yang menyediakan metode non-dokumen. Negara yang tidak tercantum, atau sel yang bertuliskan Tidak direncanakan, hanya mendukung pengambilan dokumen.Cakupan dihasilkan dari katalog kapabilitas yang disediakan oleh backend, sehingga tabel ini menggunakan sumber yang sama yang menjadi acuan validasi konsol dan API. Segera hadir berarti entri tersebut terlihat di konsol dan belum dapat diaktifkan; ini bukan kapabilitas aktif dan tidak disertai tanggal yang dijanjikan.
Data pada sesi
Setiap hasil Verifikasi Identitas memuat metode yang menghasilkannya, tingkat jaminannya, dan — saat metode non-dokumen dijalankan — blok bukti per metode. Sesi dokumen tetap terbaca persis seperti sebelumnya, dengan kunci baru bernilainull.
Tipe dan contoh per kolom untuk ketiga metode tersedia di model data Verifikasi Identitas, dan kunci yang sama dikirim melalui webhook
status.updated.
Terkait
- Pencarian non-dokumen — kolom per negara, format, persetujuan, dan retensi
- Dompet ID digital — atribut per dompet, tingkat jaminan, dan semantik kegagalan
- Metode Verifikasi Identitas di konsol — tab Negara dan chip metode sesi
- Konfigurasi fitur alur kerja — referensi kunci
methods