Transaction Notifications API
Webhook notifications
Current version | Updated by | Updated at |
---|---|---|
Version 1.0.2 | John Rutledge | 15 Aug 2022 |
Version 1.0.1 | John Rutledge | 15 Aug 2022 |
Version 1.0.0 | Ivan Bajalovic | 1 Aug 2022 |
POST /notification/
Payment Notification
Request Body
{
"event_type": "PAYMENT",
"customer_identifier": "1004X10000670210580"
"event_fields": {
"pan_last_4": 7202,
"account_ccy": "SGD",
"amount": 1234.44,
"status": "COMPLETED",
"merchant": "Corporate XYZ",
"remark": "some-remarks"
}
Response
HTTP Status 200
Payment Failure Notification
Request Body
"event_type": "PAYMENT_FAILURE",
"customer_identifier": "1004X10000670210580"
"event_fields": {
"pan_last_4": 7202,
"account_ccy": "SGD",
"amount": 1234.44,
"status": "FAIL",
"merchant": "Corporate XYZ",
"remark": "some-remarks"
}
Response
HTTP Status 200
Payment Threshold Notification
Request Body
"event_type": "PAYMENT_THRESHOLD_EXCEEDED",
"customer_identifier": "1004X10000670210580"
"event_fields": {
"pan_last_4": 7202,
"account_ccy": "SGD",
"amount": 1234.44,
“Payment_threshold”: 1000.00
"merchant": "Corporate XYZ",
"remark": "A payment was made that exceeds the set threshold of: "
}
Response
HTTP Status 200
Balance Threshold Exceeded Notification
Request Body
"event_type": "BALANCE_THRESHOLD_EXCEEDED",
"customer_identifier": "1004X10000670210580"
"event_fields": {
"pan_last_4": 7202,
"account_ccy": "SGD",
"amount": 6534.44,
“balance_threshold”: 5000.00
"merchant": "Corporate XYZ",
"remark": "Your account has a balance that exceeds the set threshold of: "
}
Response
HTTP Status 200
Balance Below Threshold Notification
Request Body
"event_type": "BALANCE_THRESHOLD_BELOW",
"customer_identifier": "1004X10000670210580"
"event_fields": {
"pan_last_4": 7202,
"account_ccy": "SGD",
"amount": 4534.44,
“balance_threshold”: 5000.00
"merchant": "Corporate XYZ",
"remark": "Your account balance is below the threshold of: "
}
Response
HTTP Status 200
Top Up Notification
Request Body
{
"event_type": "TOP_UP",
"customer_identifier": "1004X10000670210580"
"event_fields": {
"account_no": 885001100000001, // va present in topup screen
"account_ccy": "SGD",
"amount": 1234.44,
"status": "COMPLETED",
"sender_name": "Corporate XYZ",
"remark": "some-remarks"
}
Response
HTTP Status 200
Withdrawal Complete Notification
Request Body
{
"event_type": "WITHDRAWAL_COMPLETED",
"customer_identifier": "1004X10000670210580",
"event_fields": {
"withdrawal_id": "8ba12f76-dc60-11e9-8a34-2a2ae2dbcce4",
"client_ref": "4f758206-7c15-42cb-96de-b1cae350e107",
"account_no": "122223",
"status": "COMPLETED",
"account_ccy": "SGD",
"created_date_time" :"2022-07-26T00:00:00",
"updated_date_time" :"2022-07-26T00:00:00",
"amount": 1234.44,
"remark": "some-remark",
"account_details": {
"withdrawal_account_id": "8aa12f76-dc60-11e9-8a34-2a2ae2dbcce1",
"name": "John Doe",
"bank_bic":"CUS123",
"account_no":"122-31313",
"account_ccy":"SGD",
},
"payee_remark": "Withdrawal from GoGoGo wallet."
}
Response
HTTP Status 200
Withdrawal Rejected Notification
Request Body
{
"event_type": "WITHDRAWAL_REJECTED",
"customer_identifier": "1004X10000670210580",
"event_fields": {
"withdrawal_id": "8ba12f76-dc60-11e9-8a34-2a2ae2dbcce4",
"client_ref": "4f758206-7c15-42cb-96de-b1cae350e107",
"account_no": "122223",
"status": "REJECTED",
"account_ccy": "SGD",
"amount": 1234.44,
"created_date_time" :"2022-07-26T00:00:00",
"updated_date_time" :"2022-07-26T00:00:00",
"remark": "some-remark",
"payee_remark": "Withdrawal from GoGoGo wallet.",
"status": "Rejected due to invalid withdrawal account number.",
"account_details": {
"withdrawal_account_id": "8aa12f76-dc60-11e9-8a34-2a2ae2dbcce1",
"name": "John Doe",
"bank_bic":"CUS123",
"account_no":"122-31313",
"account_ccy":"SGD",
}
}
Response ‘HTTP Status 200’
Wallet Threshold Exceeded Notification
Request Body
{
"event_type": "WALLET_THRESHOLD_EXCEEDED",
"customer_identifier": "1004X10000670210580",
"event_fields": {
"amount_refunded": 250,
"currency": "SGD",
"account_no": "2223033",
"remark": "Refunded to <withdrawal account name> due to wallet holding balance exceeding 5000 SGD."
}
Response
HTTP Status 200