Asynchronous Notification
About 564 wordsAbout 2 min
2025-03-07
Asynchronous Notification Overview
- First, the merchant configures the asynchronous callback notification
notificationUrladdress. - Whenever a transaction-related event occurs (such as transaction success), the PingPongCheckOut notification service will create a JSON object containing event-related data and information.
- Then, the PingPongCheckOut notification service sends the JSON object to the developer-configured callback notification
notificationUrlvia HTTP POST request. After receiving the callback notification, the merchant side can perform subsequent business processing based on the asynchronous notification message.
The process is described as follows:
Receiving Asynchronous Notifications
Prepare a web service that supports HTTP POST
PingPongCheckOut notification service will push JSON formatted data in HTTP POST manner, so the Web service provided by the developer needs to be able to receive and parse JSON data from HTTP POST requests and return the corresponding HTTP status code.
Set callback notification address
Developers can configure the callback notification URL address through the notificationUrl parameter in each interface input parameter.
Asynchronous notifications are affected by network connection status on both sides, please ensure the notification address is publicly accessible
Receive and Respond
For merchant transaction notification responses, follow these conventions:
| Reception Result | HTTP Code Convention | Response Message Format Convention |
|---|---|---|
| Reception Success | 200 <= httpcode < 300, e.g.: 200, 201, 204 | No need to return response message |
| Reception Failure |
|
|
Retry mechanism: In case of reception failure, the retry mechanism will be triggered. PingPongCheckout will re-send with increasing time intervals within a subsequent period of time, with intervals of
5s/5s/3m/10m/20m/30m/30m/30m/60m/3h/3h/3h(if intermediate retry notifications succeed, the retry will be interrupted and no longer continue).
Caution
- Merchants cannot rely solely on asynchronous notifications. If transaction results are not received for a long time, merchants should actively initiate transaction queries to PingPongCheckout to check the corresponding transaction results;
- Do not append query-type parameters after
notificationUrlto avoid loss. If parameters must be carried, please use pathInfo URL mode; - The processing logic of asynchronous notification code cannot perform login state verification.
PingPongCheckout Callback Notification Server Information
If the merchant side requires firewall configuration to allow PingPongCheckout message notification service to push data, please configure the firewall according to the information below and add the IP addresses to the whitelist:
| Production Environment | Sandbox Environment |
|---|---|
| 3.125.243.2 | 52.76.198.228 |
| 3.126.196.22 | |
| 18.195.199.34 | |
| 188.239.12.25 |
Notification Messages
Transaction Asynchronous Notification
Refund Asynchronous Notification
Pre-authorization Confirmation Notification
Pre-authorization Cancellation Notification
