Langsung ke konten utama
Data perbankan tersedia untuk aplikasi sandbox. Panggilan dari aplikasi live akan menghasilkan 404 hingga akses live diumumkan, dan tidak ada biaya yang dikenakan di sandbox. Panduan memulai cepat ini membawa Anda dari aplikasi sandbox ke akun, saldo, dan transaksi Didit Test Bank dengan permintaan yang dapat disalin-tempel.
Setiap respons di bawah ini dipersingkat menjadi hanya kolom yang penting. Simpan kunci API di server Anda: kunci ini tidak pernah sampai ke browser atau aplikasi.

Langkah 1: buat kunci API dengan izin Bank data

Bank data tidak termasuk dalam akses penuh. Kunci akses penuh, termasuk rahasia utama aplikasi, ditolak pada setiap panggilan Bank data dengan 403 bank_data_access_denied.
  1. Di Business Console, buka aplikasi sandbox Anda lalu buka API keys.
  2. Buat kunci dengan akses kustom dan tambahkan Bank data: Read untuk operasi baca, Write untuk panggilan yang membuat, mengubah, atau menghapus sesuatu.
  3. Salin kunci tersebut lalu ekspor:
Lihat Kunci API untuk daftar lengkap sumber daya.

Langkah 2: buat tautan

Tautan adalah satu rangkaian layar tempat pengguna akhir menghubungkan bank. Buat tautan berkelanjutan untuk Test Bank:
country adalah kode negara tiga huruf dari bank pengguna akhir dan bersifat opsional. Kirimkan nilai ini jika Anda mengetahuinya, agar pengguna akhir hanya melihat bank dari negara tersebut; tanpa nilai ini, pengguna akhir memilih dari semua negara yang dapat Anda layani. Untuk akses sekali pakai, kirimkan "access": "one_time" (bawaan).
Simpan id tautan bersama pengguna Anda. url dan client_token hanya dikembalikan sekali, saat tautan dibuat.

Langkah 3: buka tautan dan hubungkan Didit Test Bank

Buka url di browser, atau kirimkan ke pengguna melalui email atau chat. Pengguna melihat layar persetujuan, memilih Didit Test Bank, masuk dengan salah satu pelanggan uji, lalu memilih rekening yang akan dibagikan. Halaman sandbox mencantumkan pelanggan uji beserta data yang didapat dari masing-masing. Untuk mengarahkan pengguna kembali ke situs Anda setelahnya, lihat Kembali ke situs Anda. Tanpa redirect_url, pengguna menyelesaikan proses di halaman hasil Didit, dan Anda mengetahui hasilnya melalui webhook atau permintaan baca.

Langkah 4: terima webhook dan konfirmasi

Berlanggananlah suatu tujuan ke event bank.* di konsol, seperti untuk webhook lainnya. Saat pengguna menyelesaikan proses, bank.link.completed dikirim dengan link_id dan connection_id, lalu bank.connection.created setelah sinkronisasi pertama menyimpan akun. Jangan pernah percaya pada ID tautan yang dikirim browser kepada Anda. Ambil data tautan itu sendiri:
status bernilai completed atau salah satu status akhir (cancelled, expired, failed). Tautan berstatus failed memiliki error.code; tautan berstatus cancelled memiliki error: null.

Langkah 5: baca akun, saldo, dan transaksi

Jumlah dinyatakan sebagai string desimal, bernilai negatif untuk uang keluar. Halaman transaksi memuat next_page_token selama masih ada data yang belum dibaca. Lihat Akun, saldo, dan transaksi.

Langkah 6: ikuti umpan perubahan

Umpan perubahan hanya mengembalikan data yang berubah sejak pembacaan terakhir Anda. Pembacaan pertama Anda, tanpa kursor, adalah snapshot lengkap: setiap transaksi yang dimiliki koneksi, masing-masing sebagai added, dengan reset: true. Halaman pertama dapat memuat has_more: true dengan next_page_token dan belum ada next_cursor. Terus baca dengan page_token selama has_more bernilai true, lalu simpan next_cursor dari halaman terakhir (yang memiliki has_more: false) untuk pembacaan berikutnya:
reset: true berarti respons adalah snapshot lengkap: ganti salinan Anda dengan respons tersebut, bukan menambahkannya. bank.data.updated memberi tahu Anda saat sinkronisasi menyimpan data baru.

Langkah 7: sinkronkan sekarang

Koneksi berkelanjutan menyinkronkan dirinya sendiri secara otomatis. Untuk membaca data bank sekarang, minta sinkronisasi:
Bank membatasi jumlah pembacaan tanpa interaksi pengguna per hari. sync.live_syncs_left_today dan sync.budgets pada koneksi menunjukkan sisa kuota dan waktu reset-nya. Panggilan yang melebihi batas akan menghasilkan respons 429 refresh_limit_reached beserta waktu reset. Lihat Perbarui data bank sesuai permintaan.

Langkah 8: hentikan akses dan hapus

Menghentikan akses dan menghapus adalah dua panggilan yang berbeda.
Koneksi yang sudah dihapus hanya merespons id, status, status_reason, created_at dan erasure. Lihat Data, persetujuan dan penghapusan.

Langkah berikutnya

Terakhir diubah pada 22 November 2026