Sandbox & Live
Perbedaan mode uji dan mode nyata, alamat masing-masing, dan daftar periksa sebelum go-live.
Sandbox dan Live adalah dua lingkungan yang datanya terpisah total. Transaksi sandbox tidak muncul di Live dan sebaliknya. Kode integrasi Anda sama persis, cukup ganti alamat dan kunci.
Perbandingan
| Sandbox | Live | |
|---|---|---|
Alamat dasar | https://api-sandbox.zevalpay.com/v1 | https://api.zevalpay.com/v1 |
Kunci API | zp_test_… | zp_live_… |
Syarat | Langsung tersedia setelah daftar. | Verifikasi usaha (KYB) disetujui. |
Uang | Tidak ada. Tidak menyentuh saldo, settlement, maupun penarikan. | Uang sungguhan lewat provider pembayaran. |
Hasil pembayaran | Anda tentukan lewat endpoint Simulasi. | Pembeli membayar. Hasil dikabarkan provider ke ZevalPay, lalu ke Anda lewat webhook. |
Fee | Tidak ada (selalu 0). | Sesuai tarif channel merchant. |
Instruksi bayar | Data palsu (kode VA, QRIS, dan tautan hanya contoh bentuk). | Kode VA, QRIS, dan tautan sungguhan. |
Cek saldo | Tidak tersedia (wrong_environment). | Tersedia (GET /v1/balance). |
Simulasi | Tersedia. | Ditolak (wrong_environment). |
Webhook | Alamat dan secret sendiri. Atribut livemode = false. | Alamat dan secret sendiri. Atribut livemode = true. |
Daftar channel | Semua channel aktif. | Hanya channel yang sudah siap dipakai merchant Anda. |
Cara penjagaan mode
- Mode ditentukan oleh kunci, bukan oleh isi permintaan. Merchant dan mode tidak pernah dibaca dari input Anda.
- Dilapis oleh alamat:
api-sandbox.hanya menerima kunci test,api.hanya menerima kunci live. - Daftar dan detail pembayaran hanya menampilkan data sesuai mode kunci. Pembayaran sandbox tidak bisa dibuka dengan kunci live.
- Atribut
livemodepada setiap respons dan webhook memberi tahu mode transaksi itu.
Daftar periksa sebelum go-live
- 1Selesaikan verifikasi usaha (KYB)Ajukan di dashboard lalu tunggu persetujuan. Setelah disetujui, kunci live aktif dan saklar Live bisa dipakai.
- 2Uji semua hasil di sandboxCoba tiga hasil:
paid,failed, danexpired. Pastikan sistem Anda menangani masing-masing. - 3Pastikan webhook idempotenWebhook bisa terkirim lebih dari sekali. Proses berdasarkan
referencedan abaikan bila sudah pernah diproses. - 4Verifikasi signature webhookTolak permintaan yang signature-nya tidak cocok. Lihat Webhook.
- 5Ganti alamat dan kunciTukar alamat dasar ke
https://api.zevalpay.com/v1dan kunci kezp_live_…lewat konfigurasi, bukan kode. - 6Pasang webhook LiveAlamat webhook dan secret Live terpisah dari Sandbox. Atur ulang di mode Live.
- 7Coba nominal kecilBuat satu pembayaran nyata bernominal kecil dan pastikan statusnya berubah menjadi
paidserta webhook diterima.
Nomor order unik per merchantNomor order
merchant_ref unik untuk satu merchant dan berlaku lintas mode. Nomor yang sudah dipakai di sandbox tidak bisa dipakai lagi di live. Biarkan kosong agar dibuat otomatis, atau beri awalan berbeda seperti TEST- untuk uji coba.