Get Balance

Get Balance merupakan layanan yang dapat Anda gunakan untuk melakukan pengecekan jumlah saldo. Layanan ini hanya dapat digunakan oleh Anda dengan mekanisme deposit.

Flow

Anda melakukan permintaan dengan mengirimkan parameter yang dibutuhkan, dan Biller akan memberikan respons dalam bentuk JSON.

API URL

Environment URL
Sandbox
https://sandbox-api.espay.id/rest/billertools/getbalance
Production
https://api.espay.id/rest/billertools/getbalance

Authorization

Setiap permintaan yang dikirim, harus memerlukan otentikasi menggunakan Basic Authentication. Pastikan Anda menambahkan Authorization pada header. Pelajari lebih lanjut Authorization.

Authorization: Basic {base64(username:password)}
Key Value
Method
POST
HTTP Version
HTTP/1.1
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.
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.
balance
...
...
Total saldo deposit.
Y: Yes, O: Optional, C: Conditional








































Contoh Permintaan

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


rq_uuid=getbalance018&
rq_datetime=2018-01-15 10:33:43&
sender_id=SENDERID&
password=p45w0rd&
signature=db420be770fef07ebdc23378456a1c6b7c6b3cd9aadef39cb2784f0bb48bf869
















Contoh Respons Positif

{
    "rq_uuid":"getbalance09",
    "rq_datetime":"2018-01-15 10:45:50",
    "error_code":"getbalance09",
    "error_desc":"2018-01-15 10:45:50",
    "balance":"16127451.00"
}




cURL

....








































Scroll to Top