Langsung ke konten utama
POST
Validasi biometrik Unico IDCloud: mencocokkan swafoto pengguna dengan wajah yang tercatat untuk CPF-nya dan mengembalikan apakah itu orang yang sama, bukan orang yang sama, atau tidak konklusif. Didit menyediakan layanan ini melalui POST /v3/database-validation/ agar Anda dapat memverifikasi data yang dikirim terhadap sumber otoritatif dan menerima hasil pencocokan yang dinormalisasi. Format input: tax_number menerima CPF Brasil (tepat 11 digit).

Cakupan

  • Cakupan: 96%
  • Negara: Brasil
  • ID layanan: bra_unico_idcloud
  • Domain data: Identitas
  • Kategori: BiometricRiskScore
Sekitar 96% pemegang CPF Brasil terhubung ke catatan biometrik di registri Unico. Jangkauannya kira-kira dua kali lipat sumber pencocokan wajah pemerintah, Datavalid, yang sekitar 50%.

Input

  • Input wajib: tax_number, selfie
  • Input opsional: first_name, last_name, full_name, date_of_birth, vendor_data
  • Persetujuan: Wajib
  • Ketersediaan di alur kerja: Tersedia dalam alur kerja
  • Cakupan: 96%
  • Harga: $0.20 per kueri yang berhasil

Parameter isi

string
default:"BRA"
wajib
Kode negara ISO 3166-1 alpha-3 untuk layanan database ini.Contoh: BRA
string
default:"bra_unico_idcloud"
wajib
Array yang berisi ID layanan ini. Mengunci layanan membuat permintaan hanya berlaku untuk database yang tepat ini.Contoh: bra_unico_idcloud
Persetujuan eksplisit dari pengguna akhir untuk layanan ini.Contoh: true
string
default:"11111111111"
wajib
Nomor identifikasi pajak atau fiskal.Contoh: 11111111111
file
wajib
File gambar swafoto yang diunggah untuk validasi database biometrik. Format yang diterima: JPEG, PNG, atau WebP.Contoh: @./selfie.jpg
string
Nama depan yang akan divalidasi.Contoh: John
string
Nama belakang yang akan divalidasi.Contoh: Doe
string
Nama lengkap resmi yang akan divalidasi.Contoh: John Doe
string
Tanggal lahir dalam format YYYY-MM-DD.Contoh: 1990-01-01
string
default:"user-1234"
Referensi pengguna Anda yang stabil untuk orang ini, misalnya ID pengguna internal Anda. Didit menggunakannya untuk menautkan pemeriksaan terpisah ke pengguna akhir yang sama dan mengurangi gangguan dalam deteksi duplikat.Contoh: user-1234

Aturan input & catatan validasi

  • CPF Brasil (tepat 11 digit)
  • tax_number hanya boleh berisi digit; hapus spasi, tanda hubung, dan tanda baca sebelum mengirim permintaan.
  • tax_number harus tepat 11 karakter.

Cara memanggilnya

Data yang dikembalikan

Kolom yang tepat ditampilkan di source_data bergantung pada apa yang dikembalikan registri. Contoh yang dihasilkan untuk bra_unico_idcloud saat ini mendokumentasikan bentuk ternormalisasi berikut:
  • unico_face_match

Harga & SLA

Kueri BRA - Unico IDCloud (CPF + swafoto) hanya ditagih ketika Didit menerima hasil konklusif dari sumber validasi.
  • Harga per panggilan: $0.20 USD.
  • Penagihan: per kueri yang berhasil. Anda tidak dikenai biaya ketika registri tidak dapat dijangkau, ketika kolom wajib tidak ada, atau ketika permintaan ditolak sebelum mencapai sumber.
  • Latensi: p95 tipikal kurang dari 2 dtk.
  • Ketersediaan: 99.9% per kuartal di sisi Didit; ketersediaan sumber hilir bervariasi menurut negara dan dataset.

Tentang sumber ini

Unico adalah IDtech asal Brasil yang mengelola registri biometrik wajah swasta terbesar di negara tersebut. Platform IDCloud-nya menyimpan lebih dari satu miliar embedding wajah dan menambahkan sekitar 35 juta wajah baru setiap bulan, yang bersumber dari alur onboarding dan autentikasi ulang lebih dari 800 perusahaan Brasil, termasuk empat dari lima bank terbesar. Skala inilah yang menghasilkan angka cakupan di atas: pencarian CPF menghasilkan rekaman biometrik untuk sekitar 96% orang dewasa di Brasil. Didit memiliki kemitraan langsung dengan Unico, sehingga Anda dapat menanyakan IDCloud melalui API Validasi Database standar: bayar per panggilan, tanpa kontrak Unico terpisah, tanpa volume minimum, dan tanpa proses onboarding. Perbedaannya dengan registri pemerintah. Didit juga menawarkan Brasil - CPF + pencocokan wajah (Datavalid), yang merupakan sumber resmi SERPRO dan pilihan tepat jika Anda secara khusus membutuhkan registri pemerintah sebagai sumber kebenaran utama. IDCloud adalah pilihan yang lebih baik untuk kebutuhan lainnya, berdasarkan dua aspek yang dapat Anda periksa sendiri. Pertama, IDCloud menjangkau sekitar 96% orang dewasa, sedangkan Datavalid sekitar 50%. Kedua, IDCloud mencocokkan wajah dengan rekaman biometrik yang dikelola registri itu sendiri, bukan dengan foto potret yang diambil dari dokumen yang diberikan pengguna, sehingga tahan terhadap pemalsuan dokumen maupun penipuan dengan CPF curian. Biayanya juga kurang dari setengah harga per kueri.

Alur yang direkomendasikan untuk Brasil

Untuk sebagian besar kasus penggunaan di Brasil, Anda sama sekali tidak perlu menangkap dokumen. Pengguna memberikan CPF mereka, lalu swafoto yang diperiksa liveness-nya memastikan bahwa orang di depan kamera adalah pemilik CPF tersebut.
1

Kumpulkan CPF

Satu-satunya input teks Anda adalah CPF 11 digit. Tidak ada foto dokumen, dan tidak ada nama atau tanggal lahir yang diketik manual.Karena tidak ada dokumen yang dibaca dalam alur ini, Didit tidak punya sumber untuk mengambil CPF kecuali Anda memberi tahu asalnya. Kirim CPF di metadata sesi saat Anda membuat sesi, lalu petakan sebagai input tax_number pada langkah Validasi Database. Di Business Console, itu adalah pemetaan input langkah tersebut. Melalui API alur kerja, itu adalah database_validation_field_sources pada node:
Kemudian buat setiap sesi dengan nilai di bawah kunci tersebut:
Tanpa pemetaan ini, langkah tetap berjalan, tetapi melaporkan tax_number sebagai hilang dan tidak pernah melakukan kueri ke registri. Tidak ada yang ditagihkan, dan entri database_validations pada sesi berisi alasannya.
2

Ambil swafoto dengan pemeriksaan liveness

Tambahkan langkah liveness ke alur kerja yang sama, lalu pilih metode yang sesuai dengan toleransi risiko Anda: Liveness Pasif (tanpa tindakan apa pun dari pengguna), Flash 3D, atau Aksi 3D & Flash (metode aktif yang memproyeksikan pola cahaya, dan yang terakhir menambahkan tindakan acak). Atur dengan face_liveness_method (PASSIVE, FLASHING, atau ACTIVE_3D) di Business Console atau melalui API alur kerja. Apa pun yang Anda pilih, Didit menampilkan langkah pengambilan gambar dan memastikan bahwa orang tersebut nyata serta benar-benar hadir di depan kamera. Inilah yang mencegah foto tersimpan atau pemutaran ulang layar dikirimkan.
3

Validasi CPF dan swafoto terhadap Unico IDCloud

Di dalam alur sesi, Didit menggunakan ulang swafoto liveness secara otomatis. Anda tidak perlu menangani gambarnya sama sekali. Didit juga membaca CPF dari pemetaan di atas. IDCloud kemudian mengonfirmasi apakah wajah tersebut milik orang yang memiliki CPF itu. Langkah ini hanya membutuhkan dua input ini. Jika Anda juga mengirim full_name atau date_of_birth di metadata dan memetakannya, nilainya diteruskan ke Unico sebagai pemeriksaan silang, tetapi keduanya tidak wajib.
Alur khusus CPF ini berlaku untuk integrasi sesi dan alur kerja, saat Didit melakukan pengambilan gambar dan meneruskan swafoto liveness ke layanan ini untuk Anda. Jika Anda memanggil POST /v3/database-validation/ secara langsung, selfie adalah input file yang wajib, dan Anda sendiri yang menyediakan gambarnya. Lihat ikhtisar Validasi Database untuk kedua mode tersebut.
Biaya: sekitar $0.30 per pengguna terverifikasi dengan Liveness Pasif, yaitu $0.20 untuk kueri IDCloud ditambah $0.10 untuk pemeriksaan liveness. Atau sekitar $0.35 dengan metode aktif, saat pemeriksaan liveness berbiaya $0.15. Ini adalah harga daftar. Diskon paket Anda berlaku untuk masing-masing biaya tersebut. Lihat harga. Cadangan untuk sekitar 4% yang tidak tercakup. Ketika IDCloud mengembalikan INCONCLUSIVE, registri tidak dapat mencocokkan CPF tersebut dengan catatan biometrik yang dapat digunakan, biasanya karena orang tersebut tidak ada di dalam registri. Perlakukan ini sebagai “tidak ada jawaban”, bukan sebagai pemeriksaan yang gagal. Lalu alihkan ke Verifikasi Identitas lengkap: pengambilan dokumen ditambah pencocokan wajah dengan potret dokumen. Semua pengguna tetap dapat diverifikasi, dan Anda hanya membayar verifikasi dokumen untuk sisa yang kecil. Menangani penolakan. BIOMETRIC_NO_MATCH berarti registri secara aktif tidak setuju: wajah tersebut bukan milik CPF itu. Perlakukan ini sebagai indikasi negatif yang kuat, bukan sebagai alasan untuk mencoba lagi. Mengarahkan pengguna langsung ke pengambilan dokumen justru jalur yang diinginkan oleh penipu, karena dokumen adalah artefak yang mereka kendalikan. Meski begitu, hasil negatif palsu yang sungguhan memang terjadi, misalnya penampilan yang berubah, foto registri yang lama, atau pengambilan gambar yang buruk. Karena itu, arahkan kasus ini ke peninjauan manual. Jangan menyetujuinya secara otomatis, dan jangan menghentikan pengguna begitu saja. BIOMETRIC_IMAGE_UNUSABLE berbeda: swafoto tersebut tidak bisa dibaca, jadi mintalah swafoto baru. Tentukan apa yang dilakukan setiap hasil terhadap sesi dengan tindakan Partial Match / No Match, dan lihat Kode Hasil untuk daftar lengkapnya. Pengguna yang kembali. Anda hanya perlu membayar pencarian registri sekali. Setelah pengguna lolos alur ini, swafoto liveness disimpan di vendor_data mereka, sehingga Anda dapat memverifikasi ulang mereka nanti dengan Autentikasi Biometrik, yaitu pemeriksaan liveness ditambah pencocokan wajah dengan wajah tersimpan tersebut, seharga $0.10, dengan pilihan metode liveness yang sama. Perhatikan bahwa ini khusus untuk pengguna yang kembali. Sesi autentikasi biometrik membutuhkan wajah tersimpan (atau portrait_image yang Anda sediakan), dan akan gagal saat dibuat jika pengguna tidak memiliki keduanya. Karena itu, pengguna baru tetap melalui alur di atas.

Lanjutkan membaca

Terakhir diubah pada 7 November 2026