Best full-service eCommerce agency 2026
Magento and Adobe Commerce merchants using Airwallex can integrate the payment provider with Hyvä Checkout through a dedicated compatibility module documented by both Hyvä and Airwallex.
The integration is relevant to merchants evaluating a Hyvä Checkout migration because payment-provider compatibility needs to be assessed alongside the checkout itself. A new checkout still needs to support the payment methods, transaction flows and operational requirements the business relies on.
Hyvä lists Airwallex in its available payment integrations for Hyvä Checkout, while Airwallex provides dedicated guidance for installing the Hyvä compatibility module.
For merchants already using Airwallex, this provides a documented integration path when evaluating or implementing Hyvä Checkout.
What the Airwallex integration supports
The Hyvä compatibility module works alongside the main Airwallex Magento payment plugin rather than replacing it.
Airwallex documents the setup specifically for Magento stores using Hyvä Checkout. The store therefore needs the Airwallex Magento plugin configured alongside Hyvä Checkout before the compatibility module is added.
The practical benefit is that merchants can retain supported Airwallex payment functionality while moving to a Hyvä-based checkout, subject to the payment methods and features available through the relevant Magento and Hyvä integration.
That distinction matters because Airwallex supports a broad range of payment methods across its wider platform, but that does not mean every Airwallex payment method is automatically available through Magento and Hyvä in every market.
Airwallex provides separate guidance for configuring payment methods in Magento. Merchants should check the payment methods relevant to their market and implementation before deployment.
Why payment compatibility matters for a Hyvä Checkout migration
Payment compatibility is one of the core requirements in a checkout migration.
A merchant can improve checkout design or frontend performance, but the migration still needs to support the payment options customers rely on and the operational flows the business requires.
Depending on the implementation, that can include:
-
card payments
-
local and alternative payment methods
-
payment authorisation and capture
-
refunds and cancellations
-
saved payment functionality
-
multi-currency requirements
-
regional payment methods
-
interactions with fraud, shipping and order-management processes
The relevant question is therefore not simply whether a payment provider has a Hyvä integration.
Merchants need to establish whether the specific Airwallex functionality used by their store is supported and behaves correctly within their Hyvä Checkout implementation.
How the integration works
Airwallex provides the core Magento payment plugin. Hyvä documents a separate compatibility module for using that payment integration with Hyvä Checkout.
According to Airwallex’s Magento installation guidance, merchants first need the Airwallex Magento plugin installed and configured.
The Hyvä compatibility module then provides the frontend compatibility required for a Hyvä Checkout implementation.
This model is consistent with the wider Hyvä Checkout ecosystem, where payment integrations can be maintained by Hyvä, payment service providers or community contributors.
For merchants, the important point is that the maintainer and support route can differ between integrations. The current Hyvä and payment-provider documentation should therefore be checked when planning implementation or troubleshooting a specific payment method.
What merchants should check before implementation
The existence of a compatibility module is an important starting point, but it should not replace implementation testing.
On Tap recommends checking the following areas before a production rollout.
Confirm the payment methods you need
Review the Airwallex payment methods currently used by the store and confirm that the relevant Magento and Hyvä setup supports them.
Do not assume that every payment method available elsewhere in the Airwallex platform is automatically available through the Magento integration.
Where local payment methods are important, check Airwallex’s current Magento configuration guidance for the merchant’s market.
Check extension and platform compatibility
Confirm the versions of:
-
Magento Open Source or Adobe Commerce
-
Hyvä Checkout
-
the Airwallex Magento plugin
-
the Hyvä Airwallex compatibility module
Use the current Airwallex and Hyvä documentation when planning an implementation or upgrade, as supported combinations can change over time.
Test the complete payment flow
On Tap recommends testing the flows the merchant actually relies on, including where relevant:
-
successful payments
-
declined payments
-
authentication flows
-
order creation
-
authorisation and capture
-
refunds
-
cancellations
-
multiple currencies
-
guest and logged-in checkout
-
mobile checkout
-
relevant local and alternative payment methods
Testing should cover both the customer-facing experience and the resulting order and payment records in Magento.
Review existing customisations
If the current Airwallex implementation includes bespoke checkout logic, custom payment behaviour or integrations with other systems, those elements should be reviewed separately.
A compatibility module for the standard integration does not automatically establish compatibility for store-specific customisations.
What this means for merchants already using Airwallex
For merchants already using Airwallex on Magento, the documented Hyvä compatibility module removes one question from the initial Hyvä Checkout assessment: there is an established integration route for the payment provider.
It does not mean the migration becomes configuration-only or that no development work will be required.
The amount of implementation work depends on the merchant’s existing Airwallex setup, payment methods, checkout customisations, Magento version and wider extension stack.
A relatively standard implementation may have a more straightforward migration path than one with bespoke payment or checkout logic.
The compatibility module therefore provides a starting point for migration planning rather than a guarantee of identical implementation effort across stores.
The wider Hyvä Checkout payment ecosystem
Airwallex is one of several payment providers with documented Hyvä Checkout integrations.
Hyvä maintains an overview of available payment integrations, including modules associated with the Hyvä team, payment service providers and community contributors.
For merchants assessing Hyvä Checkout, this makes it possible to review payment compatibility before committing to a migration.
The important step is to assess each required provider and feature individually. The existence of a payment integration should be treated as the start of compatibility validation rather than proof that every merchant requirement is covered.
The bigger picture
The Airwallex compatibility module gives Magento and Adobe Commerce merchants using Airwallex a documented route for adopting Hyvä Checkout without replacing their payment provider solely because of the frontend migration.
That is useful for merchants whose payment stack is an important part of the migration decision.
However, the business case for Hyvä Checkout should still be based on the complete implementation: payment coverage, technical compatibility, checkout functionality, testing requirements, performance and commercial objectives.
For merchants already using Airwallex, the practical next step is to compare their current payment requirements with Airwallex’s Magento and Hyvä documentation and test the required flows before deployment.
About On Tap
On Tap is a growth-focused eCommerce consultancy and Hyvä partner, specialising in Magento and Adobe Commerce implementations for mid-market and enterprise merchants.
From Hyvä Checkout migration planning and payment compatibility audits to implementation, testing and ongoing optimisation, On Tap helps merchants assess how their existing eCommerce stack will work with a new checkout.
If you are considering Hyvä Checkout and use Airwallex, get in touch with the On Tap team.
