espay logo

Payment Instruction

Inquiry Balance





Download Image

Seperti pada umunya, Balance berarti saldo atau dapat disebut juga sebagai jumlah yang terdapat / tersedia pada suatu wadah. Fitur Balance ini digunakan untuk mendapatkan jumlah yang tersedia pada rekening klien (available balance Client). Service ini hanya dapat digunakan apabila Client sudah / telah mendaftarkan dan menginformasikan data rekeningnya kepada pihak ESPAY.

API URL
Development : https://sandbox-api.espay.id/b2b/inquiry/balance
Production : https://api.espay.id/b2b/inquiry/balance

Format message yang dikirimkan harus dalam bentuk URL encoded. Keterangan untuk setiap field dalam HTTP POST message tersebut:

Inquiry Balance Request Data:

Nama Field Attribute Mandatory Keterangan
rq_uuid ANS 255 Ya Request Identifier. ID unik untuk mengidentifikasi request message tersebut dengan message lainnya.
Format : Client ID + Unique ID
Ex : CLIENTID123abc-def456
rq_datetime ANS 19 Ya Tanggal dan waktu di server aplikasi client pada saat message di kirim.
Format : YYYY-MM-DD HH:MM:SS
Ex : 2014-12-17 12:30:45
sender_id AN 32 Ya Identitas unik aplikasi Client yang terdaftar di sistem ESPay
signature AN 255 Ya Signature (lihat Signature Validation)
bank_code AN 5 Ya Kode bank
account_number AN 32 Tidak Nomor rekening, jika tidak diisi maka sistem ESPay melakukan eksekusi kepada rekening default

Setelah melakukan request dengan contoh diatas, client akan mendapatkan response. Dengan rincian dan contoh sebagai berikut :

Inquiry Balance Response Data:

Nama Field Attribute Mandatory Keterangan
rq_uuid ANS 255 Ya Request Identifier. ID unik untuk mengidentifikasi request message tersebut dengan message lainnya (echoed from request).
Format : Client ID + Unique ID
Ex : CLIENTID123abc-def456
rs_datetime ANS 19 Ya Tanggal dan waktu di server aplikasi client
pada saat message di kirim.
Format : YYYY-MM-DD HH:MM:SS Ex : 2014-12-17 12:30:45
error_code ANS 4 Ya Kode error
error_message ANS 255 Ya Deskripsi error
account_number AN 32 Ya Nomor rekening terdaftar
account_name AN 32 Ya Nama pemilik rekening
account_currency AN 3 Ya Kode mata uang rekening
account_status AN 5 Tidak Status rekening
account_balance NUM 15,2 Ya Saldo yang tersedia
Format: 1000000.00		 
	

	
Contoh Request:

		
POST /b2b/inquiry/balance HTTP/1.1
Host: sandbox-api.espay.id
Connection: keep-alive
Content-Length: 170
Authorization: Basic Um9tZW86SnVsaWV0
Content-Type: application/x-www-form-urlencoded
Accept: */*

rq_uuid=CLIENTIDUUID171214002
&rq_datetime=2017-12-14 15:31:00
&signature=1f5e3532b1f4f17845ae15c2f9a0256249f87f541db42f075be7c07594d7e3f2
&sender_id=CLIENTID
&bank_code=008
	    
	
	

	
Contoh Response:

		
	{
		{
		  "rq_uuid":"CLIENTIDUUID171214002",
		  "rs_datetime":"2017-12-14 15:30:02",
		  "error_code":"0000",
		  "error_message":"Success",
		  "account_number":"90000038726114",
		  "account_name":"PT. Square Gate One",
		  "account_currency":"IDR",
		  "account_status":"1",
		  "account_balance":"11284555229.67"
		}