Integrating Mollie
Auth: API key · Partner program: not required · Setup time: about 5 minutes · Last verified: 2026-05-15
European multi-method gateway — iDEAL, Bancontact, SEPA, plus the usual card brands. Full canonical surface including mandates and chargebacks.
Auth model
Section titled “Auth model”api_key. Submit a live key (live_…) or test key (test_…) via the Connect Link form. The adapter sets Authorization: Bearer <key> on every request.
Configure in admin
Section titled “Configure in admin”- Sign in at https://www.mollie.com/dashboard/.
- Go to Developers → API keys, copy the live or test key.
- Open
/platforms→ Payments → Mollie → Configure and submit:apiKey
Webhooks
Section titled “Webhooks”Mollie uses per-payment webhook URLs — set the webhookUrl field on every POST /v2/payments to https://${PUBLIC_BASE_URL}/webhooks/mollie. The adapter looks up the payment by ID on receipt and re-fetches the canonical record.
There is no separate signing secret on Mollie — verification works by hitting the API with the same key, fetching the resource, and trusting the upstream record. Keep the webhook URL behind a hard-to-guess subpath if you want stronger isolation.
Quirks
Section titled “Quirks”- Decimal money + per-currency normalisation. Mollie returns
{"value": "10.50", "currency": "EUR"}in major units; the adapter multiplies by 100 + rounds to minor units. Watch JPY (amount.value: "150"already in whole yen). - Recurring is mandate-driven. Customers must have a
Mandatebefore subscriptions can be created. The adapter surfaces them through thePaymentMethodresource (type: 'mandate'). - No native Plan resource. Subscription
amount,interval, anddescriptionlive inline on eachSubscription. - Disputes are called “chargebacks” at the API layer. The adapter normalises them to the canonical
Disputeresource.
References
Section titled “References”opensteward.dev ·Plans and free license ·Terms ·Privacy ·support@opensteward.dev
© 2026 Falco Consulting AB. Built from open-steward/opensteward@a3961d8. This site sets no cookies, runs no analytics and loads nothing from other sites, except platform logos from Brandfetch on the Platforms page.