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.
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.
idadalah milik Didit dan disimpan saat pertama kali terlihat. Pergerakan yang sama tetap memiliki id yang sama pada setiap pembacaan, sinkronisasi, dan perpanjangan.identity_qualitymenunjukkan seberapa kuat jaminan tersebut.bank_referencedanroute_idbersifat stabil.derivedberarti pergerakan dicocokkan berdasarkan isinya, sehingga koreksi bank dapat muncul sebagai saturemoveddan satuadded.statusadalahbookedataupending. Transaksi pending memiliki id sendiri. Ketika bank membukukannya, transaksi yang sudah dibukukan datang sebagaiadded, dan transaksi pending datang sebagairemoveddenganreason: pending_booked.pending_iddiisi hanya jika bank menautkan keduanya.amountbertanda: nilai negatif berarti uang keluar.directionmengulang tanda tersebut.bank_referenceadalah referensi entri bank yang tidak dapat diubah, bernilainulljika bank tidak menyediakannya. Didit tidak pernah membuatnya sendiri.categoryadalah kategorisasi milik Didit sendiri, jika berlaku.- Koreksi bank terhadap transaksi yang sudah dibukukan berstatus
modified. Pembalikan adalah transaksi baru, denganreverses_idjika bank menautkannya.
Kolom yang tidak dikirim bank bernilai null
Setiap kolom yang tidak dikirim bank bernilainull.
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 denganpage_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
addeddenganreset: true. Ganti salinan Anda dengan hasil tersebut, jangan menambahkannya. - Terus lanjutkan paging dengan
page_tokenselamahas_morebernilai true. Simpannext_cursorhanya setelah respons denganhas_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_expireddisertaibootstrap: true: mulai lagi dari cursor kosong dan ganti salinan Anda. removed[].reasonberisipending_booked,pending_expired,bank_removedatauaccess_removed.
Header
Kedua permintaan baca transaksi mengembalikan headerX-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.