# mollie/magento2-hyva-compatibility

> Hyvä Themes Compatibility module for Mollie Payments

`composer require mollie/magento2-hyva-compatibility`

Canonical URL: https://packagento.com/mollie/magento2-hyva-compatibility

## At a glance

- **Vendor**: mollie (https://packagento.com/mollie.md)
- **Latest version**: v3.1.0 — released 2026-06-22
- **Pricing**: Free
- **Package type**: Magento 2 module
- **Status**: active, accepting new buyers

## Installation

Packagento is licence-gated, so even free packages need a licence on a project before Composer can resolve them.

1. **Sign in or create an account** at https://packagento.com/customer/account/.

2. **Add the package to your account.** Open https://packagento.com/mollie/magento2-hyva-compatibility and complete the free checkout. A licence is minted automatically.

3. **Create or pick a project, then activate the licence on it.**
   - Projects represent the Magento installs you deploy to. Manage them at https://packagento.com/projects/.
   - Activate the new licence on the project you'll deploy this package to. Activation is what generates the Composer credentials scoped to that project.

4. **Add the project credentials to your Magento codebase.**

   Grab the project's public + private key from https://packagento.com/projects/ (open the project, then its Credentials tab), and add them to `auth.json`:

   ```json
   {
     "http-basic": {
       "packagento.com": {
         "username": "ppk_live_...",
         "password": "psk_live_..."
       }
     }
   }
   ```

   Add the Packagento Composer repository to `composer.json`:

   ```json
   {
     "repositories": [
       { "type": "composer", "url": "https://packagento.com" }
     ]
   }
   ```

5. **Install and apply.**

   ```bash
   composer require mollie/magento2-hyva-compatibility:*
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:flush
   ```

## What it does

Hyvä Themes Compatibility module for Mollie Payments

## README

<p align="center">
  <img src="./images/hyva-mollie-header.jpg" />
</p>

## General Hyvä Compatibility for Mollie
Hyvä Themes Magento 2 frontend offers the best performance and user experience, without the cost and overhead of a PWA.

### About Mollie Payments
With Mollie, you can accept payments and donations online and expand your customer base internationally with support for all major payment methods through a single integration. No need to spend weeks on paperwork or security compliance procedures. No more lost conversions because you don’t support a shopper’s favourite payment method or because they don’t feel safe. We made our products and API expansive, intuitive, and safe for merchants, customers and developers alike.

Mollie requires no minimum costs, no fixed contracts, no hidden costs. At Mollie you only pay for successful transactions. More about this pricing model can be found here. You can create an account here. The Mollie Magento 2 plugin quickly integrates all major payment methods ready-made into your Magento webshop.

### About this repository

This repository hold the module to add support for Mollie to Hyvä. This module has a dependency on the Mollie Magento 2 module.

If you are using the **Hyvä Checkout** module, we have a separate repository for that:
https://github.com/mollie/magento2-hyva-checkout

If you are using the **Hyvä React Checkout** module, we have a separate repository for that:
https://github.com/mollie/magento2-hyva-react-checkout

### Installation

1. Install the module using composer: 

```bash
composer require mollie/magento2-hyva-compatibility
```

2. Enable the module:

```bash
bin/magento module:enable Mollie_HyvaCompatibility
```

3. Upgrade the database:

```bash
bin/magento setup:upgrade
```

4. Let Hyvä know about the new module:

```bash
php bin/magento hyva:config:generate
```

5. Generate the CSS files:

```bash
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
```

Or from your theme:

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

### Missing styles?

Make sure that PostCSS uses the `postcssImportHyvaModules` plugin in your theme:

1. Go to your theme folder: `app/design/frontend/<Vendor>/<Theme>/web/tailwind`
2. Install the module:
```bash
npm install --save-dev @hyva-themes/hyva-modules
```
3. Open your `postcss.config.js` and add this as the first line:
```js
const { postcssImportHyvaModules } = require("@hyva-themes/hyva-modules");
```
4. Make sure the plugin is includes in the plugins list:
```js
module.exports = {
    plugins: [
        postcssImportHyvaModules,
        // ...
    ],
};
```

## Recent Versions

| Version | Released |
|---|---|
| v3.1.0 | 2026-06-22 |
| v3.0.1 | 2026-06-08 |
| v3.0.0 | 2026-06-08 |
| 3.0.0-RC5 | 2026-03-30 |
| 3.0.0-RC4 | 2026-03-24 |
| 3.0.0-RC3 | 2026-03-24 |
| 2.6.0 | 2026-03-10 |
| 3.0.0-RC2 | 2026-01-26 |
| 2.5.0 | 2025-11-11 |
| 2.4.1 | 2025-06-16 |

Showing 10 of 19 versions. Full release history on https://packagento.com/mollie/magento2-hyva-compatibility.

## Dependencies

### Require

| Package | Constraint |
|---|---|
| hyva-themes/magento2-compat-module-fallback | * |
| magento/framework | * |
| magewirephp/magewire | ^1.13.3 |
| mollie/magento2 | ^3.0.0 |

## Licence and pricing

Free. A licence is still minted on checkout and bound to your project for Composer access — no payment step.

Refundable within 14 days of first purchase via https://packagento.com/account/refunds/.

## Install via Claude Code or any MCP client

The Packagento MCP server can run the licence + project + Composer steps above in one tool call:

```
purchase_and_install_packages(
  composer_names=["mollie/magento2-hyva-compatibility"],
  project_id="proj_xxx"
)
```

This handles cart, checkout, licence minting, project activation, and writes auth.json credentials. Connect a client with `claude mcp add packagento https://mcp.packagento.com`. Full setup at https://packagento.com/docs/mcp-setup.

## Vendor

mollie is a Magento 2 vendor on Packagento. See https://packagento.com/mollie.md for their full catalogue.