Hyvä Checkout Quick Setup
This guide describes the quick installation procedure of the Novalnet payment module with hyvä checkout (this guide comes along with the module) to integrate it with your shop system and to start accepting payments worldwide. For this integration, a Novalnet merchant account is needed to accept Novalnet payments, so please make sure that you have received your merchant account details from our sales team. If not, drop a mail to sales@novalnet.de
Requirements:
To get started with the integration, ensure your system meets the following requirements:
- PHP Version: 8.1 - 8.4
- Magento version: 2.4.5-p8 - 2.4.8-p2
- Novalnet Payment Module: 13.4.0
- Novalnet Hyvä Module: 1.0.0
- Hyvä Checkout Version: 1.3.0 - 1.3.5
Change Log
Version 1.0.0 - Released on 11 October, 2025
- [New Release] Novalnet Payments integrated for Hyvä checkouts, enabling seamless payment processing and compatibility with the Hyvä storefront.
To get started:
- Log in to your Magento shop system.
- Hyvä theme and checkout need to be installed.
- The Novalnet payment module needs to be installed. If you need the Novalnet payment module, kindly get the module details from here.
- Ensure that you have extracted the Novalnet Hyvä Checkout module package from the ZIP file provided. If you have only received the installation guide and not the module package (ZIP file), install the Hyvä Checkout module using Composer.
Module Installation
Via Composer:
To install the latest Novalnet Hyvä Checkout module via Composer, please follow the steps below.
Step 1: Run the following command in your terminal from the shop root directory.
composer require novalnet/hyva-checkout
Step 2: In your terminal, from the shop root directory, execute the following command to enable the Novalnet Hyvä Checkout module.
php bin/magento module:enable Novalnet_HyvaCheckout
Step 3: Run the following command in your terminal to proceed further.
php bin/magento setup:upgrade
Step 4: After upgrading, you will be asked to re-run the Magento compile command. To proceed further, execute the following command.
php bin/magento setup:di:compile
Step 5: Execute the following command to deploy static-content files (images, CSS, templates, and JS files).
php bin/magento setup:static-content:deploy -f
Once you have installed the latest Novalnet Hyvä Checkout through Composer, skip Module Installation via Package
Via Package:
To install the latest Novalnet Hyvä checkout module, please follow the steps below to install it in your shop system.
Before installing the Novalnet Hyvä Checkout module, ensure that the Novalnet Payment module is installed in your shop root directory.
If you have downloaded the Novalnet Hyvä Checkout module from the GitHub repository, please rename the extracted folder to “HyvaCheckout”.
Step 1: Upload the HyvaCheckout folder (which you have extracted from the zip file) into the following path
Step 2: In your terminal, from the shop root directory, execute the following command to enable the Novalnet Hyvä Checkout module
php bin/magento module:enable Novalnet_HyvaCheckout
Step 3: To verify whether the Novalnet Hyvä Checkout module has been activated properly, execute the following command.
php bin/magento module:status
Step 4: Run the following command in your terminal to proceed further
php bin/magento setup:upgrade
Step 5: After upgrading, you will be asked to re-run the Magento compile command. To proceed further, execute the following command.
php bin/magento setup:di:compile
Step 6: Execute the following command to deploy static-content files (images, CSS, templates, and JS files)
php bin/magento setup:static-content:deploy -f
Step 7: After the Hyvä Checkout module installation, navigate to CONTENT → Design → Configuration as shown below.
Hyvä Checkouts
Configure the Hyvä checkout in shop
To enable the Hyvä checkout in shop. Please follow the below steps to display the checkout in shop.
Step 1: Once log in to the shop, navigate to STORES → Configuration
Step 2: After the configuration page opens, go to HYVÄ THEMES → Checkout, choose the desired checkout type from the dropdown, and click Save Config as shown below
The sample checkout page of Hyvä One Page Checkout with Novalnet Payment.
The sample checkout page of Hyvä default checkout with Novalnet Payment.
The sample checkout page of Hyvä Default (for:Mobile devices) checkout with Novalnet Payment.
Uninstallation
To deactivate and delete the Novalnet Hyvä Checkout module, please follow the steps below.
Step 1: Then, run the command to disable the Novalnet Hyvä Checkout module,
php bin/magento module:disable --clear-static-content Novalnet_HyvaCheckout
Step 2: To remove the Novalnet Hyvä Checkout module, run the following command in your terminal, from the shop root directory,
rm -rf app/code/Novalnet/HyvaCheckout
Step 3: Run the following command in your terminal to proceed further.
php bin/magento setup:upgrade
Step 4: After this, re-run the Magento compile command, and execute the following command
php bin/magento setup:di:compile
Step 5: Execute the following to deploy static-content files (images, CSS, templates, and JS files)
php bin/magento setup:static-content:deploy -f