Cek Tagihan PPOB

Endpoint ini digunakan untuk mengecek informasi tagihan pelanggan berdasarkan nomor pelanggan dan kode produk layanan tagihan (seperti PLN, PDAM, BPJS, dll). Proses ini wajib dilakukan sebelum melakukan pembayaran.

---

🚣️ Endpoint POST

https://sandbox.bisatopup.co.id/api/tagihan/cek_tagihan

---

🔐 Autentikasi

Setiap permintaan harus menyertakan token autentikasi:

Authorization: Bearer <token>

---

📥 Request Body

{
  "product": "PLN",
  "phone_number": "085277677761",
  "nomor_rekening": "3212015027302"
}

Parameter

Parameter	Tipe	Wajib	Deskripsi
product	string	Ya	Kode produk layanan tagihan (contoh: PLN)
phone_number	string	Ya	Nomor HP pelanggan (jika diperlukan)
nomor_rekening	string	Ya	ID pelanggan atau nomor rekening tagihan

---

📤 Response

{
  "status": "ok",
  "error": false,
  "message": "Cek tagihan berhasil",
  "struk_data": "...",
  "is_process": false,
  "data": {
    "no_pelanggan": "121150148275",
    "product_name": "TAGIHAN PLN",
    "jumlah_tagihan": 18345,
    "jumlah_bayar": 19345,
    "potongan": 2000,
    "denda": 3000,
    "admin": 3000,
    "terbayar": null,
    "nama": "GEREJA KATHOLIK",
    "periode": "JUN25",
    "nomor_tagihan": "121150148275",
    "tagihan_id": 5377648
  },
  "response_code": "00"
}

Penjelasan Field:

Field	Tipe	Deskripsi
status	string	Status response (ok jika sukses)
message	string	Informasi hasil pengecekan tagihan
struk_data	string	Data tagihan dalam format siap cetak
is_process	boolean	Status apakah sedang dalam proses
jumlah_tagihan	integer	Nilai pokok tagihan
jumlah_bayar	integer	Total jumlah yang harus dibayar
potongan	integer	Potongan harga (jika ada)
denda	integer	Biaya denda (jika ada)
admin	integer	Biaya administrasi
nama	string	Nama pelanggan
periode	string	Periode tagihan
tagihan_id	integer	ID tagihan unik yang digunakan saat bayar
no_pelanggan	string	Nomor pelanggan/ID pengguna
nomor_tagihan	string	Nomor tagihan (biasanya sama dengan pelanggan)

---

Catatan:

• Gunakan nilai tagihan_id dari response ini untuk melanjutkan ke proses pembayaran.
• struk_data bisa digunakan langsung sebagai isi cetak struk digital atau fisik.
• Pastikan ID pelanggan dan produk benar untuk menghindari kegagalan inquiry.

Setelah informasi ini dikonfirmasi oleh pengguna, lanjutkan ke endpoint pembayaran tagihan.