Bagaimana menguji integrasi di sandbox?

Sandbox adalah mode akun, bukan kunci terpisah. Selama mode ini menyala, setiap tagihan yang dibuat dengan API key dan base URL yang sama menjadi transaksi uji (is_sandbox: true) yang tidak menyentuh uang, saldo, maupun laporan pendapatan.

Isi halaman ini dicocokkan dengan kode API per 16 Oktober 2026.

Bagaimana memakai sandbox?#

Nyalakan mode sandbox
Pengaturan API, Mode & akses. Berlaku untuk seluruh akun sampai dimatikan.
Buat tagihan seperti biasa
Permintaan, tanda tangan, dan bentuk respons sama dengan produksi. Respons berisi is_sandbox: true.
Buka payment_link
Tautannya menuju halaman bayar sandbox. Nomor VA dan QR di sana palsu dan tidak bisa dibayar.
Simulasikan hasilnya
Klik simulasi sukses atau gagal. Tombolnya hanya berfungsi dari halaman itu: URL simulasinya bertanda tangan dan tidak bisa dipanggil langsung.
Terima webhook
Webhook dikirim ke callback_url dengan field, format tanggal, dan tanda tangan yang sama dengan produksi.

Apa yang berbeda dari produksi?#

Hal	Sandbox	Produksi
Status lunas (webhook dan cek status)	`completed`	`paid`
Webhook pembayaran gagal	Dikirim dengan status `failed` saat simulasi gagal.	Tidak dikirim. Tagihan yang tidak dibayar menjadi `canceled` setelah kedaluwarsa; lihat lewat cek status.
Uang dan saldo	Tidak ada. Tidak masuk saldo maupun laporan.	Masuk saldo tertahan, lalu cair sesuai jadwal metode.
Detail bayar	Nomor VA dan QR palsu.	Dari mitra pembayaran.

Perlakukan paid dan completed sebagai lunas

Kode yang hanya memeriksa status === "paid" tidak pernah lulus di sandbox, dan yang hanya memeriksa completed tidak pernah lulus di produksi.

Apa yang berubah saat pindah ke produksi?#

Hanya mode akun: matikan sandbox di Mode & akses. API key, secret key, base URL, dan URL webhook tetap sama. Transaksi sandbox yang sudah ada tetap bertanda is_sandbox: true dan tidak dihitung di saldo maupun laporan.

Siap memakai kunci Anda sendiri?

Masuk ke dasbor merchant untuk mengambil API key dan secret key, mengatur mode akses dan URL webhook, serta mengunduh koleksi Postman berisi kunci akun Anda.

Masuk ke dasbor