checkoutcom/module-magento-hyva

Checkout.com — Hyvä theme/storefront compatibility module (express buttons, PayPal review, account cards)

1.0.0 2026-07-24 10:03 UTC

Requires

• php: ~8.1.0 || ~8.2.0 || ~8.3.0 || ~8.4.0
• checkoutcom/magento2: 7.4.0
• hyva-themes/magento2-default-theme: ^1.4.0 <1.5.0
• magento/framework: >=103.0.5

MIT

Published on Packagist.org on 2026-07-27 10:31 UTC

README

Checkout.com for Hyvä

Official compatibility module of the Magento 2 Checkout.com module for the Hyvä Theme.

This package is required to use Checkout.com with the Hyvä Theme outside of the checkout — it brings the storefront features (express payment buttons, PayPal review page, saved cards in the customer account). For the Checkout.com integration inside Hyvä Checkout, install the complementary checkoutcom/module-magento-hyva-checkout module in addition.

About Checkout.com

Checkout.com is a software platform that has integrated 100% of the value chain to create payment infrastructures that truly make a difference. Checkout.com is authorized and regulated as a Payment institution by the UK Financial Conduct Authority.

The Checkout.com extension for Magento 2 allows shop owners to process online payments through the Checkout.com Payment Gateway, including Card Payments with Frames.js, Apple Pay, Google Pay, Saved Cards, Instant Purchase, MOTO and a wide range of Alternative Payment Methods (Alipay, Bancontact, Boleto, EPS, Fawry, Ideal, Klarna, KNet, Poli, Sepa, Sofort, …).

Please refer to https://www.checkout.com for more information.

Requirements

In order to work, this module requires:

• A valid Hyvä Theme licence
• The base checkoutcom/magento2 module installed and configured

Dependency	Constraint
PHP	8.1 / 8.2 / 8.3 / 8.4
magento/framework	>=103.0.5
hyva-themes/magento2-default-theme	^1.4.0 <1.5.0
checkoutcom/magento2	*

Please refer to https://docs.hyva.io for more instructions about Hyvä prerequisites.

Installation

1 - Install the module via composer:

composer require checkoutcom/module-magento-hyva

2 - Enable the module:

bin/magento module:enable CheckoutCom_Magento2Hyva
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean

3 - Generate Tailwind CSS styles:

# Register module to Hyvä Tailwind config
bin/magento hyva:config:generate

# Replace path by the Hyvä default theme
cd vendor/hyva-themes/magento2-default-theme/web/tailwind/
# Or, if you use the Hyvä CSP-compliant default theme
cd vendor/hyva-themes/magento2-default-theme-csp/web/tailwind/
# Or replace path by your Hyvä custom theme if you have one
cd path/to/project/app/design/frontend/Vendor/default/web/tailwind

# Switch to the good Node.js version
nvm use

# Install dependencies
npm i

# Compile Tailwind CSS file
npm run build

Configuration

This module does not add new configuration options. All Checkout.com settings remain managed from the base module under Stores > Configuration > Sales > Payment Methods > Checkout.com.

In order to effectively process payments through the Checkout.com Payment Gateway, you will need to open an account. Contact your Checkout.com account manager or send an email to [e-mail] for more information.

Support

Dedicated technical support is available to all merchants using Checkout.com via the public GitHub repositories or directly by email at [e-mail]. Checkout.com does not provide support for third-party plugins or any alterations made to the official Checkout.com plugins.

License

MIT — see the LICENSE file at the repository root.

DISCLAIMER

In no event shall Checkout.com be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from the information or code provided or the use of the information or code provided. This disclaimer of liability refers to any technical issue or damage caused by the use or non-use of the information or code provided or by the use of incorrect or incomplete information or code provided.