Introduction
Payment Gateway
Integration
Your Account
Biller Products
Water Utility Bill (PDAM)
Espay provides an API for paying water utility bills online. For integration, you send a request to the Bill Inquiry service with the customer number and the selected product. Then, to complete the payment, you send a request to the Bill Payment service using the data returned from the Bill Inquiry. Learn more about Biller Product | Bill Inquiry and Biller Product | Bill Payment.
Download the Postman collection – Water Utility Bill (PDAM) here.
Product Codes
PDAM
PDAM
| Product Code | Product Name | Transaction Type |
|---|---|---|
| SLYPLJ | PAM Palyja | PAYMENT |
| SLYATR | PAM Aetra | PAYMENT |
| SLYLPR | 100 PLN Prabayar 100.000 | PAYMENT |
| SLYATG | PAM Aetra Tangerang | PAYMENT |
| SLYPDB | PDAM Kab. Bogor | PAYMENT |
| SLYPDD | PDAM Kota Bandung | PAYMENT |
| SLYPDK | PDAM Kota Depok | PAYMENT |
| SLYPDL | PDAM Lampung | PAYMENT |
| SLYPDM | PDAM Kota Mataram | PAYMENT |
| SLYPDP | PDAM Palembang | PAYMENT |
Bill Inquiry - PAM Aetra
Sample Request
POST /rest/biller/inquirytransaction HTTP/1.1
Host: sandbox-api.espay.id
Content-Type: application/x-www-form-urlencoded
Authorization: Basic ZXNwYXktdGVzdDp0ZXN0
Content-Length: 229
rq_uuid=SANDBOXINQUIRYBILLER01010986785&
rq_datetime=2019-10-10%2011%3A01%3A30&
sender_id=SANDBOX&
password=test&
order_id=400400400400400&
product_code=SLYATR&
signature=9d6eede295d8865adc9eefa3fc48c059d22773338b01284eb42ab688671a7c9c
Sample Positive Response
{
"rq_uuid":"SANDBOXINQUIRYBILLER010109867850",
"rs_datetime":"2025-02-14 14:48:36",
"error_code":"0000",
"error_desc":"Success",
"order_id":"400400400400400",
"amount":"200350000",
"bill_amount":"200000000",
"admin_fee":"350000",
"data":{
"bill_amount":"0002000000",
"bill_date":"201510",
"bill_total":"01",
"cubication":"00000000-00000000",
"customer_id":"000315996",
"customer_name":"ASMUNI",
"penalty":"00000000",
"provider_code":"11",
"ref_no":""
},
"bankFee":"350000",
"barcode_fee":"",
"receipt":{
"field":"Reference Number",
"value":""
}
}
Sample Negative Response
{
"rq_uuid": "SANDBOXINQUIRYBILLER01010986785",
"rs_datetime": "2025-02-14 14:48:02",
"error_code": 210,
"error_desc":"UUID already exist"
}
Bill Payment - PAM Aetra
Sample Request
POST /rest/biller/paymentreport HTTP/1.1
Host: sandbox-api.espay.id
Content-Type: application/x-www-form-urlencoded
Authorization: Basic ZXNwYXktdGVzdDp0ZXN0
Content-Length: 852
rq_uuid=SANDBOXPAYMENTBILLER01010264654&
rq_datetime=2019-10-10%2011%3A02%3A30&
sender_id=SANDBOX&
password=test&
order_id=400400400400400&
product_code=SLYATR&
amount=1498400&
signature=f46a2c34884c3d9194140f5ab595cae393749a0c5c25f23d2ebcfec3865196d1&
data={
"provider_code": "11",
"customer_id": "000315996",
"customer_name": "ASMUNI",
"bill_total": "01",
"bill_date": "201510",
"bill_amount": "000000011484",
"penalty": "00000000",
"cubication": "00000000-00000000",
"ref_no": ""
}
Sample Positive Response
{
"rq_uuid": "SANDBOXPAYMENTBILLER01010264651",
"rs_datetime": "2025-02-14 15:33:16",
"error_code": "0000",
"error_desc": "Success",
"order_id": "400400400400400",
"ref_id": "20250214153316",
"data": {
"bill_amount": "0002000000",
"bill_date": "201510",
"bill_total": "01",
"cubication": "00000000-00000000",
"customer_id": "000315996",
"customer_name": "ASMUNI",
"penalty": "00000000",
"provider_code": "11",
"ref_no": ""
},
"bankFee": 0,
"mwData": "{\"ftbpTraceNo\":\"141296\"}",
"barcode_fee": "",
"receipt": {
"field": "Reference Number",
"value": ""
}
}
Sample Negative Response
{
"rq_uuid": "SANDBOXPAYMENTBILLER01010264651",
"rs_datetime": "2025-02-14 15:33:42",
"error_code": 610,
"error_desc": "Anda bisa melakukan transaksi yang sama setelah 5 menit"
}
HTTP Bill Inquiry - PAM Aetra
POST /rest/biller/inquirytransaction HTTP/1.1
Host: sandbox-api.espay.id
Content-Type: application/x-www-form-urlencoded
Authorization: Basic ZXNwYXktdGVzdDp0ZXN0
Content-Length: 229
rq_uuid=SANDBOXINQUIRYBILLER01010986785&rq_datetime=2019-10-10%2011%3A01%3A30&sender_id=SANDBOX&password=test&order_id=400400400400400&product_code=SLYATR&signature=9d6eede295d8865adc9eefa3fc48c059d22773338b01284eb42ab688671a7c9c
HTTP Bill Payment - PAM Aetra
POST /rest/biller/paymentreport HTTP/1.1
Host: sandbox-api.espay.id
Content-Type: application/x-www-form-urlencoded
Authorization: Basic ZXNwYXktdGVzdDp0ZXN0
Content-Length: 852
rq_uuid=SANDBOXPAYMENTBILLER01010264654&rq_datetime=2019-10-10%2011%3A02%3A30&sender_id=SANDBOX&password=test&order_id=400400400400400&product_code=SLYATR&amount=1498400&signature=f46a2c34884c3d9194140f5ab595cae393749a0c5c25f23d2ebcfec3865196d1&data=%7B%0A%20%20%20%20%20%20%20%20%22provider_code%22%3A%20%2211%22%2C%0A%20%20%20%20%20%20%20%20%22customer_id%22%3A%20%22000315996%22%2C%0A%20%20%20%20%20%20%20%20%22customer_name%22%3A%20%22ASMUNI%22%2C%0A%20%20%20%20%20%20%20%20%22bill_total%22%3A%20%2201%22%2C%0A%20%20%20%20%20%20%20%20%22bill_date%22%3A%20%22201510%22%2C%0A%20%20%20%20%20%20%20%20%22bill_amount%22%3A%20%22000000011484%22%2C%0A%20%20%20%20%20%20%20%20%22penalty%22%3A%20%2200000000%22%2C%0A%20%20%20%20%20%20%20%20%22cubication%22%3A%20%2200000000-00000000%22%2C%0A%20%20%20%20%20%20%20%20%22ref_no%22%3A%20%22%22%0A%20%20%20%20%7D
CURL Bill Inquiry - PAM Aetra
curl --location 'https://sandbox-api.espay.id/rest/biller/inquirytransaction' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Basic ZXNwYXktdGVzdDp0ZXN0' \
--data-urlencode 'rq_uuid=SANDBOXINQUIRYBILLER01010986785' \
--data-urlencode 'rq_datetime=2019-10-10 11:01:30' \
--data-urlencode 'sender_id=SANDBOX' \
--data-urlencode 'password=test' \
--data-urlencode 'order_id=400400400400400' \
--data-urlencode 'product_code=SLYATR' \
--data-urlencode 'signature=9d6eede295d8865adc9eefa3fc48c059d22773338b01284eb42ab688671a7c9c'
CURL Bill Payment - PAM Aetra
curl --location 'https://sandbox-api.espay.id/rest/biller/paymentreport' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Basic ZXNwYXktdGVzdDp0ZXN0' \
--header 'Cookie: sl-session=vovWUqX/9mizRcfBxwNaYg==' \
--data-urlencode 'rq_uuid=SANDBOXPAYMENTBILLER01010264654' \
--data-urlencode 'rq_datetime=2019-10-10 11:02:30' \
--data-urlencode 'sender_id=SANDBOX' \
--data-urlencode 'password=test' \
--data-urlencode 'order_id=400400400400400' \
--data-urlencode 'product_code=SLYATR' \
--data-urlencode 'amount=1498400' \
--data-urlencode 'signature=f46a2c34884c3d9194140f5ab595cae393749a0c5c25f23d2ebcfec3865196d1' \
--data-urlencode 'data={
"provider_code": "11",
"customer_id": "000315996",
"customer_name": "ASMUNI",
"bill_total": "01",
"bill_date": "201510",
"bill_amount": "000000011484",
"penalty": "00000000",
"cubication": "00000000-00000000",
"ref_no": ""
}'