Transfer (Top Up)

API Reference

For the Development environment

https://sendme-sandbox.faspay.co.id/account/api/transfer

Transfer

POST account/api/transfer

This service works when the partner is about to top up, where the partner will transfer some funds to Faspay to get the balance

* it means parameters are required

Request Body

Parameter	Data Type	Description
virtual_account*	Number (20)	Virtual account number partner
beneficiary_account*	Number (128)	Phone number/account E-Wallet
beneficiary_name*	String (255)	Account name
beneficiary_bank_code *	Number (3)	Beneficiary bank code: - ovo: OVO - gpy: GoPay - dna: DANA - lkj: LinkAja
beneficiary_region_code *	Number (4)	Benefeciary Region Code
beneficiary_country_code*	String (2)	Code of Country
beneficiary_purpose_code	Number (1)	Code of the purpose of using the system account
beneficiary_phone	Number (15)	Beneficiary phone
beneficiary_email	String (128)	Email customer
trx_no*	String (255)	Transaction number (from partner)
trx_date *	Datetime	Transaction date time. Format (yyyy-mm-dd)
instruct_date	Datetime	Transfer instruction date. Format (yyyy-mm-dd)
trx_amount *	Number	Total amount, ex : 10.000 → 1000000
trx_desc	String (15)	Description, If the user input is more than 15 characters, it will be cut into 15 characters
callback_url*	String (255)	URL for callback/notification, used if the partner wants the system to send notifications to the partner

200: OK Transfer Response

{
 "virtual_account": "9920011089",
 "beneficiary_account": "081234567890",
 "beneficiary_name": "Johnny Suh",
 "beneficiary_bank_code": "ovo",
 "beneficiary_region_code": "0102",
 "beneficiary_country_code": "ID",
 "beneficiary_purpose_code": "1",
 "beneficiary_phone": "",
 "beneficiary_email": "[e-mail]",
 "trx_no": "12345670096",
 "trx_date": "2021-06-29 11:15:00",
 "instruct_date": "",
 "trx_amount": 2000000,
 "trx_desc": "Top-Up E-Wallet OVO",
 "callback_url": "http://account-service/account/api/mail/sendtotele",
 "trx_id": 1246279,
 "trx_reff": "ITxD7wMZ68cAaFNZQQOM",
 "status": "1",
 "message": "On Process",
 "response_code": "00",
 "response_desc": "success"
}

Body Parameter Transfer Response

Parameter	Data Type	M/O/C	Description
virtual_account	Number (20)	Mandatory	Virtual account number partner
beneficiary_account	Number (128)	Mandatory	hone number/account E-Wallet
beneficiary_name	String (255)	Mandatory	Account name
beneficiary_bank_code	String (3)	Mandatory	Beneficiary Bank Code : ovo : ovo gpy : GoPay dna : DANA lkj : LinkAja
beneficiary_region_code	Number (4)	Mandatory	Benefeciary Region Code
beneficiary_country_code	String (2)	Optional	Code of Country
beneficiary_purpose_code	Number (1)	Optional	Code of purpose of using the system account
beneficiary_phone	Number (15)	Optional	Beneficiary phone
beneficiary_email	String (128)	Mandatory	Beneficiary email
trx_no	Number (255)	Mandatory	Transaction number (from partner)
trx_date	Datetime	Optional	Transaction date time
instruct_date	Datetime	Mandatory	Transfer instruction date
trx_amount	Number	Optional	Total amount, ex : 10.000 → 1000000
trx_desc	String (15)	Mandatory	Description, If the user input is more than 15 characters, it will be cut into 15 characters
callback_url	String (255)	Mandatory	URL for callback / notification, used if the partner wants the system to send notifications to the partner
trx_id	Number (16)	Mandatory	ID Transaction
trx_reff	String	Mandatory	Reference of transaction number on system disbursement
status	Number (1)	Mandatory	List Status Transaction : 1 = On Process, 2 = Success, 4 = Failed, 5 = Reverse, 9 = Error Message
message	String	Mandatory	Message Description
response_code	Number (2)	Mandatory	Response code from bank (00 = success)
response_desc	String (32)	Mandatory	Response description from bank

Sample code JSON Request & Response Transfer

Transfer Request

{
 "virtual_account": "9920011089",
 "beneficiary_account": "081234567890",
 "beneficiary_name": "Johnny Suh",
 "beneficiary_bank_code": "ovo",
 "beneficiary_region_code": "0102",
 "beneficiary_country_code": "ID",
 "beneficiary_purpose_code": "1",
 "beneficiary_phone" : "",
 "beneficiary_email" : "[e-mail]",
 "trx_no": "12345670096",
 "trx_date": "2021-06-29 11:15:00",
 "instruct_date": "",
 "trx_amount": "2000000",
 "trx_desc": "Top up E-Wallet ovo",
 "callback_url": "http://account-service/account/api/mail/sendtotele"
}

Transfer Response

{
 "virtual_account": "9920011089",
 "beneficiary_account": "081234567890",
 "beneficiary_name": "Johnny Suh",
 "beneficiary_bank_code": "ovo",
 "beneficiary_region_code": "0102",
 "beneficiary_country_code": "ID",
 "beneficiary_purpose_code": "1",
 "beneficiary_phone": "",
 "beneficiary_email": "[e-mail]",
 "trx_no": "12345670096",
 "trx_date": "2021-06-29 11:15:00",
 "instruct_date": "",
 "trx_amount": 2000000,
 "trx_desc": "Top-Up E-Wallet OVO",
 "callback_url": "http://account-service/account/api/mail/sendtotele",
 "trx_id": 1246279,
 "trx_reff": "ITxD7wMZ68cAaFNZQQOM",
 "status": "1",
 "message": "On Process",
 "response_code": "00",
 "response_desc": "success"
}