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

# Sinkronisasi Sekarang: Perbarui Data Bank Sesuai Permintaan

> Minta data bank terbaru sebuah koneksi kapan saja dengan satu panggilan, tunggu hasilnya, dan ketahui batas harian bank serta respons 429 di Didit.

Sync Now dari Didit membaca data terbaru sebuah koneksi dari bank kapan pun, hanya dengan satu panggilan.
Sinkronisasi langsung sudah termasuk dalam harga bulanan koneksi: tidak ada biaya tambahan yang dikenakan.
Satu-satunya batasan berasal dari bank.

## Sinkronisasi otomatis

* Sinkronisasi pertama berjalan saat orang tersebut terhubung.
* Setelah itu, setiap koneksi berkelanjutan yang aktif disinkronkan secara otomatis satu hingga empat kali sehari, tergantung bank. `sync.frequency_per_day` pada koneksi menunjukkan jumlahnya, dan `sync.next_sync_at` menunjukkan kapan sinkronisasi berikutnya dijadwalkan.
* Jika bank mengizinkan lebih banyak pembacaan tanpa pengawasan per hari, minimal dua kali sehari selalu disisakan untuk sinkronisasi langsung.
* Ketika sinkronisasi menyimpan perubahan, `bank.data.updated` dikirim dan Anda membaca [umpan perubahan](https://docs.didit.me/id/standalone-apis/bank-transactions-sync.md) menggunakan kursor Anda.
* Sinkronisasi yang gagal akan dicoba ulang dengan penundaan bertahap. Setelah kegagalan berlangsung selama 24 jam, koneksi tetap `active` dengan `sync.status: failing`, dan `bank.sync.failed` dikirim. `bank.sync.recovered` dikirim saat sinkronisasi kembali berfungsi.
* Ketika bank meminta orang tersebut untuk masuk kembali, koneksi berubah menjadi `renewal_required`.

## Sinkronkan sekarang, dalam satu panggilan

Tambahkan `"wait": true` dan satu permintaan akan mengembalikan data terbaru:

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

Header `Prefer: wait=25` memberikan hasil yang sama.
Panggilan ini menunggu hingga 25 detik:

| Respons | Arti |
| - | - |
| `200` | Sinkronisasi selesai. Isi respons berisi sinkronisasi beserta `outcome`-nya, jumlah per akun untuk `added`, `modified` dan `removed`, serta `balances_changed`. |
| `202` | Bank belum merespons dalam 25 detik, atau Anda tidak meminta untuk menunggu. Isi respons berisi `sync_id`: baca sinkronisasi dengan `get_sync_run`, atau berlangganan `bank.sync.completed`. `bank.data.updated` hanya menyusul jika sinkronisasi menyimpan perubahan. |

```json theme={null}
{
  "id": "d4a9e7b2-1c58-4f03-96ab-5e2d8c7f0b14",
  "trigger": "requested",
  "status": "succeeded",
  "outcome": "succeeded",
  "balances_changed": true,
  "results": [{ "resource": "transactions", "outcome": "succeeded", "added": 3, "modified": 0, "removed": 1 }]
}
```

Jika sinkronisasi sudah berjalan, Anda akan mendapatkan `sync_id` yang sama, bukan sinkronisasi kedua.
Setelah `200` atau `bank.data.updated`, baca feed perubahan dengan cursor yang Anda simpan.
Baca apa yang dilakukan oleh sinkronisasi tersebut nanti dengan [`get_sync_run`](https://docs.didit.me/id/standalone-apis/bank-sync-run-get).

## Harga

Sinkronisasi otomatis dan sinkronisasi langsung sama-sama termasuk dalam harga bulanan koneksi, lihat [harga](https://docs.didit.me/id/getting-started/bank-verification-pricing.md).
Sinkronisasi langsung tidak pernah menambah biaya.

## Batas harian bank

Bank membatasi seberapa sering data dapat diambil tanpa kehadiran pengguna.
Aturan Eropa memungkinkan bank membatasi akses tanpa kehadiran pengguna menjadi empat kali pengambilan data per hari untuk setiap rekening.
Itu adalah batas maksimum, bukan jaminan: bank dapat mengizinkan lebih sedikit atau menyetujui lebih banyak.

* Sinkronisasi otomatis dan langsung menggunakan kuota yang sama, dan jadwal otomatis tidak pernah menggunakan dua pembacaan terakhir dalam sehari.
* `sync.live_syncs_left_today` pada koneksi menunjukkan berapa sinkronisasi langsung yang tersisa hari ini, dan `sync.budgets[]` menampilkan setiap kuota: `scope` (`connection` atau `account`), `resource`, `limit`, `remaining` dan `resets_at`.
* Selama pengguna hadir di Bank Link, untuk perpanjangan atau koneksi ulang, pengambilan data tidak dibatasi.
* Ketika kuota harian habis, permintaan mengembalikan respons `429 refresh_limit_reached` dengan header `Retry-After` (jumlah detik hingga kuota direset) dan objek `sync` yang berisi `live_syncs_left_today` dan `budgets`. Tunggu selama itu, dan andalkan sinkronisasi otomatis sementara itu.
* Batas API Anda terpisah: 600 operasi baca dan 300 operasi tulis per menit per aplikasi, dengan header `X-RateLimit-*`.

## Mengetahui seberapa mutakhir datanya

* `sync.last_synced_at` pada koneksi dan pada setiap akun menunjukkan kapan Didit terakhir mengambil data dari bank, bukan kapan Anda terakhir membacanya.
* Kedua permintaan untuk membaca transaksi mengembalikan `X-Bank-Last-Synced-At`.

## Kesalahan yang perlu Anda tangani

| Kesalahan | Artinya | Tindakan |
| - | - | - |
| `429 refresh_limit_reached` | Anggaran bank sudah habis. | Tunggu selama `Retry-After`, lalu andalkan sinkronisasi otomatis. |
| `409 connection_not_active` | Koneksi tidak berstatus `active`. | Periksa statusnya. |
| `409 consent_expired` | Persetujuan telah berakhir. | [Perbarui](https://docs.didit.me/id/use-cases/renew-bank-consent.md). |

## Terkait

* [Feed bank berkelanjutan untuk akuntansi](https://docs.didit.me/id/use-cases/bank-data-for-accounting.md)
* [Webhook bank](https://docs.didit.me/id/core-technology/bank-verification/webhooks.md)


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