Two Gateway Hyva Extension

Introduction

This document provides instructions for installing the Two Gateway Payment Method module with Hyvä Checkout compatibility for Magento 2. This module ensures a seamless payment experience for stores using the Hyvä frontend.

Compatibility

• Magento Version: 2.4.x
• Two Gateway Module Version: 1.12.2
• Hyvä Checkout Ready

Prerequisites

• Hyvä Theme and Hyvä Checkout module installed.
• Access to the Hyvä private composer repository.
• Node.js and Tailwind dependencies installed for building CSS.

Installation Steps

1. Install Hyvä Theme & Checkout (if not already installed)

Use composer to install the necessary Hyvä packages:

composer config repositories.private-packagist composer {repositories path}
composer config --auth http-basic.hyva-themes.repo.packagist.com token {token}
composer require hyva-themes/magento2-default-theme
composer require hyva-themes/magento2-hyva-checkout

2. Configure Hyvä Checkout

Configure basic settings via the Magento Admin: Admin > Stores > Settings > Configuration > Hyvä Themes > Checkout

3. Install Two Gateway Hyva Module

1. Download and extract the module's ZIP package.
2. Connect to your Magento server.
3. Upload the module files to app/code/Two/GatewayHyva.

4. Run Magento Commands

Execute the following commands from your Magento root directory:

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

5. Generate Hyvä Configuration

Run the Hyvä configuration generator:

php bin/magento hyva:config:generate

6. Build Tailwind CSS (Optional: If using custom styles)

For custom Hyvä themes:

npm --prefix app/design/frontend/<Vendor>/<Theme>/web/tailwind run ci
npm --prefix app/design/frontend/<Vendor>/<Theme>/web/tailwind run build-prod

For the default Hyvä theme:

npm --prefix vendor/hyva-themes/magento2-default-theme/web/tailwind run ci
npm --prefix vendor/hyva-themes/magento2-default-theme/web/tailwind run build-prod

7. Configure Two Gateway

Set up your Two Gateway credentials and settings in the Magento Admin: Admin > Stores > Configuration > Two Gateway

Testing

1. Navigate to your store's frontend checkout page.
2. Verify that the Two Gateway payment method is visible.
3. Place a test order to ensure everything is working correctly.