# mollie/magento2

> Mollie Payment Module for Magento 2

`composer require mollie/magento2`

Canonical URL: https://packagento.com/mollie/magento2

## At a glance

- **Vendor**: mollie (https://packagento.com/mollie.md)
- **Latest version**: 3.0.2 — released 2026-06-23
- **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 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:*
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:flush
   ```

## What it does

Mollie Payment Module for Magento 2

## README

<p align="center">
  <img src="mollie-logo.svg" />
</p>

<h1 align="center">Mollie for Magento 2.4.5 and higher</h1>

> **Magento 1.x** users check out our [Mollie Magento 1 plugin](https://github.com/mollie/Magento).

### Version 3.0

We recently released version 3.0 of the Mollie Payment extension. Some of the highlights of this release are:

- PHP 8.1 and Magento 2.4.5 or higher are required.
- Removed Orders API integration
- Queue-based transaction processing enabled by default.
- Handle refunds from external sources
- Optional invoices
- Cancel order on manual checkout return

For more information, see the upgrade guides in [English](docs/en/UPGRADING.md) and [Dutch](docs/nl/UPGRADING.md).

### Installation & Update the Mollie Payments plugin

[1. Installation through Magento Marketplace](docs/en/INSTALLATION.md#installation-via-magento-marketplace)

[2. Installation by Composer](docs/en/INSTALLATION.md#installation-via-composer)

[3. Update by Composer](docs/en/INSTALLATION.md#update-an-existing-installation)

[- Configuration](docs/en/CONFIGURATION.md)

[- Troubleshooting](docs/en/TROUBLESHOOTING.md)

### 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](https://www.mollie.com/en/pricing/). You can create an account [here](https://www.mollie.com/dashboard/signup). The Mollie Magento 2 plugin quickly integrates all major payment methods ready-made into your Magento webshop.

### Supported Mollie Payment Methods

- Apple Pay (direct)
- Alma
- Bancontact
- Bancomat Pay
- Bank transfer
- Belfius Pay Button
- Billie
- Bizum
- Blik
- Credit card (VISA, MasterCard, Maestro and American Express)
- EPS
- Gift cards (Webshop Giftcard, Podium Cadeaukaart, VVV Cadeaukaart, YourGift etc.)
- Google Pay
- iDEAL
- in3
- KBC/CBC Payment Button
- Klarna One
- Klarna Pay now
- Klarna Pay later
- Klarna Slice it
- Meal vouchers, eco vouchers, and various other gift vouchers (Appetiz, Cadeau Pass, Chèque Déjeuner, Eco Pass, Lunch Pass, Monizze, PassRestaurant, Swile)
- Pay by Bank
- PayPal
- Paysafecard
- Point Of Sale (POS)
- Payconiq
- Przelewy24
- Satispay
- SEPA Direct Debit
- SOFORT Banking
- Swish
- TWINT
- Vipps

### Additional modules

To extend the functionality of the Mollie Magento 2 plugin, we have developed a number of additional modules.

- [Subscriptions](https://github.com/mollie/magento2-subscriptions) - Create and manage subscriptions in your Magento 2 webshop.
- [Multi shipping](https://github.com/mollie/magento2-multishipping) - Enable multi shipping in your Magento 2 webshop.

> The former [Analytics](https://github.com/mollie/magento2-analytics) addon is now part of the main module.

#### Support for other alternative frontends

- [Hyvä Checkout](https://github.com/mollie/magento2-hyva-compatibility)
- [Hyvä React Checkout](https://github.com/mollie/magento2-hyva-react-checkout)
- [Scandi PWA](https://github.com/mollie/magento2-scandipwa)

### Configuration, FAQ and Troubleshooting
If you experience problems with the extension installation, setup or whenever you need more information about how to setup the Mollie Payment extension, please see the [full documentation](docs/en/README.md) or send an e-mail to [info@mollie.com](mailto:info@mollie.com) with an exact description of the problem.

### Compatible modules

These modules are tested and known to be working with the Mollie Payment extension:

- Aheadworks Add Free Gift
- Amasty Extra Fee
- Fooman Totals
- Magento Giftcard
- Magento Gift Wrapping
- MageWorx Reward Points
- Mirasvit Rewards
- Weee Fee
- Geissweb EU Vat

### License
[BSD (Berkeley Software Distribution) License](http://www.opensource.org/licenses/bsd-license.php).
Copyright (c) 2011-2025, Mollie B.V.

## Recent Versions

| Version | Released |
|---|---|
| 3.0.2 | 2026-06-23 |
| 3.0.1 | 2026-06-12 |
| 3.0.0 | 2026-06-08 |
| 3.0.0-RC7 | 2026-05-20 |
| 2.51.0 | 2026-05-13 |
| 2.50.1 | 2026-04-08 |
| 3.0.0-RC6 | 2026-03-30 |
| 3.0.0-RC5 | 2026-03-19 |
| 3.0.0-RC4 | 2026-03-11 |
| 2.50.0 | 2026-03-10 |

Showing 10 of 152 versions. Full release history on https://packagento.com/mollie/magento2.

## Dependencies

### Require

| Package | Constraint |
|---|---|
| ext-json | * |
| magento/framework | >=103.0.5 |
| magento/module-backend | >=100.3.3 |
| magento/module-catalog | >=100.3.3 |
| magento/module-checkout | >=100.3.3 |
| magento/module-config | >=100.3.3 |
| magento/module-customer | >=100.3.3 |
| magento/module-eav | >=100.3.3 |
| magento/module-payment | >=100.3.3 |
| magento/module-quote | >=100.3.3 |
| magento/module-sales | >=100.3.3 |
| magento/module-sales-rule | >=100.3.3 |
| magento/module-store | >=100.3.3 |
| magento/module-tax | >=100.3.3 |
| magento/module-ui | >=100.3.3 |
| mollie/mollie-api-php | ^3.3 |
| php | >=8.1 |

### Replace

| Package | Constraint |
|---|---|
| mollie/magento2-analytics | * |

### Suggest

| Package | Constraint |
|---|---|
| mollie/magento2-hyva-checkout | Hyvä Checkout integration for Mollie Payments |
| mollie/magento2-hyva-compatibility | Hyvä compatibility for Mollie Payments |
| mollie/magento2-hyva-react-checkout | Hyvä React Checkout integration for Mollie Payments |
| mollie/magento2-multishipping | Multishipping integration for Mollie Payments |
| mollie/magento2-scandipwa | ScandiPWA integration for Mollie Payments |
| mollie/magento2-subscriptions | Subscriptions integration for Mollie Payments |

## Quality

Latest release (3.0.2) fails the Packagento QA pipeline. Verdicts below are per-cell (Magento line × PHP version) for the matrixed tools, and run-once for the static / security tiers.


### Compatibility

Each Magento line is installed on its supported PHP versions, then the module is built (DI compile + static-content deploy). Cells show passed / failed / untested; staircase gaps render as `–`.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | Pass | Pass | – | – |
| 2.4.8 | – | Pass | Pass | – |
| 2.4.9 | – | – | Pass | Pass |


### Code Quality

Advisory checks against the module's source. Never affect the Compatibility verdict — a phpcs finding can't make a module incompatible.

#### Static Analysis

Coding standards (phpcs), mess detection (phpmd), copy-pasted code (cpd), PHP cross-version compatibility, composer.json validity. Each runs once for the whole module.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| PHPCS | Warning | 735 | 735 warnings (ruleset: Magento2) — 424 auto-fixable with phpcbf |
| PHPMD | Warning | 182 | 182 rule violations (UnusedFormalParameter:114, IfStatementAssignment:24, NPathComplexity:7, ExcessiveParameterList:6, UnusedLocalVariable:6) |
| Cpd | Pass | 0 |  |
| Composer validate | Info | 15 | valid; 15 advisory notes (composer validate --strict) |

#### PHPStan

Type-checks the module against a real Magento install. Re-runs per Magento + PHP version because resolvable symbols differ between releases.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | 430 | 430 | – | – |
| 2.4.8 | – | 430 | 430 | – |
| 2.4.9 | – | – | 423 | 423 |


### Tests

Unit and integration suites run per Magento + PHP cell. Test failures speak to the module's behaviour, not its compatibility with a line, so they're reported here separately.

#### Unit Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |

#### Integration Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | Pass | Pass | – | – |
| 2.4.8 | – | Pass | Pass | – |
| 2.4.9 | – | – | not tested | Pass |


### Security

Dependency-advisory audit (composer audit) plus a source malware scan. A malware detection fails the version outright.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| Composer audit | Pass | 0 |  |
| Malware scan | Pass | 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"],
  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.