Install Airwallex Additional Payments App
Offer your shoppers a curated selection of Local Payment Methods directly at the Shopify checkout, without redirecting them to a hosted payment page.
The Airwallex Additional Payments app lets you offer multiple Local Payment Methods (LPMs) such as Alipay, WeChat Pay, KakaoPay, GrabPay, iDEAL, Klarna, Wero, and many more, directly at the Shopify checkout. Unlike the Airwallex Online Payments app, shoppers can see and select their preferred payment method natively in the Shopify checkout before being routed to the payment provider, providing a faster and more streamlined experience.
When to use this app
Use the Additional Payments app when you want to surface multiple LPMs natively in your Shopify checkout. If you also want to offer card payments with an embedded experience, install it alongside the Airwallex Card Payments app.
Pre-requisites
- You must have a valid and activated Airwallex account. If you do not have one, please follow these instructions.
- The payment methods you wish to offer must be enabled and activated in Airwallex (Please ensure you do this before proceeding).
Installation Steps
-
Login to your Shopify Admin and select the store you want to integrate with Airwallex.
-
Click on the following link to go to the Shopify App Store listing for Airwallex Additional Payments. Ensure the store name and URL match the one selected in the previous step.
-
Click Install.
-
You will be redirected to Shopify Admin. Click Install to complete the installation.
-
Before you can start accepting payments using Airwallex, you will need to connect your Airwallex account to Shopify. Click Manage Account.
-
You will be redirected to an Airwallex login page. Login to your Airwallex account.
-
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.
-
Toggle the individual payment method logos you wish to display on your Shopify checkout page. Note that this doesn't correspond to the payment methods offered to your shoppers; these are configured in Step 10.
-
Click Activate and you are all set for the Shopify-side configuration. The Additional Payments option will now appear on your Shopify checkout page. Next up: Airwallex-side configuration.
-
Configure the payment methods you wish to offer. This is done in two places:
- 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.
- 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.
-
You should now be able to see the Additional Payments option grouping your enabled LPMs on your store.
Don't see a payment method?
A payment method only appears at checkout when the shopper's billing country and the store currency match the method's eligibility rules. Check our troubleshooting steps for common reasons why a payment method might not be shown.
Optional Steps
-
Risk Management To help improve your success rates and reduce fraud you can install our Airwallex Fraud Protection App .
-
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.
Re-save the connections page after configuring ACC
Since Automatic Currency Switching (ACC) is a global setting, you need to re-save the connections page after configuring it to ensure the changes are applied to the Airwallex Additional Payments app on your store.
Testing
-
Enable test mode in Settings > Payments > Airwallex Additional Payments > Manage if you want to mock successful and failed transactions before going live.
-
Go to your store and attempt to check out. Select Additional payment methods at the Shopify checkout, choose the LPM you want to test, and click Place order.
-
Mock the different statuses by clicking on the status that you wish to test. For the payment pending states, they will be pending before transitioning to "Success" or "Failure" after 10 minutes.
Handling Orders for Off-Checkout Payments (e.g. QR Code, LPMs)
Some shoppers may complete payment outside the standard checkout flow, such as via QR codes or other Local Payment Methods (LPMs). To support these scenarios, Airwallex will: create the order with a "Pending Payment" status; automatically update the order to "Paid" once payment is complete; and mark the order as "Expired" if payment is not completed within the valid timeframe. Please make sure your order processing logic accounts for these status transitions. QR code payment initiation is a useful signal that this flow may occur. Learn more about pending and expired off-checkout orders.
Shopper Experience
Overview
The Additional Payments app surfaces all your enabled Local Payment Methods under a single Additional payment methods option in the Shopify checkout. Shoppers select the option, see the methods they're eligible for based on their billing country and store currency, choose their preferred method, and click Place order to complete payment.
Depending on the payment method, the shopper may complete their payment via:
- A redirect to the payment provider (e.g. Klarna, Afterpay, iDEAL, Wero).
- An inline QR code or one-time password challenge.
- A bank app handoff for instant bank transfers.
Experience Walk-through
When a customer visits your online store, they will see Additional payment methods as an option in the checkout page.
Possible Scenarios
Scenario 1
Scenario: Shopper is shopping in a store with an eligible store currency and billing country combination.
Shopper Experience:
The shopper selects Additional payment methods, picks their preferred method from the list shown, and clicks Place order to complete the payment with the selected provider.
Scenario 2
Scenario: Shopper is shopping in a store and wants to pay with a local payment method that doesn't support the store currency. You have turned on Automatic Currency Conversion.
Shopper Experience:
On top of the default set of payment methods, shopper is shown an option to expand the "Additional options" they have. These payment methods will trigger automatic currency conversion, allowing shoppers to check out with them.
