Skip to main content

Transaction Notifications API

Webhook notifications

Current versionUpdated byUpdated at
Version 1.0.2John Rutledge15 Aug 2022
Version 1.0.1John Rutledge15 Aug 2022
Version 1.0.0Ivan Bajalovic1 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