Notification / Callback
Used by a merchant for receiving notification transactions from the 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]
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
Parameter | Type | M/O/C | Description |
---|---|---|---|
request | Alphanumeric | Mandatory | Request Description |
virtual_account | Numeric | Mandatory | Sender VA |
va_name | Alphanumeric | Mandatory | Sender VA Name |
beneficiary_virtual_account | Numeric | Mandatory | Receiver VA number |
beneficiary_account | Alphanumeric | Mandatory | Account number of VA receiver |
beneficiary_name | Alphanumeric | Mandatory | Account Number Name |
trx_id | Alphanumeric | Mandatory | Transaction ID |
trx_date | Datetime | Mandatory | Datetime format (YYYY-MM-DD H:i:s) |
trx_amount | Numeric | Mandatory | Total amount, ex : 10.000 -> 1000000 |
trx_desc | Alphanumeric | Mandatory | Description |
trx_status | Numeric | Mandatory | List of status transaction:
1 = On Process,
2 = Success,
4 = Failed,
5 = Reverse |
trx_status_date | Datetime | Mandatory | Transaction of Success Date, Format Datetime (YYYY-MM-DD H:i:s) |
trx_reff | Alphanumeric | Mandatory | Remark from system |
trx_no | Alphanumeric | Mandatory | Transaction number of the merchant |
bank_code | Numeric | Mandatory | Bank code of VA receiver |
bank_name | Alphanumeric | Mandatory | Beneficiary Bank Name |
bank_response_code | Numeric | Mandatory | Response transaction (trx) from bank:
2 = Transaction Success,
3 = Transaction Reversal/Transaction Expired |
bank_response_msg | Alphanumeric | Mandatory | Response message of transaction (trx) from bank |
signature | Alphanumeric | Mandatory | *) see documentation on generate signature |
{
"request":"Notification",
"virtual_account":"9920000153",
"va_name":"Aselole",
"beneficiary_virtual_account":"9920000206",
"beneficiary_account":"1020006137993",
"beneficiary_name":"PT LENTERA ABADI INDONUSA",
"trx_id":"1064620",
"trx_date":"2018-09-18 14:53:00.0000000",
"trx_amount":"15000",
"trx_desc":"Cashout disburse",
"trx_status":"2",
"trx_status_date":"2018-09-18 16:19:02.7059190",
"trx_reff":"9999980500003798",
"trx_no":"3140815927999298410",
"bank_code":"008",
"bank_name":"BANK MANDIRI",
"bank_response_code":"2",
"bank_response_msg":"Payment Success",
"signature":"e3350052919bfef6a436110988265508aa5738898383a4bae4d4cb4e3575cf27"
}
Notes: Please note, that in the notification process. trx_status parameter will be able to know the actual status of transactions.
Response Body
Sample Response
Parameter | Type | Required | Description |
---|---|---|---|
response | Alphanumeric | Mandatory | Description of response |
virtual_account | Numeric | Mandatory | VA Sender of transaction |
beneficiary_virtual_account | Numeric | Mandatory | Receiver VA number |
bank_code | Numeric | Mandatory | Bank code of VA receiver |
bank_name | Alphanumeric | Mandatory | Bank name |
response_code | Numeric | Mandatory | List of response:
00 = Success,
01 = Failed |
response_desc | Alphanumeric | Mandatory | Response Description |
{
"response":"Notification",
"virtual_account":"9920000153",
"beneficiary_virtual_account":"9920000206",
"bank_code":"008",
"bank_name":"BANK MANDIRI",
"response_code":"00",
"response_desc":"Success"
}
Last modified 10mo ago