Cek Tagihan

---

API ini digunakan untuk melakukan pengecekan tagihan produk pascabayar sebelum melakukan pembayaran

Endpoint

https://api-ppob.hesda-store.com/v1/billing/inquiry

HTTP Method	Endpoint	Deskripsi
POST	BASE_URL/billing/inquiry	Melakukan pengecekan tagihan pascabayar

Inquiry Sebelum Pembayaran

Pastikan melakukan inquiry terlebih dahulu sebelum melakukan pembayaran untuk mendapatkan informasi detail tagihan dan transaction_id yang akan digunakan untuk proses pembayaran.

Request Body

Parameter

Parameter	Type	Required	Description
product_code	string	Ya	Kode produk pascabayar yang akan dicek
customer_no	string	Ya	Nomor pelanggan/ID pelanggan

Example Request

{
  "product_code": "IN01",
  "customer_no": "146xxxxx"
}

Response

Internet

{
  "status": "success",
  "message": "OK",
  "data": {
    "transaction_id": "dnomk9Acig49kat",
    "product_code": "IN01",
    "brand": {
      "name": "INDIHOME & SPEEDY ",
      "logo": "https://hesda-store.com/upload/brand/65eaea9f35f6872c6a2939d6ed8e8cca.png"
    },
    "category": {
      "name": "Internet"
    },
    "customer_name": "XXXXXX",
    "price": 19000,
    "status": "inquiry",
    "message": "Transaksi Sukses",
    "description": {
      "bill_sheet": 1,
      "details": [
        {
          "period": "DES 2025",
          "bill_value": "194250",
          "price_admin": "2500"
        }
      ]
    }
  }
}

Structure

Attribute	Type	Description
status	string	Status respon dari server.
message	string	Keterangan status.
data	object	Objek data hasil inquiry.
transaction_id	string	ID unik transaksi untuk proses pembayaran.
product_code	string	Kode produk yang dicek.
brand	object	Objek brand/provider.
brand.name	string	Nama brand/provider.
brand.logo	string	Link URL menuju file logo brand.
category	object	Objek kategori produk.
category.name	string	Nama kategori (Internet, Tagihan Listrik, dll).
customer_name	string	Nama pelanggan (biasanya disamarkan).
price	integer	Total harga yang harus dibayar.
status	string	Status inquiry (inquiry/failed).
message	string	Pesan keterangan hasil inquiry.
description	object	Objek detail tagihan.
description.bill_sheet	integer	Jumlah lembar tagihan.
description.details	array	Array detail tagihan per periode.
details.period	string	Periode tagihan (contoh: DES 2025).
details.bill_value	string	Nilai tagihan.
details.price_admin	string	Biaya admin.

Contoh Penggunaan

curl -X POST https://api-ppob.hesda-store.com/v1/billing/inquiry \
  -H "Content-Type: application/json" \
  -d '{
    "product_code": "IN1",
    "customer_no": "146XXXXXX"
  }'

Simpan Transaction ID

Simpan transaction_id dari response inquiry untuk digunakan pada proses pembayaran. Transaction ID ini memiliki masa berlaku tertentu.