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
Mulai

Quick start

Dari daftar sampai request pertama: cek saldo sandbox dengan API key dan signature HMAC.

Pakai AI Agent? Buka panduan vibe coder.

Base URL untuk semua request: https://api.bisadagang.com. Contoh di bawah memakai alamat lengkap, jadi bisa langsung dijalankan.

1. Buat API key sandbox#

  • Daftar sebagai Mitra Bisnis, lalu buka menu API key di dashboard.
  • Buat key sandbox. Anda menerima API key (bdk_test_…) dan API secret (bds_test_…).
  • Secret hanya ditampilkan sekali. Simpan sekarang; jika hilang, buat key baru dan cabut yang lama. Setiap environment bisa punya paling banyak 2 key aktif.

2. Simpan key#

Simpan key dan secret di environment variable, bukan di kode atau repository. Semua contoh di dokumentasi ini membaca dua variabel berikut:

Terminal
export BISADAGANG_API_KEY="bdk_test_…"
export BISADAGANG_API_SECRET="bds_test_…"

3. Request pertama#

Contoh ini membuat empat header autentikasi lalu memanggil GET /h2h/v1/balance. Penjelasan lengkap ada di 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"

Jika berhasil, respons berisi saldo sandbox Anda:

200 OK
{
  "success": true,
  "data": {
    "balance": 10000000,
    "currency": "IDR",
    "environment": "sandbox"
  },
  "request_id": "a1b2c3d4e5"
}

Jika gagal#

Error yang paling sering muncul di request pertama:

Kode
Periksa
INVALID_API_KEY
Header X-Bisadagang-Key kosong, salah ketik, atau key sudah dicabut.
TIMESTAMP_OUT_OF_RANGE
Timestamp harus dalam detik (bukan milidetik) dan jam server Anda tidak boleh selisih lebih dari 300 detik.
INVALID_SIGNATURE
Urutan canonical, path yang diberi signature, atau secret yang dipakai. Cek fungsi Anda dengan contoh uji di halaman Autentikasi.
PARTNER_NOT_ACTIVE
Akun Mitra Bisnis belum aktif, misalnya nomor WhatsApp belum diverifikasi.
IP_NOT_WHITELISTED
Hanya untuk key production atau jika daftar IP sandbox diisi. IP yang terlihat oleh Bisadagang ada di error.details.ip.

Daftar lengkap ada di Kode error.

Berikutnya#

  • Ambil daftar harga & produk untuk melihat kode produk yang bisa Anda jual.
  • Memakai asisten AI? Salin prompt dari Panduan vibe coder.
Sebelumnya
Pengenalan
Berikutnya
Autentikasi & signature
Butuh bantuan?
Tanya soal integrasi teknis lewat WhatsApp.
Chat di WhatsApp
Di halaman ini
  • 1. Buat API key sandbox
  • 2. Simpan key
  • 3. Request pertama
  • Jika gagal
  • Berikutnya