Biller Product

Bill Payment Status Inquiry

Bill Payment Status Inquiry is a service used to retrieve detailed information about a completed biller transaction based on the payment reference number. This service can be used after the Bill Payment process to check the final status of the transaction.

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/billertools/gettransactioninfo
Production
https://api.espay.id/rest/billertools/gettransactioninfo

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 (32)
Y
Merchant identity code from Espay team.
password
String (32)
Y
Password from Espay team.
signature
String (128)
Y
Code used to validate transactions. Learn how to make a Biller Product | Hash-Based Signature.
ref_id
String (32)
Y
Reference ID provided by Espay in the Bill Payment response.
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
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
error_code
String (4)
Y
Response code.

Format:
  • Success: 0000
  • Failure: XXXX
error_desc
String (128)
Y
Response description.
product_code
String (16)
C
Product code.

Please visit the page of the biller products you are using to view the data details. See Biller products.
order_id
String (64)
C
Unique code to identify the transaction.

Example:
Handphone number, credit card number, id customer, etc.
Y: Yes, O: Optional, C: Conditional











































Sample Request

POST /rest/billertools/gettransactioninfo HTTP/1.0
Host: api.espay.id
Content-Length: 197
Content-type: application/x-www-form-urlencoded
Authorization: Basic QWxhZGRpbjpTbWVsYW5h
    
rq_uuid=ESPAY123ABC-456DEF&
rq_datetime=2017-12-17 12: 22: 32&
sender_id=ESPAY&
password=espaypass&
signature=c26a2a9901941a2eefd9c529c38822fabbd470c2693d40465616fa3fd58a0b26&
ref_id=TX1712171209991FA





















Sample Positive Response

{
  "rq_uuid": "ESPAY123ABC-456DEF",
  "rq_datetime": "2017-12-17 12:22:32",
  "error_code": "0000",
  "error_desc": "COMPLETED SUCCESFULLY",
  "product_code": "SVHTS50",
  "order_id": "081218816222",
  "status_code": "00",
  "status_desc": "SUCCESS",
  "serial_number": "41001621787608"
}


Sample Negative Response

{
   "rq_uuid":"ESPAY123ABC-456DEF",
   "rs_datetime":"2025-10-14 12:52:40",
   "error_code":"EX",
   "error_desc":"Cannot map server service. Record not found"
}


HTTP

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

rq_uuid=ESPAY123ABC-456DEF&rq_datetime=2017-12-17%2012%3A22%3A32&sender_id=ESPAY&password=espaypass&signature=c26a2a9901941a2eefd9c529c38822fabbd470c2693d40465616fa3fd58a0b26&ref_id=TX1712171209991FA


CURL

curl --location 'https://sandbox-api.espay.id/rest/billertools/gettransactioninfo' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Basic ZXNwYXktdGVzdDp0ZXN0' \
--data-urlencode 'rq_uuid=ESPAY123ABC-456DEF' \
--data-urlencode 'rq_datetime=2017-12-17 12:22:32' \
--data-urlencode 'sender_id=ESPAY' \
--data-urlencode 'password=espaypass' \
--data-urlencode 'signature=c26a2a9901941a2eefd9c529c38822fabbd470c2693d40465616fa3fd58a0b26' \
--data-urlencode 'ref_id=TX1712171209991FA'
Scroll to Top