Dokumentasi › API V1

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

SandboxLive
Alamat dasarhttps://api-sandbox.zevalpay.com/v1https://api.zevalpay.com/v1
Kunci APIzp_test_…zp_live_…
SyaratLangsung tersedia setelah daftar.Verifikasi usaha (KYB) disetujui.
UangTidak ada. Tidak menyentuh saldo, settlement, maupun penarikan.Uang sungguhan lewat provider pembayaran.
Hasil pembayaranAnda tentukan lewat endpoint Simulasi.Pembeli membayar. Hasil dikabarkan provider ke ZevalPay, lalu ke Anda lewat webhook.
FeeTidak ada (selalu 0).Sesuai tarif channel merchant.
Instruksi bayarData palsu (kode VA, QRIS, dan tautan hanya contoh bentuk).Kode VA, QRIS, dan tautan sungguhan.
Cek saldoTidak tersedia (wrong_environment).Tersedia (GET /v1/balance).
SimulasiTersedia.Ditolak (wrong_environment).
WebhookAlamat dan secret sendiri. Atribut livemode = false.Alamat dan secret sendiri. Atribut livemode = true.
Daftar channelSemua 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 livemode pada setiap respons dan webhook memberi tahu mode transaksi itu.

Daftar periksa sebelum go-live

  1. 1
    Selesaikan verifikasi usaha (KYB)Ajukan di dashboard lalu tunggu persetujuan. Setelah disetujui, kunci live aktif dan saklar Live bisa dipakai.
  2. 2
    Uji semua hasil di sandboxCoba tiga hasil: paid, failed, dan expired. Pastikan sistem Anda menangani masing-masing.
  3. 3
    Pastikan webhook idempotenWebhook bisa terkirim lebih dari sekali. Proses berdasarkan reference dan abaikan bila sudah pernah diproses.
  4. 4
    Verifikasi signature webhookTolak permintaan yang signature-nya tidak cocok. Lihat Webhook.
  5. 5
    Ganti alamat dan kunciTukar alamat dasar ke https://api.zevalpay.com/v1 dan kunci ke zp_live_… lewat konfigurasi, bukan kode.
  6. 6
    Pasang webhook LiveAlamat webhook dan secret Live terpisah dari Sandbox. Atur ulang di mode Live.
  7. 7
    Coba nominal kecilBuat satu pembayaran nyata bernominal kecil dan pastikan statusnya berubah menjadi paid serta 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.