Install the plugin

Learn how to install and configure the plugin.

Follow these steps to install Unzer Hyvä Checkout plugins for Magneto 2 ecommerce platform.

Before you begin

Before installing Hyvä Checkout plugin, make sure you meet the following requirements:

• Install our Magento 2 plugin
• Install Hyvä Theme module
• Install Hyvä Checkout module

Install the Hyvä Themes Compatibility plugin

This a required step and must be done prior to installing Unzer Hyvä Checkout or Reach Checkout plugins.

1. Install the Plugin using Composer:
   Install using Composer

   Install using Composer

   Copy

   composer require unzerdev/magento2-hyva-compatibility
   

2. Once Composer has installed the dependencies and the plugin, activate it using the following command:
   Install using Composer

   Install using Composer

   Copy

   php bin/magento module:enable Unzer_HyvaCompatibility --clear-static-content
   

3. Import the plugin schema into your database:
   Install using Composer

   Install using Composer

   Copy

   php bin/magento setup:upgrade
   

4. Clear the cache, generate dependency injection, and deploy static files:
   Install using Composer

   Install using Composer

   Copy

   php bin/magento cache:flush
   php bin/magento setup:di:compile
   php bin/magento setup:static-content:deploy
   

The installation is now complete, and you can continue with installing Checkout and React Checkout.

Install Hyvä Checkout (recommended)

For best customer experience, we recommend Hyvä Checkout plugin.

1. Install the Plugin using Composer:
   Install using Composer

   Install using Composer

   Copy

   composer require unzerdev/magento2-hyva-checkout
   

2. Once Composer has installed the dependencies and the plugin, activate it using the following command:
   Install using Composer

   Install using Composer

   Copy

   php bin/magento module:enable Unzer_HyvaCheckout --clear-static-content
   

3. Import the plugin schema into your database:
   Install using Composer

   Install using Composer

   Copy

   php bin/magento setup:upgrade
   

4. Clear the cache, generate dependency injection, and deploy static files:
   Install using Composer

   Install using Composer

   Copy

   php bin/magento cache:flush
   php bin/magento setup:di:compile
   php bin/magento setup:static-content:deploy
   

The installation is now complete, and you can finalize the setup in Magento backend.

Install Hyvä React Checkout (not recommended)

There are some known bugs in Hyvä React Checkout plugin that you must consider before installing and using the plugin. We have reported these bugs to Hyvä React Checkout developers and awaits their response.

• Company name is always required and can’t be changed in the plugin as a result of this, you can’t accept payments from private customers
• State is always required for Dutch customers and can’t be disabled in the plugin

1. Open the package.json file and add the following line:
   Edit package.json file

   Edit package.json file

   Copy

   "config": {
   "paymentMethodsRepo": {
   "unzer": "git@github.com:unzerdev/magento2-hyva-react-checkout.git"
     }
   }
   

2. Under src/components/DefaultRenderer.js import:
   Import to DefaultRenderer.js

   Import to DefaultRenderer.js

   Copy

   import unzerRenderers from './unzer/renderers';
   
   export default {
     ...unzerRenderers,
   };
   

   Next, run npm install. This should install the repository into your checkout.
   Install repository to checkout

   Install repository to checkout

   Copy

   run npm install
   

The installation is now complete, and you can finalize the setup in Magento backend.

Next steps

• Setup Hyvä checkout
• Integration checklist
• Go-live checklist