1. Ensure Accuracy of Memebership Points

To provide best experience for your customer, we suggest to establish de-duplicate mechanism to avoid duplicate calculations on membership points via other channels, such as your own application & customer service center, etc.

For example, your ordering system / CRM may verify the transaction before adding the membership points based on the transaction number.

2. Avoid Out of Sync

We suggest you to update us once the transaction record is received from AlipayHK to avoid the membership points being out of sync, i.e. call the /updatePass API immediately after receiving the /notify API request.

If your CRM / OMS system updates the membership points in batch, we strongly recommend them to implement real-time points update.

Alternatively, you may also split into two sperate logic, real-time and batch update.

3. Response to AlipayHK's API Request Timely

Your system should be able to response to AlipayHK's request within 3 seconds or less, which is the timeout time of our front-end, if we didn't receive the response within 3 seconds, a display error will be shown to the user.

4. Implement Retry Mechanism

As payment service is critical, we suggest you to implement necessary retry mechanism to minimize impact in case any incident occurs.

For example, you can use below interval and frequency to retry.

5. Make the Login Process Smooth (miniprogram solution)

If you are using miniprogram solution with us, we suggest you to adopt our SSO solution and avoid duplicate user logins for best customer experience.