Biller Product

Bill Payment

Bill Payment adalah layanan yang berfungsi untuk memproses transaksi dengan dua tahapan utama: pemotongan saldo dan penyelesaian status transaksi. Layanan ini bersifat wajib, karena seluruh produk biller menggunakan proses Bill Payment untuk menyelesaikan 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/biller/paymentreport
Production
https://api.espay.id/rest/biller/paymentreport

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.
channel_code
String (32)
C
...
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.
amount
String (17)
Y
Total tagihan yang harus dibayar.

Format:
Desimal (,00)

Contoh:
150.000,00
additional_data
String (999)
C
Detail transaksi dengan format 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 Espay.

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

Contoh:
2024-03-14 07:49:28
error_code
String (4)
Y
Kode respons.
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.
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/paymentreport HTTP/1.0
Host: sandbox.api.espay.id
Content-Length: 124
Authorization: Basic QWxhZGRpbjpTbWVsYW5h
Content-type: application/x-www-form-urlencoded
    
rq_uuid=4328662&
rq_datetime=2014-12-11 15:21:15&
sender_id=SENDERID&
password=espaypass&
order_id=9900990099&
product_code=STCKAI&
amount=35000000&
data={
  "ticket_no":"9900990099",
  "reserved1":"",
  "reserved2":"",
  "bill_total":"1",
  "passenger_name":"Andreanus Hendy",
  "train_number":"KA 16",
  "train_name":"ARGO GEDE",
  "train_seat":"39A",
  "info":[
     {
        "trip_info":"JKTSBY0000",
        "trip_info_extended":"23072340"
     }
  ]
}&
signature=c26a2a9901941a2eefd






































Contoh Respons Positif

{
   "rq_uuid":"4328662",
   "rs_datetime":"2014-12-09 15:21:15",
   "error_code":"0000",
   "error_desc":"COMPLETED SUCCESFULLY",
   "order_id":"9900990099",
   "description":"Pembayaran tiket KAI",
   "data":{
      "ticket_no":"9900990099",
      "reserved1":"",
      "reserved2":"",
      "bill_total":"1",
      "passenger_name":"Andreanus Hendy",
      "train_number":"KA 16",
      "train_name":"ARGO GEDE",
      "train_seat":"39A",
      "info":[
         {
            "trip_info":"JKTSBY0000",
            "trip_info_extended":"23072340"
         }
      ]
   }
}


Contoh Respons Negative

{
   "rq_uuid":"SANDBOXINQUIRYBILLER010101034",
   "rs_datetime":"2025-10-13 13:29:00",
   "error_code":405,
   "error_desc":"product denied"
}


HTTP

POST /rest/biller/paymentreport HTTP/1.1
Host: sandbox-api.espay.id
Content-Type: application/x-www-form-urlencoded
Authorization: Basic ZXNwYXktdGVzdDp0ZXN0
Content-Length: 1111
                
rq_uuid=SANDBOXINQUIRYBILLER010105&rq_datetime=2019-10-10%2011%3A01%3A30&sender_id=SANDBOX&password=test&order_id=520520795556&product_code=SLYLPR100&signature=9d6eede295d8865adc9eefa3fc48c059d22773338b01284eb42ab688671a7c9c&rq_uuid=4328662&rq_datetime=2014-12-11%2015%3A21%3A15&sender_id=SENDERID&password=espaypass&order_id=9900990099&product_code=STCKAI&amount=35000000&data=%7B%0A%20%20%20%20%22ticket_no%22%3A%20%229900990099%22%2C%0A%20%20%20%20%22reserved1%22%3A%20%22%22%2C%0A%20%20%20%20%22reserved2%22%3A%20%22%22%2C%0A%20%20%20%20%22bill_total%22%3A%20%221%22%2C%0A%20%20%20%20%22passenger_name%22%3A%20%22Andreanus%20Hendy%22%2C%0A%20%20%20%20%22train_number%22%3A%20%22KA%2016%22%2C%0A%20%20%20%20%22train_name%22%3A%20%22ARGO%20GEDE%22%2C%0A%20%20%20%20%22train_seat%22%3A%20%2239A%22%2C%0A%20%20%20%20%22info%22%3A%20%5B%0A%20%20%20%20%20%20%20%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%22trip_info%22%3A%20%22JKTSBY0000%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%22trip_info_extended%22%3A%20%2223072340%22%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%5D%0A%7D&signature=c26a2a9901941a2eefd


CURL

curl --location 'https://sandbox-api.espay.id/rest/biller/paymentreport' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Basic ZXNwYXktdGVzdDp0ZXN0' \
--data-urlencode 'rq_uuid=SANDBOXINQUIRYBILLER010105' \
--data-urlencode 'rq_datetime=2019-10-10 11:01:30' \
--data-urlencode 'sender_id=SANDBOX' \
--data-urlencode 'password=test' \
--data-urlencode 'order_id=520520795556' \
--data-urlencode 'product_code=SLYLPR100' \
--data-urlencode 'signature=9d6eede295d8865adc9eefa3fc48c059d22773338b01284eb42ab688671a7c9c' \
--data-urlencode 'rq_uuid=4328662' \
--data-urlencode 'rq_datetime=2014-12-11 15:21:15' \
--data-urlencode 'sender_id=SENDERID' \
--data-urlencode 'password=espaypass' \
--data-urlencode 'order_id=9900990099' \
--data-urlencode 'product_code=STCKAI' \
--data-urlencode 'amount=35000000' \
--data-urlencode 'data={
    "ticket_no": "9900990099",
    "reserved1": "",
    "reserved2": "",
    "bill_total": "1",
    "passenger_name": "Andreanus Hendy",
    "train_number": "KA 16",
    "train_name": "ARGO GEDE",
    "train_seat": "39A",
    "info": [
        {
            "trip_info": "JKTSBY0000",
            "trip_info_extended": "23072340"
        }
    ]
}' \
--data-urlencode 'signature=c26a2a9901941a2eefd'
Scroll to Top