@gorgo/medusa-payment-mollie
v2.1.0
Published
Mollie payment provider for Medusa
Maintainers
Readme
Plugin Features
- Full Integration with Mollie: Connect your store to Mollie and accept payments on Mollie's hosted payment page.
- Every Payment Method of Your Profile: The buyer picks a card, iDEAL, Bancontact, PayPal or any other method you enabled in Mollie, with no code per method.
- One-Step & Two-Step Payments: Autocapture or authorization/hold payment flows.
- Refunds & Cancellations: Full and partial refunds, cancellation of open payments and release of held amounts.
- Webhook Notifications: The order is placed once Mollie reports the payment as paid, even if the buyer never returns to the store. The plugin reads every notification back from Mollie, so a forged one changes nothing.
- Detailed Logging: Request and response logs for debugging and support in development mode.
- Full Test Coverage: Comprehensive unit and integration tests covering core flows and edge cases.
- Storefront Example: A complete Next.js storefront ready to use as a reference.
- Integration module : Configure this plugin directly in the Medusa Admin application – no editing configuration files or redeploying the store.
Integration Module: This plugin supports the Integration module, which lets store administrators configure it directly in the Medusa Admin application instead of editing configuration files and redeploying the store. Sensitive values are encrypted, and settings are validated before they take effect.
What is Mollie
With Mollie, the buyer pays on Mollie's hosted payment page and chooses there among the methods enabled on your website profile, so card details never reach your server. The plugin talks to Mollie through Mollie's official Node SDK, mollie-api-typescript. Mollie's test mode accepts only EUR.
💬 Support & Community
Got questions or ideas about the plugin? Join the Telegram support chat, @gorgojs_chat.
Connect with other Medusa developers on Telegram in @medusajs_chat.
Requirements
- Medusa v2.21.0 or later
- Node.js v22.23.4, v24.22.1, v26.12.1 or later
- A Mollie account and the API key of its website profile, from Developers → API keys in the Mollie Web App
- Integration Module
Installation
yarn add @gorgo/medusa-integration @gorgo/medusa-payment-mollie
# or
npm install @gorgo/medusa-integration @gorgo/medusa-payment-mollieConfiguration
Register the plugin and the Integration Module in medusa-config.ts:
const MOLLIE_INTEGRATION_ID = "mollie-1"
module.exports = defineConfig({
plugins: [
{
resolve: "@gorgo/medusa-integration",
options: {
encryptionKey: process.env.INTEGRATION_ENCRYPTION_KEY,
providers: [
{
resolve: "@gorgo/medusa-payment-mollie/providers/integration-mollie",
id: MOLLIE_INTEGRATION_ID,
options: {},
},
],
},
},
{
resolve: "@gorgo/medusa-payment-mollie",
options: {},
},
],
modules: [
{
resolve: "@medusajs/medusa/payment",
options: {
providers: [
{
resolve: "@gorgo/medusa-payment-mollie/providers/payment-mollie",
id: "mollie",
options: { id: MOLLIE_INTEGRATION_ID },
},
],
},
},
],
})The payment provider registered this way gets the ID pp_mollie_mollie, and its webhook route is /hooks/payment/mollie_mollie.
Set INTEGRATION_ENCRYPTION_KEY to a long random string, for example the output of openssl rand -hex 32. The Integration Module derives the key that encrypts secret settings, such as the API key, from it.
Then restart the server and configure the integration in Medusa Admin under Settings → Integrations → Mollie.
Documentation
The complete installation, configuration, and usage guide for this plugin is available on the Gorgo documentation website.
License
Licensed under the MIT License.
