Langsung ke konten utama
POST
curl
Dalam produksi, pemeriksaan rekening berjalan di Nigeria, Ghana, dan Kenya. Negara lain menghasilkan respons 404 dengan code: country_not_covered, dan tidak ditagih. Negara baru akan dibuka seiring waktu, dan harga Bank Verification selalu menunjukkan apa yang ditawarkan setiap negara saat ini.
Backend Anda mengirim nama dan rekening, lalu membaca hasilnya. Ini adalah pemeriksaan rekening pada langkah Bank Verification, tanpa melibatkan orang tersebut.

Kirim rekening sesuai format penulisan negaranya

Beberapa negara juga meminta bic, dan untuk rekening bisnis meminta registration_id. Spasi, tanda hubung, dan titik diabaikan. Jika kunci yang dibutuhkan pemeriksaan negara tersebut tidak dikirim, responsnya adalah 400 yang menyebutkan kunci itu, misalnya "field": "account.bank_code", "reason": "required". Kirim holder.full_name untuk memeriksa rekening seseorang, atau holder.business_name untuk memeriksa rekening sebuah perusahaan.

Kirim persetujuan pemegang rekening

Di beberapa negara, pemeriksaan rekening memerlukan persetujuan eksplisit dari pemegang rekening sebelum setiap pemeriksaan. Mintalah persetujuan tersebut di produk Anda, lalu kirim "consent": true. Tanpa itu, pemeriksaan di negara tersebut ditolak dengan 400 (field: consent, reason: required) dan tidak ditagih. Di negara lain, consent bersifat opsional, dan jika Anda mengirimnya, Didit mencatatnya bersama biaya pemeriksaan. Kunci sandbox meminta persetujuan di negara yang sama dengan kunci produksi.

Baca hasilnya

Penagihan dan coba lagi

Setiap pemeriksaan yang dijawab bank ditagih sekali dengan harga Pemeriksaan rekening untuk negara asal rekening tersebut, apa pun hasilnya. Permintaan yang dijawab dengan kesalahan tidak pernah ditagih: isi permintaan yang ditolak (400), tidak ada kredit (402), rekening di negara yang belum dilayani pemeriksaan (404), atau bank yang tidak dapat menjawab (503). Tidak ada kunci idempotensi dan tidak ada endpoint untuk membaca kembali pemeriksaan. Permintaan yang dicoba ulang akan menjalankan pemeriksaan baru, dengan request_id baru, dan ditagih lagi, jadi simpan responsnya. Didit hanya menyimpan biaya, dengan ID permintaan, negara, hasil, dan rekening yang disamarkan, tidak pernah nama atau nomor rekening lengkap.

Uji di sandbox

Kunci API sandbox tidak memanggil bank dan tidak dikenakan biaya. 4 karakter terakhir IBAN, atau jika tidak ada, dari nomor rekening, menentukan jawabannya: IBAN, CLABE, dan CBU memiliki digit pemeriksa: gunakan nilai sandbox yang lolos semua pemeriksaan format.

Akses

Autentikasi dengan x-api-key aplikasi Anda, atau dengan token bearer kredensial klien aplikasi Anda. Kunci API dengan cakupan terbatas memerlukan akses tulis ke sesi. Endpoint ini berbagi batas tulis 300 permintaan per menit per kunci API.

Otorisasi

x-api-key
string
header
wajib

Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys.

Body

application/json
country
string
wajib

Negara akun, sebagai kode ISO 3166-1 alpha-3, misalnya NGA. Huruf kecil diterima.

Required string length: 3
Contoh:

"NGA"

account
object
wajib

Akun sesuai format penulisan di negaranya: sebuah iban, atau sebuah account_number dengan kode bank atau cabang yang dibutuhkan negara tersebut (sort_code, routing_number, transit_institution, bsb, ifsc, bank_code, atau bic). Meksiko menerima clabe dan Argentina menerima cbu_cvu, yang sudah mencakup nama bank. Akun bisnis menambahkan registration_id jika negara tersebut memintanya. Spasi, tanda hubung, dan titik diabaikan. Kunci yang tidak digunakan oleh pemeriksaan negara tersebut akan diabaikan; kunci yang dibutuhkan tetapi tidak diberikan akan menghasilkan 400 yang menyebutkan kuncinya.

Contoh:
holder
object
wajib

Nama yang digunakan untuk memeriksa akun. Kirim tepat salah satu dari full_name dan business_name.

vendor_data
string | null

Referensi Anda sendiri untuk pemeriksaan ini, dikembalikan tanpa perubahan.

Contoh:

"payout_20481"

Atur ke true jika pemegang akun telah memberikan persetujuan secara eksplisit untuk pemeriksaan ini. Diperlukan di negara-negara yang pemeriksaan akunnya membutuhkan persetujuan tersebut: tanpanya, pemeriksaan ditolak dengan 400 yang memiliki field bernilai consent dan reason bernilai required, serta tidak ada tagihan yang dikenakan. Di tempat lain, ini bersifat opsional, dan Didit mencatatnya bersama biaya pemeriksaan saat Anda mengirimkannya.

Contoh:

true

Respons

Bank memberikan jawaban. Biaya pemeriksaan tetap dikenakan, apa pun hasilnya.

request_id
string<uuid>
wajib

ID pemeriksaan ini.

result
enum<string>
wajib

match: bank menyimpan rekening dengan nama yang Anda kirimkan. close_match: dengan nama yang mirip, misalnya nama tengah yang hilang atau salah ketik. no_match: dengan nama lain, atau rekening tersebut tidak ada. cannot_verify: bank menjawab tanpa membandingkan nama, misalnya untuk rekening yang diblokir atau ditutup.

Opsi yang tersedia:
match,
close_match,
no_match,
cannot_verify
holder_name
string | null
wajib

Hanya pada close_match, dan hanya saat bank mengembalikannya: nama pada akun, sebagaimana yang tercatat di bank. Jika tidak, null.

account
string
wajib

Akun, dimasker hingga 4 karakter terakhirnya.

vendor_data
string | null
wajib

Referensi Anda sendiri, persis seperti yang Anda kirimkan.

created_at
string<date-time>
wajib

Waktu ketika pemeriksaan dijalankan, dalam UTC.

Terakhir diubah pada 7 November 2026