Langsung ke konten utama
POST
SERPRO Datavalid v4 pf-facial memvalidasi CPF (wajib) terhadap Receita Federal dan mencocokkan swafoto langsung (wajib) dengan potret CNH yang disimpan di Senatran. Secara opsional, layanan ini juga memeriksa nama dan tanggal lahir. Didit menyediakan layanan ini melalui POST /v3/database-validation/ sehingga Anda dapat memverifikasi data yang dikirim terhadap sumber otoritatif dan menerima hasil pencocokan yang ternormalisasi. Format input: tax_number menerima CPF Brasil (tepat 11 digit).

Cakupan

  • Cakupan: ~50%
  • Negara: Brasil
  • ID layanan: bra_cpf_facial
  • Domain data: Biometrik
  • Kategori: NationalIDRegistry
Sekitar 50% orang dewasa di Brasil dapat dicocokkan; langkah pencocokan wajah bergantung pada potret CNH yang disimpan di Senatran, sehingga hanya pemegang SIM (CNH) yang dapat dicocokkan.

Input

  • Input wajib: tax_number, selfie
  • Input opsional: first_name, last_name, date_of_birth, vendor_data
  • Persetujuan: Wajib
  • Ketersediaan alur kerja: Tersedia dalam alur kerja
  • Cakupan: ~50%
  • Harga: $0.45 per kueri yang berhasil

Parameter body

string
default:"BRA"
wajib
Kode negara ISO 3166-1 alpha-3 untuk layanan basis data ini.Contoh: BRA
string
default:"bra_cpf_facial"
wajib
Larik yang berisi ID layanan ini. Menetapkan layanan ini membuat permintaan hanya mengacu pada basis data yang tepat ini.Contoh: bra_cpf_facial
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 basis data 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
Tanggal lahir dalam format YYYY-MM-DD.Contoh: 1990-01-01
string
default:"user-1234"
Referensi pengguna 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 persis yang ditampilkan di source_data bergantung pada apa yang dikembalikan registri. Contoh yang dihasilkan untuk bra_cpf_facial saat ini mendokumentasikan bentuk ternormalisasi berikut:
  • date_of_birth
  • first_name
  • identification_number
  • last_name
  • name_match_score

Harga & SLA

Brasil - kueri CPF + pencocokan wajah (Datavalid) ditagih hanya ketika Didit menerima hasil yang konklusif dari sumber validasi.
  • Harga per panggilan: $0.45 USD.
  • Penagihan: per kueri yang berhasil. Anda tidak dikenakan biaya ketika registri tidak dapat dihubungi, ketika kolom wajib tidak ada, atau ketika permintaan ditolak sebelum mencapai sumber.
  • Latensi: p95 tipikal < 2 s.
  • Ketersediaan: 99.9% per kuartal di sisi Didit; ketersediaan sumber hilir bervariasi menurut negara dan kumpulan data.

Tentang sumber ini

Ini adalah sumber resmi pemerintah: SERPRO Datavalid, yang dioperasikan oleh layanan pemrosesan data federal Brasil. CPF diperiksa terhadap Receita Federal, dan swafoto dicocokkan dengan potret yang tersimpan untuk orang tersebut di Senatran, registri nasional surat izin mengemudi. Karena potret berasal dari catatan CNH (surat izin mengemudi), hanya orang yang memiliki CNH yang memiliki data wajah. Hal inilah yang membatasi cakupan hingga sekitar 50% penduduk dewasa: datanya otoritatif, tetapi tidak tersedia bagi setiap warga Brasil yang belum pernah memiliki surat izin mengemudi. Butuh cakupan yang lebih luas? Gunakan BRA - Unico IDCloud (CPF + selfie) sebagai gantinya. Layanan ini menjangkau sekitar 96% penduduk dewasa Brasil melalui registri biometrik privat Unico, dan biayanya $0.20, dibandingkan $0.45 di sini. Pilih Datavalid jika Anda secara khusus memerlukan registri pemerintah sebagai sumber kebenaran; pilih IDCloud jika Anda perlu memverifikasi semua orang.

Lanjut membaca

Terakhir diubah pada 7 November 2026