Alipay, China's leading third-party online payment solutionAlipay, China's leading third-party online payment solution

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

notifyAuthorization

alipay.ams.authorizations.notify

notifyPayment

alipay.ams.payments.payNotify

notifyCapture

alipay.ams.payments.captureNotify

notifyDispute

alipay.ams.payments.disputeNotify

notifyRefund

alipay.ams.payments.refundNotify

Table 1. Notification interfaces

To configure notification URLs:

  1. Log in to Alipay+ Dashboard.
  2. Go to Developers > Notification address, select the Configuration tab.
  3. Click Add under Action and enter your URL under Notification URL for a notification interface.
  4. Click Save. Your notification URL is successfully configured.
  5. (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:

  1. If you modify the notification URL, make sure you also update the URL in your live system to avoid any potential errors.
  2. 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:

  1. Log in to Alipay+ Dashboard.
  2. Go to Developers > Notification address, select the Test tab.
  3. 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.
  4. (Optional) Edit the notification message in the Request body field.
  5. Click Send.
  6. Alipay+ then sends a simulated asynchronous notification to your notification URL.
  7. Response to Alipay+ by following the notification response requirement. Refer to Return a receipt acknowledgment message about how to send a response.
  8. 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.