Langsung ke konten utama
POST
Memverifikasi DNI Argentina terhadap registri sipil resmi RENAPER, dengan pencocokan wajah biometrik terhadap foto yang tersimpan. Cakupan populasi 100%. Didit menyediakan layanan ini melalui POST /v3/database-validation/ agar Anda dapat memverifikasi data yang dikirim terhadap sumber otoritatif dan menerima hasil kecocokan yang dinormalisasi. Format input: document_number menerima DNI Argentina (7-8 digit, awalan M/F opsional).

Cakupan

  • Cakupan: 100%
  • Negara: Argentina
  • ID layanan: arg_renaper
  • Domain data: Identitas
  • Kategori: NationalIDRegistry
RENAPER adalah registri yang menerbitkan setiap DNI Argentina, sehingga setiap nomor DNI tersimpan di dalamnya, termasuk DNI yang diterbitkan untuk penduduk asing. Pencocokan wajah membandingkan swafoto dengan foto yang dimiliki RENAPER untuk DNI tersebut.

Input

  • Input wajib: document_number, selfie, gender
  • Input opsional: first_name, last_name, date_of_birth, vendor_data
  • Persetujuan: Tidak diperlukan
  • Ketersediaan dalam alur kerja: Tersedia dalam alur kerja
  • Cakupan: 100%
  • Harga: $0.20 per kueri yang berhasil

Parameter body

string
default:"ARG"
wajib
Kode negara ISO 3166-1 alpha-3 untuk layanan database ini.Contoh: ARG
string
default:"arg_renaper"
wajib
Array yang berisi ID layanan ini. Mengunci layanan membuat permintaan hanya berlaku untuk database yang tepat ini.Contoh: arg_renaper
string
default:"11111111"
wajib
Nomor dokumen yang diekstrak dari atau diberikan oleh pengguna.Contoh: 11111111
file
wajib
File gambar swafoto yang diunggah untuk validasi database biometrik. Format yang diterima: JPEG, PNG, atau WebP.Contoh: @./selfie.jpg
string
default:"M"
wajib
Nilai jenis kelamin, jika diwajibkan oleh database.Nilai yang diizinkan: M (laki-laki), F (perempuan), X (lainnya atau tidak diketahui).Contoh: M
string
Nama depan yang akan divalidasi.Contoh: John
string
Nama keluarga 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 dari orang ini di sistem Anda, misalnya ID pengguna internal. Didit menggunakannya untuk menautkan pemeriksaan terpisah ke pengguna akhir yang sama dan mengurangi gangguan dalam deteksi duplikasi.Contoh: user-1234

Aturan input dan catatan validasi

  • DNI Argentina (7-8 digit, awalan M/F opsional)
  • document_number harus terdiri dari 7-9 karakter.
  • document_number harus cocok dengan [MFmf]?\d{7,8}.

Cara memanggilnya

Data yang dikembalikan

Kolom spesifik yang ditampilkan di source_data bergantung pada apa yang dikembalikan registri. Contoh yang dihasilkan untuk arg_renaper saat ini mendokumentasikan bentuk ternormalisasi berikut:
  • date_of_birth
  • face_match_score
  • first_name
  • full_name
  • identification_number
  • last_name
  • tax_id
  • tax_id_type

Harga & SLA

Argentina - kueri verifikasi DNI (RENAPER) 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 s.
  • Ketersediaan: 99.9% per kuartal di sisi Didit; ketersediaan sumber hilir bervariasi menurut negara dan dataset.

Skor kecocokan wajah

face_match_score adalah tingkat kemiripan RENAPER antara swafoto dan foto yang tersimpan untuk DNI. Nilainya berupa bilangan bulat dari 0 sampai 100 dalam bentuk string, misalnya "92". Nilai ini bukan probabilitas antara 0 dan 1. Pemeriksaan mengembalikan BIOMETRIC_NO_MATCH ketika RENAPER melaporkan bahwa wajah tidak cocok, atau ketika skornya di bawah 50. Pada skor 50 atau lebih, wajah diterima, lalu nama dan tanggal lahir yang terdaftar dibandingkan dengan data yang Anda kirim. Foto yang tersimpan bisa berusia beberapa tahun, sehingga pengguna yang asli pun bisa mendapat skor rendah setelah penampilannya berubah banyak. Pertimbangkan untuk mengirim BIOMETRIC_NO_MATCH ke peninjauan manual, bukan langsung menolaknya, dengan memakai tindakan Partial Match / No Match.

Saat RENAPER tidak merespons

Jika RENAPER tidak dapat dihubungi atau merespons dengan kesalahan, hasilnya adalah REGISTRY_UNAVAILABLE. Tidak ada data orang tersebut yang diperiksa, dan panggilan tidak ditagih. Permintaan yang sama dapat berhasil jika Anda mencobanya lagi nanti. Lihat Kode Hasil untuk cara menanganinya.

Dokumen yang dibaca alur kerja

Di dalam alur kerja, nomor DNI dan jenis kelamin berasal dari langkah Verifikasi Identitas, yang membaca kartu DNI Argentina dan DNI digital. Penduduk asing memiliki kartu DNI yang sama dan diverifikasi dengan cara yang sama. DNI versi buku lama (libreta) bukan dokumen Verifikasi Identitas yang didukung, sehingga pengguna yang hanya memiliki dokumen tersebut tidak dapat menyelesaikan langkah itu. Anda tetap dapat memeriksa nomor DNI mereka secara langsung dengan POST /v3/database-validation/.

Menggunakan layanan ini dalam alur kerja

Tambahkan layanan ke langkah Validasi Database setelah Verifikasi Identitas. Misalnya, dengan POST /v3/workflows/:
Jika ada langkah Deteksi Liveness sebelumnya, RENAPER membandingkan swafoto langsung. Tanpa langkah tersebut, Didit mengirim potret yang tercetak pada dokumen identitas. Cara ini memastikan foto dokumen, tetapi tidak memastikan bahwa orang di depan kamera adalah pemilik dokumen tersebut. ID layanan yang tidak dapat dijalankan oleh alur kerja akan ditolak dengan 400 yang menyebutkan ID tersebut, sehingga langkah tidak pernah disimpan tanpa pemeriksaan yang Anda minta. Lihat Konfigurasi Fitur Alur Kerja untuk setiap pengaturan Validasi Database.

Lanjut membaca

Terakhir diubah pada 7 November 2026