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 batasconsent_days yang Anda minta.
Setiap koneksi menampilkan tanggal sebenarnya di consent:
expires_atdanrenew_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_granteddanaccounts_granted: apa yang telah diberikan, dan berapa kali persetujuan telah diperpanjang.
Perpanjangan
Perpanjangan mempertahankan ID koneksi dan setiap ID akun, dan riwayat terus berlanjut tanpa duplikat.- Didit mengirim
bank.connection.consent_expiring14, 7, dan 1 hari sebelum persetujuan berakhir. - Panggil
POST /v3/bank/connections/{id}/renew/. Endpoint ini menjawab409 renewal_not_neededselama masih ada lebih dari 30 hari, dan409 renewal_window_expiredsetelahconsent.renewable_until. Jika tidak, endpoint ini menjawab201dengan tautan perpanjangan.
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 mengembalikanid, 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 denganend_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/menerimastatus,access,institution_id,country,vendor_data,end_user_reference,consent_expires_before, dancreated_after. - Lihat biaya setiap koneksi melalui objek
billing: satuan, harga, dan bulan yang sudah dilunasi.