Inquiry

API to inquiry Telco Postpaid.

Path

MethodPath
POSTapi/v1/bill/check

Test Case

CodeNumberResponse
HPTHREE08991230000Success
HPTHREE08991230001Inquiry - Invoice Has Been Paid
HPTHREE08991230014Inquiry - Incorrect Destination Number
HPTHREE08991230103Inquiry - Time Out
HPTHREE08991231037Payment - Payment Failed
HPTHREE08991231039Payment - Pending / transaction in process
HPTHREE08991231105Payment - MISC Error / Biller System Error
HPTHREE0899123XXXXTest 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
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"          : "08991230000",
  "ref_id"      : "09128374658",
  "sign"        : "1231656ad1449ea56be648495e195ea4"
}

<?xml version="1.0" ?>
<mp>
  <commands>inq-pasca</commands>
  <username>123123123</username>
  <code>HPTHREE</code>
  <hp>08991230000</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 balance (price - commission)Yes
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": "08991230000",
    "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>08991230000</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