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
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=true untuk 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.
Sebelumnya
Cek saldo
Berikutnya
Transaksi
Butuh bantuan?
Tanya soal integrasi teknis lewat WhatsApp.
Chat di WhatsApp
Di halaman ini
  • Parameter
  • Request
  • Respons
  • Field produk
  • Membaca harga
  • Daftar harga publik