Comfino Payment Gateway for Magento 2

Magento 2 payment module for Comfino — Polish payment gateway offering installment payments, buy now pay later (BNPL), and business financing solutions.

Requirements

• Magento: 2.4.4 or higher (Magento 2.3.7+ / 2.4.0–2.4.3 → use v3.1.0 ZIP instead)
• PHP: 8.1 or higher
• PHP extensions: ctype, json, sodium, zlib

Installation

Via Composer (recommended)

composer require comfino/magento2:^4.0
bin/magento module:enable Comfino_ComfinoGateway Comfino_SdkForMagento2
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush

Hyvä Checkout support (optional)

composer require comfino/magento2-hyva-checkout:^1.0
bin/magento module:enable Comfino_ComfinoGatewayHyvaCheckout
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Note for Hyvä Checkout clients: hyva-themes/magento2-hyva-checkout is distributed via the private Hyvä repository. Add {"type":"composer","url":"https://hyva.io/packages/"} to your project's repositories before running composer require.

Manual installation (legacy — Magento 2.3.x / 2.4.0–2.4.3 only)

See Installation Guide (English) or Installation Guide (Polish).

Configuration

1. Navigate to: Stores → Configuration → Sales → Payment Methods → Comfino.
2. Enable the module.
3. Enter your API key (provided by your Comfino representative).
4. Configure widget and payment options.
5. Save configuration.

Migration from ZIP installation

If you previously installed via ZIP, see Migration Guide for upgrade instructions.

Hyvä Theme support

Version 4.0.0+ includes full support for Hyvä themes using an iframe-based architecture.

Development

Local setup

# Install dependencies
./bin/composer install

# Run tests
./bin/phpunit

# Run with coverage
XDEBUG_MODE=coverage ./bin/phpunit --coverage-html coverage

Tests run without a Magento installation — tests/bootstrap.php provides Magento stubs.

Support

• E-mail: pomoc@comfino.pl
• Documentation (English): comfino.pl/plugins/Magento/en
• Documentation (Polish): comfino.pl/plugins/Magento/pl
• Issues: GitHub Issues

License

Open Software License (OSL 3.0)