Mollie payment gateway integration for Maho Commerce.
Accept payments through Mollie, 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. Core payment flow (create → redirect → webhook → return → cron) is implemented against the Mollie Payments API, including online refunds, admin-configurable order statuses, and a configurable payment fee. 16 payment methods ship out of the box with translations for Dutch, German, French, Italian, and Spanish. End-to-end checkout has not yet been verified against a live Mollie sandbox — expect rough edges. The Orders API (required for full Klarna line-item detail) and Apple Pay express checkout are not yet implemented.
- PHP >= 8.3
- Maho Commerce
- A Mollie merchant account
composer require mahocommerce/module-mollieClear the cache after installation:
./maho cache:flushNavigate to System > Configuration > Payment Methods in the Maho admin panel.
| Setting | Description | Default |
|---|---|---|
| Test Mode | Use the Mollie test API key to process mock payments | Yes |
| 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 |
No |
Find your API keys in the Mollie dashboard under Developers.
Configurable codes applied when Mollie reports pending / paid, with optional per-method overrides on each method group.
Optional surcharge added to the order grand total when the customer picks a fee-enabled Mollie method. Supports fixed, percent, or combined fees, with per-method opt-in.
Each of the 16 bundled methods (iDEAL, Bancontact, Credit Card, PayPal, Klarna Pay Later / Pay Now / Slice It, Apple Pay, Bank Transfer, SEPA Direct Debit, Gift Card, iDEAL in3, Riverty, Google Pay, Trustly) has its own admin group with the usual active / title / country / sort-order controls plus optional status and fee overrides.
- 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)
- iDEAL
- Credit card (redirect; components / hosted fields not yet)
- Bancontact
- PayPal
- Klarna Pay Later (Payments API — Orders API pending for line items)
- Klarna Pay Now (Payments API — Orders API pending)
- Klarna Slice It (Payments API — Orders API pending)
- Apple Pay (redirect — express button pending)
- Bank Transfer
- SEPA Direct Debit
- Gift Card
- iDEAL in3
- Riverty (redirect — full line-item detail pending Orders API)
- Google Pay
- Trustly
- SOFORT Banking
- Przelewy24
- KBC / Belfius / EPS / Voucher / ... (long tail)
- Full + partial refunds from admin (online refunds via Mollie API)
- Webhook-driven payment status reconciliation
- Cron-based safety net for missed webhooks
- Admin-configurable pending / processing order statuses (global + per-method override)
- Payment fee (fixed / percent / combined, per-method opt-in)
- External-refund and chargeback reconciliation (creditmemo from Mollie dashboard refunds; chargeback order comments)
- Multi-store API key scoping
- Admin "Test API Key" button (one-click connectivity check)
- Debug logging toggle (gates info-level entries in
mollie.log) - Translations for Dutch, German, French, Italian, and Spanish
- Multi-currency support (code paths present but not verified end-to-end)
- Second-chance payment email
- Vault / stored cards
- Mollie Components (hosted card fields)
- Payment-link generation from admin
- Shipment push to Mollie (Orders API)
- Tax on the payment fee (fee_tax_class is stored but not yet applied by a tax collector)
Architecture and feature set informed by the official 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.
This module is licensed under the Open Software License v3.0.
