mahocommerce/module-mollie

Mollie payment gateway integration for Maho

Maintainers

Package info

github.com/MahoCommerce/module-mollie

Type:maho-module

pkg:composer/mahocommerce/module-mollie

Fund package maintenance!

fballiano

Buy Me A Coffee

paypal.me/fabrizioballiano

Statistics

Installs: 0

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

dev-main 2026-04-21 17:43 UTC

Requires

Requires (Dev)

OSL-3.0, AFL-3.0 ca8893bea7824690f5f4174b5cd72736eab84bcf

This package is auto-updated.

Last update: 2026-04-21 17:43:56 UTC

README

License PHP Maho Commerce

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.

Requirements

  • PHP >= 8.3
  • Maho Commerce
  • A Mollie merchant account

Installation

composer require mahocommerce/module-mollie

Clear the cache after installation:

./maho cache:flush

Configuration

Navigate to System > Configuration > Payment Methods in the Maho admin panel.

General Settings (Mollie - General Settings)

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.

Order statuses (Mollie - Order Statuses)

Configurable codes applied when Mollie reports pending / paid, with optional per-method overrides on each method group.

Payment fee (Mollie - Payment Fee)

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.

Method-specific groups

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.

Roadmap

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

  • 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)

Features

  • 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)

Acknowledgements

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.

License

This module is licensed under the Open Software License v3.0.

Links