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

Pengenalan

API H2H (host-to-host) Bisadagang Bisnis menghubungkan sistem Mitra Bisnis langsung ke produk digital Bisadagang: pulsa, paket data, token listrik, e-wallet, dan tagihan.

Base URL#

Semua request dikirim ke satu alamat:

https://api.bisadagang.com
  • Endpoint untuk Mitra Bisnis ada di bawah /h2h/v1, mis. https://api.bisadagang.com/h2h/v1/balance.
  • Hanya HTTPS. Request lewat HTTP ditolak dengan HTTPS_REQUIRED.
  • Request dan respons memakai JSON.

Production dan sandbox#

Production dan sandbox memakai base URL yang sama. Environment ditentukan oleh API key yang dipakai, bukan oleh alamatnya.

Awalan key
Environment
bdk_live_
Production: saldo asli, IP server wajib didaftarkan di whitelist.
bdk_test_
Sandbox: saldo sandbox terpisah (mulai Rp10.000.000), bisa dari IP mana saja.

Setiap key punya pasangan API secret (bds_live_… atau bds_test_…) untuk menghitung signature. Secret hanya ditampilkan sekali saat key dibuat di dashboard.

Endpoint yang tersedia#

Endpoint
Kegunaan
GET /h2h/v1/balance
Cek saldo
GET /h2h/v1/products
Daftar harga & produk
POST /h2h/v1/transactions
Transaksi prabayar
GET /h2h/v1/transactions/{ref_id}
Cek status transaksi
POST /h2h/v1/bills/inquiry
Inquiry tagihan pascabayar
POST /h2h/v1/bills/payment
Pembayaran tagihan pascabayar
Status akhir transaksi juga dikirim lewat webhook ke server Anda, dengan signature yang bisa diverifikasi.

Alur integrasi#

  • Daftar sebagai Mitra Bisnis, lalu buat API key sandbox di dashboard. Ikuti Quick start.
  • Buat fungsi untuk menghitung signature seperti di Autentikasi & signature, lalu cek dengan contoh uji di halaman itu.
  • Tangani error berdasarkan error.code (lihat Format respons & kode error).
  • Setelah semuanya jalan di sandbox, buat key production dan daftarkan IP server Anda.
Berikutnya
Quick start
Butuh bantuan?
Tanya soal integrasi teknis lewat WhatsApp.
Chat di WhatsApp
Di halaman ini
  • Base URL
  • Production dan sandbox
  • Endpoint yang tersedia
  • Alur integrasi