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 balance (price - commission)Yes
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": "08991230000",
    "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>
    <data>
        <tr_id>9732412</tr_id>
        <code>HPTHREE</code>
        <datetime>20180803171944</datetime>
        <hp>08991230000</hp>
        <tr_name>INTAN NUR AZIZA</tr_name>
        <period></period>
        <nominal>55000</nominal>
        <admin>0</admin>
        <response_code>00</response_code>
        <message>PAYMENT SUCCESS</message>
        <price>55000</price>
        <selling_price>54000</selling_price>
        <balance>997294759</balance>
        <noref>259558197</noref>
        <ref_id>09128374658</ref_id>
        <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>
    </data>
</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.