Inquiry

API to inquiry Telco Postpaid.

Path

MethodPath
POSTapi/v1/bill/check

Test Case

CodeNumberResponse
HPTHREE08991234501Success
HPTHREE08991234503Inquiry - Time Out
HPTHREE08991234504Inquiry - Invoice Has Been Paid
HPTHREE08991234505Inquiry - Incorrect Destination Number
HPTHREE08991234506Payment - Payment Failed
HPTHREE08991234507Payment - Pending / transaction in process
HPTHREE08991234508Payment - MISC Error / Biller System Error

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
hpStringTelco postpaid customer numberYes
ref_idStringYour order number / reference ID ( must unique )Yes
signStringSignature. Value: md5(username+api_key+ref_id)Yes
{
  "commands"    : "inq-pasca",
  "username"    : "123123123",
  "code"        : "HPTHREE",
  "hp"          : "08991234501",
  "ref_id"      : "09128374658",
  "sign"        : "1231656ad1449ea56be648495e195ea4"
}

<?xml version="1.0" ?>
<mp>
  <commands>inq-pasca</commands>
  <username>123123123</username>
  <code>HPTHREE</code>
  <hp>08991234501</hp>
  <ref_id>09128374658</ref_id>
  <sign>1231656ad1449ea56be648495e195ea4</sign>
</mp>

Response

AttributesTypeDescriptionMandatory
tr_idIntegerIAK inquiry IDYes
codeStringProduct codeYes
hpStringTelco postpaid customer 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 balanceYes
descObjectProduct descriptionYes
desc.kode_areaStringArea codeYes
desc.divreStringDivreYes
desc.datelStringDatelYes
desc.jumlah_tagihanIntegerNumber of invoiceYes
desc.tagihanObjectInvoice dataYes
desc.tagihan.detailArrayDetail of invoice per monthYes
desc.tagihan.detail.periodeStringBill period for detailed monthYes
desc.tagihan.detail.nilai_tagihanStringBill amount for detailed monthYes
desc.tagihan.detail.adminStringAdmin fee for detailed monthYes
desc.tagihan.detail.totalStringBill total for detailed monthYes
{
  "data": {
    "tr_id": 9732412,
    "code": "HPTHREE",
    "hp": "08991234501",
    "tr_name": "INTAN NUR AZIZA",
    "period": "",
    "nominal": 55000,
    "admin": 0,
    "ref_id": "09128374658",
    "response_code": "00",
    "message": "INQUIRY SUCCESS",
    "price": 55000,
    "selling_price": 54000,
    "desc": {
      "kode_area": "",
      "divre": "",
      "datel": "",
      "jumlah_tagihan": 1,
      "tagihan": {
        "detail": [
          {
            "periode": "",
            "nilai_tagihan": "",
            "admin": "",
            "total": ""
          }
        ]
      }
    }
  },
  "meta": []
}

<?xml version="1.0"?>
<mp>
  <tr_id>9732412</tr_id>
  <code>HPTHREE</code>
  <hp>08991234501</hp>
  <tr_name>INTAN NUR AZIZA</tr_name>
  <period></period>
  <nominal>55000</nominal>
  <admin>0</admin>
  <ref_id>09128374658</ref_id>
  <response_code>00</response_code>
  <message>INQUIRY SUCCESS</message>
  <price>55000</price>
  <selling_price>54000</selling_price>
  <desc>
    <kode_area></kode_area>
    <divre></divre>
    <datel></datel>
    <jumlah_tagihan>1</jumlah_tagihan>
    <tagihan>
      <detail>
        <periode></periode>
        <nilai_tagihan></nilai_tagihan>
        <admin></admin>
        <total></total>
      </detail>
    </tagihan>
  </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