> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# API Rekening, Saldo & Transaksi Bank: Model Data

> Model data Bank Didit: rekening dengan ID stabil, saldo bertipe, transaksi dibukukan dan tertunda, serta feed perubahan dengan kursor yang tahan lama.

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.

| Kolom | Arti |
| - | - |
| `id` | Terikat pada koneksi dan tidak pernah berubah selama koneksi itu ada, termasuk saat koneksi diperbarui. |
| `account_ref` | Mengidentifikasi akun bank yang sama di seluruh koneksi dalam satu aplikasi dan lingkungan. Nilainya adalah hash berkunci dari pengenal milik bank, dan bernilai `null` jika bank tidak memberikan pengenal yang andal. |
| `type`, `usage` | `current`, `savings`, `card`, `loan`, `investment` atau `other`, serta `personal`, `business` atau `unknown`. |
| `identifiers` | IBAN, BIC, dan pengenal lainnya. Pemanggil sisi server yang memiliki izin data bank menerima data ini secara lengkap. |
| `holders[]` | Setiap pemegang rekening dengan `name` dan `role`: `holder`, `joint_holder`, `representative` atau `unknown`. |
| `sync.last_synced_at` | Waktu terakhir Didit mengambil data dari bank, bukan waktu terakhir Anda membacanya. |
| `history_coverage` | Bagian riwayat yang diminta dan dikirim oleh bank: `requested_from`, `oldest_booking_date`, `covered_ranges`, `missing_ranges`, serta `status` berupa `complete`, `partial`, `empty`, `unavailable` atau `unknown`. |

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.

```json theme={null}
{
  "account_id": "a71f0c2e-...",
  "balances": [
    { "type": "booked", "amount": "18250.34", "currency": "EUR", "reference_date": "2026-11-20" },
    { "type": "available", "amount": "17990.34", "currency": "EUR", "reference_date": "2026-11-21" }
  ],
  "last_synced_at": "2026-11-21T12:04:40Z"
}
```

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`.

```json theme={null}
{
  "id": "8f2b...",
  "status": "booked",
  "booking_date": "2026-11-19",
  "value_date": "2026-11-20",
  "amount": "-1210.00",
  "currency": "EUR",
  "direction": "debit",
  "description": "RECIBO SEGURIDAD SOCIAL",
  "counterparty": { "name": "TESORERIA GENERAL SEG SOCIAL", "iban": "ES7620770024003102575766" },
  "remittance": { "unstructured": ["RECIBO SEGURIDAD SOCIAL 10/2026"], "reference": "0028123456789" },
  "bank_transaction_code": "PMNT-RDDT-ESDD",
  "bank_reference": "2026111900012345",
  "identity_quality": "bank_reference",
  "balance_after": "18250.34",
  "category": "taxes_and_social_security"
}
```

* **`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](https://docs.didit.me/id/core-technology/bank-verification/sandbox.md) 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.

```json theme={null}
{
  "added": [ { "id": "...", "status": "booked", "amount": "-35.00" } ],
  "modified": [],
  "removed": [ { "id": "...", "reason": "pending_booked" } ],
  "has_more": false,
  "next_cursor": "...",
  "reset": false
}
```

* 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](https://docs.didit.me/id/use-cases/bank-data-for-accounting.md).

## Header

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](https://docs.didit.me/id/use-cases/refresh-bank-data-on-demand.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.