Payment

API to pay PDAM.

Path

Method	Path
POST	api/v1/bill/check

Request Body

Attributes	Type	Description	Mandatory
commands	String	Value: `pay-pasca`	Yes
username	String	Your registered phone number	Yes
tr_id	Integer	IAK inquiry ID	Yes
sign	String	Signature. Value: `md5(username+api_key+tr_id)`	Yes

{
  "commands" : "pay-pasca",
  "username" : "123123123", 
  "tr_id"    : "9732791",
  "sign"     : "c6836fdee839788a61b917eebb32ec53"
}

<?xml version="1.0" ?>
<mp>
  <commands>pay-pasca</commands>
  <username>123123123</username>
  <tr_id>9732791</tr_id>
  <sign>c6836fdee839788a61b917eebb32ec53</sign>
</mp>

Response

Attributes	Type	Description	Mandatory
tr_id	Integer	IAK inquiry ID	Yes
code	String	Product code	Yes
datetime	String	Transaction time (Format YmdHis)	Yes
hp	String	PDAM customer number	Yes
tr_name	String	Bill account name	Yes
period	String	Bill period	Yes
nominal	Double	Bill nominal	Yes
admin	Double	Admin fee	Yes
response_code	String	Response code. See response code list	Yes
message	String	Message	Yes
price	Double	Total price that must be paid (nominal + admin fee)	Yes
selling_price	Double	Deducted balance	Yes
balance	Double	Client remaining balance	Yes
noref	String	Biller reference number (if exist)	No
ref_id	String	Your order number / reference ID ( must unique )	Yes
desc	Object	Product description	Yes
desc.bill_quantity	Integer	Bill quantity	Yes
desc.address	String	Invoice Address	Yes
desc.biller_admin	String	Admin fee	Yes
desc.pdam_name	String	PDAM name	Yes
desc.stamp_duty	String	Stamp duty fee	Yes
desc.due_date	String	Due date (only for PDAMKOTA.SURABAYA)	No
desc.kode_tarif	String	Fare code (only for PDAMKOTA.SURABAYA)	No
desc.bill	Object	Bill details	Yes
desc.bill.detail	Array	Bill details	Yes
desc.bill.detail.period	String	Bill period of detailed month	Yes
desc.bill.detail.first_meter	Integer	Initial meter of detailed month	Yes
desc.bill.detail.last_meter	Integer	Final meter of detailed month	Yes
desc.bill.detail.penalty	Double	Penalty fee of detailed month	Yes
desc.bill.detail.bill_amount	Double	Bill amount of detailed month	Yes
desc.bill.detail.misc_amount	Double	Others fee of detailed month	Yes
desc.bill.detail.stand	String	Current PDAM stand of detailed month (only for PDAMKOTA.SURABAYA)	No

There are 2 types of PDAM response :

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.

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.ACEHBESAR	PDAMKAB.ACEHTAMIANG	PDAMKAB.ACEHUTARA
PDAMKAB.AGAM	PDAMKAB.BANDUNGB	PDAMKAB.BANGGAI
PDAMKAB.BANGKABARAT	PDAMKAB.BANTUL	PDAMKAB.BANYUASIN
PDAMKAB.BATANGHARI	PDAMKAB.BEKASI	PDAMKAB.BELITUNGTIMUR
PDAMKAB.BENGKAYANG	PDAMKAB.BONE	PDAMKAB.BONEBOLANGO
PDAMKAB.BULUNGANTANJUNGSELOR	PDAMKAB.BUTON	PDAMKAB.CILACAPNONREGULER
PDAMKAB.DOMPU	PDAMKAB.ENREKANG	PDAMKAB.GIANYAR
PDAMKAB.GIANYARNONAIR	PDAMKAB.GORONTALO	PDAMKAB.GORONTALOLIMBOTO
PDAMKAB.GOWA	PDAMKAB.GUNUNGKIDUL	PDAMKAB.HALMAHERAUTARA
PDAMKAB.HULUSUNGAIUTARAAMUNTAI	PDAMKAB.JEMBRANA	PDAMKAB.KAPUASHULU
PDAMKAB.KARAWANGB	PDAMKAB.KEDIRI	PDAMKAB.KERINCI
PDAMKAB.KETAPANG	PDAMKAB.KOLAKA	PDAMKAB.KOLAKAUTARA
PDAMKAB.KOTABARUPULAULAUT	PDAMKAB.KUDUS	PDAMKAB.KUPANG
PDAMKAB.KUTAIBARAT	PDAMKAB.KUTAIKERTANEGARA	PDAMKAB.LAMANDAU
PDAMKAB.LAMONGAN	PDAMKAB.LAMPUNGSELATAN	PDAMKAB.LEBAK
PDAMKAB.LIMAPULUHKOTA	PDAMKAB.LOMBOKTIMUR	PDAMKAB.LUWU
PDAMKAB.LUWUTIMUR	PDAMKAB.LUWUUTARA	PDAMKAB.MAGELANG
PDAMKAB.MAGETAN	PDAMKAB.MAJALENGKA	PDAMKAB.MALINAU
PDAMKAB.MALUKUTENGGARA	PDAMKAB.MANGGARAI	PDAMKAB.MAROS
PDAMKAB.MEMPAWAH	PDAMKAB.MERANGIN	PDAMKAB.MINAHASAUTARA
PDAMKAB.MUARABUNGO	PDAMKAB.MUARAENIM	PDAMKAB.MUAROJAMBI
PDAMKAB.MUSIBANYUASIN	PDAMKAB.NGAWI	PDAMKAB.OGANILIR
PDAMKAB.OKUBATURAJA	PDAMKAB.OKUSELATAN	PDAMKAB.PACITAN
PDAMKAB.PADANGPARIAMAN	PDAMKAB.PAMEKASAN	PDAMKAB.PANDEGLANG
PDAMKAB.PESSEL	PDAMKAB.POLMAN	PDAMKAB.PRABUMULIH
PDAMKAB.PURWAKARTA	PDAMKAB.SANGGAU	PDAMKAB.SAROLANGUN
PDAMKAB.SERANG	PDAMKAB.SERDANG	PDAMKAB.SERUYAN
PDAMKAB.SIDRAP	PDAMKAB.SIJUNJUNG	PDAMKAB.SIKKA
PDAMKAB.SINJAI	PDAMKAB.SOLOK	PDAMKAB.SRAGEN
PDAMKAB.SUMBAWA	PDAMKAB.SUMENEP	PDAMKAB.TABALONG
PDAMKAB.TANAHBUMBU	PDAMKAB.TANAHDATAR	PDAMKAB.TANGERANG
PDAMKAB.TANJUNGJABUNGBARAT	PDAMKAB.TEBO	PDAMKAB.TIMORTENGAHUTARA
PDAMKAB.TRENGGALEK	PDAMKAB.TUBAN	PDAMKAB.TULUNGAGUNG
PDAMKAB.WAJO	PDAMKOTA.BIMA	PDAMKOTA.BLITAR
PDAMKOTA.BONEWATAMPONE	PDAMKOTA.BONTANG	PDAMKOTA.BUKITTINGGI
PDAMKOTA.CILEGON	PDAMKOTA.DAROY	PDAMKOTA.DKIPALYJA
PDAMKOTA.GORONTALO	PDAMKOTA.JAMBI	PDAMKOTA.KANDANGAN
PDAMKOTA.KENDARI	PDAMKOTA.KUTAITIMUR	PDAMKOTA.LANGSA
PDAMKOTA.LUBUKLINGGAU	PDAMKOTA.MAGELANG	PDAMKOTA.MOJOKERTO
PDAMKOTA.PALOPO	PDAMKOTA.PALU	PDAMKOTA.PANGKALPINANG
PDAMKOTA.PAREPARE	PDAMKOTA.PARIAMAN	PDAMKOTA.PEKANBARU
PDAMKOTA.PEMATANGSIANTAR	PDAMKOTA.RANTAUPRAPAT	PDAMKOTA.SABANG
PDAMKOTA.SAMPIT	PDAMKOTA.SINGKAWANG	PDAMKOTA.TANJUNGBALAI
PDAMKOTA.TANJUNGPINANG	PDAMKOTA.TARAKAN	PDAMKOTA.TARUTUNG
PDAMKOTA.TASIKMALAYA	PDAMKOTA.TEBINGTINGGI	PDAMKOTA.TEMBILAHAN
PDAMKOTA.TERNATE	PDAMKOTA.TOMOHON	PDAMKOTA.WISATABATU
PDAMKOTA.YOGYAKARTA	-	-

Other than above table is separated detail

Separated Detail Response

{
  "data": {
    "tr_id": 9732791,
    "code": "PDAMKOTA.SURABAYA",
    "datetime": "20180803171834",
    "hp": "10202001",
    "tr_name": "DADANG SOEKARDI",
    "period": "201412",
    "nominal": 35490,
    "admin": 2000,
    "response_code": "00",
    "message": "PAYMENT SUCCESS",
    "price": 37490,
    "selling_price": 36790,
    "balance": 997888008,
    "noref": "267411786",
    "ref_id": "0912837465",
    "desc": {
      "bill_quantity": 1,
      "address": "WONOKROMO S.S BARU 2 8",
      "biller_admin": "",
      "pdam_name": "PDAM SURABAYA",
      "stamp_duty": "",
      "due_date": "1-15 DES 2014",
      "kode_tarif": "3A",
      "bill": {
        "detail": [
          {
            "period": "201412",
            "first_meter": 4589,
            "last_meter": 4613,
            "penalty": 7500,
            "bill_amount": 27240,
            "misc_amount": 750,
            "stand": ""
          }
        ]
      }
    }
  },
  "meta": []
}

Unified Detail Response

{
  "data": {
    "tr_id": 9732791,
    "code": "PDAMKOTA.YOGYAKARTA",
    "datetime": "20180803171834",
    "hp": "10202001",
    "tr_name": "DADANG SOEKARDI",
    "period": "201803,201804",
    "nominal": 35490,
    "admin": 2000,
    "response_code": "00",
    "message": "PAYMENT SUCCESS",
    "price": 37490,
    "selling_price": 36790,
    "balance": 997888008,
    "noref": "267411786",
    "ref_id": "0912837465",
    "desc": {
      "bill_quantity": 1,
      "address": "WONOKROMO S.S BARU 2 8",
      "biller_admin": "",
      "pdam_name": "PDAM KOTA YOGYAKARTA",
      "stamp_duty": "",
      "kode_tarif": "",
      "bill": {
        "detail": [
          {
            "period": "201803,201804",
            "first_meter": 4589,
            "last_meter": 4613,
            "penalty": 7500,
            "bill_amount": 27240,
            "misc_amount": 750
          }
        ]
      }
    }
  },
  "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 payment code explanation using Laravel.

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

PdamInquiry

PgasInquiry