Biller Product

Bill Payment Status Inquiry

Bill Payment Status Inquiry merupakan layanan yang digunakan untuk memperoleh detail transaksi biller yang telah diproses, berdasarkan nomor referensi pembayaran. Layanan ini dapat digunakan setelah proses Bill Payment untuk memeriksa status akhir transaksi.

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

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 (32)
Y
Kode identitas merchant yang diberikan oleh tim Espay.
password
String (32)
Y
Kata sandi yang diberikan oleh tim Espay.
signature
String (128)
Y
Kode yang digunakan untuk melakukan validasi transaksi. Pelajari Biller Product | Hash-Based Signature.
ref_id
String (32)
Y
ID referensi dari Espay yang terdapat pada response Bill Payment.
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.

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.
product_code
String (16)
C
Kode produk.

Silahkan kunjungi halaman produk yang Anda gunakan untuk mengetahui detail data transaksi. Lihat Biller Products.
order_id
String (64)
C
Kode unik untuk identifikasi transaksi.

Contoh:
Nomor handphone, nomor kartu kredit, customer id, dll.
Y: Yes, O: Optional, C: Conditional











































Sample permintaan

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 Respons Positif

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

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