Referensi API
Daftar harga & produk
Daftar produk dengan harga untuk akun Anda. Secara default hanya produk yang aktif untuk Anda; produk yang sedang gangguan tetap ikut dengan status gangguan.
GET/h2h/v1/products
Parameter
Semua parameter opsional dan dikirim sebagai query string.
Parameter
Tipe
Keterangan
categorystring
string
Hanya produk di kategori ini, mis.
Pulsa. Huruf besar/kecil tidak berpengaruh. Maksimal 100 karakter.statusstring
string
normal atau gangguan.semuaboolean
boolean
true: seluruh katalog yang bisa Anda pilih, dengan field active untuk menandai yang aktif. Default false: hanya produk aktif.Request
Query string ikut diberi signature: path di signature harus sama persis dengan yang dikirim, termasuk ?category=Pulsa.
# BISADAGANG_API_KEY dan BISADAGANG_API_SECRET diisi di environment
REQ_PATH="/h2h/v1/products?category=Pulsa"
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
Harga di contoh ini hanya ilustrasi.
200 OK
{
"success": true,
"data": {
"updated_at": "2026-11-17T08:00:00.000Z",
"total": 2,
"products": [
{
"code": "TSEL10",
"product_name": "Telkomsel 10.000",
"category": "Pulsa",
"brand": "TELKOMSEL",
"type": "Umum",
"product_type": "prepaid",
"is_open_amount": false,
"status": "normal",
"price": 10357,
"fee": null,
"admin_fee": null,
"commission": null,
"success_rate": null,
"speed_seconds": null,
"active": true
},
{
"code": "PLNPASCA",
"product_name": "PLN Pascabayar",
"category": "Pascabayar",
"brand": "PLN PASCABAYAR",
"type": "Umum",
"product_type": "postpaid",
"is_open_amount": false,
"status": "gangguan",
"price": null,
"fee": null,
"admin_fee": 2750,
"commission": 1200,
"success_rate": null,
"speed_seconds": null,
"active": true
}
]
},
"request_id": "a1b2c3d4e5"
}Field
Tipe
Keterangan
updated_atstring
string
Waktu daftar harga terakhir disusun (ISO 8601, UTC).
totalnumber
number
Jumlah produk di products setelah filter.
productsarray
array
Daftar produk (lihat di bawah).
Field produk
Field
Tipe
Keterangan
codestring
string
Kode produk Bisadagang (huruf besar dan angka, maksimal 20 karakter). Dipakai saat bertransaksi.
product_namestring
string
Nama produk.
categorystring
string
Kategori, mis. Pulsa. Nilai ini yang dipakai di parameter category.
brandstring
string
Brand atau operator.
typestring
string
Jenis produk di dalam brand.
product_typestring
string
prepaid (prabayar) atau postpaid (tagihan).is_open_amountboolean
boolean
true jika nominalnya ditentukan saat transaksi.statusstring
string
normal atau gangguan.pricenumber | null
number | null
Prabayar nominal tetap: harga yang dipotong dari saldo. null untuk produk lain.
feenumber | null
number | null
Nominal bebas: biaya yang ditambahkan ke nominal yang Anda kirim.
admin_feenumber | null
number | null
Tagihan: biaya admin per tagihan, bagian dari total tagihan.
commissionnumber | null
number | null
Tagihan: komisi Anda per tagihan, dikurangkan dari total tagihan.
success_ratenumber | null
number | null
Success rate 24 jam terakhir, 0–100: sukses dibagi (sukses + gagal). Pending tidak dihitung, begitu juga transaksi gagal karena nomor tujuan salah (kesalahan input pelanggan). null jika belum ada transaksi final dalam periode itu.
speed_secondsnumber | null
number | null
Kecepatan 24 jam terakhir: median lama transaksi sampai final, dalam detik. null jika belum ada data.
success_rate_30dnumber | null
number | null
Sama seperti success_rate, untuk 30 hari terakhir. Field tambahan: abaikan jika belum ada di respons.
speed_seconds_30dnumber | null
number | null
Sama seperti speed_seconds (median), untuk 30 hari terakhir.
success_rate_90dnumber | null
number | null
Sama seperti success_rate, untuk 90 hari terakhir.
speed_seconds_90dnumber | null
number | null
Sama seperti speed_seconds (median), untuk 90 hari terakhir.
activeboolean
boolean
Apakah produk aktif untuk akun Anda. Tanpa semua=true selalu true.
Membaca harga
- Harga di daftar ini untuk ditampilkan. Saat transaksi, harga dihitung ulang dari sumber terbaru, jadi bisa berbeda dari daftar yang Anda simpan.
- Pilihan produk aktif untuk sandbox dan production terpisah. Key sandbox hanya melihat pilihan sandbox, key production hanya pilihan production. Lihat Sandbox.
- Produk aktif diatur di dashboard. Pakai
semua=trueuntuk melihat produk yang belum Anda aktifkan. - Simpan daftar di cache dan perbarui berkala; endpoint ini termasuk kelompok batas baca.
Daftar harga publik
Harga standar juga tersedia tanpa API key di GET /h2h/portal/prices, dengan parameter category dan status yang sama. Isinya sama dengan halaman Harga: harga standar (bukan harga khusus akun Anda) dan tanpa field active.
Terminal
curl "https://api.bisadagang.com/h2h/portal/prices?category=Pulsa"Endpoint publik dibatasi 30 request per menit per IP dan di-cache 5 menit. Untuk sistem Anda, pakai
/h2h/v1/products.Butuh bantuan?
Tanya soal integrasi teknis lewat WhatsApp.