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

# Feed Bank Berkelanjutan untuk Akuntansi: Saldo dan Transaksi

> Bangun feed harian saldo dan transaksi untuk tiap klien dengan Didit: tautan berkelanjutan, webhook, change feed berbasis cursor, dan penghentian.

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](https://docs.didit.me/id/core-technology/bank-verification/quickstart.md#langkah-1-buat-kunci-api-dengan-izin-bank-data).
* Tujuan webhook yang menerima event `bank.*`. Lihat [Webhook bank](https://docs.didit.me/id/core-technology/bank-verification/webhooks.md).
* Tabel di database Anda untuk setiap ID koneksi klien, kursor umpan perubahan, dan akhir masa persetujuan.

## Langkah 1: buat tautan dengan akses berkelanjutan

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/links/ \
  -H "x-api-key: $DIDIT_API_KEY" -H "content-type: application/json" \
  -d '{
    "access": "ongoing",
    "country": "ESP",
    "segment": "business",
    "data": ["accounts", "balances", "transactions"],
    "history_from": "2026-01-01",
    "consent_days": 180,
    "ownership": { "compare": "none" },
    "end_user": { "reference": "client-7731", "email": "ana@example.com" },
    "redirect_url": "http://localhost:3000/bank/return",
    "vendor_data": "client-7731"
  }'
```

* `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](https://docs.didit.me/id/integration/bank-link/hosted-link.md) dan kembalikan mereka ke produk Anda dengan [URL redirect](https://docs.didit.me/id/integration/bank-link/return-to-your-site.md).

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:

```bash theme={null}
curl https://verification.didit.me/v3/bank/links/$LINK_ID/ -H "x-api-key: $DIDIT_API_KEY"
```

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:

```bash theme={null}
curl "https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/transactions/sync/?limit=500" \
  -H "x-api-key: $DIDIT_API_KEY"
```

```python theme={null}
cursor, page_token = stored_cursor or "", None
while True:
    params = {"limit": 500, "page_token": page_token} if page_token else {"cursor": cursor, "limit": 500}
    page = get(f"/v3/bank/connections/{connection_id}/transactions/sync/", params)
    if page["reset"] and not page_token:
        wipe_local_copy(connection_id)       # replace, never append
    apply(page["added"], page["modified"], page["removed"])
    if not page["has_more"]:
        store_cursor(connection_id, page["next_cursor"])
        break
    page_token = page["next_page_token"]
```

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

## Langkah 4: tetap mendapatkan informasi terbaru dari setiap webhook

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

## 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`](https://docs.didit.me/id/standalone-apis/bank-connection-renew) 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](https://docs.didit.me/id/use-cases/renew-bank-consent.md).

## Langkah 7: hentikan akses dan hapus data

* Klien meninggalkan produk Anda: panggil [`revoke_connection`](https://docs.didit.me/id/standalone-apis/bank-connection-revoke) untuk langsung berhenti membaca data, atau [`delete_connection`](https://docs.didit.me/id/standalone-apis/bank-connection-delete) 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](https://docs.didit.me/id/getting-started/bank-verification-pricing.md#data-perbankan-dan-akses-berkelanjutan).

## Daftar periksa

* [ ] Satu koneksi per klien dan bank, disimpan beserta kursor dan tanggal berakhirnya persetujuan.
* [ ] Handler webhook bersifat idempoten, dengan kunci berupa ID event.
* [ ] `reset: true` menggantikan salinan Anda, tidak pernah menambahkannya.
* [ ] `removed` ditangani beserta alasannya.
* [ ] Pengingat persetujuan terhubung ke pemberitahuan Anda sendiri kepada klien.
* [ ] `bank.connection.revoked` menghentikan aliran data.
* [ ] Paket sandbox di [Sandbox](https://docs.didit.me/id/core-technology/bank-verification/sandbox.md#rencana-pengujian-yang-baik) lolos.


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