Langsung ke konten utama
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 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

Akses berkelanjutan hanya berfungsi di bank yang mengizinkannya. Tanyakan ke endpoint institusi atau baca halaman cakupan. 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_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/. 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.

Hentikan akses

Menghentikan akses tidak sama dengan menghapus. Baca Data, persetujuan, dan penghapusan 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/ 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.
Terakhir diubah pada 22 November 2026