PHPackages                             mahocommerce/module-mollie - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. mahocommerce/module-mollie

ActiveMaho-module[Payment Processing](/categories/payments)

mahocommerce/module-mollie
==========================

Mollie payment gateway integration for Maho

v0.8.0(2w ago)12↓100%[1 PRs](https://github.com/MahoCommerce/module-mollie/pulls)OSL-3.0PHPPHP &gt;=8.3CI passing

Since May 20Pushed 1w ago1 watchersCompare

[ Source](https://github.com/MahoCommerce/module-mollie)[ Packagist](https://packagist.org/packages/mahocommerce/module-mollie)[ Fund](https://www.buymeacoffee.com/fballiano)[ Fund](https://paypal.me/fabrizioballiano)[ RSS](/packages/mahocommerce-module-mollie/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (1)Dependencies (8)Versions (4)Used By (0)

Maho Mollie
===========

[](#maho-mollie)

[![Maho Commerce](https://camo.githubusercontent.com/b6b18863bd9be2e126f1d0153283cb2c819a84aaf70031e8b7587a9faedeebcb/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d61686f5f436f6d6d657263652d6d6f64756c652d6f72616e6765)](https://camo.githubusercontent.com/b6b18863bd9be2e126f1d0153283cb2c819a84aaf70031e8b7587a9faedeebcb/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d61686f5f436f6d6d657263652d6d6f64756c652d6f72616e6765)[![License](https://camo.githubusercontent.com/bf8fb4e29810a9fc189ac77817d64e700c8cdad65219aec8af767d3413542703/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4f534c2d2d332e302d626c7565)](https://camo.githubusercontent.com/bf8fb4e29810a9fc189ac77817d64e700c8cdad65219aec8af767d3413542703/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4f534c2d2d332e302d626c7565)[![PHP](https://camo.githubusercontent.com/304040cd133992ef00119f16bf25c890678ce0c5b9898eb2b53349394e39707e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e332d383839324246)](https://camo.githubusercontent.com/304040cd133992ef00119f16bf25c890678ce0c5b9898eb2b53349394e39707e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e332d383839324246)[![PHPStan Level](https://camo.githubusercontent.com/ff3c7f8c8667ce643f47e74532748f673482a5f95d7d4269f925f2eebbe5117e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6c6576656c253230382d627269676874677265656e)](https://camo.githubusercontent.com/ff3c7f8c8667ce643f47e74532748f673482a5f95d7d4269f925f2eebbe5117e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6c6576656c253230382d627269676874677265656e)

**Mollie** payment gateway integration for [Maho Commerce](https://mahocommerce.com).

Accept payments through [Mollie](https://www.mollie.com), one of Europe's leading payment service providers — offering 40+ payment methods across the Payments API and the Orders API (for Klarna and other Buy Now Pay Later methods).

> **Status: Beta — redirect flow + Mollie Components verified against the Mollie sandbox.** Core payment flow (create → redirect → webhook → return → cron) is implemented against the Mollie Payments API, plus online refunds and admin-configurable order statuses. 28 method blocks are configurable in admin and all of them work end-to-end via redirect (the generic Mollie selector plus the per-method blocks listed below). For credit cards there's an opt-in PCI-SAQ-A flow via Mollie Components: the card-number / expiry / CVC / cardholder fields render inline in your checkout (cross-origin iframes hosted by Mollie), the customer stays on your site through to the success page, and the redirect-to-Mollie fallback still triggers if Components isn't configured or JS fails. Apple Pay's express-checkout button (cart/PDP) is not yet implemented, though Apple Pay via redirect works. Translations ship for Dutch, German, French, Italian, and Spanish.
>
> **Known gap:** the webhook re-fetches the payment from Mollie's API for verification, but there is no DB-level lock around the capture path; concurrent webhook redeliveries could race.

Requirements
------------

[](#requirements)

- PHP &gt;= 8.3
- Maho Commerce
- A [Mollie](https://www.mollie.com) merchant account

Installation
------------

[](#installation)

```
composer require mahocommerce/module-mollie
```

Clear the cache after installation:

```
./maho cache:flush
```

Configuration
-------------

[](#configuration)

Navigate to **System &gt; Configuration &gt; Payment Methods** in the Maho admin panel.

### General Settings (Mollie - General Settings)

[](#general-settings-mollie---general-settings)

SettingDescriptionDefault**Test Mode**Use the Mollie test API key to process mock paymentsYes**Live API Key**Your Mollie live API key (starts with `live_`)—**Test API Key**Your Mollie test API key (starts with `test_`)—**Test API Key** (button)One-click check that the configured key can reach the Mollie API—**Debug Logging**When enabled, writes verbose reconcile/refund events to `var/log/mollie.log`NoFind your API keys in the [Mollie dashboard](https://my.mollie.com/dashboard/) under **Developers**.

### Method-specific groups

[](#method-specific-groups)

Each of the 28 bundled methods has its own admin group with the usual active / title / country / sort-order controls plus per-method pending / processing order statuses.

Roadmap
-------

[](#roadmap)

### API layer

[](#api-layer)

- Payments API integration (create, webhook, return, cron reconciliation, refunds)
- Orders API integration (Klarna line items, in3, Billie, Alma, Riverty, Voucher categorisation)
- Apple Pay express checkout (domain association + JS button)

### Payment methods

[](#payment-methods)

Working end-to-end via redirect (Mollie hosts the actual UI):

- Generic Mollie gateway (Mollie's full method picker)
- iDEAL
- Bancontact
- Credit card (redirect by default; PCI-SAQ-A inline checkout via Mollie Components — toggle "Use Mollie Components" + Profile ID in the admin section)
- PayPal
- Apple Pay (redirect only — express button on cart/PDP not yet)
- Bank Transfer
- SEPA Direct Debit
- Gift Card
- Google Pay
- Trustly
- TWINT (Switzerland)
- BLIK (Poland)
- Przelewy24 (Poland)
- EPS (Austria)
- Belfius (Belgium)
- Bizum (Spain)
- MyBank (Italy / Spain)
- Satispay (Italy)
- BANCOMAT Pay (Italy)
- Multibanco (Portugal)
- MB WAY (Portugal)
- Payconiq (Belgium / NL / Lux)
- MobilePay (Denmark / Finland)
- Swish (Sweden)
- Vipps (Norway)
- Pay by Bank (UK)
- paysafecard

Not bundled at all (Mollie supports them; this module has no method block, model, or config):

- Klarna Pay Later / Pay Now / Slice It — need the Orders API to send `orderLines`
- iDEAL in3 — needs Orders API
- Riverty — needs Orders API
- KBC / CBC (Belgium) — needs issuer selection
- Voucher (meal-voucher schemes — Edenred, Sodexo, etc.) — needs per-product category mapping
- Alma, Billie — BNPL, need the Orders API
- POS (point-of-sale) — needs terminal picker
- SOFORT Banking (deprecated by Mollie — listed for completeness)

### Features

[](#features)

- Online refunds from admin via Mollie API (full + partial)
- Webhook-driven payment status reconciliation (all `mollie_*` method codes, not just the generic gateway)
- Cron-based safety net for missed webhooks (5-minute interval, 24-hour lookback)
- Admin-configurable pending / processing order statuses, per payment method
- External-refund and chargeback reconciliation (creditmemo from Mollie dashboard refunds; chargeback order comments only)
- Multi-store API key scoping
- Admin "Test API Key" button (one-click connectivity check)
- Debug logging toggle (gates info-level entries in `var/log/mollie.log`)
- Translations for Dutch, German, French, Italian, and Spanish
- DB-level idempotency lock on the capture path (today only an in-memory `hasInvoices()` check)
- Multi-currency support (code paths present but not verified end-to-end)
- Second-chance payment email
- Vault / stored cards
- Mollie Components (hosted card fields) — opt-in per store via admin
- Payment-link generation from admin
- Shipment push to Mollie (Orders API)

Acknowledgements
----------------

[](#acknowledgements)

Architecture and feature set informed by the official [mollie/magento2](https://github.com/mollie/magento2) module by Magmodules (OSL-3.0). This module is an independent Maho implementation; no code is copied, but the integration shape and feature surface follow the upstream as a reference.

License
-------

[](#license)

This module is licensed under the [Open Software License v3.0](LICENSE.txt).

Links
-----

[](#links)

- [Maho Commerce](https://mahocommerce.com)
- [Mollie](https://www.mollie.com)
- [Mollie API documentation](https://docs.mollie.com/)
- [Mollie Magento 2 module (reference for business logic)](https://github.com/mollie/magento2)

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance97

Actively maintained with recent releases

Popularity5

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity40

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 90.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

20d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/262e16fb4a6bbef60ac0fd0172f5586e2c24effcc80a2138e662fb0316083c4c?d=identicon)[fballiano](/maintainers/fballiano)

---

Top Contributors

[![fballiano](https://avatars.githubusercontent.com/u/909743?v=4)](https://github.com/fballiano "fballiano (29 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)")[![maho-organization-controller[bot]](https://avatars.githubusercontent.com/u/176492716?v=4)](https://github.com/maho-organization-controller[bot] "maho-organization-controller[bot] (1 commits)")

---

Tags

ecommercemahomaho-modulemolliepayment-integrationphp

###  Code Quality

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/mahocommerce-module-mollie/health.svg)

```
[![Health](https://phpackages.com/badges/mahocommerce-module-mollie/health.svg)](https://phpackages.com/packages/mahocommerce-module-mollie)
```

###  Alternatives

[duncanmcclean/statamic-cargo

Comprehensive e-commerce addon for Statamic. Build bespoke e-commerce sites without the complexity.

3310.1k](/packages/duncanmcclean-statamic-cargo)[mollie/laravel-cashier-mollie

Laravel Cashier provides an expressive, fluent interface to Mollie's subscription billing services.

173185.5k1](/packages/mollie-laravel-cashier-mollie)[duncanmcclean/simple-commerce

A simple, yet powerful e-commerce addon for Statamic.

16214.1k2](/packages/duncanmcclean-simple-commerce)[tastyigniter/ti-ext-payregister

Allows you to accept credit card payments using PayPal, Stripe, Authorize.Net and/or Mollie.

1016.7k6](/packages/tastyigniter-ti-ext-payregister)[taronyuu/nova-mollie-tool

Simple tool for Laravel Nova to show your transactions from Mollie

104.6k](/packages/taronyuu-nova-mollie-tool)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
