Langsung ke konten utama
POST
curl
Endpoint Refresh a Bank Connection dari Didit meminta sinkronisasi sekarang dan merespons 202 dengan sync_id. Kirim "wait": true untuk menunggu hingga 25 detik dan mendapatkan sinkronisasi yang sudah selesai dalam satu panggilan, tanpa biaya tambahan. Bank membatasi akses tanpa pengawasan, sehingga panggilan dapat merespons 429 refresh_limit_reached dengan Retry-After. Lihat Perbarui data bank sesuai permintaan.

Otorisasi

x-api-key
string
header
wajib

Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat dibatasi: tanpa akses, baca, atau tulis per sumber daya, dibatasi untuk beberapa alur kerja atau untuk sesi yang disetujui, ke daftar alamat IP tertentu, dan ke tanggal kedaluwarsa. 401 berarti kunci salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirim, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan berasal dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status yang diizinkan untuk kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa akses tulis sesi menerima tautan dan token sesi sebagai null. Lihat https://docs.didit.me/console/api-keys.

Header

Idempotency-Key
string

Kunci opsional untuk keamanan saat mencoba lagi yang Anda pilih untuk satu operasi, hingga 255 karakter (UUID juga dapat digunakan). Permintaan yang diulang dengan kunci, endpoint, query, dan body yang sama akan dijawab dengan respons pertama, dengan status dan body yang sama, dan tidak dijalankan dan tidak ditagih lagi. Kunci yang sama dengan endpoint, query, atau body lain akan mengembalikan 409 idempotency_key_reused, dan selama permintaan pertama masih berjalan, akan mengembalikan 409 idempotency_key_in_progress dengan Retry-After. Permintaan yang gagal (4xx atau 5xx apa pun) tidak disimpan, sehingga Anda dapat mengirimkannya lagi dengan kunci yang sama. Kunci menjadi milik aplikasi Anda, baik Anda memanggil dengan kunci API maupun dengan token akses. Lihat Coba lagi dan idempotensi.

Required string length: 1 - 255
Prefer
string

wait=<seconds> menahan panggilan hingga jumlah detik tersebut, maksimal 25, seperti wait: true pada isi permintaan.

Contoh:

"wait=25"

Parameter Path

id
string<uuid>
wajib

ID koneksi.

Body

application/json

Isi opsional dari penyegaran.

wait
boolean
default:false

true menahan panggilan hingga 25 detik dan merespons 200 dengan sinkronisasi yang sudah selesai, sehingga satu permintaan mengembalikan data terbaru. Jika bank belum merespons dalam waktu tersebut, panggilan merespons 202: baca sinkronisasi dengan get_sync_run menggunakan sync_id, atau berlangganan bank.sync.completed. bank.data.updated hanya menyusul jika sinkronisasi menyimpan perubahan. Header Prefer: wait=<seconds> (hingga 25) memberikan hasil yang sama.

Respons

Sinkronisasi selesai dalam 25 detik.

Sinkronisasi yang telah selesai, dikembalikan oleh penyegaran dengan wait: eksekusi sinkronisasi beserta outcome-nya, jumlah per akun dalam results, dan balances_changed.

id
string<uuid>
wajib
connection_id
string<uuid>
wajib
trigger
enum<string>
wajib
Opsi yang tersedia:
initial,
scheduled,
requested
status
enum<string>
wajib
Opsi yang tersedia:
queued,
running,
succeeded,
partial,
failed
started_at
string<date-time> | null
wajib
finished_at
string<date-time> | null
wajib
results
object[]
wajib

Apa yang dilakukan eksekusi, per rekening dan per sumber daya.

error
object | null
wajib

Alasan seluruh proses gagal. null jika tidak. Kesalahan pada rekening dan sumber daya tunggal ada di results.

outcome
enum<string>
wajib

Bagaimana sinkronisasi berakhir.

Opsi yang tersedia:
succeeded,
partial,
failed
balances_changed
boolean
wajib

Apakah ada saldo yang berubah.

Terakhir diubah pada 22 November 2026