Inquiry

API to inquiry BPJS Kesehatan Penerima Upah (PU).

Path

MethodPath
POSTapi/v1/bill/check

Test Case

CodeNumberResponse
BPJSTKPU210300010000Success
BPJSTKPU210300010001Inquiry - Invoice Has Been Paid
BPJSTKPU210300010014Inquiry - Incorrect Destination Number
BPJSTKPU210300010103Inquiry - Time Out
BPJSTKPU210300011037Payment - Payment Failed
BPJSTKPU210300011039Payment - Pending / transaction in process
BPJSTKPU210300011105Payment - MISC Error / Biller System Error
BPJSTKPU21030001XXXXTest 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
hpStringBill 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"     : "BPJSTKPU",
  "hp"       : "210300010000",
  "ref_id"   : "091283746511",
  "sign"     : "6515c5094421834a85ed9ac7a0fe443b",
  "month"    : "1"
}
<?xml version="1.0" ?>
<mp>
  <commands>inq-pasca</commands>
  <username>123123123</username>
  <code>BPJSTKPU</code>
  <hp>210300010000</hp>
  <ref_id>091283746511</ref_id>
  <sign>6515c5094421834a85ed9ac7a0fe443b</sign>
  <month>1</month>
</mp>

Response

AttributesTypeDescriptionMandatory
tr_idIntegerIAK inquiry IDYes
codeStringProduct codeYes
datetimeStringTransaction time (Format YmdHis)Yes
hpStringNIKYes
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_iuranStringContribution CodeYes
desc.jhtIntegerPension Plan FeeYes
desc.jkkIntegerAccident Insurance FeeYes
desc.jkmIntegerDeath Insurance FeeYes
desc.jpkIntegerLost Job FeeYes
desc.jpnIntegerPension Plan FeeYes
desc.nppStringCompany Registration NumberYes
desc.kode_divisiStringDivision CodeYes
{
  "data": {
    "tr_id": 219342904,
    "code": "BPJSTKPU",
    "hp": "210300010000",
    "tr_name": "PT LIMABELAS",
    "period": "202104",
    "nominal": 100000,
    "admin": 2500,
    "ref_id": "091283746511",
    "response_code": "00",
    "message": "INQUIRY SUCCESS",
    "price": 102500,
    "selling_price": 100500,
    "desc": {
      "kode_iuran": "210300016066",
      "jht": 61688,
      "jkk": 1082,
      "jkm": 2166,
      "jpk": 2597,
      "jpn": 32467,
      "npp": "15092873",
      "kode_divisi": "000"
    }
  },
  "meta": []
}
<?xml version="1.0" encoding="UTF-8" ?>
<mp>
  <tr_id>219342904</tr_id>
  <code>BPJSTKPU</code>
  <hp>210300010000</hp>
  <tr_name>PT LIMABELAS</tr_name>
  <period>202104</period>
  <nominal>100000</nominal>
  <admin>2500</admin>
  <ref_id>091283746511</ref_id>
  <response_code>00</response_code>
  <message>INQUIRY SUCCESS</message>
  <price>102500</price>
  <selling_price>100500</selling_price>
  <desc>
    <kode_iuran>210300016066</kode_iuran>
    <jht>61688</jht>
    <jkk>1082</jkk>
    <jkm>2166</jkm>
    <jpk>2597</jpk>
    <jpn>32467</jpn>
    <npp>15092873</npp>
    <kode_divisi>000</kode_divisi>
  </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.