Umpan bank berkelanjutan memberikan saldo dan transaksi rekening bank setiap klien kepada produk akuntansi atau pembukuan setiap hari, tanpa klien harus masuk kembali.
Dengan Didit, Anda membuat tautan dengan akses berkelanjutan, menerima webhook saat data baru tersedia, membaca hanya data yang berubah menggunakan kursor, memantau kapan persetujuan berakhir, dan menghentikan atau menghapus akses saat klien tidak lagi menjadi pelanggan.
Panduan ini membawa Anda dari nol hingga umpan harian untuk satu klien.
Kode yang sama berjalan untuk setiap klien: satu koneksi per klien dan per bank.
Yang Anda butuhkan
- Kunci API dengan izin data bank untuk aplikasi sandbox Anda. Lihat panduan cepat.
- Tujuan webhook yang menerima event
bank.*. Lihat Webhook bank.
- Tabel di database Anda untuk setiap ID koneksi klien, kursor umpan perubahan, dan akhir masa persetujuan.
Langkah 1: buat tautan dengan akses berkelanjutan
access: ongoing menjaga akses tetap terbuka hingga persetujuan berakhir. consent_days adalah permintaan: bank yang menentukan tanggal sebenarnya, yang ditampilkan pada koneksi.
history_from meminta riwayat sejak suatu tanggal, misalnya awal tahun. Gunakan history_days (1 sampai 365) sebagai gantinya jika Anda lebih suka, dan jangan pernah gunakan keduanya. Bank mungkin mengirimkan lebih sedikit: setiap rekening melaporkan history_coverage.
ownership.compare: none melewati perbandingan pemilik rekening, sehingga tidak diperlukan identitas referensi. Gunakan business untuk membandingkan pemilik rekening dengan perusahaan yang telah diverifikasi di Didit.
end_user.reference adalah ID Anda untuk klien. ID ini dapat dicari dan memungkinkan Didit mengenali klien yang sama saat menghubungkan rekening yang sama lagi.
- Kirim klien ke halaman yang di-hosting dan kembalikan mereka ke produk Anda dengan URL redirect.
Simpan id tautan bersama data klien.
Langkah 2: tunggu koneksi
Saat klien menyelesaikan proses, bank.link.completed dikirim beserta connection_id.
Konfirmasikan event tersebut, karena browser tidak pernah dipercaya:
Simpan connection_id dan tunggu bank.connection.created: akun, saldo, dan transaksi terbaru kemudian dapat dibaca (sync.initial_status bernilai succeeded atau partial).
bank.connection.history_complete dikirim saat pengambilan riwayat selesai.
Untuk setiap akun, history_coverage.oldest_booking_date menunjukkan seberapa jauh ke belakang bank benar-benar mengirimkan data.
Langkah 3: muat salinan pertama
Kursor kosong akan mengembalikan setiap transaksi terkini sebagai added dengan reset: true.
Lakukan paginasi melalui hasilnya dan simpan kursor hanya di akhir:
- Pembacaan pertama adalah snapshot sejati: pembacaan ini mengembalikan setiap transaksi yang tersedia pada koneksi saat pembacaan dimulai, masing-masing tepat satu kali sebagai
added, dalam keadaan terkininya, bahkan jika sinkronisasi berjalan saat Anda melakukan paginasi.
- Perubahan yang terjadi saat Anda melakukan paginasi akan tiba pada pembacaan berikutnya dari
next_cursor: transaksi yang sudah Anda terima akan datang lagi sebagai modified, dan transaksi baru sebagai added.
- Simpan
next_cursor hanya setelah respons dengan has_more: false.
- Jika paginasi gagal di tengah jalan, mulai ulang dari kursor yang telah tersimpan.
- Baca saldo dengan
GET /v3/bank/accounts/{account_id}/balances/.
Didit menyinkronkan setiap koneksi berkelanjutan yang aktif secara otomatis, antara satu hingga empat kali sehari, tergantung bank (sync.frequency_per_day).
Saat sinkronisasi menyimpan perubahan, bank.data.updated dikirim dengan connection_id, account_ids, dan jumlahnya.
Panggil feed perubahan dengan cursor yang sudah Anda simpan:
added adalah transaksi baru, termasuk transaksi yang masih tertunda.
modified adalah transaksi yang berubah, dalam kondisi terkininya. Terapkan setiap item sebagai upsert berdasarkan id: transaksi yang sudah Anda miliki akan diperbarui, dan transaksi yang belum Anda miliki akan ditambahkan.
removed memiliki reason. Abaikan id yang tidak Anda miliki. Saat transaksi tertunda dibukukan, transaksi itu muncul di removed dengan pending_booked, dan transaksi yang sudah dibukukan muncul di added.
Gunakan id transaksi sebagai kunci Anda: nilainya tetap sama di seluruh pembacaan, sinkronisasi, dan perpanjangan koneksi.
Periksa identity_quality: dengan derived, koreksi bank dapat muncul sebagai satu removed dan satu added.
Pembacaan tidak pernah ditagih, tetapi data hanya berubah saat sinkronisasi berjalan, jadi satu pembacaan per webhook sudah cukup.
Untuk mengambil data lebih cepat, gunakan Sync Now: Segarkan data bank sesuai permintaan.
Langkah 5: Menangani pengaturan ulang
Kursor yang lebih lama dari jendela pemutaran ulang menghasilkan 410 cursor_expired dengan bootstrap: true.
Log perubahan dapat diputar ulang selama 90 hari, jadi kejadian ini jarang terjadi untuk tugas harian.
Mulai lagi dari kursor kosong, dan ganti salinan Anda dengan hasilnya alih-alih menambahkannya.
Setiap pembacaan dari kursor kosong menyertakan reset: true, sehingga jalur kode yang sama menangani koneksi baru dan kursor yang kedaluwarsa.
Langkah 6: pantau berakhirnya persetujuan
Persetujuan memiliki tanggal berakhir: consent.expires_at.
Didit mengirimkan bank.connection.consent_expiring 14, 7, dan 1 hari sebelumnya.
Panggil renew_connection saat Anda ingin memperpanjang: API akan menjawab 409 renewal_not_needed selama masih tersisa lebih dari 30 hari.
Halaman tempat klien menyelesaikan perpanjangan belum tersedia.
Jika klien membiarkan persetujuan berakhir, koneksi berstatus renewal_required: Anda tetap dapat membaca data yang sudah disinkronkan.
Rinciannya ada di Perpanjang persetujuan bank.
Langkah 7: hentikan akses dan hapus data
- Klien meninggalkan produk Anda: panggil
revoke_connection untuk langsung berhenti membaca data, atau delete_connection untuk berhenti dan menghapus data yang tersimpan.
- Klien berhenti berbagi di bank:
bank.connection.revoked dikirim beserta ended_by. Hentikan aliran data Anda untuk koneksi tersebut.
Harga
Akses berkelanjutan ditagih per koneksi aktif per bulan.
Harga mencakup setiap rekening dalam koneksi, saldo, transaksi, riwayat hingga 365 hari jika disediakan oleh bank, sinkronisasi otomatis, sinkronisasi langsung dalam batas bank, perpanjangan, webhook, dan semua pembacaan data.
Tautan yang tidak diselesaikan oleh siapa pun tidak dikenai biaya, begitu pula koneksi dengan status renewal_required, paused, dan revoked.
Lihat harga.
Daftar periksa
Terakhir diubah pada 22 November 2026