Configure webhooks

To keep order statuses in sync between Airwallex and your PrestaShop store, configure webhooks so Airwallex can notify your store about asynchronous payment events such as successful payments and refunds.

Before you begin

• You have configured your API credentials in the Airwallex module.
• You have access to the Airwallex web app to create webhook endpoints.

Copy the webhook URL

1. In the PrestaShop Back Office, go to Modules > Airwallex > Configure.

2. On the Account Settings tab, find the Webhook URL field. It displays your auto-generated URL:

   text

   1https://your-store.com/module/airwallexpayments/webhook

3. Copy this URL.

Register the webhook in Airwallex

1. Log in to the Airwallex web app .

2. Go to Settings > Developer > Webhooks.

3. Create a new webhook and paste the copied URL into the Notification URL field.

4. Under Payments, subscribe to the following event groups:

   • All events in Payment Intents.
   • All events in Refund.

5. Save the webhook configuration.

6. Copy the Webhook Secret that Airwallex generates and paste it into the corresponding Webhook Secret field in the module configuration (see Configure API credentials).

How webhooks work

1. Airwallex sends a POST request to your webhook endpoint with the event payload.

2. The module verifies the request using HMAC-SHA256 signature verification with timing-safe comparison. Invalid signatures receive an HTTP 401 response.

3. Valid events update order statuses in PrestaShop automatically (for example, confirming payment success or processing refunds).

Next steps

Now that you have configured webhooks, enable payment methods for your shoppers:

• Configure card payments
• Configure local payment methods