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 dengan403 bank_data_access_denied.
- Di Business Console, buka aplikasi sandbox Anda lalu buka API keys.
- Buat kunci dengan akses kustom dan tambahkan Bank data: Read untuk operasi baca, Write untuk panggilan yang membuat, mengubah, atau menghapus sesuatu.
- Salin kunci tersebut lalu ekspor:
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).
id tautan bersama pengguna Anda.
url dan client_token hanya dikembalikan sekali, saat tautan dibuat.
Langkah 3: buka tautan dan hubungkan Didit Test Bank
Bukaurl 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 eventbank.* 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
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 sebagaiadded, 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: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.id, status, status_reason, created_at dan erasure.
Lihat Data, persetujuan dan penghapusan.
Langkah berikutnya
- Koneksi: akses sekali dan berkelanjutan, persetujuan, dan perpanjangan.
- Webhook bank
- Harga
- Referensi API