Referensi API
Cek saldo
Saldo Mitra Bisnis saat ini. Key production mengembalikan saldo asli, key sandbox mengembalikan saldo sandbox yang terpisah.
GET/h2h/v1/balance
Request
Tanpa parameter dan tanpa body. Kirim header autentikasi seperti biasa (lihat Autentikasi & signature).
# BISADAGANG_API_KEY dan BISADAGANG_API_SECRET diisi di environment
REQ_PATH="/h2h/v1/balance"
BODY=""
TS=$(date +%s)
NONCE=$(openssl rand -hex 16)
BODY_HASH=$(printf '%s' "$BODY" | openssl dgst -sha256 | awk '{print $NF}')
CANONICAL=$(printf '%s\n%s\n%s\n%s\n%s' "GET" "$REQ_PATH" "$TS" "$NONCE" "$BODY_HASH")
SIGNATURE=$(printf '%s' "$CANONICAL" | openssl dgst -sha256 -hmac "$BISADAGANG_API_SECRET" | awk '{print $NF}')
curl "https://api.bisadagang.com$REQ_PATH" \
-H "X-Bisadagang-Key: $BISADAGANG_API_KEY" \
-H "X-Bisadagang-Timestamp: $TS" \
-H "X-Bisadagang-Nonce: $NONCE" \
-H "X-Bisadagang-Signature: $SIGNATURE"Respons
200 OK
{
"success": true,
"data": {
"balance": 1250000,
"currency": "IDR",
"environment": "production"
},
"request_id": "a1b2c3d4e5"
}Field
Tipe
Keterangan
balancenumber
number
Saldo dalam rupiah.
currencystring
string
Selalu
IDR.environmentstring
string
production atau sandbox, sesuai key yang dipakai.Saldo sandbox
Key sandbox memakai saldo sendiri yang terpisah dari saldo asli.
- Saldo awal sandbox Rp10.000.000.
- Transaksi sandbox memotong saldo sandbox, tidak pernah saldo asli. Simulasi gagal mengembalikan saldo sandbox, dan simulasi pending ditahan sampai final. Lihat Sandbox.
- Reset kapan saja di dashboard, menu Deposit & saldo mode Sandbox: kembali ke Rp10.000.000 atau ke nominal pilihan Anda, misalnya Rp5.000 untuk menguji saldo tidak cukup.
- Saldo sandbox tidak bisa dipindah ke production, dan tidak ada deposit di sandbox.
Saldo tidak cukup
Jika saldo kurang dari harga produk, transaksi ditolak dengan HTTP 422 dan kode INSUFFICIENT_BALANCE. Saldo tidak terpotong dan transaksi tidak dibuat. Harga yang dibutuhkan ada di details.price.
422 · INSUFFICIENT_BALANCE
{
"success": false,
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "Saldo tidak mencukupi.",
"details": { "price": 10357 }
},
"request_id": "a1b2c3d4e5"
}Catatan
- Termasuk kelompok batas baca (default 120 request per menit). Lihat Batas request.
Butuh bantuan?
Tanya soal integrasi teknis lewat WhatsApp.