Biller Products

Mobile Postpaid

Espay provides an API for postpaid mobile payments. For integration, you send a request to the Bill Inquiry service with the customer number. 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 dan Biller Product | Bill Payment.
Download the Postman collection – Mobile Postpaid here.

Product Codes



Bill Inquiry - Smartfren

Sample Request

POST /rest/biller/inquirytransaction HTTP/1.1
Host: sandbox-api.espay.id
Content-Type: application/x-www-form-urlencoded
Authorization: ••••••
Content-Length: 220
  
rq_uuid=SANDBOXINQUIRYBILLER0101031&
rq_datetime=2019-10-10%2011%3A01%3A30&
sender_id=SANDBOX&
password=test&
order_id=0888666777&
product_code=SPBFRE&
signature=9d6eede295d8865adc9eefa3fc48c059d22773338b01284eb42ab688671a7c9c


POST /rest/biller/inquirytransaction HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Content-Length: 240
Accept: */*
Host: api.espay.id
Authorization: Basic QWxhZGRpbjpTbWVsYW5h

rq_uuid=SENDERIDUUID0001&rq_datetime=2019-09-26 21:03:33&sender_id=SENDERID&&password=TeJ9LtGs7xWZNwwm&order_id=0888666777&product_code=SPBFRE&signature=818f1dd24644408f4f378fb606502b8720f3306ae62250ea3a95fb29b6b67e63&additional_data=


Sample Positive Response

{
   "rq_uuid":"SENDERIDUUID0001",
   "rs_datetime":"2019-09-26 21:03:36",
   "error_code":"0000",
   "error_desc":"Success",
   "order_id":"0888666777",
   "amount":"12540000",
   "bill_amount":"12540000",
   "admin_fee":"0",
   "data":{
      "phone_no":"0888666777",
      "bill_total":"1",
      "bill_ref":"108A000000",
      "bill_amount":"000000125400",
      "customer_name":"SMARTFREN CUSTOMER POSTPAID",
      "region_code":"00"
   }
}


Sample Negative Response

{
   "rq_uuid":"SANDBOXINQUIRYBILLER010102",
   "rs_datetime":"2025-10-16 15:29:15",
   "error_code":"EX",
   "error_desc":"Timeout while execution"
}



Bill Payment - Smartfren

Sample Request

POST /rest/biller/paymentreport HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Content-Length: 318
Accept: */*
Host: api.espay.id
Authorization: Basic QWxhZGRpbjpTbWVsYW5h

rq_uuid=SENDERIDUUID0001&
rq_datetime=2019-09-26 21:08:13&
sender_id=SENDERID&
password=TeJ9LtGs7xWZNwwm&
order_id=0888666777&
product_code=SPBFRE&
amount=12540000&
signature=1f4ee0cb00f68775b2a47ee36d6b44e652b446dda9a6317b0933de1cb23d0b4d&
data={
    "phone_no":"0888666777",
    "bill_total":"1",
    "bill_ref":"108A000000",
    "bill_amount":"000000125400",
    "customer_name":"SMARTFREN CUSTOMER POSTPAID",
    "region_code":"00"
 }


Sample Positive Response

{
   "rq_uuid":"SENDERIDUUID0001",
   "rs_datetime":"2019-09-26 21:08:17",
   "error_code":"0000",
   "error_desc":"Inproses",
   "order_id":"0888666777",
   "ref_id":"TX20190918155254952",
   "data":{
      "phone_no":"0888666777",
      "bill_total":"1",
      "bill_ref":"108A000000",
      "bill_amount":"000000125400",
      "customer_name":"SMARTFREN CUSTOMER POSTPAID",
      "region_code":"00"
   }
}


Sample Negative Response

{
   "rq_uuid":"SANDBOXPAYMENTBILLERPULSAPOSTPAID010102",
   "rs_datetime":"2025-10-16 15:32:57",
   "error_code":801,
   "error_desc":"Transaction error, inquiry data not found"
}


HTTP Bill Inquiry - Smartfren

POST /rest/biller/inquirytransaction HTTP/1.1
Host: sandbox-api.espay.id
Content-Type: application/x-www-form-urlencoded
Authorization: Basic ZXNwYXktdGVzdDp0ZXN0
Content-Length: 219

rq_uuid=SANDBOXINQUIRYBILLER010102&rq_datetime=2019-10-10%2011%3A01%3A30&sender_id=SANDBOX&password=test&order_id=0888666777&product_code=SPBFRE&signature=9d6eede295d8865adc9eefa3fc48c059d22773338b01284eb42ab688671a7c9c


HTTP Bill Payment - Smartfren

POST /rest/biller/paymentreport HTTP/1.1
Host: sandbox-api.espay.id
Content-Type: application/x-www-form-urlencoded
Authorization: Basic ZXNwYXktdGVzdDp0ZXN0
Cookie: sl-session=ne88ArXH8Gh+U65nqdQl+Q==
Content-Length: 490

rq_uuid=SANDBOXPAYMENTBILLERPULSAPOSTPAID010102&rq_datetime=2019-10-10%2011%3A02%3A30&sender_id=SANDBOX&password=test&order_id=0888666777&product_code=SPBFRE&amount=128900&signature=f46a2c34884c3d9194140f5ab595cae393749a0c5c25f23d2ebcfec3865196d1&data=%7B%22phone_no%22%3A%220888666777%22%2C%22bill_total%22%3A%221%22%2C%22bill_ref%22%3A%22108A000000%22%2C%22bill_amount%22%3A%22000000125400%22%2C%22customer_name%22%3A%22SMARTFREN%20CUSTOMER%20POSTPAID%22%2C%22region_code%22%3A%2200%22%7D


CURL Bill Inquiry - Smartfren

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=SANDBOXINQUIRYBILLER010102' \
--data-urlencode 'rq_datetime=2019-10-10 11:01:30' \
--data-urlencode 'sender_id=SANDBOX' \
--data-urlencode 'password=test' \
--data-urlencode 'order_id=0888666777' \
--data-urlencode 'product_code=SPBFRE' \
--data-urlencode 'signature=9d6eede295d8865adc9eefa3fc48c059d22773338b01284eb42ab688671a7c9c'


CURL Bill Payment - Smartfren

curl --location 'https://sandbox-api.espay.id/rest/biller/paymentreport' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Basic ZXNwYXktdGVzdDp0ZXN0' \
--data-urlencode 'rq_uuid=SANDBOXPAYMENTBILLERPULSAPOSTPAID010102' \
--data-urlencode 'rq_datetime=2019-10-10 11:02:30' \
--data-urlencode 'sender_id=SANDBOX' \
--data-urlencode 'password=test' \
--data-urlencode 'order_id=0888666777' \
--data-urlencode 'product_code=SPBFRE' \
--data-urlencode 'amount=128900' \
--data-urlencode 'signature=f46a2c34884c3d9194140f5ab595cae393749a0c5c25f23d2ebcfec3865196d1' \
--data-urlencode 'data={"phone_no":"0888666777","bill_total":"1","bill_ref":"108A000000","bill_amount":"000000125400","customer_name":"SMARTFREN CUSTOMER POSTPAID","region_code":"00"}'
Scroll to Top