Bisadagang BisnisBisadagang BisnisDocs
HargaMasukDaftar gratis
Mulai
  • Pengenalan
  • Quick start
Dasar
  • Autentikasi & signature
  • Format respons & kode error
Referensi API
  • GETCek saldo
  • GETDaftar harga & produk
  • Transaksi
  • Komplain
  • Webhook
Panduan
  • Sandbox
  • Panduan vibe coder
Butuh bantuan?

Tim teknis kami siap membantu integrasi lewat WhatsApp.

Chat tim teknis
Syarat dan ketentuanKebijakan privasi
Mulai
  • Pengenalan
  • Quick start
Dasar
  • Autentikasi & signature
  • Format respons & kode error
Referensi API
  • GETCek saldo
  • GETDaftar harga & produk
  • Transaksi
  • Komplain
  • Webhook
Panduan
  • Sandbox
  • Panduan vibe coder
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.
Sebelumnya
Format respons & kode error
Berikutnya
Daftar harga & produk
Butuh bantuan?
Tanya soal integrasi teknis lewat WhatsApp.
Chat di WhatsApp
Di halaman ini
  • Request
  • Respons
  • Saldo sandbox
  • Saldo tidak cukup
  • Catatan