Dokumentasi › API V1

Cek Saldo

Melihat saldo tersedia dan saldo menunggu settlement.

GET/v1/balance
Berlaku diLive (zp_live_)

Melihat saldo merchant. Sandbox tidak punya uang, jadi kunci test dijawab 403 wrong_environment.

Contoh kode

cURL
curl https://api.zevalpay.com/v1/balance \
  -H "Authorization: Bearer zp_live_KUNCI_ANDA"
PHP
<?php
$result = zevalpay('GET', '/v1/balance');

if (isset($result['error'])) {
    echo $result['error']['message'];
} else {
    echo 'Tersedia: Rp ' . number_format($result['data']['available'], 0, ',', '.');
}
Node.js
const result = await zevalpay('GET', '/v1/balance');

if (result.error) console.log(result.error.message);
else console.log('Tersedia: Rp', result.data.available.toLocaleString('id-ID'));

Contoh respons

Berhasil
HTTP 200
{
  "data": {
    "available": 1250000,
    "pending": 480000,
    "currency": "IDR"
  }
}
Gagal: memakai kunci test
HTTP 403
{
  "error": {
    "code": "wrong_environment",
    "message": "Saldo hanya tersedia untuk kunci live."
  }
}

Isi data

ParameterTipeKeterangan
availableintegerSaldo yang siap ditarik, dalam rupiah.
pendingintegerSaldo yang menunggu settlement. Menjadi tersedia pada jadwal settlement channel (lihat available_at pada pembayaran).
currencystringSelalu IDR.
Hanya membacaPenarikan dana dilakukan lewat dashboard dengan konfirmasi authenticator. Belum tersedia lewat API.