buckaroo / magento2-hyva-checkout

v2.4.0 2026-11-09 13:13 UTC

Requires

• php: >=8.1
• buckaroo/magento2: >=2.7.5
• magewirephp/validation: ^1.0

CC-BY-NC-ND-3.0

• Buckaroo

Published on Packagist.org on 2026-11-09 13:14 UTC

README

Buckaroo Hyvä Checkout module for Magento 2

About · Requirements · Installation · Upgrade · Configuration · Support · Contribute

About

Hyvä is a lightweight frontend for Magento 2 that replaces the default Luma theme, cutting page weight and complexity. Hyvä Checkout is its checkout implementation.

This module adds Buckaroo payment support to Hyvä Checkout. It is an extension of the Buckaroo Magento 2 plugin, not a replacement for it — the main plugin handles the payments, and this module makes them work inside the Hyvä Checkout flow.

Important

There are two Hyvä checkout products, and they need different modules.
This repository is for Hyvä Checkout. If you use Hyvä React Checkout, install Magento2_Hyva instead.

Full module documentation on docs.buckaroo.io

Requirements

Requirement	Supported versions
Buckaroo Magento 2 plugin	2.7.5 or higher
Hyvä Checkout	1.1.8 or higher

Magento, PHP and Composer requirements come from the main plugin. You also need a Buckaroo account — don't have one yet? Request an account.

Installation

Run the following commands from your Magento 2 root folder:

composer require buckaroo/magento2-hyva-checkout
php bin/magento module:enable Buckaroo_HyvaCheckout
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy
php bin/magento cache:flush

Upgrade

composer update buckaroo/magento2-hyva-checkout
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy
php bin/magento cache:flush

Tip

Always test an upgrade on a staging environment first and check the changelog and release notes for breaking changes.

Configuration

This module has no settings of its own. Payment methods are configured in the main Buckaroo plugin, under Stores → Configuration → Sales → Buckaroo in the Magento admin.

Once the module is installed and Hyvä Checkout is active, the payment methods you enabled there appear in the Hyvä checkout.

Step-by-step instructions: Configuring the Magento 2 plugin

Support

Having trouble? Work through this list before reaching out:

1. Confirm the main Buckaroo plugin is installed, active and correctly configured, and that the payment methods work outside Hyvä Checkout.
2. Check that you installed the right module for your checkout — this one for Hyvä Checkout, Magento2_Hyva for Hyvä React Checkout.
3. Confirm you are on the latest release of both this module and the main plugin.
4. Clear the cache and redeploy static content after installing or upgrading.

Still stuck? Contact us and include your Magento version, Hyvä Checkout version, main plugin version, this module's version and the relevant log lines.

• Bug reports and feature requests: open an issue
• Technical support: [e-mail]
• Phone: [phone]
• Gateway status: status.buckaroo.io

Contribute

We really appreciate it when developers help improve the Buckaroo plugins. Please read our Contribution Guidelines before opening a pull request.

Found a security issue? Please report it privately as described in our Security Policy instead of opening a public issue.

Versioning

We follow semantic versioning (MAJOR.MINOR.PATCH):

• MAJOR — breaking changes that require additional testing and caution.
• MINOR — new functionality with limited impact.
• PATCH — bug fixes and hotfixes only.

All changes are documented on the releases page.

_{Made with care by Buckaroo.
This document is subject to change; typos and language errors are possible.}