Bisadagang BisnisBisadagang BisnisDocs
HargaMasukDaftar gratis
Mulai
  • Pengenalan
  • Quick start
Dasar
  • Autentikasi & signature
  • Format respons & kode error
Referensi API
  • GETCek saldo
  • GETDaftar harga & produk
  • Transaksi
  • Komplain
  • Webhook
Panduan
  • Sandbox
  • Panduan vibe coder
Butuh bantuan?

Tim teknis kami siap membantu integrasi lewat WhatsApp.

Chat tim teknis
Syarat dan ketentuanKebijakan privasi
Mulai
  • Pengenalan
  • Quick start
Dasar
  • Autentikasi & signature
  • Format respons & kode error
Referensi API
  • GETCek saldo
  • GETDaftar harga & produk
  • Transaksi
  • Komplain
  • Webhook
Panduan
  • Sandbox
  • Panduan vibe coder
Panduan

Sandbox

Uji seluruh alur transaksi tanpa menyentuh saldo asli. Hasil ditentukan oleh nomor tujuan, jadi setiap skenario bisa diulang kapan saja.

Cara kerja#

Pakai API key sandbox (bdk_test_…) di base URL yang sama dengan production. Request, signature, validasi, kode error, aturan ref_id, dan bentuk respons sama persis dengan production. Bedanya, tidak ada penyedia yang dihubungi dan tidak ada uang asli yang bergerak: hanya saldo sandbox yang berubah.

  • Pembuatan transaksi, inquiry dan pembayaran tagihan pascabayar, serta cek nama pemilik akun semuanya bisa dicoba dengan key sandbox.
  • Semua endpoint ini dibahas di Transaksi.

Skenario nomor tujuan#

Hasil ditentukan oleh 4 digit terakhir nomor tujuan (customer_no). Akhiran lain, termasuk nomor uji Anda sendiri, diperlakukan seperti 0001.

Akhiran
Hasil
…0001
Sukses langsung, dengan nomor serial (sn) simulasi.
…0002
Gagal langsung. Saldo sandbox dikembalikan.
…0003
Pending, lalu sukses sekitar 30 detik kemudian.
…0004
Pending, lalu gagal sekitar 30 detik kemudian. Saldo sandbox dikembalikan saat gagal.
…0005
Pending terus, tidak pernah mencapai status akhir.
…0006
Tidak ada jawaban untuk pengecekan: inquiry tagihan dijawab INQUIRY_FAILED, cek nama dijawab ACCOUNT_NOT_FOUND.
  • Untuk skenario pending, hasil akhir dikirim ke URL webhook sandbox Anda, atau baca lewat cek status.
  • Cek nama yang ditemukan mengembalikan nama pemilik PELANGGAN SANDBOX.
  • Aturan production tetap berlaku di sandbox, misalnya cek nama sebelum pembelian nominal bebas.

Saldo sandbox#

  • Saldo awal Rp10.000.000, terpisah dari saldo asli.
  • Setiap transaksi sandbox memotong saldo sandbox, tidak pernah saldo asli. Saldo yang kurang dijawab INSUFFICIENT_BALANCE, sama seperti production.
  • Simulasi gagal mengembalikan saldo sandbox satu kali. Simulasi pending menahan saldo sampai statusnya final.
  • Reset kapan saja di dashboard, menu Deposit & saldo mode Sandbox: kembali ke Rp10.000.000 atau ke nominal pilihan Anda (maksimal Rp1.000.000.000). Nominal kecil berguna untuk menguji INSUFFICIENT_BALANCE. Lihat Cek saldo.
  • Saldo sandbox tidak bisa dipindah ke production, dan tidak ada deposit di sandbox.

Pilihan produk#

Pilihan produk aktif untuk sandbox dan production terpisah. Mengaktifkan produk di mode Sandbox tidak mengaktifkannya di production, begitu juga sebaliknya. Produk yang tidak aktif untuk sandbox dijawab PRODUCT_DISABLED. Atur di dashboard, menu Produk; ada tombol untuk menyalin pilihan dari satu environment ke yang lain. Lihat Daftar produk.

Beda dengan production#

Sandbox tidak terpengaruh mode pemeliharaan. Saat production dalam pemeliharaan dan menjawab SERVICE_MAINTENANCE, transaksi sandbox tetap berjalan karena tidak ada penyedia yang dihubungi.
  • Harga dihitung dari harga live seperti production, jadi nominal yang terpotong mencerminkan harga sebenarnya.
  • Nomor serial dan ID transaksi sandbox adalah simulasi (ID berawalan SB).
  • Transaksi sandbox tidak muncul di riwayat transaksi production.
Sebelumnya
Webhook
Berikutnya
Panduan vibe coder
Butuh bantuan?
Tanya soal integrasi teknis lewat WhatsApp.
Chat di WhatsApp
Di halaman ini
  • Cara kerja
  • Skenario nomor tujuan
  • Saldo sandbox
  • Pilihan produk
  • Beda dengan production