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.
Butuh bantuan?
Tanya soal integrasi teknis lewat WhatsApp.