Masuk

Pengenalan

Cara kerja API, alamat server, dan langkah awal supaya sistem Anda bisa melakukan transaksi otomatis.

API ini dipakai agar sistem Anda (website, aplikasi, bot, atau kasir) bisa membeli produk digital di Zeval Digital secara otomatis, tanpa membuka dashboard. Anda mengirim permintaan ke server kami, kami memprosesnya, lalu memberi tahu hasilnya.

Alamat server (Base URL)

Semua alamat endpoint diawali dengan Base URL berikut:

Cara kerja singkat

  1. 1
    Ambil kunci aksesLogin ke dashboard, buka menu Kredensial API, lalu salin Secret ID dan Secret Key. Aktifkan API di halaman yang sama.
  2. 2
    Kirim requestSemua endpoint memakai metode POST dan isi (body) berformat JSON. Setiap request harus menyertakan secret_id dan signature (lihat halaman Autentikasi).
  3. 3
    Terima hasilJawaban selalu berupa JSON. Hasil akhir transaksi bisa Anda terima lewat Callback (otomatis) atau Anda cek sendiri lewat Cek Status Transaksi.

Syarat sebelum bisa dipakai

  • Akun sudah terverifikasi (menu Verifikasi Akun di dashboard).
  • API sudah diaktifkan di menu Kredensial API.
  • Saldo cukup. Isi saldo lewat menu Topup di dashboard.
  • (Opsional) Daftarkan IP server Anda di Kredensial API. Bila diisi, request dari IP lain ditolak. Ini sangat disarankan untuk keamanan.

Alur membeli produk

Alur
1. Ambil daftar produk      →  POST /v1/products
2. Buat transaksi            →  POST /v1/transaction/create
3. Tunggu hasil              →  Callback masuk ke server Anda
   (atau cek berkala)          POST /v1/transaction/status
4. Selesai                   →  status: success  atau  failed
Penting: jangan menganggap "pending" sebagai gagalSetelah membuat transaksi, statusnya biasanya pending (sedang diproses) dan baru berubah menjadi success atau failed beberapa detik sampai beberapa menit kemudian. Jangan membeli ulang dengan ref_id baru sebelum status akhirnya jelas.

Aturan umum

  • Nominal selalu dalam rupiah berupa angka bulat (tanpa titik atau koma), mis. 1400.
  • Batas penggunaan: 300 request/menit per IP dan 120 request/menit per akun. Khusus daftar produk: 6 kali per menit (simpan hasilnya di server Anda).
  • Jangan pernah menaruh Secret Key di aplikasi yang dipakai pengguna akhir (browser atau aplikasi HP). Panggil API dari server Anda.
Berikutnya →Autentikasi