Dokumentasi › API V1

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.

ModeAlamat dasarKunci APIUang
Sandboxhttps://api-sandbox.zevalpay.com/v1zp_test_…Tidak ada uang sungguhan. Hasil pembayaran Anda tentukan sendiri.
Livehttps://api.zevalpay.com/v1zp_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

  1. 1
    Daftar dan masuk ke dashboardBuat akun merchant di dashboard. Mode Sandbox langsung bisa dipakai tanpa verifikasi.
  2. 2
    Ambil kunci APIBuka menu Kunci API di dashboard. Mode Sandbox menampilkan kunci zp_test_…, mode Live menampilkan zp_live_….
  3. 3
    Cek channelPanggil Daftar Channel untuk tahu kode channel dan batas nominalnya.
  4. 4
    Buat pembayaranPanggil Buat Pembayaran, lalu tampilkan instruksi bayar (kode VA, QRIS, atau tautan) kepada pembeli.
  5. 5
    Tentukan hasilnya (sandbox)Panggil Simulasi untuk membuat pembayaran menjadi berhasil, gagal, atau kedaluwarsa.
  6. 6
    Terima 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/json pada 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.