There are three ways to run the Payments Suite — the Opayo by Elavon (formerly Sage Pay) integration — on a Hyvä store:
| Checkout | What you need |
|---|---|
| Hyvä Checkout | The Payments Suite for Hyvä Checkout compatibility module — the best Hyvä integration and customisability, sold separately |
| Luma checkout (fallback) | Nothing extra — the extension is fully compatible when Hyvä falls back to the Luma theme on the checkout pages; OneStepCheckout is a good alternative |
| Hyvä React Checkout | The open-source, community-supported checkout for teams with React experience — supported via the magento2-hyva-react-checkout-sage-pay-suite module, covering the PI integration with and without Drop-In |
Installing the Hyvä Checkout compatibility module
Before you start you need Hyvä Themes and Hyvä Checkout installed (hyva.io), the Payments Suite installed and configured, and the compatibility module purchased from the ebizmarts store.
- Register the Composer credentials —
your_tokencomes with your module purchase; contact support if you don’t have it:
composer config http-basic.hyva.gitlab.ebizmarts.com hyva your_token- Require the module:
composer require ebizmarts/hyvacheckoutsagepaysuite- Run the Magento setup:
bin/magento setup:upgrade
bin/magento setup:di:compile- Rebuild the Hyvä Tailwind styles:
npm --prefix vendor/hyva-themes/magento2-default-theme/web/tailwind/ ci
npm --prefix vendor/hyva-themes/magento2-default-theme/web/tailwind/ run build-prodThe Opayo payment methods then appear in Hyvä Checkout. If they don’t, flush the cache and check Common errors.