Langsung ke konten utama
API data perbankan Didit menyimpan akun, saldo, dan transaksi setiap koneksi, lalu menyajikannya melalui endpoint baca dengan paginasi (cursor pada daftar, page_token pada pembacaan transaksi). Jumlah uang ditulis sebagai string desimal dengan currency ISO 4217 yang terpisah, tanggal mengikuti ISO 8601, dan negara menggunakan kode ISO alpha-3. Pembacaan tidak pernah ditagih.

Akun

GET /v3/bank/connections/{id}/accounts/ menampilkan daftar akun dari sebuah koneksi, dan GET /v3/bank/accounts/{account_id}/ mengembalikan satu akun. Gunakan account_ref untuk mengenali akun bank ketika seseorang menghubungkannya kembali, dan gunakan id untuk segala hal di dalam satu koneksi.

Saldo

GET /v3/bank/accounts/{account_id}/balances/ mengembalikan saldo bertipe beserta tanggal referensinya.
Nilai type adalah booked, available atau expected, dan iso_type berisi kode ISO 20022 dari bank jika bank menyediakannya.

Transaksi

GET /v3/bank/accounts/{account_id}/transactions/ membaca rentang tanggal. Endpoint ini menerima date_from dan date_to (tanggal kalender sebagaimana dilaporkan bank, termasuk kedua tanggal tersebut), status (booked atau pending, keduanya secara default), limit (hingga 500) dan page_token. Hasil diurutkan berdasarkan effective_date secara menurun, lalu id.
  • id adalah milik Didit dan disimpan saat pertama kali terlihat. Pergerakan yang sama tetap memiliki id yang sama pada setiap pembacaan, sinkronisasi, dan perpanjangan.
  • identity_quality menunjukkan seberapa kuat jaminan tersebut. bank_reference dan route_id bersifat stabil. derived berarti pergerakan dicocokkan berdasarkan isinya, sehingga koreksi bank dapat muncul sebagai satu removed dan satu added.
  • status adalah booked atau pending. Transaksi pending memiliki id sendiri. Ketika bank membukukannya, transaksi yang sudah dibukukan datang sebagai added, dan transaksi pending datang sebagai removed dengan reason: pending_booked. pending_id diisi hanya jika bank menautkan keduanya.
  • amount bertanda: nilai negatif berarti uang keluar. direction mengulang tanda tersebut.
  • bank_reference adalah referensi entri bank yang tidak dapat diubah, bernilai null jika bank tidak menyediakannya. Didit tidak pernah membuatnya sendiri.
  • category adalah kategorisasi milik Didit sendiri, jika berlaku.
  • Koreksi bank terhadap transaksi yang sudah dibukukan berstatus modified. Pembalikan adalah transaksi baru, dengan reverses_id jika bank menautkannya.

Kolom yang tidak dikirim bank bernilai null

Setiap kolom yang tidak dikirim bank bernilai null. Institusi mencantumkan kolom yang diketahui dikirimnya di transaction_fields, bersama pending_transactions, pending_linkage, balance_types dan history_days_max, agar tidak ada yang baru menemukan kekurangan saat produksi. Gunakan pelanggan uji sparse_fields di sandbox untuk menguji kode Anda terhadap bank yang mengirim sedikit data.

Membaca rentang tanggal per halaman

Lanjutkan membaca dengan page_token selama has_more bernilai true. Token mengunci snapshot pembacaan selama satu jam: penambahan setelah halaman pertama tidak termasuk di dalamnya, setiap baris disajikan dalam kondisi terkininya, dan baris yang dihapus selama paging tidak muncul di halaman-halaman berikutnya serta akan muncul di change feed. Token yang kedaluwarsa menghasilkan 410 page_expired: mulai ulang pembacaan dari kueri aslinya.

Umpan perubahan

GET /v3/bank/connections/{id}/transactions/sync/ mengembalikan apa yang berubah di semua rekening dari sebuah koneksi sejak cursor tertentu.
  • Cursor kosong mengembalikan setiap transaksi saat ini sebagai added dengan reset: true. Ganti salinan Anda dengan hasil tersebut, jangan menambahkannya.
  • Terus lanjutkan paging dengan page_token selama has_more bernilai true. Simpan next_cursor hanya setelah respons dengan has_more: false, dan jika paging gagal di tengah jalan, mulai ulang dari cursor yang sudah Anda simpan.
  • Cursor bersifat opak dan tidak dapat diinterpretasikan, serta terikat pada koneksi dan lingkungan. Log perubahan dapat diputar ulang selama 90 hari. Cursor yang lebih lama akan menghasilkan respons 410 cursor_expired disertai bootstrap: true: mulai lagi dari cursor kosong dan ganti salinan Anda.
  • removed[].reason berisi pending_booked, pending_expired, bank_removed atau access_removed.
Versi langkah demi langkah ada di Umpan bank berkelanjutan untuk akuntansi. Kedua permintaan baca transaksi mengembalikan header X-RateLimit-* (600 permintaan baca dan 300 permintaan tulis per menit per aplikasi, dan 429 dengan Retry-After jika melebihi batas tersebut) serta X-Bank-Last-Synced-At. Batas API dan batas pengambilan data yang ditetapkan bank adalah dua hal yang terpisah: lihat Segarkan data bank sesuai permintaan.
Terakhir diubah pada 22 November 2026