Inquiry

API to inquiry PDAM.

Path

MethodPath
POSTapi/v1/bill/check

Test Case

CodeNumberResponse
PDAMKOTA.SURABAYA10200000Success - 1 bill
PDAMKOTA.MEDAN10200999Success - 4 bills
AETRA10200001Inquiry - Invoice Has Been Paid
AETRA10200014Inquiry - Incorrect Destination Number
AETRA10200103Inquiry - Time Out
PDAMKOTA.MEDAN10201037Payment - Payment Failed
PDAMKOTA.MEDAN10201039Payment - Pending / transaction in process
PDAMKOTA.MEDAN10201105Payment - MISC Error / Biller System Error
PDAMKOTA.MEDAN1020XXXXTest 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
hpStringPDAM 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"        : "PDAMKOTA.SURABAYA",
  "hp"          : "10200000",
  "ref_id"      : "0912837465",
  "sign"        : "ebb8b87be79243370bd29bfb8894e8d7"
}
<?xml version="1.0" ?>
<mp>
  <commands>inq-pasca</commands>
  <username>123123123</username>
  <code>PDAMKOTA.SURABAYA</code>
  <hp>10200000</hp>
  <ref_id>0912837465</ref_id>
  <sign>ebb8b87be79243370bd29bfb8894e8d7</sign>
</mp>

Response

Loading...

There are 2 types of PDAM response :

  1. Separated desc.bill.detail for each period

For example when there is PDAM bill 2 periods, then the desc.bill.detail will be 2 index array that contain detail for each period.

  1. Unified desc.bill.detail for all period

For example when there is PDAM bill 2 periods, then the desc.bill.detail just 1 index array that contain detail for all period. Below table is a list of PDAM products for unified detail for all period:

---
PDAMKAB.ACEHBESARPDAMKAB.ACEHTAMIANGPDAMKAB.ACEHUTARA
PDAMKAB.AGAMPDAMKAB.BANDUNGBPDAMKAB.BANGGAI
PDAMKAB.BANGKABARATPDAMKAB.BANTULPDAMKAB.BANYUASIN
PDAMKAB.BATANGHARIPDAMKAB.BEKASIPDAMKAB.BELITUNGTIMUR
PDAMKAB.BENGKAYANGPDAMKAB.BONEPDAMKAB.BONEBOLANGO
PDAMKAB.BULUNGANTANJUNGSELORPDAMKAB.BUTONPDAMKAB.CILACAPNONREGULER
PDAMKAB.DOMPUPDAMKAB.ENREKANGPDAMKAB.GIANYAR
PDAMKAB.GIANYARNONAIRPDAMKAB.GORONTALOPDAMKAB.GORONTALOLIMBOTO
PDAMKAB.GOWAPDAMKAB.GUNUNGKIDULPDAMKAB.HALMAHERAUTARA
PDAMKAB.HULUSUNGAIUTARAAMUNTAIPDAMKAB.JEMBRANAPDAMKAB.KAPUASHULU
PDAMKAB.KARAWANGBPDAMKAB.KEDIRIPDAMKAB.KERINCI
PDAMKAB.KETAPANGPDAMKAB.KOLAKAPDAMKAB.KOLAKAUTARA
PDAMKAB.KOTABARUPULAULAUTPDAMKAB.KUDUSPDAMKAB.KUPANG
PDAMKAB.KUTAIBARATPDAMKAB.KUTAIKERTANEGARAPDAMKAB.LAMANDAU
PDAMKAB.LAMONGANPDAMKAB.LAMPUNGSELATANPDAMKAB.LEBAK
PDAMKAB.LIMAPULUHKOTAPDAMKAB.LOMBOKTIMURPDAMKAB.LUWU
PDAMKAB.LUWUTIMURPDAMKAB.LUWUUTARAPDAMKAB.MAGELANG
PDAMKAB.MAGETANPDAMKAB.MAJALENGKAPDAMKAB.MALINAU
PDAMKAB.MALUKUTENGGARAPDAMKAB.MANGGARAIPDAMKAB.MAROS
PDAMKAB.MEMPAWAHPDAMKAB.MERANGINPDAMKAB.MINAHASAUTARA
PDAMKAB.MUARABUNGOPDAMKAB.MUARAENIMPDAMKAB.MUAROJAMBI
PDAMKAB.MUSIBANYUASINPDAMKAB.NGAWIPDAMKAB.OGANILIR
PDAMKAB.OKUBATURAJAPDAMKAB.OKUSELATANPDAMKAB.PACITAN
PDAMKAB.PADANGPARIAMANPDAMKAB.PAMEKASANPDAMKAB.PANDEGLANG
PDAMKAB.PESSELPDAMKAB.POLMANPDAMKAB.PRABUMULIH
PDAMKAB.PURWAKARTAPDAMKAB.SANGGAUPDAMKAB.SAROLANGUN
PDAMKAB.SERANGPDAMKAB.SERDANGPDAMKAB.SERUYAN
PDAMKAB.SIDRAPPDAMKAB.SIJUNJUNGPDAMKAB.SIKKA
PDAMKAB.SINJAIPDAMKAB.SOLOKPDAMKAB.SRAGEN
PDAMKAB.SUMBAWAPDAMKAB.SUMENEPPDAMKAB.TABALONG
PDAMKAB.TANAHBUMBUPDAMKAB.TANAHDATARPDAMKAB.TANGERANG
PDAMKAB.TANJUNGJABUNGBARATPDAMKAB.TEBOPDAMKAB.TIMORTENGAHUTARA
PDAMKAB.TRENGGALEKPDAMKAB.TUBANPDAMKAB.TULUNGAGUNG
PDAMKAB.WAJOPDAMKOTA.BIMAPDAMKOTA.BLITAR
PDAMKOTA.BONEWATAMPONEPDAMKOTA.BONTANGPDAMKOTA.BUKITTINGGI
PDAMKOTA.CILEGONPDAMKOTA.DAROYPDAMKOTA.DKIPALYJA
PDAMKOTA.GORONTALOPDAMKOTA.JAMBIPDAMKOTA.KANDANGAN
PDAMKOTA.KENDARIPDAMKOTA.KUTAITIMURPDAMKOTA.LANGSA
PDAMKOTA.LUBUKLINGGAUPDAMKOTA.MAGELANGPDAMKOTA.MOJOKERTO
PDAMKOTA.PALOPOPDAMKOTA.PALUPDAMKOTA.PANGKALPINANG
PDAMKOTA.PAREPAREPDAMKOTA.PARIAMANPDAMKOTA.PEKANBARU
PDAMKOTA.PEMATANGSIANTARPDAMKOTA.RANTAUPRAPATPDAMKOTA.SABANG
PDAMKOTA.SAMPITPDAMKOTA.SINGKAWANGPDAMKOTA.TANJUNGBALAI
PDAMKOTA.TANJUNGPINANGPDAMKOTA.TARAKANPDAMKOTA.TARUTUNG
PDAMKOTA.TASIKMALAYAPDAMKOTA.TEBINGTINGGIPDAMKOTA.TEMBILAHAN
PDAMKOTA.TERNATEPDAMKOTA.TOMOHONPDAMKOTA.WISATABATU
PDAMKOTA.YOGYAKARTA--
Other than above table is separated detail

Separated Detail Response

{
  "data": {},
  "meta": []
}

Unified Detail Response

{
  "data": {},
  "meta": []
}

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.