Magento 2 Hyvä Checkout

The ICEPAY for Magento 2 Hyvä Checkout module adds support for ICEPAY payment methods to stores using Hyvä Checkout.

It works alongside the standard ICEPAY Magento 2 module and provides the compatibility required to display and use supported ICEPAY payment methods in Hyvä Checkout.

Using the standard Magento checkout?

You do not need this module when your store uses Magento’s standard checkout.

See the Magento 2 integration guide instead.

Before you begin

Make sure your Magento installation already has:

ICEPAY for Magento 2

The standard ICEPAY Magento 2 module must be installed and configured.

Magento 2 integration guide →

Hyvä Checkout

Hyvä Checkout must be installed and working in your Magento store before adding the ICEPAY compatibility module.

The Hyvä Checkout module requires PHP 8.1 or later within the supported PHP 8 releases.

Install the module

Run the following commands from the root directory of your Magento installation:

composer require icepay/magento2-hyva-checkout

php bin/magento module:enable Icepay_HyvaCheckout

php bin/magento setup:upgrade

php bin/magento cache:clean

You can verify that the module is enabled with:

php bin/magento module:status Icepay_HyvaCheckout

When enabled successfully, Magento should report:

Module is enabled

Tip

The Hyvä Checkout package is an addition to the standard ICEPAY Magento 2 module. Your ICEPAY merchant credentials and payment method configuration remain managed by the standard Magento integration.

Configure ICEPAY

There is no separate ICEPAY merchant configuration for the Hyvä Checkout module.

Configure your ICEPAY Account and payment methods through the standard ICEPAY Magento 2 integration.

See the Magento 2 integration guide for the regular ICEPAY configuration.

Once both modules are installed, supported ICEPAY payment methods become available through Hyvä Checkout when they are enabled and available for the current checkout.

Supported payment methods

The Hyvä Checkout integration currently supports:

• Bancontact
• Credit and debit cards
• EPS
• iDEAL
• Online Überweisen
• PayPal
• SOFORT

The payment methods shown to a customer can depend on your ICEPAY configuration and the properties of the order.

Test your checkout

After installing the module, place a test order through Hyvä Checkout.

Check that:

1. The expected ICEPAY payment methods are displayed.
2. A payment method can be selected.
3. The customer is redirected to the appropriate payment flow.
4. Returning from the payment flow redirects the customer back to your store.
5. The Magento order receives the expected payment status.

Tip

Test both successful and cancelled payments before enabling the integration in production.

Update the module

Update the Hyvä Checkout integration using Composer:

composer update icepay/magento2-hyva-checkout

php bin/magento setup:upgrade

php bin/magento cache:clean

After updating, test the checkout again before deploying the changes to production.

Source code

The ICEPAY Magento 2 Hyvä Checkout integration is open source and available on GitHub.

ICEPAY for Magento 2 Hyvä Checkout

View the source code and releases on GitHub.

Need help?

If you experience problems with the integration, include your Magento version, PHP version, Hyvä Checkout version, and ICEPAY module versions when contacting the ICEPAY team.

Contact the ICEPAY team

Get help with your ICEPAY Magento integration.

Troubleshooting

ICEPAY payment methods are not visible in Hyvä Checkout

Check that:

• The standard ICEPAY Magento 2 module is installed and enabled.
• The ICEPAY Hyvä Checkout module is installed and enabled.
• The payment method is enabled in Stores → Configuration → Sales → Payment Methods → ICEPAY.
• The correct ICEPAY merchant is configured.
• The payment method is enabled for your ICEPAY merchant.
• Your Magento, PHP, and Hyvä Checkout versions meet the extension requirements.

Verify that both ICEPAY modules are enabled:

php bin/magento module:status Icepay_Payment
php bin/magento module:status Icepay_HyvaCheckout

Clear the Magento cache after changing the payment configuration:

php bin/magento cache:flush

If the payment methods are available in the standard Magento checkout but not in Hyvä Checkout, check the Magento logs for errors related to Icepay_HyvaCheckout.

The standard Magento checkout works, but Hyvä Checkout does not

Confirm that the ICEPAY Hyvä Checkout module is enabled:

php bin/magento module:status Icepay_HyvaCheckout

If the module is disabled, enable it:

php bin/magento module:enable Icepay_HyvaCheckout

Then run the Magento upgrade and clear the cache:

php bin/magento setup:upgrade
php bin/magento cache:flush

Test the checkout again after these commands have completed.

If the problem continues, check the Magento logs for errors related to Hyvä Checkout or the ICEPAY integration.

The payment remains pending

Open the corresponding order in Sales → Orders and review its status history.

Then check the payment in the ICEPAY Portal and compare its status with the Magento order.

The Hyvä Checkout module only provides compatibility with the checkout. Payment processing and order status handling are provided by the standard ICEPAY Magento 2 integration.

If the payment has been completed in ICEPAY but the Magento order has not been updated, contact the ICEPAY team with the order number, payment reference, Merchant ID, and approximate time of the payment.

Do not include your Merchant Secret in a support request.

The customer cannot complete the payment

Confirm that:

• The correct Merchant ID and Merchant Secret are configured.
• The ICEPAY merchant is enabled.
• The selected payment method is available for the merchant.
• Both ICEPAY Magento modules are enabled.
• Your Magento store can communicate with ICEPAY.

Check the Magento logs for errors related to the payment request or Hyvä Checkout.

If an error is shown during checkout, include the error message when contacting the ICEPAY team.

The extension does not work after an update

Confirm that your Magento, PHP, Hyvä Checkout, and ICEPAY extension versions are compatible.

Check whether both ICEPAY modules are enabled:

php bin/magento module:status Icepay_Payment
php bin/magento module:status Icepay_HyvaCheckout

Then run the Magento upgrade and clear the cache:

php bin/magento setup:upgrade
php bin/magento cache:flush

If your deployment process requires it, regenerate compiled code and static content before testing the checkout again.

If the issue continues, check the Magento logs and contact the ICEPAY team with the ICEPAY module versions, Hyvä Checkout version, Magento version, PHP version, and any relevant error message.

The ICEPAY configuration is not taking effect in Hyvä Checkout

ICEPAY settings are managed by the standard Magento 2 module. There is no separate payment configuration for the Hyvä Checkout compatibility module.

Make sure the ICEPAY settings were saved for the correct website or store view.

Then clear the Magento configuration cache:

php bin/magento cache:clean config

Reload the configuration and test Hyvä Checkout again.

If the problem continues, confirm that no website-level or store-level configuration is overriding the value you expect.