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

# Panduan Cepat Data Bank: Hubungkan Bank Uji dan Baca Transaksi

> Dari aplikasi sandbox ke akun, saldo, dan transaksi Didit Test Bank: buat kunci API dan tautan, hubungkan, baca, sinkronkan, lalu hapus.

Data perbankan tersedia untuk aplikasi sandbox.
Panggilan dari aplikasi live akan menghasilkan `404` hingga akses live diumumkan, dan tidak ada biaya yang dikenakan di sandbox.
Panduan memulai cepat ini membawa Anda dari aplikasi sandbox ke akun, saldo, dan transaksi Didit Test Bank dengan permintaan yang dapat disalin-tempel.

> [!NOTE]
>
> Setiap respons di bawah ini dipersingkat menjadi hanya kolom yang penting.
> Simpan kunci API di server Anda: kunci ini tidak pernah sampai ke browser atau aplikasi.

## Langkah 1: buat kunci API dengan izin Bank data

Bank data tidak termasuk dalam akses penuh.
Kunci akses penuh, termasuk rahasia utama aplikasi, ditolak pada setiap panggilan Bank data dengan `403 bank_data_access_denied`.

1. Di [Business Console](https://business.didit.me), buka aplikasi sandbox Anda lalu buka **API keys**.
2. Buat kunci dengan akses kustom dan tambahkan **Bank data**: **Read** untuk operasi baca, **Write** untuk panggilan yang membuat, mengubah, atau menghapus sesuatu.
3. Salin kunci tersebut lalu ekspor:

```bash theme={null}
export DIDIT_API_KEY="your-sandbox-key"
```

Lihat [Kunci API](https://docs.didit.me/id/console/api-keys.md) untuk daftar lengkap sumber daya.

## Langkah 2: buat tautan

Tautan adalah satu rangkaian layar tempat pengguna akhir menghubungkan bank.
Buat tautan berkelanjutan untuk Test Bank:

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/links/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "access": "ongoing",
    "country": "ESP",
    "data": ["accounts", "balances", "transactions"],
    "history_days": 90,
    "vendor_data": "client-7731"
  }'
```

`country` adalah kode negara tiga huruf dari bank pengguna akhir dan bersifat opsional. Kirimkan nilai ini jika Anda mengetahuinya, agar pengguna akhir hanya melihat bank dari negara tersebut; tanpa nilai ini, pengguna akhir memilih dari semua negara yang dapat Anda layani.
Untuk akses sekali pakai, kirimkan `"access": "one_time"` (bawaan).

```json theme={null}
{
  "id": "0b9c4f1e-6a2d-4e8b-9f31-7c5d2e1a8b40",
  "mode": "connect",
  "access": "ongoing",
  "status": "created",
  "url": "https://verify.didit.me/bank/link/...",
  "expires_at": "2026-11-22T13:00:00Z",
  "connection_id": null
}
```

Simpan `id` tautan bersama pengguna Anda.
`url` dan `client_token` hanya dikembalikan sekali, saat tautan dibuat.

## Langkah 3: buka tautan dan hubungkan Didit Test Bank

Buka `url` di browser, atau kirimkan ke pengguna melalui email atau chat.
Pengguna melihat layar persetujuan, memilih **Didit Test Bank**, masuk dengan salah satu pelanggan uji, lalu memilih rekening yang akan dibagikan.
[Halaman sandbox](https://docs.didit.me/id/core-technology/bank-verification/sandbox.md) mencantumkan pelanggan uji beserta data yang didapat dari masing-masing.

Untuk mengarahkan pengguna kembali ke situs Anda setelahnya, lihat [Kembali ke situs Anda](https://docs.didit.me/id/integration/bank-link/return-to-your-site.md).
Tanpa `redirect_url`, pengguna menyelesaikan proses di halaman hasil Didit, dan Anda mengetahui hasilnya melalui webhook atau permintaan baca.

## Langkah 4: terima webhook dan konfirmasi

Berlanggananlah suatu tujuan ke event `bank.*` di konsol, seperti untuk [webhook](https://docs.didit.me/id/integration/webhooks.md) lainnya.
Saat pengguna menyelesaikan proses, `bank.link.completed` dikirim dengan `link_id` dan `connection_id`, lalu `bank.connection.created` setelah sinkronisasi pertama menyimpan akun.

Jangan pernah percaya pada ID tautan yang dikirim browser kepada Anda.
Ambil data tautan itu sendiri:

```bash theme={null}
curl https://verification.didit.me/v3/bank/links/$LINK_ID/ -H "x-api-key: $DIDIT_API_KEY"
```

```json theme={null}
{ "id": "0b9c4f1e-6a2d-4e8b-9f31-7c5d2e1a8b40", "status": "completed", "connection_id": "5e1d2a70-3b4c-4d5e-8f60-71829304a5b6" }
```

`status` bernilai `completed` atau salah satu status akhir (`cancelled`, `expired`, `failed`). Tautan berstatus `failed` memiliki `error.code`; tautan berstatus `cancelled` memiliki `error: null`.

## Langkah 5: baca akun, saldo, dan transaksi

```bash theme={null}
curl https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/accounts/ -H "x-api-key: $DIDIT_API_KEY"
curl https://verification.didit.me/v3/bank/accounts/$ACCOUNT_ID/balances/ -H "x-api-key: $DIDIT_API_KEY"
curl "https://verification.didit.me/v3/bank/accounts/$ACCOUNT_ID/transactions/?date_from=2026-01-01" -H "x-api-key: $DIDIT_API_KEY"
```

Jumlah dinyatakan sebagai string desimal, bernilai negatif untuk uang keluar.
Halaman transaksi memuat `next_page_token` selama masih ada data yang belum dibaca.
Lihat [Akun, saldo, dan transaksi](https://docs.didit.me/id/core-technology/bank-verification/accounts-balances-transactions.md).

## Langkah 6: ikuti umpan perubahan

Umpan perubahan hanya mengembalikan data yang berubah sejak pembacaan terakhir Anda.
Pembacaan pertama Anda, tanpa kursor, adalah snapshot lengkap: setiap transaksi yang dimiliki koneksi, masing-masing sebagai `added`, dengan `reset: true`.
Halaman pertama dapat memuat `has_more: true` dengan `next_page_token` dan belum ada `next_cursor`.
Terus baca dengan `page_token` selama `has_more` bernilai `true`, lalu simpan `next_cursor` dari halaman terakhir (yang memiliki `has_more: false`) untuk pembacaan berikutnya:

```bash theme={null}
curl "https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/transactions/sync/" -H "x-api-key: $DIDIT_API_KEY"
curl "https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/transactions/sync/?page_token=$NEXT_PAGE_TOKEN" -H "x-api-key: $DIDIT_API_KEY"
curl "https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/transactions/sync/?cursor=$NEXT_CURSOR" -H "x-api-key: $DIDIT_API_KEY"
```

`reset: true` berarti respons adalah snapshot lengkap: ganti salinan Anda dengan respons tersebut, bukan menambahkannya.
`bank.data.updated` memberi tahu Anda saat sinkronisasi menyimpan data baru.

## Langkah 7: sinkronkan sekarang

Koneksi berkelanjutan menyinkronkan dirinya sendiri secara otomatis.
Untuk membaca data bank sekarang, minta sinkronisasi:

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/refresh/ -H "x-api-key: $DIDIT_API_KEY"
```

Bank membatasi jumlah pembacaan tanpa interaksi pengguna per hari.
`sync.live_syncs_left_today` dan `sync.budgets` pada koneksi menunjukkan sisa kuota dan waktu reset-nya. Panggilan yang melebihi batas akan menghasilkan respons `429 refresh_limit_reached` beserta waktu reset.
Lihat [Perbarui data bank sesuai permintaan](https://docs.didit.me/id/use-cases/refresh-bank-data-on-demand.md).

## Langkah 8: hentikan akses dan hapus

Menghentikan akses dan menghapus adalah dua panggilan yang berbeda.

```bash theme={null}
# Stop access at the bank. The connection keeps its data until you delete it.
curl -X POST https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/revoke/ -H "x-api-key: $DIDIT_API_KEY"

# Delete the connection and its data. Irreversible.
curl -X DELETE https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/ -H "x-api-key: $DIDIT_API_KEY"
```

Koneksi yang sudah dihapus hanya merespons `id`, `status`, `status_reason`, `created_at` dan `erasure`.
Lihat [Data, persetujuan dan penghapusan](https://docs.didit.me/id/core-technology/bank-verification/data-consent-and-deletion.md).

## Langkah berikutnya

* [Koneksi](https://docs.didit.me/id/core-technology/bank-verification/connections.md): akses sekali dan berkelanjutan, persetujuan, dan perpanjangan.
* [Webhook bank](https://docs.didit.me/id/core-technology/bank-verification/webhooks.md)
* [Harga](https://docs.didit.me/id/getting-started/bank-verification-pricing.md)
* [Referensi API](https://docs.didit.me/id/standalone-apis/bank-data.md)


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