Airwallex is a global fintech company that provides businesses with a powerful suite of financial tools to operate and grow internationally. It is designed for global e-commerce, digital platforms, and tech companies that need to send, receive, and hold funds in multiple currencies without the complexities of traditional banking.
For Checkify.pro customers, it opens such options as:
Cards: accept payments from all major credit and debit cards, including Visa, Mastercard, American Express, and UnionPay.
Digital wallets: fast checkout via Apple Pay and Google Pay, others.
Alternative payment methods: Klarna, Skrill, BLIK, P24, iDEAL, Afterpay / Clearpay, and dozens of others, which are essential for running an effective e-commerce business in various markets.
Bank transfers.
For more info about this payment processor please visit airwallex.com.
In this article:
1. Pre-connection checklist
To enable Airwallex as a payment gateway on your store, you must have an active Airwallex account. If you you don't have one, register it here.
Please note that Airwallex is available only to businesses in certain geos. For the list of supported countries, see Airwallex's global availability.
2. Setting up Airwallex on Checkify's checkout
The secure, no-code connection between Airwallex and Checkify.pro requires a few setup steps. Visit admin.checkify > Payment methods to get started. Press "Connect +" button and keep this page open in a tab.
2.1 Generate your API key, find your Client ID, add webhook
Log in to your Airwallex live account (production environment).
Go to Developer section, API Keys tab.
Copy your Client ID and paste it into the appropriate field in admin.checkify.
Press "Generate API key", confirm your choice. You may be asked to enter your Airwallex account's password. Copy the API key to clipboard and then paste into the appropriate field of admin.checkify.
For your convenience, consider saving the API key in a secure location for future use. While it can be regenerated if needed, doing so requires additional steps compared to retrieving it from your secure vault. Note that your Client ID also changes, whenever the Admin API key is regenerated. So, it is advisable to save both.Go to Developer section, Webhooks tab. Then press "+ Add Webhook" button.
Webhooks provide notifications and callbacks that allow you to receive asynchronous updates about events on the connected platforms. A valid and active webhook is required for the integration to function properly.If a webhook is incorrect or not set up properly, payment status updates for orders imported into Shopify will not be received, and the orders will remain marked as Payment pending.
Therefore, the steps below are especially important.
Get a webhook URL from admin.checkify and paste it into Notification URL field.
The URL is: https://admin.checkify.pro/api/airwallex/webhookSelect one of the API versions from the drop-down.
In the list of events, find "Payment attempt" and select all those events that belong to it.
Scroll down this page and press "Submit" button.
You will see the success message and an option to reveal a webhook secret key.
Display the secret key (a password from your Airwallex account may be required) and copy-paste it to admin.checkify into the Webhook secret field.
The Checkify – Airwallex integration can be activated by pressing "Connect +" button once all three required credentials are available.
You will get a success message and will be taken to Payment methods page of admin.checkify.
Otherwise, an error will appear, and you may need to carefully repeat the steps outlined above.
Make sure your store's logo is present and visible to buyers at all times. It boosts trust and conversions at checkout, especially when redirect (alternative) payment methods are involved.
Before selling at scale via Airwallex, please check it by visiting admin > Customization > Design settings tab. Scroll down this page to reach Brand images block.
The URL (link) to a publicly available storage on the web with your logo file should be present there. If so, the logo will be both on Checkify checkout page and Airwallex.
2.2 Connect using a restricted API key (optional)
If the Admin API key is unavailable or you prefer not to use it, you can rely on the restricted key. However, this is not recommended, due to the complexities of the payment gateway and potential future changes may affect the integration’s ability to function smoothly with a limited key.
Log in to your Airwallex live account (production environment).
Go to Developer section, API Keys tab, and press "Create restricted API key" button.
Give your restricted API key a name, scroll down the page to find "Payment Acceptance" options.
Select "Edit" and "View" permissions then press "Create API key" button in the bottom of the page.
Confirm your actions. The key will appear in the list of API credentials along with your new Client ID.
Proceed to admin.checkify > Payment methods to finish the integration. You will still need a valid webhook secret key for the integration to work. See the connection flow for more details.
2.3 Additional options
When adding Airwallex as a payment method on Checkify.pro, you will also able to configure additional options:
i. Target countries.
You can select specific countries or regions for which this payment method will be displayed.
ii. Hide / reveal card payments option on the checkout page.
You can visit admin.checkify > Payment methods section > Settings tab and disable displaying of the card payments form on the checkout page. If hidden, your buyers will still get the option of paying using alternative payment methods.
3. Alternative payment methods by Airwallex
Based on Airwallex's reports and industry data, the top non-card payment methods used by their customers fall into these key categories:
Digital wallets
Digital wallets are the most used alternative payment method, particularly for e-commerce. They have become the preferred option in many regions because of their speed and convenience. For Airwallex and Checkify.pro customers, the most popular digital wallets are Apple Pay, Google Pay, Alipay, and WeChat Pay.
Buy now, pay later (BNPL)
BNPL services are a popular choice, especially among younger demographics. They offer a flexible payment option for consumers who may prefer not to use credit cards. The most prominent BNPL services integrated for Airwallex - Checkify.pro merchants are Klarna and Afterpay.
Local bank transfers
In some regions, direct bank transfers are the most preferred payment method due to their perceived security and low fees. Airwallex - Checkify.pro integration facilitates many of these local payment schemes:
iDEAL (Netherlands)
SEPA Direct Debit (Europe)
Multibanco (Portugal)
Italian bank transfers (Italy): This includes methods like MyBank and SEPA
BACS (UK) and ACH (US)
Airwallex has several payment options enabled by default: cards, Google Pay, Apple Pay, Airwallex Pay, Alipay, AlipayHK.
If you would like to offer more options to your buyers, simply enable them in your Airwallex dashboard.
Log in to your account and find Payments section > Payment methods tab.
Pick "Other available methods", select one or several and press "Activate".
You will be taken back to "My payment methods". Your request to add an alternative payment method will be reviewed. The activation time differs, however, Airwallex will keep you updated on the status via email.
Once approved, the payment methods will become available upon clicking "Other methods" button on your Checkify checkout page.
Example: Klarna alternative payment method has been enabled successfully and can be processed via Airwallex
4. Supported currencies
Multi-currency capability is a core feature of the Airwallex platform, designed to simplify international financial operations for businesses. The full list for Checkify.pro - Airwallex integration is given below. You can charge customers in one of them.
Currencies list
Currencies list
"AED", United Arab Emirates (UAE) Dirham,
"ALL", Albanian Lek,
"AMD", Armenian Dram,
"AOA", Angolan Kwanza,
"ARS", Argentine Peso,
"AUD", Australian Dollar (also used in Kiribati, Nauru, and Tuvalu),
"AWG", Aruban Florin,
"AZN", Azerbaijani Manat,
"BAM", Bosnian and Herzegovinian Convertible Mark,
"BBD", Barbadian Dollar,
"BDT", Bangladeshi Taka,
"BGN", Bulgarian Lev,
"BIF", Burundian Franc,
"BND", Brunei Dollar,
"BOB", Bolivian Boliviano,
"BRL", Brazilian Real,
"BWP", Botswana Pula,
"BZD", Belize Dollar,
"CAD", Canadian Dollar,
"CHF", Swiss Franc (also used in Liechtenstein),
"CNY", Chinese Yuan,
"COP", Colombian Peso,
"CRC", Costa Rican Colón,
"CZK", Czech Koruna,
"DJF", Djiboutian Franc,
"DKK", Danish Krone,
"DOP", Dominican Peso,
"DZD", Algerian Dinar,
"EGP", Egyptian Pound,
"ETB", Ethiopian Birr,
"EUR", Euro (used by 20 of the 27 EU member states and a number of other countries),
"FJD", Fijian Dollar,
"FKP", Falkland Islands Pound,
"GBP", British Pound Sterling (used in the United Kingdom and its dependencies),
"GEL", Georgian Lari,
"GIP", Gibraltar Pound,
"GMD", Gambian Dalasi,
"GNF", Guinean Franc,
"GTQ", Guatemalan Quetzal,
"GYD", Guyanese Dollar,
"HKD", Hong Kong Dollar,
"HNL", Honduran Lempira,
"HUF", Hungarian Forint,
"IDR", Indonesian Rupiah,
"ILS", Israeli Shekel,
"INR", Indian Rupee,
"JMD", Jamaican Dollar,
"JPY", Japanese Yen,
"KES", Kenyan Shilling,
"KGS", Kyrgyzstani Som,
"KHR", Cambodian Riel,
"KMF", Comorian Franc,
"KRW", South Korean Won,
"KYD", Cayman Islands Dollar,
"KZT", Kazakhstani Tenge,
"LAK", Lao Kip,
"LBP", Lebanese Pound,
"LKR", Sri Lankan Rupee,
"LRD", Liberian Dollar,
"LSL", Lesotho Loti,
"MAD", Moroccan Dirham,
"MDL", Moldovan Leu,
"MGA", Malagasy Ariary,
"MKD", Macedonian Denar,
"MNT", Mongolian Tögrög,
"MOP", Macanese Pataca,
"MUR", Mauritian Rupee,
"MVR", Maldivian Rufiyaa,
"MWK", Malawian Kwacha,
"MXN", Mexican Peso,
"MYR", Malaysian Ringgit,
"NAD", Namibian Dollar,
"NGN", Nigerian Naira,
"NIO", Nicaraguan Córdoba,
"NOK", Norwegian Krone,
"NPR", Nepalese Rupee,
"NZD", New Zealand Dollar (also used in Cook Islands, Niue, Pitcairn, and Tokelau),
"PAB", Panamanian Balboa,
"PEN", Peruvian Sol,
"PGK", Papua New Guinean Kina,
"PHP", Philippine Peso,
"PKR", Pakistani Rupee,
"PLN", Polish Złoty,
"PYG", Paraguayan Guaraní,
"QAR", Qatari Riyal,
"RON", Romanian Leu,
"RSD", Serbian Dinar,
"RWF", Rwandan Franc,
"SAR", Saudi Riyal,
"SBD", Solomon Islands Dollar,
"SCR", Seychellois Rupee,
"SEK", Swedish Krona,
"SGD", Singapore Dollar,
"SHP", Saint Helena Pound,
"SRD", Surinamese Dollar,
"STD", São Tomé and Príncipe Dobra,
"SVC", Salvadoran Colón,
"SZL", Swazi Lilangeni,
"THB", Thai Baht,
"TJS", Tajikistani Somoni,
"TOP", Tongan Paʻanga,
"TRY", Turkish Lira,
"TTD", Trinidad and Tobago Dollar,
"TWD", New Taiwan Dollar,
"TZS", Tanzanian Shilling,
"UAH", Ukrainian Hryvnia,
"USD", United States Dollar (and many other countries and territories),
"UYU", Uruguayan Peso,
"UZS", Uzbekistan Som,
"VND", Vietnamese Đồng,
"VUV", Vanuatu Vatu,
"WST", Samoan Tala,
"ZAR", South African Rand,
"ZMW", Zambian Kwacha.
If the default currency of your Shopify store is not one of them, Airwallex integration will not work.
In other words, the currency of the checkout should be in one of those currencies. This is not a limitation for your buyers, whose cards may still be in any other currency, even those outside the list of supported ones.
There are around 20 languages/locales supported by Airwallex. If the checkout page is in a language not supported by the payment provider, its elements will appear in English. Once the buyer completes the purchase, the order confirmation (thank you) page by Checkify will be displayed in their native language again.
5. Resolving common issues
🙀 How do I link an imported order with an Airwallex payment received?
When the order is placed successfully, there is always a set of data associated with it. It is provided in the Orders section of the Checkify admin.
Alternatively, you may find this info on Shopify. Open the order timeline. Here, Authorization key = Airwallex Transaction ID. Example:
The Airwallex dashboard allows searching as well, using the same transaction identifier.
Visit Payments > Payment Activity > All payments tab and search by Payment ID, which can be obtained from Orders section of either Checkify or Shopify.
🙀 What is an Order ID on Airwallex, Payments section
The order ID is equivalent to Checkify checkout unique ID. Such an ID is attributed to every checkout page URL. It consists of a series of digits and letters. Example: 93c6029b-2229-480b-ba64-cdc321eb4863.
For tracking and easy search and matching of orders on all the platforms involved, we recommend to rely on payment ID by Airwallex. It looks like this: int_hkdm5jmx4hb9hpwamv8
🙀 I see an order pending status on my Shopify. What happens with the order?
There is always a gap between accepting an order and capturing the payment (marking it as 'Paid'). This is normal, because during this time the payment is authorized but not yet charged. If the order is canceled before capture, the authorization is simply released, usually without fees, since the funds were never fully processed by the bank.
It is advisable to wait for the payment to be captured. No immediate action is required on your side. Order statuses may not update right away; the change usually occurs within one to two hours. If nothing has changed after a reasonable amount of time, you may want to check the gateway logs or contact the payment provider or the buyer before considering cancellation.
🙀 How do I refund the payment for an order received via Airwallex?
For more accurate accounting and reporting, we recommend using the native Shopify refund flow for orders. This process is fully automated: Shopify and Airwallex communicate directly, and Checkify is not involved.
🙀 I want my buyers who reach the checkout page to understand which methods apart from card payments are available. What to do?
Since the wording on the checkout page is editable, you can adjust it depending on your business needs and target geo. The default selector is "Cards" or "Other methods". It can be modified.
Visit admin > Localization section, Airwallex. For example, if Klarna is your focus, you may edit the text in the in the “Switcher - Other methods” field and explicitly indicate it. The description of the payment method has also been changed. See the example of such an update below:
🙀 I want to understand what's the best payment processor for me: Airwallex, Stripe, PayPal or Adyen, and how they are different from each other.
There is no simple answer for that. Here, we explain more about the differences. Several payment gateways (Stripe + PayPal or Airwallex + PayPal) and a manual payment method is totally fine and is a good practice.