Inquiry

API to inquiry PBB.

Path

MethodPath
POSTapi/v1/bill/check

Test Case

CodeNumberResponse
PBBKOT.CIMAHI329801092375990000Success
PBBKOT.CIMAHI329801092375990001Inquiry - Invoice Has Been Paid
PBBKOT.CIMAHI329801092375990014Inquiry - Incorrect Destination Number
PBBKOT.CIMAHI329801092375990103Inquiry - Time Out
PBBKOT.CIMAHI329801092375991037Payment - Payment Failed
PBBKOT.CIMAHI329801092375991039Payment - Pending / transaction in process
PBBKOT.CIMAHI329801092375991105Payment - MISC Error / Biller System Error
PBBKOT.CIMAHI32980109237599XXXXTest other response scenarios in the test case menu.

Request Body

AttributesTypeDescriptionMandatory
commandsStringValue: inq-pascaYes
usernameStringYour registered phone numberYes
codeStringProduct Code. You can get list of product code in pricelist api or from pricelist hereYes
hpStringTax object numberYes
ref_idStringYour order number / reference ID ( must unique )Yes
signStringSignature. Value: md5(username+api_key+ref_id)Yes
yearStringNumber of year you're willing to payYes
{
  "commands" : "inq-pasca",
  "username" : "123123123",
  "code"     : "PBBKOT.CIMAHI",
  "hp"       : "329801092375990000",
  "ref_id"   : "978994691278",
  "sign"     : "6c6a046a14c444e44cfab5e4bbb01b01",
  "year"     : "2023"
}

<?xml version="1.0" ?>
<mp>
  <commands>inq-pasca</commands>
  <username>123123123</username>
  <code>PBBKOT.CIMAHI</code>
  <hp>329801092375990000</hp>
  <ref_id>978994691278</ref_id>
  <sign>6c6a046a14c444e44cfab5e4bbb01b01</sign>
  <year>2023</year>
</mp>

Response

AttributesTypeDescriptionMandatory
tr_idIntegerIAK inquiry IDYes
codeStringProduct codeYes
hpStringTax object numberYes
tr_nameStringBill account nameYes
periodStringBill periodYes
nominalDoubleBill nominalYes
adminDoubleAdmin feeYes
ref_idStringYour order number / reference ID ( must unique )Yes
response_codeStringResponse code. See response code listYes
messageStringMessageYes
priceDoubleTotal price that must be paid (nominal + admin fee)Yes
selling_priceDoubleDeducted balance (price - commission)Yes
descObjectProduct descriptionYes
desc.tanggalDoubleDateYes
desc.nopStringTax object numberYes
desc.tahun_pajakStringYear of the taxYes
desc.lokasiStringAsset locationYes
desc.kelurahanStringVillage officeYes
desc.kecamatanDoubleDistrictsYes
desc.kab_kotaDoubleDistricts / cityYes
desc.luas_tanahDoubleWide of surface areaYes
desc.luas_gedungStringWide of building areaYes
desc.jatuh_tempoStringDue dateYes
desc.total_tagihanFloatTotal billYes
desc.dendaFloatPenalty feeYes
desc.adminIntegerAdmin feeYes
desc.total_bayarFloatTotal paymentYes
{
  "data": {
    "tr_id": 24462730,
    "code": "PBBKOT.CIMAHI",
    "hp": "329801092375990000",
    "tr_name": "TESTING PBB",
    "period": "201909",
    "nominal": 203857,
    "admin": 5000,
    "ref_id": "978994691278",
    "response_code": "00",
    "message": "INQUIRY SUCCESS",
    "price": 208857,
    "selling_price": 208857,
    "desc": {
      "tanggal": "2019-08-14 14:38:59",
      "nop": "328073000401005610",
      "tahun_pajak": "2019",
      "lokasi": "KO. GRIYA ASRI CIPAGERAN",
      "kelurahan": "CIPAGERAN",
      "kecamatan": "CIMAHI UTARA",
      "kode_kab_kota": "0023",
      "kab_kota": "PEMKOT CIMAHI",
      "luas_tanah": "113 M2"
      "luas_gedung": "47 M2",
      "jatuh_tempo": "31/10/2019",
      "total_tagihan": 203857,
      "denda": 0,
      "admin": 5000,
      "total_bayar": 208857
    }
  },
  "meta": []
}

<?xml version="1.0"?>
<mp>
  <tr_id>24462730</tr_id>
  <code>PBBKOT.CIMAHI</code>
  <hp>329801092375990000</hp>
  <tr_name>TESTING PBB</tr_name>
  <period>201909</period>
  <nominal>203857</nominal>
  <admin>5000</admin>
  <ref_id>978994691278</ref_id>
  <response_code>00</response_code>
  <message>INQUIRY SUCCESS</message>
  <price>208857</price>
  <selling_price>208857</selling_price>
  <desc>
    <tanggal>2019-08-14 14:38:59</tanggal>
    <nop>328073000401005610</nop>
    <tahun_pajak>2019</tahun_pajak>
    <lokasi>KO. GRIYA ASRI CIPAGERAN</lokasi>
    <kelurahan>CIPAGERAN</kelurahan>
    <kecamatan>CIMAHI UTARA</kecamatan>
    <kode_kab_kota>0023</kode_kab_kota>
    <kab_kota>PEMKOT CIMAHI</kab_kota>
    <luas_tanah>113 M2</luas_tanah>
    <luas_gedung>47 M2</luas_gedung>
    <jatuh_tempo>31/10/2019</jatuh_tempo>
    <total_tagihan>203857</total_tagihan>
    <denda>0</denda>
    <admin>5000</admin>
    <total_bayar>208857</total_bayar>
  </desc>
</mp>

Live Testing

Request URL
https://testpostpaid.mobilepulsa.net/api/v1/bill/check
Request Method
Request Header
Content-Type: application/json
Body
Result

Tutorial Video

You can see this video for inquiry code explanation using Laravel.

Or you can see this video for inquiry code explanation using PHP.

Table of Contents