# Connect your Airwallex account

> Take cards and local payment methods like Alipay, WeChat Pay, GrabPay and FPX with your own Airwallex account. In Settings > Payments, click Set up Airwallex, paste your Client ID and API key, add our webhook URL in Airwallex and paste its secret, choose Demo or Live, switch it on and click Save settings.

Help Centre / Payments - Updated 19 November 2026

Airwallex is a payment provider for businesses across Asia-Pacific, Europe and North America. When you connect your Airwallex account, your customers can pay by card or with the local payment methods you have turned on in Airwallex, such as Alipay, WeChat Pay, GrabPay, FPX and PayNow. Payments go straight to your Airwallex account, and Shoprocket takes 0%.

When a customer clicks **Pay now**, Airwallex's secure payment form opens right inside your checkout. The customer pays there without leaving your shop. Card details go straight to Airwallex and never pass through Shoprocket.

## Before you start

You need an Airwallex account with online payments turned on. You also need three things:

1. A **Client ID** and **API key**. In Airwallex, go to **Developer > API keys** and create a restricted key. Give it read and write access to **Payment Acceptance**, and nothing else. Airwallex shows the API key only once, so copy it straight away.
2. A **webhook secret**. You create the webhook in Airwallex using a URL from Shoprocket, so you will get the secret during the setup steps below.
3. To know whether your keys come from your **demo** account (for trying things out) or your **live** account.

## Connect Airwallex

1. In your dashboard, go to **Settings > Payments**.
2. On the Airwallex card in **Payment gateways**, click **Set up Airwallex**.
3. Paste your **Client ID** and **API key** into the fields with the same names.
4. Under **Environment**, choose **Demo** for keys from your demo account, or **Live** for your live account.
5. Copy the **Webhook URL** shown under the fields.
6. In Airwallex, go to **Developer > Webhooks** and add a webhook with that URL. Subscribe it to the **Payment Intent** and **Refund** events, then save it.
7. Airwallex then shows the webhook's secret. Copy it into the **Webhook secret** field in Shoprocket.
8. Turn Airwallex's switch to **On** and click **Save settings**.

![The Airwallex card in Settings > Payments: the Client ID, API key, webhook secret and environment fields, with the webhook URL to copy below them](https://shoprocket.io/img/help/connect-airwallex/airwallex-setup.webp)

When you save, Shoprocket signs in to Airwallex with your Client ID and API key. If Airwallex rejects them, nothing is saved and a message at the top of the screen says why. The most common mistake is choosing the wrong environment. Demo keys only work with **Demo**, and live keys only work with **Live**.

The card then says **Connected**, and Airwallex appears at your checkout.

## Why the webhook matters

Some payment methods finish after the customer has left your checkout, for example a QR code paid in a banking app. Airwallex tells Shoprocket about each payment and refund through the webhook. Shoprocket then checks the payment with Airwallex before it marks the order paid. The webhook is also how a refund you make in Airwallex shows up on the order in Shoprocket.

Card payments are confirmed straight away even without the webhook, but please add it before you start selling.

## The currencies you can take

When you save, Shoprocket reads the currencies your Airwallex account takes card payments in. If a customer checks out in a currency your account doesn't take cards in, the payment can't go through Airwallex. The checkout then asks them to choose another way to pay. To take more currencies, turn them on in Airwallex, then save your Airwallex credentials in Shoprocket again.

If your account takes cards in only one currency and your shop is priced in another, the card warns you. You can still offer Airwallex to customers who pay in that currency. To do that, add the currency under **Card gateway by currency**, as [Choose a payment gateway](https://shoprocket.io/help/choose-a-payment-gateway.md) explains.

## Try it in demo mode

Airwallex gives you a demo account with its own keys. To try your checkout without moving real money, choose **Demo** and paste your demo keys. The card then shows **Test credentials: no real money moves**. Airwallex's documentation lists test card numbers you can use.

When you are ready to sell, click **Edit Airwallex credentials**, paste your live Client ID and API key, choose **Live**, and paste the secret of a webhook you created in your live account. Then click **Save settings**.

## How customers pay

- **By card**: the customer types their card into Airwallex's form in your checkout. If their bank needs to check the payment, the check opens there too. If the card is declined, they can try another one in the same form.
- **With a local payment method**: the customer picks it in the same form and follows the steps, such as scanning a QR code or approving the payment in their app. The order is confirmed as soon as Airwallex tells Shoprocket the payment went through.

A customer who changes their mind can click **Choose another way to pay** under the form to go back to their cart.

Apple Pay and Google Pay are not available through Airwallex yet.

## Refunds

When you refund an order paid with Airwallex, the money goes back to the customer automatically, in full or in part. See [Refund an order](https://shoprocket.io/help/refund-an-order.md). Refunds come out of your Airwallex balance, so keep enough in it to cover them.

## Subscriptions

Airwallex can renew subscriptions. When a customer buys a subscription, the card they pay with is saved in your Airwallex account. Each renewal is then charged to that card on the subscription's schedule.

## Changing your credentials or turning it off

After you connect Airwallex, its button reads **Edit Airwallex credentials**. Your saved credentials are stored encrypted and never shown again. To keep them, leave the fields blank. To replace them, fill in every field and click **Save settings**.

To stop offering Airwallex, turn its switch to **Off** and click **Save settings**. Your credentials stay saved, so you can switch it back on at any time. Payments that customers had already started still complete.

## Related

- [Choose a payment gateway](https://shoprocket.io/help/choose-a-payment-gateway.md)
- [Refund an order](https://shoprocket.io/help/refund-an-order.md)
- [Take a test order](https://shoprocket.io/help/take-a-test-order.md)

[Open Payments in your dashboard](https://app.shoprocket.io/go/settings/payments)

---

- HTML version: https://shoprocket.io/help/connect-airwallex
- Language: English (en)
- Also in: [العربية](https://shoprocket.io/ar/help/connect-airwallex.md), [Deutsch](https://shoprocket.io/de/hilfe/airwallex-konto-verbinden.md), [Ελληνικά](https://shoprocket.io/el/help/connect-airwallex.md), [Español](https://shoprocket.io/es/ayuda/conectar-airwallex.md), [Français](https://shoprocket.io/fr/aide/connecter-airwallex.md), [עברית](https://shoprocket.io/he/help/connect-airwallex.md), [हिन्दी](https://shoprocket.io/hi/help/connect-airwallex.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/hubungkan-akun-airwallex.md), [Italiano](https://shoprocket.io/it/aiuto/collega-airwallex.md), [日本語](https://shoprocket.io/ja/help/connect-airwallex.md), [Lietuvių](https://shoprocket.io/lt/pagalba/prijunkite-airwallex-paskyra.md), [Norsk](https://shoprocket.io/nb/hjelp/koble-til-airwallex-kontoen-din.md), [Nederlands](https://shoprocket.io/nl/hulp/airwallex-account-koppelen.md), [Polski](https://shoprocket.io/pl/pomoc/polacz-konto-airwallex.md), [Português](https://shoprocket.io/pt/ajuda/conectar-airwallex.md), [Română](https://shoprocket.io/ro/ajutor/conecteaza-contul-airwallex.md), [Русский](https://shoprocket.io/ru/help/connect-airwallex.md), [ไทย](https://shoprocket.io/th/help/connect-airwallex.md), [Türkçe](https://shoprocket.io/tr/yardim/airwallex-hesabi-baglama.md), [中文](https://shoprocket.io/zh/help/connect-airwallex.md)
