Biller Product

Check Biller Products

Check Biller Products is a service that allows you to check the codes and names of biller products registered on your platform.

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

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 (32)
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
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
String (16)
C
Product code. See the list of product codes here.
Y: Yes, O: Optional, C: Conditional
Parameter Tipe Mandatory Keterangan
rq_uuid
String (255)
Y
Request identifier. ID unik yang digunakan untuk mengidentifikasi pesan.

Format:
Sender_id + Unik ID

Contoh:
SENDERID123ABC-DEF456
rq_datetime
String (19)
Y
Tanggal dan waktu transaksi yang dikirim dari server merchant.

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

Contoh:
2024-12-17 12:30:45
error_code
String (4)
Y
Kode respons.

Format:
  • Sukses: 0000
  • Gagal: xxxx
error_desc
String (128)
Y
Deskripsi respons.
products
String (16)
C
Produk yang terdaftar. Lihat Daftar Produk
  product_code
...
...
Kode produk.
  product_name
...
...
Nama produk.









































Sample Request

POST /rest/billertools/getregisteredproducts HTTP/1.0
Host: https://sandbox-api.espay.id
Content-Length: 108
Content-type: application/x-www-form-urlencoded
Authorization: Basic RU5TRVZBTDprVXVYUjVNUkRtcHZrY1lk
    
rq_uuid=5441217&
rq_datetime=2014-12-09 17:53:20&
sender_id=SENDERID&
password=590biller




















Sample Positive Response

{
   "rq_uuid":"5441217",
   "rs_datetime":"2014-12-09 17:53:24",
   "error_code":"0000",
   "error_desc":"COMPLETED SUCCESFULLY",
   "products":[
      {
         "product_code":"SINCBN",
         "product_name":"CBN"
      },
      {
         "product_code":"SCCCTB",
         "product_name":"CITIBANK CREDIT CARD"
      },
      {
         "product_code":"STBFRM",
         "product_name":"FIRST MEDIA (d/h KABELVISION)"
      },
      {
         "product_code":"STCGRI",
         "product_name":"GARUDA INDONESIA"
      },
      {
         "product_code":"SVHTS50",
         "product_name":"TELKOMSEL 50000"
      },
      {
         "product_code":"STBTOP",
         "product_name":"TOP TV"
      },
      {
         "product_code":"SLYYTV",
         "product_name":"YES TV"
      }
   ]
}


Sample Negative Response

{
   "rq_uuid":"5441217",
   "rs_datetime":"2025-10-14 15:49:38",
   "error_code":"EX",
   "error_desc":"Cannot map server service. Record not found"
}


HTTP

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

rq_uuid=5441217&rq_datetime=2014-12-09%2017%3A53%3A20&sender_id=SENDERID&password=590biller


CURL

curl --location 'https://sandbox-api.espay.id/rest/billertools/getregisteredproducts' \
--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 'password=590biller'
Scroll to Top