espay logo

Payment Instruction

Fund Transfer





Download Image

Fitur ini digunakan untuk melakukan proses pemindahan buku dari rekening yang sudah didaftarkan di ESPay atau dari balance deposit milik mitra yang berada di ESPay ke nomor rekening yang diinginkan.

API URL
Development : https://sandbox-api.espay.id/b2b/transfer/fund
Production : https://api.espay.id/b2b/transfer/fund

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

Fund Transfer Request Data:

Nama Fields 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 )
transfer_type N 1 Ya Jenis transfer :
0: Online transfer
1: SKN
2: RTGS
5: Merchant Deposit
(Apabila tidak diset, ESPay menentukan sebagai online transfer)
source_bank_code AN 32 Conditional Deposit : Mandatory
Kode akan diberikan oleh ESPay.
Direct : Kode bank pengirim, jika tidak diisi sistem ESPay melakukan eksekusi kepada rekening default
source_account_number AN 32 Conditional Deposit : Mandatory
Kode akan diberikan oleh ESPay.
Direct : Nomor rekening pengirim, jika tidak diisi sistem ESPay melakukan eksekusi kepada rekening default
beneficiary_bank_code AN 5 Ya Kode bank penerima
beneficiary_bank_name AN 255 Tidak Nama bank penerima
swift_code AN 10 Ya Kode swift bank penerima. (Mandatory untuk transfer type SKN dan RTGS)
beneficiary_account_number AN 32 Ya Nomor rekening penerima
beneficiary_account_name AN 32 Ya Nama penerima
beneficiary_phone_number ANS 16 Tidak Nomor telephone penerima (Mandatory untuk transfer type SKN dan RTGS Source Bank Permata)
beneficiary_email ANS 64 Ya Alamat email penerima
beneficiary_address1 AN 64 Tidak Alamat tinggal penerima (Mandatory untuk transfer type SKN dan RTGS)
beneficiary_address2 AN 32 Tidak Alamat tinggal penerima (Mandatory untuk transfer type SKN dan RTGS Source Bank Permata)
beneficiary_district AN 32 Tidak Kawasan tinggal penerima (Mandatory untuk transfer type SKN dan RTGS Source Bank Permata)
beneficiary_category N 1 Ya Kategori penerima :
0 : Individu
1 : Perusahaan
2 : Pemerintah
(Mandatory untuk transfer type SKN dan RTGS)
beneficiary_citizenship N 1 Ya Kewarganegaraan penerima :
0 : Resident
1 : Non Resident
(Mandatory untuk transfer type SKN dan RTGS)
beneficiary_nationality N 1 Tidak Kewarganegaraan penerima :
0 : WNI
1 : WNA
(Mandatory untuk transfer type SKN dan RTGS Source Bank Permata)
amount NUM 15,2 Ya Jumlah transaksi
Format: 1000000.00
transaction_id AN 32 Ya ID transaksi Client. Diharuskan berbeda untuk setiap transaksi (Tanpa karakter spasi)
transfer_reff AN 32 Conditional Nomor referensi dari service Inquiry Name (jika ada)
description AN 128 Ya Keterangan transaksi
description_detail AN 128 Tidak Keterangan transaksi (tambahan)
email AN 255 Tidak Alamat Email tujuan
address1 AN 255 Tidak Alamat tujuan pertama
address2 AN 255 Tidak Alamat Tujuan kedua
beneficiary_account_type AN 32 Conditional Deposit : Mandatory
Kode beneficiary_account_type dari response service Inquiry Name
category_purpose N 1 Conditional Deposit : Mandatory 0: Investment, 1: Transfer of Wealth, 2: Purchase, 3: Others (for various purposes)

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

Fund Transfer 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
source_bank_code AN 32 Ya Kode bank pengirim, jika tidak diisi sistem ESPay melakukan eksekusi kepada rekening default
source_account_number AN 32 Ya Nomor rekening pengirim, jika tidak diisi sistem ESPay melakukan eksekusi kepada rekening default
beneficiary_bank_code AN 5 Ya Kode bank penerima
beneficiary_account_number AN 32 Ya Nomor rekening penerima
transaction_id AN 32 Ya Kode transaksi Client
reference_id AN 32 Ya Kode referensi sistem ESPay
reference_bank AN 32 Kondisional Deposit : Mandatory
Kode referensi bank
trace_no_bank AN 32 Kondisional Kode Referensi dari bank untuk pengecekan status transaksi 
	
Contoh Request:

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

rq_uuid=CLIENTIDUUID171214003
&rq_datetime=2017-12-14 15:34:00
&signature=547b56a2a2ff08dab4d3baa73beff19a9c93f615ca912579d2bc64beba67b633
&sender_id=CLIENTID
&beneficiary_bank_code=002
&beneficiary_account_number=720801001600505
&amount=1000000.00
&description=Pembayaran Transaksi TRX171214001
&transaction_id=TRX171214001
	
	
	

	
Contoh Response:

	
	{
		"rq_uuid":"CLIENTIDUUID171214003",
		"rs_datetime":"2017-12-14 15:30:02",
		"error_code":"0000",
		"error_message":"Success",
		"beneficiary_bank_code":"002",
		"beneficiary_account_number":"720801001600505",
		"transaction_id":"TRX171214001",
		"reference_id":"B9AO10293U381011",
		"reference_bank":"799102077483101"
	}