Biller Product

Bill Inquiry

Bill Inquiry is a service used to retrieve transaction details, such as the amount to be paid and other related information. This service is conditional, as not all biller products require it. Some biller products that use Bill Inquiry include BPJS Kesehatan (Indonesia’s National Health Insurance), e-wallet top-up, mobile credit, and electricity payments.

Before proceeding with integration, make sure to verify whether the biller product you are using requires the Bill Inquiry process or not.

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

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.
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.
additional_data
String (999)
C
Additional data may vary depending on the product.

Refer to the biller product page you are using for detailed data requirements. 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 response from the Espay server.
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.
amount
String (17)
Y
Total invoice amount.

Format:
Desimal (,00)

Example:
150.000,00
bill_amount
String (17)
C
Total invoice amount excludes admin.

Format:
Desimal

Example:
150.000,00
admin_fee
String (17)
C
Total admin fee.

Format:
Desimal (,00)

Example:
50000.00
description
String (128)
C
Transaction description.
data
String (999)
Y
Transaction details with a format that may vary by product.

Please visit the biller product page you are using to view the specific transaction data details. See Biller Products.
Y: Yes, O: Optional, C: Conditional














































Sample Request

POST /rest/biller/inquirytransaction HTTP/1.0
Host: sandbox.api.espay.id
Content-Length: 108
Authorization: Basic QWxhZGRpbjpTbWVsYW5h
Content-type: application/x-www-form-urlencoded


rq_uuid=5441217&
rq_datetime=2014-12-09 17:53:20&
sender_id=SENDERID&
password=espaypass&
order_id=9900990099&
product_code=STCKAI&
signature=c26a2a9901941a2eefd






































Sample Positive Response

{
   "rq_uuid": "MERCHANT1568345855CTAFI5WIOT",
   "rs_datetime": "2019-09-13 10:37:36",
   "error_code": "0000",
   "error_desc": "Success",
   "order_id": "520520795556",
   "amount": "2250000",
   "bill_amount": "2000000",
   "admin_fee": "250000",
   "data": [The data may vary depending on the Biller products]
}


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/inquirytransaction HTTP/1.1
Host: sandbox-api.espay.id
Content-Type: application/x-www-form-urlencoded
Authorization: Basic ZXNwYXktdGVzdDp0ZXN0
Content-Length: 112

rq_uuid=5441217&rq_datetime=2014-12-09%2017%3A53%3A20&sender_id=SENDERID&order_id=9900990099&product_code=STCKAI


CURL

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=5441217' \
--data-urlencode 'rq_datetime=2014-12-09 17:53:20' \
--data-urlencode 'sender_id=SENDERID' \
--data-urlencode 'order_id=9900990099' \
--data-urlencode 'product_code=STCKAI'
Scroll to Top