Payment Instruction

Fund Transfer

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