Biller Product

Bill Payment

Bill Payment is a service used to process transactions through two main stages: balance deduction and transaction status completion. This service is mandatory, as all biller products require the Bill Payment process to finalise transactions.

Flow

Send the required parameters in your request, and Espay Biller Product will return a response in JSON format.

API URL

Environment URL
Sandbox
https://sandbox-api.espay.id/rest/biller/paymentreport
Production
https://api.espay.id/rest/biller/paymentreport

Authorization

Every request you send must include an Authorization header using Basic Auth. Learn more about Basic Auth.

Authorization: Basic {base64(username:password)}

Headers

Key Value
Method
POST
HTTP Version
HTTP/1.0
Accept
*/*
Content-Length
<dynamic>
Content-Type
application/x-www-form-urlencoded
Authorization
Basic base64(username:password)

Request Parameters​

Parameter Type Mandatory Description
rq_uuid
String (255)
Y
Request identifier. A unique ID used to identify messages.

Format:
Sender_id + unique ID

Example:
SENDERID123ABC-DEF456
rq_datetime
String (19)
Y
Date and time of the transaction request from the merchant's server.

Format:
YYYY-MM-DD HH:MM:SS

Example:
2024-03-14 07:49:28
sender_id
String (50)
Y
Merchant identity code from Espay team.
channel_code
String (32)
C
...
password
String (3)
Y
Password from Espay team.
order_id
String (3)
Y
Unique code to identify the transaction.

Example:
Handphone number, credit card number, id customer, etc.
product_code
String (16)
Y
Product code.

Please visit the page of the biller products you are using to view the data details. See Biller products.
amount
String (17)
Y
Total invoice amount.

Format:
Desimal (,00)

Example:
150.000,00
additional_data
String (999)
C
Additional data may vary depending on the product.

Please visit the page of the biller products you are using to view the data details. See Biller products.

Format:
JSON
signature
String (999)
Y
Code used to validate transactions. Learn how to make a Biller Product | Hash-Based Signature.
Y: Yes, O: Optional, C: Conditional

Response Parameters

Parameter Type Mandatory Description
rq_uuid
String (255)
Y
Request identifier. A unique ID used to identify messages.

Format:
Sender_id + unique ID

Example:
SENDERID123ABC-DEF456
rs_datetime
String (19)
Y
Date and time of the transaction request from the merchant's server.

Format:
yyyy-MM-dd hh:mi:ss

Example:
2024-03-14 07:49:28
error_code
String (4)
Y
Response code.

Format:
  • Success: 0000
  • Failure: XXXX
error_desc
String (128)
Y
Response description.
order_id
String (64)
Y
Unique code to identify the transaction.

Example:
Handphone number, credit card number, id customer, etc.
description
String (128)
C
Transaction description.
data
String (999)
Y
Transaction details with a format that may vary by product.

Please visit the page of the biller products you are using to view the data details. See Biller products.
Y: Yes, O: Optional, C: Conditional











































Sample Request

POST /rest/biller/paymentreport HTTP/1.0
Host: sandbox.api.espay.id
Content-Length: 124
Authorization: Basic QWxhZGRpbjpTbWVsYW5h
Content-type: application/x-www-form-urlencoded
    
rq_uuid=4328662&
rq_datetime=2014-12-11 15:21:15&
sender_id=SENDERID&
password=espaypass&
order_id=9900990099&
product_code=STCKAI&
amount=35000000&
data={
  "ticket_no":"9900990099",
  "reserved1":"",
  "reserved2":"",
  "bill_total":"1",
  "passenger_name":"Andreanus Hendy",
  "train_number":"KA 16",
  "train_name":"ARGO GEDE",
  "train_seat":"39A",
  "info":[
     {
        "trip_info":"JKTSBY0000",
        "trip_info_extended":"23072340"
     }
  ]
}&
signature=c26a2a9901941a2eefd
































Sample Positive Response

{
   "rq_uuid":"4328662",
   "rs_datetime":"2014-12-09 15:21:15",
   "error_code":"0000",
   "error_desc":"COMPLETED SUCCESFULLY",
   "order_id":"9900990099",
   "description":"Pembayaran tiket KAI",
   "data":{
      "ticket_no":"9900990099",
      "reserved1":"",
      "reserved2":"",
      "bill_total":"1",
      "passenger_name":"Andreanus Hendy",
      "train_number":"KA 16",
      "train_name":"ARGO GEDE",
      "train_seat":"39A",
      "info":[
         {
            "trip_info":"JKTSBY0000",
            "trip_info_extended":"23072340"
         }
      ]
   }
}


Sample Negative Response

{
   "rq_uuid":"SANDBOXINQUIRYBILLER010101034",
   "rs_datetime":"2025-10-13 13:29:00",
   "error_code":405,
   "error_desc":"product denied"
}


HTTP

POST /rest/biller/paymentreport HTTP/1.1
Host: sandbox-api.espay.id
Content-Type: application/x-www-form-urlencoded
Authorization: Basic ZXNwYXktdGVzdDp0ZXN0
Content-Length: 1111
                
rq_uuid=SANDBOXINQUIRYBILLER010105&rq_datetime=2019-10-10%2011%3A01%3A30&sender_id=SANDBOX&password=test&order_id=520520795556&product_code=SLYLPR100&signature=9d6eede295d8865adc9eefa3fc48c059d22773338b01284eb42ab688671a7c9c&rq_uuid=4328662&rq_datetime=2014-12-11%2015%3A21%3A15&sender_id=SENDERID&password=espaypass&order_id=9900990099&product_code=STCKAI&amount=35000000&data=%7B%0A%20%20%20%20%22ticket_no%22%3A%20%229900990099%22%2C%0A%20%20%20%20%22reserved1%22%3A%20%22%22%2C%0A%20%20%20%20%22reserved2%22%3A%20%22%22%2C%0A%20%20%20%20%22bill_total%22%3A%20%221%22%2C%0A%20%20%20%20%22passenger_name%22%3A%20%22Andreanus%20Hendy%22%2C%0A%20%20%20%20%22train_number%22%3A%20%22KA%2016%22%2C%0A%20%20%20%20%22train_name%22%3A%20%22ARGO%20GEDE%22%2C%0A%20%20%20%20%22train_seat%22%3A%20%2239A%22%2C%0A%20%20%20%20%22info%22%3A%20%5B%0A%20%20%20%20%20%20%20%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%22trip_info%22%3A%20%22JKTSBY0000%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22trip_info_extended%22%3A%20%2223072340%22%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%5D%0A%7D&signature=c26a2a9901941a2eefd


CURL

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=SANDBOXINQUIRYBILLER010105' \
--data-urlencode 'rq_datetime=2019-10-10 11:01:30' \
--data-urlencode 'sender_id=SANDBOX' \
--data-urlencode 'password=test' \
--data-urlencode 'order_id=520520795556' \
--data-urlencode 'product_code=SLYLPR100' \
--data-urlencode 'signature=9d6eede295d8865adc9eefa3fc48c059d22773338b01284eb42ab688671a7c9c' \
--data-urlencode 'rq_uuid=4328662' \
--data-urlencode 'rq_datetime=2014-12-11 15:21:15' \
--data-urlencode 'sender_id=SENDERID' \
--data-urlencode 'password=espaypass' \
--data-urlencode 'order_id=9900990099' \
--data-urlencode 'product_code=STCKAI' \
--data-urlencode 'amount=35000000' \
--data-urlencode 'data={
    "ticket_no": "9900990099",
    "reserved1": "",
    "reserved2": "",
    "bill_total": "1",
    "passenger_name": "Andreanus Hendy",
    "train_number": "KA 16",
    "train_name": "ARGO GEDE",
    "train_seat": "39A",
    "info": [
        {
            "trip_info": "JKTSBY0000",
            "trip_info_extended": "23072340"
        }
    ]
}' \
--data-urlencode 'signature=c26a2a9901941a2eefd'
Scroll to Top