Notification URL
Learn how to configure notification URLs and test notifications in Alipay+ Dashboard.
Configure notification URLs
You can configure your notification URLs in Alipay+ Dashboard for the following notifications:
Interface | Endpoint |
alipay.ams.authorizations.notify | |
alipay.ams.payments.payNotify | |
alipay.ams.payments.captureNotify | |
alipay.ams.payments.disputeNotify | |
alipay.ams.payments.refundNotify |
Table 1. Notification interfaces
To configure notification URLs:
- Log in to Alipay+ Dashboard.
- Go to Developers > Notification address, select the Configuration tab.
- Click Add under Action and enter your URL under Notification URL for a notification interface.
- Click Save. Your notification URL is successfully configured.
- (Optional) If you want to change the notification URL that you have already configured, click Modify under Action and enter your URL under Notification URL for the modified notification. The next step is the same as Step 4.
Notes:
- If you modify the notification URL, make sure you also update the URL in your live system to avoid any potential errors.
- If the notification URL is specified in both the interface and Alipay+ Dashboard, the URL specified in the interface takes precedence.
Test notifications
You can simulate the process of receiving and handling asynchronous notifications in Alipay+ Dashboard.
Before you begin
To test notifications, configure your API keys first. For more information about how to configure API keys, see API key configuration.
Get started
To test notifications, follow the steps:
- Log in to Alipay+ Dashboard.
- Go to Developers > Notification address, select the Test tab.
- Select the request type and configure the notification URL under Request > Configuration. The default notification URL is the URL that you specified under the Configuration tab.
- (Optional) Edit the notification message in the Request body field.
- Click Send.
- Alipay+ then sends a simulated asynchronous notification to your notification URL.
- Response to Alipay+ by following the notification response requirement. Refer to Return a receipt acknowledgment message about how to send a response.
- Alipay+ validates whether your system handles the notification as expected. If your notification response is successfully received by Alipay+, the validation result is displayed in the Response area.