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

# Koneksi Bank: Akses Berkelanjutan, Persetujuan, dan Pembaruan

> Koneksi adalah izin pengguna untuk membaca satu bank di Didit. Lihat status, akhir persetujuan, cara memperbarui, dan cara mencabut akses.

Koneksi bank Didit adalah izin dari seseorang atau perusahaan agar aplikasi Anda dapat membaca satu bank, beserta tanggal persetujuannya, status sinkronisasinya, dan rekeningnya.
[Bank Link](https://docs.didit.me/id/core-technology/bank-verification/bank-link.md) yang telah selesai akan membuat koneksi ini, dan koneksi tersebut berlaku selama bank dan orang tersebut mengizinkan.

Data bank tersedia untuk aplikasi sandbox; panggilan dari aplikasi produksi akan menjawab `404` hingga akses produksi diumumkan.

## Akses sekali dan berkelanjutan

| | Satu kali | Berkelanjutan |
| - | - | - |
| `access` | `one_time` (bawaan) | `ongoing` |
| Yang terjadi | Data dibaca sekali saat orang tersebut terhubung, lalu akses berakhir (`status_reason: collection_complete`). | Akses tetap terbuka sampai persetujuan berakhir atau dihentikan oleh seseorang. |
| Data setelahnya | Dapat dibaca melalui endpoint yang sama. | Disinkronkan secara otomatis satu hingga empat kali sehari, tergantung bank, ditambah sinkronisasi langsung sesuai permintaan. |
| Penagihan | Per pemeriksaan, lihat [harga](https://docs.didit.me/id/getting-started/bank-verification-pricing.md) | Per koneksi aktif per bulan, lihat [harga](https://docs.didit.me/id/getting-started/bank-verification-pricing.md) |

Akses berkelanjutan hanya berfungsi di bank yang mengizinkannya.
Tanyakan ke [endpoint institusi](https://docs.didit.me/id/standalone-apis/bank-institutions-list.md) atau baca [halaman cakupan](https://docs.didit.me/id/core-technology/bank-verification/coverage.md).
Jika bank tidak dapat mempertahankan akses tetap terbuka, pengguna akhir diberi tahu bahwa bank tersebut tidak mengizinkan akses berkelanjutan dan harus memilih bank lain.
Atur `allow_one_time_fallback: true` agar pengguna akhir dapat melanjutkan dengan pembacaan satu kali setelah mengonfirmasi akses terbatas di layarnya sendiri: koneksi kemudian menjadi `one_time`.

## Status

| `status` | Arti | Data dapat dibaca | Sinkronisasi | Ditagih |
| - | - | - | - | - |
| `pending` | Tautan telah diselesaikan dan sinkronisasi pertama sedang berjalan. | Belum | Berjalan | Tidak |
| `active` | Persetujuan masih berlaku dan sinkronisasi berjalan normal atau sedang dicoba ulang. | Ya | Ya | Ya |
| `renewal_required` | Persetujuan telah berakhir, atau bank meminta pengguna akhir untuk masuk kembali. `status_reason` menunjukkan alasannya. | Sesuai data terakhir yang disinkronkan | Tidak | Tidak |
| `paused` | Saldo tidak cukup untuk menutupi bulan ini. | Sesuai data terakhir yang disinkronkan | Tidak | Tidak |
| `revoked` | Akses dihentikan oleh pengguna akhir, bank, atau Anda. `consent.ended_by` menunjukkan siapa yang menghentikannya. | Hingga `consent.retain_until` | Tidak | Tidak |
| `deleted` | Koneksi dan datanya telah dihapus. | Tidak | Tidak | Tidak |
| `failed` | Sinkronisasi pertama tidak pernah berhasil. | Tidak | Tidak | Tidak |

`status_reason` adalah salah satu dari `collection_complete`, `consent_expired`, `consent_lapsed`, `bank_requires_sign_in`, `revoked_by_end_user`, `revoked_by_bank`, `revoked_by_customer`, `insufficient_balance`, `paused_by_customer` (dicadangkan, saat ini tidak ada endpoint yang mengaturnya) dan `first_sync_failed`.

## Persetujuan

Bank menetapkan akhir persetujuan, hingga batas `consent_days` yang Anda minta.
Setiap koneksi menampilkan tanggal sebenarnya di `consent`:

* `expires_at` dan `renew_by`: akhir persetujuan. Perpanjang sebelum tanggal tersebut agar tidak ada celah.
* `renewable_until`: batas waktu terakhir koneksi yang sama masih dapat dihidupkan kembali setelah persetujuan berakhir.
* `renewed_count`, `version`, `scopes_granted` dan `accounts_granted`: apa yang telah diberikan, dan berapa kali persetujuan telah diperpanjang.

Persetujuan berlaku selama bank mengizinkan.
Baca nilai aktual pada setiap koneksi dan nilai per bank pada institusi.

## Perpanjangan

Perpanjangan mempertahankan ID koneksi dan setiap ID akun, dan riwayat terus berlanjut tanpa duplikat.

1. Didit mengirim `bank.connection.consent_expiring` 14, 7, dan 1 hari sebelum persetujuan berakhir.
2. Panggil [`POST /v3/bank/connections/{id}/renew/`](https://docs.didit.me/id/standalone-apis/bank-connection-renew). Endpoint ini menjawab `409 renewal_not_needed` selama masih ada lebih dari 30 hari, dan `409 renewal_window_expired` setelah `consent.renewable_until`. Jika tidak, endpoint ini menjawab `201` dengan tautan perpanjangan.

Halaman tempat pengguna menyelesaikan perpanjangan belum tersedia, jadi jangan mengarahkan pengguna ke tautan perpanjangan saat ini.

Jika pengguna membiarkan persetujuan kedaluwarsa, koneksi berubah menjadi `renewal_required`: data tetap dapat dibaca sebagaimana terakhir disinkronkan, dan tidak ada biaya yang dikenakan.
Setelah `consent.renewable_until`, statusnya menjadi `revoked` dengan `status_reason: consent_lapsed`, dan pengguna terhubung kembali.

Untuk alur lengkapnya, lihat [Memperbarui persetujuan bank](https://docs.didit.me/id/use-cases/renew-bank-consent.md).

## Hentikan akses

| Siapa | Cara | Yang terjadi |
| - | - | - |
| Pengguna akhir | **Stop sharing** di bank mereka | `bank.connection.revoked` dengan `ended_by: end_user` atau `bank` |
| Anda | [`revoke_connection`](https://docs.didit.me/id/standalone-apis/bank-connection-revoke) | Bank langsung menerima permintaan penghentian. Status persetujuan menjadi `revocation_pending`, lalu `revoked` setelah bank mengonfirmasi. Data yang sudah dibaca tetap dapat diakses hingga Anda menghapus koneksi atau `consent.retain_until` terlewati. |
| Anda | [`delete_connection`](https://docs.didit.me/id/standalone-apis/bank-connection-delete) | Menghentikan akses dan menghapus koneksi beserta rekening, saldo, dan transaksinya. Tidak dapat dibatalkan. |

Menghentikan akses tidak sama dengan menghapus.
Baca [Data, persetujuan, dan penghapusan](https://docs.didit.me/id/core-technology/bank-verification/data-consent-and-deletion.md) untuk mengetahui secara rinci apa saja yang dihapus.

## Koneksi yang dihapus

Koneksi yang dihapus hanya mengembalikan `id`, `status` (`deleted`), `status_reason`, `created_at`, dan `erasure`.
Nilai `status_reason` adalah `deleted_by_customer`, `consent_lapsed`, `retention_elapsed`, atau `application_deleted`.
Semua kolom lainnya tidak ada.

## Duplikat

Tautan baru yang mengarah tepat ke akun yang sudah Anda bagikan dengan `end_user.reference` yang sama di bank yang sama akan diselesaikan sebagai perpanjangan koneksi tersebut (`reused: true`) dan tidak dikenai biaya dua kali.
Tumpang tindih lainnya akan membuat tautan berstatus `failed` dengan `duplicate_conflict` dan `conflicts_with`, sebelum apa pun disimpan atau ditagih.
Perpanjang koneksi yang sudah ada, atau buat ulang tautan dengan `"duplicates": "allow"` untuk koneksi kedua yang independen.

## Kelola koneksi klien Anda

* Daftar dengan filter: [`GET /v3/bank/connections/`](https://docs.didit.me/id/standalone-apis/bank-connections-list) menerima `status`, `access`, `institution_id`, `country`, `vendor_data`, `end_user_reference`, `consent_expires_before`, dan `created_after`.
* Lihat biaya setiap koneksi melalui objek `billing`: satuan, harga, dan bulan yang sudah dilunasi.


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