Notification
Depending on the setting, QR Gateway system will send notification message (URL callback) to either company or merchant backend system (so called Receiver) in asynchronous manner when there is any updates or changes to payment or refund status. The Receiver is then required to retrieve the payment or refund status from the QR Gateway though the standard call to API method.
The notification is an HTTP POST to the Receiver’s callback URL. The body of the message is the JSON request. The response from the URL is the HTTP response.
Payment Notification#
When there is an update or change to the payment status, QR Gateway system will update payment status to the Receiver. The Receiver is then required to retrieve the payment status from QR Gateway through a standard call to API method Get Payment Status.
Parameters#
- Request Body
- Example
| Name | Type | Required | Description |
|---|---|---|---|
| transactionID | string(20) | true | Unique ID of the transaction |
| timestamp | string(17) | true | Time of sending out notification. Date format is “yyyyMMdd HH:mm:ss” (i.e. “20170118 20:32:46”) |
| notificationType | string(10) | true | Type of notification. e.g.: “payment” |
| checkSum | string | true | Checksum of the query string |
Refund Notification#
When there is an update or change to the payment status, QR Gateway system will update payment status to the Receiver. The Receiver is then required to retrieve the payment status from QR Gateway through a standard call to API method Get Refund Status.
Parameters#
- Request Body
- Example
| Name | Type | Required | Description |
|---|---|---|---|
| transactionID | string(20) | true | Refund transaction ID |
| timestamp | string(17) | true | Time of sending out notification. Date format is “yyyyMMdd HH:mm:ss” (i.e. “20170118 20:32:46”) |
| notificationType | string(10) | true | Type of notification. e.g.: “payment” |
| checkSum | string | true | Checksum of the query string |
Alert Notification#
Whenever there is any transaction trigger fraud checking, QR Gateway system will send an alert notification to the Receiver. The Receiver is then required to retrieve the payment status from QR Gateway through a standard call to API method Get Payment Status.
Parameters#
- Request Body
- Example
| Name | Type | Required | Description |
|---|---|---|---|
| transactionID | string(20) | true | Refund transaction ID |
| timestamp | string(17) | true | Time of sending out notification. Date format is “yyyyMMdd HH:mm:ss” (i.e. “20170118 20:32:46”) |
| notificationType | string(10) | true | Type of notification. e.g.: alert |
| errorCode | string(10) | true | Error code. Refer Appendix A |
| checkSum | string | true | Checksum of the query string |
note
In the HTTP response message, QR Gateway will treat the HTTP status code 200 as the notification message has been successfully arrived and received by the Receiver. If the HTTP status code is not 200, then, QR Gateway will try to resend the notification to the receiver again until the maximum retry is reached. Notification Retry
Default retry interval: 1 minutes, 10 minutes, 15 minutes, 30 minutes, 1 hour and 2 hours.