[Skip to main content](#vessel-content)

☰ Documentation

#  Airwallex payment plugin

Details    Written by: Administrator    Category: [Payment plugins](/support/documentation/hikashop/payment-plugins)     Published: 09 November 2026     Hits: 8

## Installation

- 1) Open an Airwallex account at www.airwallex.com. A sandbox account to try the plugin is opened at once at demo.airwallex.com; Airwallex reviews your business before live payments.
- 2) Download the Airwallex plugin from our website, install it on your website and enable it.
- 3) In the Airwallex web app, open Developer, API keys, and create an API key with the payments permissions. Copy the Client ID and the API key.
- 4) In HikaShop, go to System > Payment methods, create an Airwallex payment method, set Sandbox to match the account, and paste the Client ID and the API key.
- 5) In the Airwallex web app, Developer, Webhooks, add a webhook with the Webhook URL shown in the settings of the method and the events of the payment intents, the payment attempts and the refunds. Copy the secret Airwallex shows for it into the Webhook secret setting and save.

## Configuration

![The settings of the Airwallex payment method in HikaShop](/images/doc/plugins/airwallex/airwallex_settings.png)

- **Sandbox**: Yes with the keys of a sandbox account, No with those of your live account.
- **Client ID** and **API key**: from Developer, API keys, in the Airwallex web app of the same account.
- **Webhook secret**: the secret of the webhook of step 5. Without it, the webhooks are refused and delayed payments are never confirmed.
- **Webhook URL**: the address to paste in Developer, Webhooks.
- **Payment methods**: those offered on the Airwallex page. None ticked offers every method of your account.
- **Debug**: writes every exchange with Airwallex in the payment log of HikaShop.
- **Waiting for payment status**: the status of an order waiting for a bank transfer, a convenience store payment or Airwallex's review.
- **Invalid status**: the status of an order whose payment was cancelled or failed.
- **Verified status**: the status of a paid order.
- **Refunded status**: moving an order to this status refunds its whole payment on Airwallex.

## Troubleshooting

- "The payment could not be started" with Airwallex's reason: the reason says what to change, for instance a currency your account does not take, or keys of the wrong mode (a sandbox key with Sandbox set to No).
- A paid order that stays unconfirmed: check that the webhook is added in Airwallex with the right address and that its secret is the one in the settings. The payment log of HikaShop says why a webhook was refused.
- A refund refused by Airwallex leaves the order in its status, with Airwallex's reason on the screen and in the payment log.