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
GET /h2h/v1/products
POST /h2h/v1/transactions
GET /h2h/v1/transactions/{ref_id}
POST /h2h/v1/bills/inquiry
POST /h2h/v1/bills/payment
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.
Butuh bantuan?
Tanya soal integrasi teknis lewat WhatsApp.