Install Airwallex Online Payments app

The Airwallex Online Payments app allows you to accept card payments and over 160 local payment methods (LPMs) at checkout via redirect.

Choose your App Version

Airwallex offers two versions of this app. Choose the one that fits your capture settings:

1. Auto-Capture App (Recommended) : Best for most merchants. It ensures all Local Payment Methods (LPMs) appear at checkout. All payments will be automatically captured immediately.
2. All Capture Modes App : Use this only if you need to respect Shopify's "Manual Capture" settings. Note: If you use Manual Capture, many LPMs that require immediate capture will NOT appear at checkout.

Airwallex recommends using the Auto-Capture App, especially for merchants who want to offer the widest range of LPMs at checkout.

Installation and Configuration Steps

1. After considering the recommendation above, choose either the Auto-Capture App or All Capture Modes App to install.

2. Ensure the store name and URL corresponds to the one you'd like to install the app on.

3. Click Install.

4. You will be redirected to Shopify Admin. Click Install to complete the installation.

5. Before you can start accepting payments using Airwallex, you will need to connect your Airwallex account to Shopify. Click Manage Account.

6. You will be redirected to an Airwallex login page. Login to your Airwallex account.

7. Select an account that you want to connect to your Shopify store, and click Connect. You will be redirected back to your Shopify settings after connecting.

8. Once connection is established, you will need to configure the payment methods you wish to offer on both Airwallex and Shopify App. The following steps will guide you through this process:

   1. Global Airwallex Activation: First, ensure the payment methods you wish to offer are enabled on your Airwallex account. Go to Payments > Payment Methods in your Airwallex WebApp to activate them.
   2. Shopify App Configuration: Once enabled globally, you can configure which specific methods appear on your Shopify checkout. Go to Settings > Connections > Shopify in your Airwallex WebApp to manage these settings for your store.

9. Finally, please configure the Capture Mode for your Shopify store. Note that if you installed the All Capture Modes App , you will need to ensure auto-capture is enabled if you wish to offer local payment methods like iDEAL or GrabPay.

10. Customizing the Checkout Experience (Optional) Within your Shopify settings, you can configure which payment method logos you would like your shoppers to see on the checkout page. Additionally, you can customize the theme of the Airwallex payment page by adding your store logo via Settings > Connections > Shopify in the Airwallex WebApp. Click Save and you are all set. Learn more about choosing logos and changing the Call-to-Action (CTA) .

11. Enable Automatic Currency Switching (ACC) (Optional) to allow your shoppers to pay in their preferred currency and payment methods. You can do so via Payments > Settings > Automatic Currency Conversion in your Airwallex WebApp.

Testing

To perform testing on any of the payment methods please follow the steps below:

1. Go to Shopify Admin > Settings > Payments > Airwallex Cards & Online Payments
2. Tick the test mode button

Testing Cards

Open the payment flow and use the test cards here to simulate the different flows described in the document.

Handling Orders for Off-Checkout Payments (e.g. QR Code, LPMs)

Enabling Klarna as a payment method

If you wish to enable Klarna, please ensure that your Customer contact method_ is set to only "Email". You can access this from your Shopify admin Settings > Checkout > Customer contact method

Email should be set as required in Shopify checkout