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

# Perpanjang Persetujuan Bank: Masa Berlaku, Pengingat, dan Kedaluwarsa

> Masa berlaku persetujuan bank di Didit, kapan pengingat dikirim, respons panggilan perpanjangan, dan yang terjadi saat persetujuan kedaluwarsa.

Persetujuan bank berlaku selama bank mengizinkannya, lalu harus diperbarui oleh orang tersebut.
Didit memberi tahu Anda sebelum persetujuan berakhir dan menyediakan panggilan untuk memperbarui koneksi yang sama.

## Berapa lama masa berlakunya

* Bank dan rute menentukan tanggal berakhir, paling lama selama `consent_days` yang Anda minta.
* Setiap koneksi menampilkan tanggal sebenarnya di `consent.expires_at` dan `consent.renew_by`.
* Lembaga menampilkan durasi persetujuan terpanjang yang diizinkan bank dalam `consent_days_max`.
* Jangan pernah menjanjikan kepada pengguna Anda jumlah hari yang tetap: sebutkan "hingga" tanggal yang tertera pada koneksi.

## Ketahui sebelumnya

`bank.connection.consent_expiring` dikirim 14, 7, dan 1 hari sebelum berakhir.
Anda juga dapat membuat daftar koneksi yang akan segera berakhir:

```bash theme={null}
curl "https://verification.didit.me/v3/bank/connections/?status=active&consent_expires_before=2026-12-15" \
  -H "x-api-key: $DIDIT_API_KEY"
```

## Perpanjangan

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/renew/ \
  -H "x-api-key: $DIDIT_API_KEY" -H "content-type: application/json" \
  -d '{ "redirect_url": "http://localhost:3000/bank/return" }'
```

Respons berisi `201` dengan tautan perpanjangan, atau salah satu dari berikut:

| Respons | Arti |
| - | - |
| `409 renewal_not_needed` | Masih ada lebih dari 30 hari. Coba lagi nanti. |
| `409 renewal_window_expired` | `consent.renewable_until` sudah lewat. Pengguna akhir terhubung kembali menggunakan tautan baru. |

Halaman tempat pengguna akhir menyelesaikan perpanjangan belum tersedia, jadi jangan arahkan pengguna akhir ke tautan perpanjangan saat ini.
Sampai halaman tersedia, gunakan pengingat di atas untuk mengetahui kapan persetujuan berakhir.

## Jika persetujuan berakhir

* Koneksi berubah menjadi `renewal_required` dengan `status_reason: consent_expired` atau `bank_requires_sign_in`.
* Anda masih dapat membaca data yang telah disinkronkan, tidak ada yang disinkronkan atau ditagih, dan `bank.connection.renewal_required` dikirim.
* Setelah `consent.renewable_until`, koneksi menjadi `revoked` dengan `status_reason: consent_lapsed`, dan pengguna terhubung kembali.

## Terkait

* [Koneksi](https://docs.didit.me/id/core-technology/bank-verification/connections.md)
* [Umpan bank berkelanjutan untuk akuntansi](https://docs.didit.me/id/use-cases/bank-data-for-accounting.md)
* [Data, persetujuan, dan penghapusan](https://docs.didit.me/id/core-technology/bank-verification/data-consent-and-deletion.md)


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