Inquiry

API to inquiry E-Samsat.

Path

MethodPath
POSTapi/v1/bill/check

Test Case

CodeNumberResponse
ESAMSAT.JABAR9658548523560000Success
ESAMSAT.JABAR9658548523560001Inquiry - Invoice Has Been Paid
ESAMSAT.JABAR9658548523560014Inquiry - Incorrect Destination Number
ESAMSAT.JABAR9658548523560103Inquiry - Time Out
ESAMSAT.JABAR9658548523561037Payment - Payment Failed
ESAMSAT.JABAR9658548523561039Payment - Pending / transaction in process
ESAMSAT.JABAR9658548523561105Payment - MISC Error / Biller System Error
ESAMSAT.JABAR965854852356XXXXTest 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
hpStringESAMSAT payment codeYes
ref_idStringYour order number / reference ID ( must unique )Yes
signStringSignature. Value: md5(username+api_key+ref_id)Yes
nomor_identitasStringRegistered identity numberYes

A thing to know

Here is the step to get ESAMSAT payment code :

  1. Download Samolnas apps
  2. Reqister and get payment code

{
  "commands"        : "inq-pasca",
  "username"        : "123123123",
  "code"            : "ESAMSAT.JABAR",
  "hp"              : "9658548523560000",
  "ref_id"          : "978994691278",
  "sign"            : "6c6a046a14c444e44cfab5e4bbb01b01",
  "nomor_identitas" : "0212502110170100"
}
<?xml version="1.0" ?>
<mp>
  <commands>inq-pasca</commands>
  <username>123123123</username>
  <code>ESAMSAT.JABAR</code>
  <hp>9658548523560000</hp>
  <ref_id>978994691278</ref_id>
  <sign>6c6a046a14c444e44cfab5e4bbb01b01</sign>
  <nomor_identitas>0212502110170100</nomor_identitas>
</mp>

Response

AttributesTypeDescriptionMandatory
tr_idIntegerIAK inquiry IDYes
codeStringProduct codeYes
hpStringESAMSAT payment codeYes
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.nomor_identitasStringCustomer identity numberYes
desc.nomor_rangkaStringVehicle identification numberYes
desc.nomor_mesinStringMachine numberYes
desc.alamatStringAddressYes
desc.milik_kenamaStringVehicle status whether the vehicle has been sold or notYes
desc.merek_kbStringVehicle brandYes
desc.tahun_buatanStringYear madeYes
desc.tgl_akhir_pajak_baruStringValid untilYes
desc.biaya_pokokObjectBasic feeYes
desc.biaya_pokok.BBNStringBea balik nama feeYes
desc.biaya_pokok.PKBStringPajak kendaraan bermotor feeYes
desc.biaya_pokok.SWDStringSumbangan wajib dana kecelakaan lalu lintas feeYes
desc.biaya_dendaObjectPenalty feeYes
desc.biaya_denda.BBNStringBea balik nama penalty feeYes
desc.biaya_denda.PKBStringPajak kendaraan bermotor penalty feeYes
desc.biaya_denda.SWDStringSumbangan wajib dana kecelakaan lalu lintas penalty feeYes
desc.biaya_adminObjectAdmin feeYes
desc.biaya_admin.stnkStringSurat tanda nomor kendaraan admin feeYes
desc.biaya_admin.tnkbStringTanda nomor kendaraan bermotor admin feeYes
desc.biaya_parkir_pokokStringMain parking feeYes
desc.biaya_pajak_progresifStringProgressive tax feeYes
desc.ntpdStringESAMSAT transaction numberYes
{
  "data": {
    "tr_id": 24462352,
    "code": "ESAMSAT.JABAR",
    "hp": "9658548523560000",
    "tr_name": "TESTING ESAMSAT",
    "period": "20181022-20191022",
    "nominal": 2274500,
    "admin": 5000,
    "ref_id": "978994691299",
    "response_code": "00",
    "message": "INQUIRY SUCCESS",
    "price": 2279500,
    "selling_price": 2277000,
    "desc": {
      "nomor_identitas": "0212502110170100",
      "nomor_rangka": "MHKV5EA2JFJ001044",
      "nomor_mesin": "1NRF012268",
      "alamat": "GRIYA BULELENG 2 RT 005 RW 014 BULELENG",
      "nomor_polisi": "DK 1243AL",
      "milik_kenama": "001",
      "merek_kb": "DAIHATSU",
      "model_kb": "XENIA 1.3 R M\/T F653RV-GMDFJ",
      "tahun_buatan": "2018",
      "tgl_akhir_pajak_baru": "20191022",
      "biaya_pokok": {
        "BBN": "0",
        "PKB": "2131000",
        "SWD": "143500"
      },
      "biaya_denda": {
        "BBN": "0",
        "PKB": "0",
        "SWD": "0"
      },
      "biaya_admin": {
        "stnk": "0",
        "tnkb": "0"
      },
      "biaya_parkir_pokok": "0",
      "biaya_pajak_progresif": "0",
      "ntpd": ""
    }
  },
  "meta": []
}
<?xml version="1.0"?>
<mp>
  <tr_id>24462352</tr_id>
  <code>ESAMSAT.JABAR</code>
  <hp>9658548523560000</hp>
  <tr_name>TESTING ESAMSAT</tr_name>
  <period>20181022-20191022</period>
  <nominal>2274500</nominal>
  <admin>5000</admin>
  <ref_id>978994691299</ref_id>
  <response_code>00</response_code>
  <message>INQUIRY SUCCESS</message>
  <price>2279500</price>
  <selling_price>2277000</selling_price>
  <desc>
    <nomor_identitas>0212502110170100</nomor_identitas>
    <nomor_rangka>MHKV5EA2JFJ001044</nomor_rangka>
    <nomor_mesin>1NRF012268</nomor_mesin>
    <alamat>GRIYA BULELENG 2 RT 005 RW 014 BULELENG</alamat>
    <nomor_polisi>DK 1243AL</nomor_polisi>
    <milik_kenama>001</milik_kenama>
    <merek_kb>DAIHATSU</merek_kb>
    <model_kb>XENIA 1.3 R M\/T F653RV-GMDFJ</model_kb>
    <tahun_buatan>2018</tahun_buatan>
    <tgl_akhir_pajak_baru>20191022</tgl_akhir_pajak_baru>
    <biaya_pokok>
      <BBN>0</BBN>
      <PKB>2131000</PKB>
      <SWD>143500</SWD>
    </biaya_pokok>
    <biaya_denda>
      <BBN>0</BBN>
      <PKB>0</PKB>
      <SWD>0</SWD>
    </biaya_denda>
    <biaya_admin>
      <stnk>0</stnk>
      <tnkb>0</tnkb>
    </biaya_admin>
    <biaya_parkir_pokok>0</biaya_parkir_pokok>
    <biaya_pajak_progresif>0</biaya_pajak_progresif>
    <ntpd></ntpd>
  </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.