Payment

API to pay Telco Postpaid.

Path

MethodPath
POSTapi/v1/bill/check

Request Body

AttributesTypeDescriptionMandatory
commandsStringValue: pay-pascaYes
usernameStringYour registered phone numberYes
tr_idIntegerIAK inquiry IDYes
signStringSignature. Value: md5(username+api_key+tr_id)Yes
{
  "commands" : "pay-pasca",
  "username" : "123123123", 
  "tr_id"    : "9732412",
  "sign"     : "5859520358d7ed4b3cd60eb10fae015d"
}
<?xml version="1.0" ?>
<mp>
  <commands>pay-pasca</commands>
  <username>123123123</username>
  <tr_id>9732412</tr_id>
  <sign>5859520358d7ed4b3cd60eb10fae015d</sign>
</mp>

Response

AttributesTypeDescriptionMandatory
tr_idIntegerIAK inquiry IDYes
codeStringProduct codeYes
datetimeStringTransaction time (Format YmdHis)Yes
hpStringPLN postpaid customer numberYes
tr_nameStringBill account nameYes
periodStringBill periodYes
nominalDoubleBill nominalYes
adminDoubleAdmin feeYes
response_codeStringResponse code. See response code listYes
messageStringMessageYes
priceDoubleTotal price that must be paid (nominal + admin fee)Yes
selling_priceDoubleDeducted balanceYes
balanceDoubleClient remaining balanceYes
norefStringBiller reference number (if exist)No
ref_idStringYour order number / reference ID ( must unique )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",
    "datetime": "20180803171944",
    "hp": "08991234501",
    "tr_name": "INTAN NUR AZIZA",
    "period": "",
    "nominal": 55000,
    "admin": 0,
    "response_code": "00",
    "message": "PAYMENT SUCCESS",
    "price": 55000,
    "selling_price": 54000,
    "balance": 997294759,
    "noref": "259558197",
    "ref_id": "09128374658",
    "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>PLNPOSTPAID</code>
  <datetime>20170725153910</datetime>
  <hp>530000000001</hp>
  <tr_name>SUBCRIBER NAME</tr_name>
  <period>201608</period>
  <nominal>300000</nominal>
  <admin>2500</admin>
  <response_code>00</response_code>
  <message>PAYMENT SUCCESS</message>
  <price>302500</price>
  <selling_price>301900</selling_price>
  <balance>73657753</balance>
  <no_ref>004212C9245F1BA43A77CEBD5CD5DA39</no_ref>
  <ref_id>09128374658</ref_id>
  <desc>
    <tarif>R1</tarif>
    <daya>1300</daya>
    <lembar_tagihan>1</lembar_tagihan>
    <lembar_tagihan_sisa>0</lembar_tagihan_sisa>
    <tagihan>
      <detail>
        <meter_awal>00080000</meter_awal>
        <meter_akhir>00080000</meter_akhir>
        <periode>201608</periode>
        <nilai_tagihan>300000</nilai_tagihan>
        <admin>2500</admin>
        <denda>0</denda>
        <total>302500</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 payment code explanation using Laravel.

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