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

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

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

Last updated