Validasi basis data - mengaktifkan layanan dan apa yang ditagih

Validasi basis data mencocokkan data identitas yang diekstrak dengan registri pemerintah atau sumber resmi. Mengapa sebuah layanan bertuliskan "Memerlukan onboarding", mengapa mengembalikan 403 atau kosong sama sekali, dan kueri mana yang ditagih.

Ditulis oleh Dukungan Didit · Diperbarui 15 September 2026

Membaca dokumen memberi tahu apa yang tercetak di dalamnya. Validasi basis data memberi tahu apakah sumber resmi setuju: registri kependudukan, otoritas pajak, biro kredit, basis data SIM. Setiap negara menyediakan satu atau lebih layanan, masing-masing dengan harga, input, dan aturan persetujuannya sendiri. Lihat negara dan layanan yang didukung dan harga per layanan.

#Berjalan diam-diam, setelah langkah dokumen

Tidak ada layar validasi basis data. Langkah ini mengambil data yang diekstrak dari dokumen identitas (atau data yang Anda kirim saat membuat sesi), mengirimkannya ke registri, dan menyimpan jawabannya di laporan sesi. Dua konsekuensi mengikuti:

• Jika langkah ID mengekstrak nomor atau nama yang salah, registri ditanya dengan nilai yang salah dan pemeriksaan gagal atau kembali tidak konklusif. Perbaiki ekstraksinya dulu. Lihat memperbaiki nama atau kolom yang salah terbaca.
• Anda tidak bisa "mengirim ulang" validasi basis data ke pengguna seperti mengirim ulang dokumen identitas atau selfie, karena tidak ada yang bisa mereka ulangi. Meminta pengiriman ulang DATABASE_VALIDATION mengembalikan error bahwa fitur tersebut bukan bagian dari langkah yang bisa dikirim ulang di sesi itu. Untuk menjalankannya lagi, panggil API validasi basis data mandiri dengan data yang sudah diperbaiki. Panggilan itu ditagih per kueri seperti yang lain.

#Mengapa tidak berjalan

Periksa secara berurutan. Ini menjelaskan hampir semua laporan "validasi basis data tidak melakukan apa-apa".

1. Apakah organisasi Anda pernah top up?

   Validasi basis data (dan verifikasi telepon) baru aktif setelah top up pertama. Kredit sambutan, termasuk kredit $10 untuk akun baru, tidak dihitung. Sebelum itu langkahnya dilewati, sebuah sesi bisa kembali disetujui dengan pemeriksaan yang diam-diam tidak dijalankan, dan panggilan langsung ke POST /v3/database-validation/ menjawab 403. Lihat top up, faktur, dan metode pembayaran.

2. Apakah layanan ditandai Memerlukan onboarding?

   Di langkah Validasi Basis Data pada alur kerja, sebagian layanan menampilkan "Memerlukan onboarding. Hubungi dukungan Didit untuk mengaktifkannya." Layanan terlihat tetapi dinonaktifkan untuk organisasi Anda sampai Didit mengaktifkannya. Ini bukan bug dan tidak ada sakelar mandiri: buka tiket dukungan dengan menyebut layanan dan negaranya, dan tim akan memulai onboarding.

3. Apakah negaranya sudah dikonfigurasi?

   Panggilan API untuk negara yang tidak pernah Anda pilih di alur kerja, atau panggilan mandiri untuk layanan yang belum diaktifkan, dijawab dengan "No database validation services configured" untuk negara itu. Tambahkan layanan ke langkah, atau kirim service_id persis dari halaman negara tersebut.

4. Apakah saldo positif?

   Validasi basis data tidak pernah termasuk paket gratis. Saldo nol atau negatif mengembalikan insufficient_credits, sama seperti fitur berbayar lainnya. Lihat memperbaiki error "kredit tidak cukup".

#Layanan yang membutuhkan onboarding penyedia

Segelintir sumber pemerintah mengharuskan Didit mendaftarkan organisasi Anda ke penyedia, bukan sekadar mengaktifkan sakelar. Saat ini berlaku untuk:

• Australia (DVS: SIM, paspor, visa, Medicare, dan layanan DVS lainnya)
• Selandia Baru (DIA: paspor, kewarganegaraan, catatan kelahiran dan kematian, SIM)
• Kanada (layanan biro kredit dan pencocokan bergaya FINTRAC)

Untuk ini, dukungan mengirimkan formulir penyedia untuk Anda isi, penyedia menerbitkan kredensial untuk akun Anda, dan pengaktifan biasanya memakan waktu hingga dua minggu. Australia dan Selandia Baru secara historis juga mensyaratkan perjanjian layanan minimum (jumlah prabayar sekali bayar, saat ini 5.000 USD, yang masuk ke saldo Anda sebagai kredit yang tidak pernah kedaluwarsa). Persyaratan itu hanya berlaku untuk akses registri kedua negara tersebut, bukan fitur Didit lainnya, dan sedang direvisi seiring Didit menyelesaikan akreditasinya sendiri di skema Australia, jadi tanyakan ketentuan terkini ke dukungan sebelum membuat rencana berdasarkan itu.

#Apa yang ditagih

Anda membayar per layanan, per kueri yang dijawab registri, dengan harga di halaman layanan tersebut. Bacalah sebagai "registri ditanya dan menjawab", bukan "jawabannya sesuai harapan":

Satu sesi bisa memicu beberapa kueri yang ditagih jika menjalankan beberapa layanan, dan sebuah kueri ditagih sekali per layanan, bukan per negara. Rincian lengkap: harga validasi basis data dan kode hasil.

#Apa yang dikembalikan

Setiap layanan mengembalikan kode hasil standar ditambah data registri itu sendiri jika sumbernya mengizinkan: kolom mana yang cocok, skor kecocokan jika registri memberi skor alih-alih menjawab ya atau tidak, dan untuk layanan biometrik (RENAPER Argentina, BVN Nigeria, Panama) perbandingan wajah dengan potret di registri. Apa yang disimpan Didit dari jawaban itu diatur oleh pengaturan Data yang dikembalikan pada langkah tersebut. Lihat memilih data yang dikembalikan verifikasi dan laporan validasi basis data.

#Menguji sebelum go live

Aplikasi sandbox tidak pernah mencapai registri sungguhan dan tidak pernah menghabiskan kredit: skenario sandbox seperti decline_database_no_match memaksa hasil yang ingin Anda latih. Yang tidak bisa diberitahukan sandbox adalah apakah layanan tertentu sudah disediakan untuk organisasi live Anda; itu membutuhkan top up pertama dan panggilan sungguhan. Lihat menguji di sandbox.