Biller Product

Bill Inquiry

Bill Inquiry merupakan layanan yang digunakan untuk mengetahui detail transaksi, seperti jumlah yang harus dibayarkan dan informasi tambahan lainnya. Layanan ini bersifat kondisional, karena tidak semua produk biller memerlukannya. Beberapa produk biller yang menggunakan Bill Inquiry antara lain BPJS Kesehatan, isi saldo e-wallet, pulsa, dan listrik.

Sebelum melakukan integrasi, pastikan Anda memeriksa apakah produk biller yang digunakan memerlukan layanan Bill Inquiry atau tidak.

Flow

Kirimkan parameter yang diperlukan dalam permintaan Anda, dan Espay Biller Product akan memberikan respons dalam format JSON.

API URL

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

Authorization

Setiap permintaan yang Anda kirim, harus menyertakan header Authorization menggunakan Basic Auth. Pelajari lebih lanjut Basic Auth.

Authorization: Basic {base64(username:password)}
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)

Parameter Permintaan

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
sender_id
String (50)
Y
Kode identitas merchant yang diberikan oleh tim Espay.
password
String (3)
Y
Kata sandi yang diberikan oleh tim Espay.
order_id
String (3)
Y
Kode unik untuk identifikasi transaksi.

Contoh:
Nomor handphone, nomor kartu kredit, customer id, dll.
product_code
String (16)
Y
Kode produk.

Silahkan kunjungi halaman produk yang Anda gunakan untuk mengetahui detail data transaksi. Lihat Biller Products.
additional_data
String (999)
C
Data pendukung yang disesuaikan berdasarkan produk.

Silahkan kunjungi halaman produk yang Anda gunakan untuk mengetahui detail data transaksi. Lihat Biller Products.

Format:
JSON
signature
String (999)
Y
Kode yang digunakan untuk melakukan validasi transaksi. Pelajari Biller Product | Hash-Based Signature.
Y: Yes, O: Optional, C: Conditional

Parameter Respons

Parameter Tipe Mandatory Keterangan
rq_uuid
String (255)
Y
Request identifier. ID unik yang digunakan untuk mengidentifikasi pesan.
rs_datetime
String (19)
Y
Tanggal dan waktu transaksi yang dikirim dari server Biller.

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

Contoh:
2024-03-14 07:49:28
error_code
String (4)
Y
Kode respons.

Format:
  • Sukses: 0000
  • Gagal: xxxx
error_desc
String (128)
Y
Deskripsi respons.
order_id
String (64)
Y
Kode unik untuk identifikasi transaksi.

Contoh:
Nomor handphone, nomor kartu kredit, customer id, dll.
amount
String (17)
Y
Total tagihan yang harus dibayar.

Format:
Desimal (,00)

Contoh:
150.000,00
bill_amount
String (17)
C
Total tagihan sebelum ditambah biaya admin.

Format:
Desimal (,00)

Contoh:
150.000,00
admin_fee
String (17)
C
Total biaya admin yang harus dibayar.

Format:
Desimal (,00)

Contoh:
5.000,00
description
String (128)
C
Deskripsi transaksi.
data
String (999)
Y
Detail data.

Silahkan kunjungi halaman produk yang Anda gunakan untuk mengetahui detail data transaksi. Lihat Biller Products.
Y: Yes, O: Optional, C: Conditional














































Contoh Permintaan

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









































Contoh Respons Positif

{
   "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": [data dapat berbeda sesuai produk Biller
   ]
}


Contoh Respons Negatif

{
    "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