Environments
Gerbang Pay dirancang untuk mempermudah Anda melakukan perpindahan lingkungan (environment) pengujian ke tahap peluncuran (Production) tanpa repot mengganti endpoint URL atau memodifikasi kode.
Berbeda dengan platform pembayaran lain yang seringkali memiliki URL API terpisah untuk Sandbox (seperti api.sandbox.xxx.com) dan Live (api.xxx.com), Gerbang Pay hanya menggunakan satu Base URL:
https://gerbang-pay-api.gai.co.idLalu bagaimana cara berpindah environment? Anda hanya perlu mengubah API Key di header Authorization.
Live Mode (Production)
Live Mode berarti transaksi nyata yang memotong dana dari rekening atau dompet digital pelanggan sungguhan. Segala tagihan yang dibuat di lingkungan ini akan diteruskan ke API Production provider terkait (misalnya URL produksi Winpay atau Midtrans).
- Format API Key: Diawali dengan
gp_live_... - Kondisi Penggunaan: Hanya gunakan kunci ini di production server Anda.
- Biaya: Biaya transaksi/MDR akan dikenakan secara nyata.
- Uang: Pembayaran lunas berarti ada uang yang masuk ke settlement Anda.
Test Mode (Sandbox)
Test Mode disediakan agar developer Anda bisa bereksperimen dengan metode pembayaran, mendengarkan webhook, atau mensimulasikan kegagalan transaksi, tanpa memengaruhi saldo nyata atau mengacaukan laporan pembukuan.
- Format API Key: Diawali dengan
gp_test_... - Tujuan Provider: Secara otomatis tagihan akan dirutekan ke URL Sandbox provider. (Contoh: Sandbox Winpay URL adalah
https://sandbox-api.bmstaging.id/snap) - Data Uji (Test Data): Di sandbox, Anda disarankan menggunakan nomor HP
081234567890. Anda bebas memasukkan angkaamountberapapun. - Biaya & Uang: 100% gratis, tidak ada perpindahan uang nyata.
Tabel Perbandingan Behavior
| Fitur / Kondisi | API Key Live (gp_live_...) | API Key Test (gp_test_...) |
|---|---|---|
| Base URL Gerbang Pay | gerbang-pay-api.gai.co.id | gerbang-pay-api.gai.co.id |
| Penyimpanan Database | Tabel Payments (Live Flag) | Tabel Payments (Test Flag) |
| Provider Destination | Production API Winpay/Midtrans | Sandbox API Winpay/Midtrans |
| Dashboard Simulator | ❌ Tidak tersedia | ✅ Dapat menggunakan Simulator |
| Laporan Analytics | Dihitung sebagai revenue nyata | Tidak masuk ke grafik revenue utama |
| Webhook Delivery | Ya, ke Live Callback URL Anda | Ya, ke Live/Test Callback URL Anda |
Generate Key
Untuk mendapatkan key masing-masing environment:
- Akses halaman Dashboard Gerbang Pay
- Navigasi ke Settings → API Keys
- Klik tombol Generate New API Key.
- Di pop-up yang muncul, pilih tombol toggle antara "Live" atau "Test".
- Simpan string key tersebut.