Langsung ke konten utama
POST
Memverifikasi data input terhadap data Credit Header yang diperoleh dari biro kredit di Italia. Didit menyediakan layanan ini melalui POST /v3/database-validation/ agar Anda dapat memverifikasi data yang dikirim terhadap sumber otoritatif dan menerima hasil pencocokan yang sudah dinormalisasi.

Cakupan

  • Cakupan: ~ 80%
  • Negara: Italia
  • ID layanan: ita_credit_bureau
  • Domain data: Keuangan
  • Kategori: CreditBureau

Input

  • Input wajib: first_name, last_name, address.street_1, address.postal_code, tax_number
  • Input opsional: date_of_birth, address.street_2, address.city, address.region, vendor_data
  • Persetujuan: Tidak diperlukan
  • Ketersediaan dalam alur kerja: Tersedia dalam alur kerja
  • Cakupan: ~ 80%
  • Harga: $3.25 per kueri yang berhasil
Tidak semua dokumen yang diterima layanan ini memuat pengenal yang digunakan untuk kueri. Jika pengenal tidak diekstrak dari dokumen, pemeriksaan dicatat sebagai tidak berlaku, tidak ada database yang dikueri, dan Anda tidak dikenakan biaya. Untuk negara tertentu, kondisi ini dapat berlaku pada sebagian besar pengguna nyata. Agar tetap tercakup, kumpulkan juga pengenal tersebut dari jawaban kuesioner, kolom ekstraksi Document AI, atau nilai yang Anda kirim saat membuat sesi, lalu petakan pada langkah Validasi Database.

Parameter body

string
default:"ITA"
wajib
Kode negara ISO 3166-1 alpha-3 untuk layanan database ini.Contoh: ITA
string
default:"ita_credit_bureau"
wajib
Array yang berisi ID layanan ini. Mematok layanan membuat permintaan hanya mengacu pada database yang tepat ini.Contoh: ita_credit_bureau
string
default:"John"
wajib
Nama depan yang akan divalidasi.Contoh: John
string
default:"Doe"
wajib
Nama belakang yang akan divalidasi.Contoh: Doe
object
wajib
Objek alamat tempat tinggal yang terstruktur. Gunakan street_1, street_2, city, region, postal_code, dan country. String alamat lengkap format lama masih diterima, tetapi tidak disarankan.Contoh: {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}
string
default:"SAMPLE-TAX-12345"
wajib
Nomor identifikasi pajak atau fiskal.Contoh: SAMPLE-TAX-12345
string
Tanggal lahir dalam format YYYY-MM-DD.Contoh: 1990-01-01
string
default:"user-1234"
Referensi pengguna yang stabil untuk orang ini di sistem Anda, misalnya ID pengguna internal. Didit menggunakannya untuk menghubungkan pemeriksaan terpisah dengan pengguna akhir yang sama dan mengurangi gangguan dari deteksi duplikat.Contoh: user-1234

Aturan input & catatan validasi

  • tax_number harus tepat 16 karakter.
  • Untuk layanan berbasis alamat, kirimkan kolom alamat yang terstruktur, bukan satu string address, bila memungkinkan.
  • address.street_1 adalah alamat jalan, termasuk nomor dan jenis jalan.
  • address.street_2 adalah apartemen, unit, gedung, lantai, atau baris alamat tambahan. Kirimkan hanya jika Anda memilikinya.
  • address.city adalah kota, kecamatan, distrik, lokalitas, atau lingkungan.
  • address.region adalah negara bagian, provinsi, wilayah, atau kota.
  • address.postal_code adalah kode pos.
  • Layanan database berbasis alamat memerlukan minimal alamat jalan dan kode pos. Permintaan yang ditolak sebelum pencarian sumber tidak dikenakan biaya.

Cara memanggilnya

Data yang dikembalikan

Kolom yang tepat di source_data bergantung pada apa yang dikembalikan registri. Contoh yang dihasilkan untuk ita_credit_bureau saat ini mendokumentasikan bentuk ternormalisasi berikut:
  • address
  • date_of_birth
  • first_name
  • identification_number
  • last_name

Harga & SLA

Kueri Italy Credit Bureau hanya ditagih ketika Didit menerima hasil yang konklusif dari sumber validasi.
  • Harga per panggilan: $3.25 USD.
  • Penagihan: per kueri yang berhasil. Anda tidak dikenai biaya ketika registri tidak dapat dijangkau, ketika kolom yang diperlukan 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 dataset.

Baca selanjutnya

Terakhir diubah pada 7 November 2026