Testing di Lingkungan Sandbox

Gerbang Pay menyediakan environment simulasi agar Anda bisa menguji sistem secara End-to-End — mulai dari pembuatan tagihan, simulasi pembayaran masuk, hingga penerimaan webhook — tanpa melibatkan uang sungguhan.

1. Aktivasi Mode Sandbox

Untuk menggunakan Sandbox, Anda tidak perlu mengubah endpoint URL Gerbang Pay. Gerbang Pay menggunakan satu base URL untuk semuanya: https://gerbang-pay-api.gai.co.id.

Cara masuk ke mode Sandbox hanyalah dengan mengubah API Key yang digunakan.

1. Buka Dashboard Gerbang Pay
2. Masuk ke Settings → API Keys
3. Klik Generate New API Key, dan pastikan Anda memilih tipe "Test"
4. Key akan berawalan dengan prefix gp_test_...
5. Gunakan key ini pada header Authorization: ApiKey gp_test_... di kode klien Anda.

Secara otomatis, Gerbang Pay akan mengenali bahwa key tersebut adalah test key, dan akan merutekan request ke sistem Sandbox milik provider (misalnya URL https://sandbox-api.bmstaging.id/snap untuk Winpay).

2. Simulasi Transaksi (Simulator Dashboard)

Setelah API berhasil mengembalikan tagihan berstatus pending (Virtual Account, QRIS, dll), Anda tentu ingin menyimulasikan agar transaksi tersebut "dibayar" seolah-olah oleh pelanggan.

Anda dapat melakukan ini dengan menggunakan fitur Sandbox Simulator di Dashboard Gerbang Pay:

1. Buka Dashboard, masuk ke menu Sandbox / Simulator
2. Anda akan melihat daftar transaksi yang baru saja Anda buat menggunakan Test Key.
3. Klik tombol Simulate Payment di sebelah transaksi tersebut.
4. Sistem akan "memaksa" status menjadi paid dengan memanggil mock endpoint secara internal.

Alternatif lainnya: Jika provider memiliki halaman web sandbox (misalnya portal sandbox Winpay atau Midtrans), Anda juga bisa memasukkan nomor Virtual Account ke portal tersebut untuk menyimulasikan pembayaran.

3. Verifikasi Keberhasilan

Ada dua cara untuk melihat apakah simulasi berhasil:

A. Verifikasi via API (Polling): Panggil endpoint GET /v1/payments/{payment_id}. Field status akan berubah dari pending menjadi paid.

B. Verifikasi via Webhook (Disarankan): Begitu Anda mengklik "Simulate Payment" di dashboard, Gerbang Pay akan mendeteksi perubahan status dan langsung memicu webhook ke URL server lokal Anda (jika sudah disetup).

💡 Tips Webhook Lokal: Saat mengembangkan aplikasi di komputer lokal (localhost), server Anda tidak bisa dijangkau oleh Gerbang Pay dari internet umum. Gunakan tool seperti Ngrok atau Cloudflare Tunnels untuk mendapatkan URL publik (https://xxx.ngrok.io), dan pasang URL tersebut sebagai Callback URL di Dashboard Gerbang Pay.

Data Test Sandbox

Data berikut bebas digunakan selama Anda berinteraksi dengan API menggunakan Test Key:

• Nomor HP / Telepon: 081234567890 (Atau angka valid 10-13 digit apapun)
• Amount: Bebas (disarankan > 1000000 / Rp 10.000)
• Email: Bebas, pastikan format @ benar.

Semua transaksi di sandbox tidak akan muncul di laporan keuangan harian Production, sehingga pembukuan riil bisnis Anda tetap aman.