Prerequisites
- A Mollie account at mollie.com
- Commerce accessible over a publicly reachable HTTPS URL (required for Mollie webhooks)
Configuration
Go to Admin → Settings → Payment Gateways → Mollie and fill in:
| Field | Notes |
|---|---|
| API Key | Your Mollie API key. Starts with live_ for production or test_ for testing. |
Click Save and enable the Mollie toggle.
[!TIP] Mollie determines whether to use live or test mode from the key prefix — there is no separate sandbox toggle in Commerce. Use
test_...while setting up and switch tolive_...when ready to go live.
Getting Your API Key
- Log in to the Mollie Dashboard
- Go to Developers → API keys
- Copy either the Live API key (
live_...) or Test API key (test_...)
[!WARNING] Do not share your API key or commit it to version control. If a key is compromised, regenerate it immediately in the Mollie Dashboard and update Commerce.
Webhook Setup
No manual webhook registration is required for Mollie. Commerce automatically includes the webhook URL in every payment request it sends to Mollie:
https://yourdomain.com/webhooks/mollie
Mollie calls this URL when a payment status changes. Commerce then fetches the payment status from the Mollie API to confirm the result and marks the invoice accordingly.
[!IMPORTANT] Your Commerce installation must be reachable from the internet at the time Mollie fires the webhook. If your server is behind a firewall or only accessible locally, Mollie cannot reach the webhook and invoices will not be marked paid automatically.
How Mollie Payments Work
Mollie uses a redirect flow:
- Client selects Mollie on the payment page and chooses a payment method (e.g. iDEAL, credit card)
- Client is redirected to Mollie's hosted checkout page
- Client completes payment (bank authorisation for iDEAL, card entry for credit card, etc.)
- Client is redirected back to Commerce (success or cancel page)
- Mollie fires a webhook to
https://yourdomain.com/webhooks/mollie - Commerce fetches the payment status from the Mollie API
- If the status is
paid, Commerce marks the invoice paid and sends the receipt email
[!TIP] The invoice is marked paid via the webhook, not the redirect. This means the invoice is marked paid even if the client closes the tab after payment and never returns to the success page.
Supported Payment Methods
Mollie supports multiple payment methods depending on your Mollie account and region. Common methods available:
| Method | Region |
|---|---|
| iDEAL | Netherlands |
| Credit card (Visa, Mastercard) | Worldwide |
| SEPA Direct Debit | Europe |
| Bancontact | Belgium |
| SOFORT | Germany, Austria |
| Klarna | Multiple |
| Apple Pay | Worldwide |
Mollie automatically shows only the methods available for the client's country and your Mollie account settings. You do not configure this in Commerce.
Refunds
Mollie refunds are processed via the Mollie API through Commerce's refund interface (Admin → Invoice → Payments → Refund). Partial and full refunds are supported. The refund typically reaches the client within 1–5 business days depending on the payment method.
Test Mode
When using a test_ API key:
- Use Mollie's test payment page (automatically shown for test keys)
- Select any payment method and confirm the test payment
- Mollie fires the webhook to your server as normal
Test payments appear in the Mollie Dashboard under Test mode.