Faspay
Search…
Notification / Callback
used by merchant for receive notification transaction from disbursement system Faspay. If there is a fund transfer transaction or disbursement of funds, the system will send the notification to the merchant via the URL sent during the transaction / withdrawal process.
Url Notification : [provide By Merchant]
Generate Signature Notification
Requirement
1. app_key
2. app_secret
3. client_id
4. client_secret
5. Request Body From Faspay
6. Request Method From Faspay
Generate
1. Request Body From Faspay :
- Remove character '\r', '\n', '\t' dan space - hashing with algorithm sha256 - Change to capital letters (UPPERCASE)
2. Faspay Authorization :
base64_encode(client_id:client_secret)
3. StringToSign : "[api_key]:[Request Method From Faspay]:[Faspay Authorization]:[Request Body From Faspay]"
*) without [] and ""
4. Signature : SHA-256 HMAC (StringToSign, api_secret)
    For validation at the merchant's side.
Request body
sample request
No
Parameter
Type
Lenght
Required
Description
1
request
Request Description
2
virtual_account
Sender VA
3
va_name
Sender VA Name
4
beneficiary_virtual_account
Receiver VA number
5
beneficiary_account
Account number of VA receiver
6
beneficiary_name
Account Number Name
7
trx_id
Transaction ID
8
trx_date
datetime (Y-m-d H:i:s)
9
trx_amount
Total amount, ex : 10.000 -> 1000000
10
trx_desc
Description
11
trx_status
List of status transaction
1 = On Process, 2 = Success, 4 = Failed, 5 = Reverse
12
trx_status_date
Transaction of Success Date, Format Datetime (Y-m-d H:i:s)
13
trx_reff
Remark from system
14
trx_no
Transaction number of the merchant
15
bank_code
Bank code of VA receiver
16
bank_name
Beneficiary Bank Name
17
bank_response_code
Response trx from bank
2 = Transaction Success, 3 = Transaction Reversal / Transaction Expired
18
bank_response_msg
Response message of trx from bank
19
signature
*) see documentation on generate signature
1
{
2
"request":"Notification",
3
"virtual_account":"9920000153",
4
"va_name":"Aselole",
5
"beneficiary_virtual_account":"9920000206",
6
"beneficiary_account":"1020006137993",
7
"beneficiary_name":"NQUSWV TPVNTUX QKSLNNZNOT",
8
"trx_id":"1064620",
9
"trx_date":"2018-09-18 14:53:00.0000000",
10
"trx_amount":"15000",
11
"trx_desc":"Cashout disb",
12
"trx_status":"2",
13
"trx_status_date":"2018-09-18 16:19:02.7059190",
14
"trx_reff":"9999980500003798",
15
"trx_no":"3140815927999298410",
16
"bank_code":"008",
17
"bank_name":"BANK MANDIRI",
18
"bank_response_code":"2",
19
"bank_response_msg":"Payment Sukses",
20
"signature":"e3350052919bfef6a436110988265508aa5738898383a4bae4d4cb4e3575cf27"
21
}
Copied!
Notes : Please note, in the notification process. trx_status parameter will be able to know the actual status of transactions.
Response body
Sample response
No
Parameter
Type
Lenght
Required
Description
1
response
AN
M
Description of response
2
virtual_account
N
M
VA Sender of transaction
3
beneficiary_virtual_account
N
M
Receiver VA number
4
bank_code
N
M
Bank code of VA receiver
5
bank_name
AN
M
Bank name
6
response_code
N
M
List of response : 00 = Success, 01 = Failed
7
response_desc
AN
M
Response Description
1
{
2
"response":"Notification",
3
"virtual_account":"9920000153",
4
"beneficiary_virtual_account":"9920000206",
5
"bank_code":"008",
6
"bank_name":"BANK MANDIRI",
7
"response_code":"00",
8
"response_desc":"Success"
9
}
Copied!
Last modified 11mo ago
Copy link