Pengenalan
Cara kerja API ZevalPay, alamat server, dan langkah awal sampai pembayaran pertama.
API ZevalPay memungkinkan sistem Anda membuat tagihan pembayaran (QRIS, Virtual Account, e-wallet, dan gerai ritel), memantau statusnya, dan menerima pemberitahuan otomatis saat pembeli membayar. Semua permintaan dan respons berformat JSON.
Dua alamat, dua mode
Rute dan bentuk datanya identik di kedua alamat. Yang membedakan hanya alamat server dan kunci API yang dipakai.
| Mode | Alamat dasar | Kunci API | Uang |
|---|---|---|---|
Sandbox | https://api-sandbox.zevalpay.com/v1 | zp_test_… | Tidak ada uang sungguhan. Hasil pembayaran Anda tentukan sendiri. |
Live | https://api.zevalpay.com/v1 | zp_live_… | Uang sungguhan. Hanya untuk merchant yang sudah lolos verifikasi usaha (KYB). |
Kunci dan alamat harus cocokKunci test hanya diterima di alamat sandbox dan kunci live hanya di alamat live. Kunci yang salah alamat ditolak dengan galat
wrong_environment. Detail lengkap ada di Sandbox & Live.Langkah awal
- 1Daftar dan masuk ke dashboardBuat akun merchant di dashboard. Mode Sandbox langsung bisa dipakai tanpa verifikasi.
- 2Ambil kunci APIBuka menu Kunci API di dashboard. Mode Sandbox menampilkan kunci
zp_test_…, mode Live menampilkanzp_live_…. - 3Cek channelPanggil Daftar Channel untuk tahu kode channel dan batas nominalnya.
- 4Buat pembayaranPanggil Buat Pembayaran, lalu tampilkan instruksi bayar (kode VA, QRIS, atau tautan) kepada pembeli.
- 5Tentukan hasilnya (sandbox)Panggil Simulasi untuk membuat pembayaran menjadi berhasil, gagal, atau kedaluwarsa.
- 6Terima webhookPasang alamat penerima di menu Webhook, lalu ikuti panduan Webhook untuk memverifikasi signature.
Contoh pertama
cURL · Sandbox
curl -X POST https://api-sandbox.zevalpay.com/v1/payments/create \
-H "Authorization: Bearer zp_test_KUNCI_ANDA" \
-H "Content-Type: application/json" \
-d '{
"amount": 25000,
"channel": "qris",
"customer": {"name": "Budi", "email": "[email protected]", "phone": "081234567890"}
}'Ketentuan umum
- Nominal selalu bilangan bulat rupiah (tanpa desimal, tanpa pemisah ribuan). Mata uang tunggal: IDR.
- Waktu memakai format ISO 8601 dengan zona (contoh
2026-10-27T14:30:00+07:00). - Kirim
Content-Type: application/jsonpada permintaan yang memiliki body. - Batas laju: 120 permintaan per menit per kunci. Lebih dari itu dijawab
429 rate_limited. - Respons tidak di-cache. Selalu minta data terbaru dari server, jangan menyimpan status lama sebagai kebenaran.