Transfer (Top Up)

API Reference

For the Development environment

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

For the Production Environment

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

Transfer

POST account/api/transfer

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

* it means parameters are required

Request Body

Name	Type	Description
virtual_account*	Number (20)	Virtual Account Number Merchant
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 merchant)
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 merchant wants the system to send notifications to the merchant

Name

Type

Description

virtual_account*

Number (20)

Virtual Account Number Merchant

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 merchant)

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 merchant wants the system to send notifications to the merchant

{
 "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": "johfam@gmail.com",
 "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 Merchant
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 merchant)
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 merchant wants the system to send notifications to the merchant
trx_id	Number (16)	Mandatory	ID Transaction
trx_reff	String	Mandatory	Refference 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

Parameter

Data Type

M/O/C

Description

virtual_account

Number (20)

Mandatory

Virtual Account Number Merchant

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 merchant)

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 merchant wants the system to send notifications to the merchant

trx_id

Number (16)

Mandatory

ID Transaction

trx_reff

String

Mandatory

Refference 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

{
 "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" : "johfam@gmail.com",
 "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"
}

{
 "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": "johfam@gmail.com",
 "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"
}

PreviousInquiry Name NextSNAP

Last updated 1 year ago