Airwallex logo
Airwallex logoAirwallex logo

Install the PrestaShop module

Upload and activate the Airwallex Payments module in your PrestaShop Back Office.

Copy for LLMView as Markdown

To start accepting payments with Airwallex on your PrestaShop store, install and activate the Airwallex Payments module.

Before you begin

  • You have a PrestaShop store running version 1.7.8.9 or higher.
  • You have administrator access to the PrestaShop Back Office.
  • You have an Airwallex account with your Know Your Business (KYB) verification submitted and desired payment methods activated under Payments > Payment Methods in the Airwallex web app.
  • You have your Airwallex API credentials (Client ID, API key, and Webhook Secret Key) for your target environment. To find your credentials, log in to the Airwallex web app and go to Settings > Developer > API keys.

Install from a release ZIP

Download the pre-built airwallexpayments.zip file from the PrestaShop Addons marketplace, and then complete these steps:

  1. In the PrestaShop Back Office, go to Modules > Module Manager.

  2. Click Upload a module and select the airwallexpayments.zip file.

  3. PrestaShop automatically extracts and installs the module.

Install from source

If you are installing from the source repository, copy the module source into your PrestaShop modules directory:

Shell
1cp -r payment-plugin-prestashop/ <prestashop_root>/modules/airwallexpayments/

Activate the module

  1. In the PrestaShop Back Office, go to Modules > Module Manager.

  2. Search for Airwallex.

  3. Click Enable.

What happens on activation

When the module is activated, it automatically:

  • Registers PrestaShop hooks for checkout, order management, admin media, and refund processing.
  • Creates a database table (ps_airwallex_payment_intent) for tracking Payment Intent IDs, order references, cart IDs, amounts, and refund details.
  • Creates a custom order status ("Airwallex Pending Payment") used as the initial order state before payment confirmation.
  • Registers hidden admin controller tabs for configuration and payment capture management.

Uninstall the module

To uninstall the module, go to Modules > Module Manager, find Airwallex, and click Uninstall. This unregisters all PrestaShop hooks and removes the admin controller tabs.

Payment data is preserved on uninstall

The database table ps_airwallex_payment_intent and configuration values are not automatically deleted on uninstall to preserve payment history. Remove them manually if needed.

Next steps

Now that you have installed the module, connect it to your Airwallex account:

Was this page helpful?