README

Two Gateway Module Version: 1.14.2

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

Component	Version	Link
Magento	2.4.x	Release Notes
Two Gateway Module	^1.13.1	two-inc/magento-plugin
Hyvä Checkout	^1.3	Hyvä Checkout

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

Download and extract the module's ZIP package.
Connect to your Magento server.
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

Check the module is enabled: php bin/magento module:status | grep Two_GatewayHyva
Navigate to your store's frontend checkout page
Verify that the Two Gateway payment method is visible
Place a test order to ensure everything is working correctly

Troubleshooting

Ensure Hyvä theme is properly installed
Check Magento logs: var/log/system.log and var/log/exception.log
Verify CSP (Content Security Policy) settings if scripts are blocked
Clear all caches after installation

Development

For developers looking to extend or customize the Two Gateway Hyva module, follow these steps:

Install direnv and uv and configure .envrc file with layout python.
Install the required tools and dependencies:

direnv allow
uv tool install bumpver
uv tool install pre-commit
pre-commit install

two-inc / magento2-hyva-checkout

Maintainers

Details