Mollie Integration Guide for Shopware 6

1. Introduction

This comprehensive guide provides a step-by-step walkthrough for integrating Mollie, a leading payment provider, into your Shopware 6 eCommerce store. Mollie is a trusted and widely adopted payment platform across Europe, offering seamless support for a diverse range of local and international payment methods, such as iDEAL, Bancontact, Klarna, credit cards, PayPal, SEPA Direct Debit, and many others. Its flexibility and ease of use make it an ideal choice for merchants aiming to enhance their checkout process and cater to a global customer base.

Whether you’re a store owner managing your Shopware platform, a developer handling technical integrations, or a Shopware agency setting up solutions for clients, this guide will walk you through the entire process of installing, configuring, and testing the Mollie plugin. By following these steps, you’ll ensure a smooth, secure, and efficient checkout experience for your customers, ultimately boosting conversions and customer satisfaction.

This guide covers everything from the initial setup and configuration to testing and troubleshooting, ensuring that your Mollie integration is robust and reliable. By the end, you’ll have a fully functional payment system tailored to your store’s needs, with best practices for security and performance.

2. What is Mollie?

🔹 Overview

Mollie is a Dutch-based payment service provider (PSP) designed to simplify the integration of multiple payment methods into eCommerce platforms. With a single, streamlined integration, Mollie enables merchants to offer a variety of payment options tailored to different markets. Serving over 130,000 businesses across Europe, Mollie is known for its fast-onboarding process, transparent pricing model, and extensive support for localized payment methods, making it a top choice for businesses operating in the European market.

Mollie’s platform is built with developers in mind, offering robust APIs, detailed documentation, and a user-friendly dashboard. This allows businesses to customize their payment flows while maintaining a high level of security and reliability. Whether you’re a small startup or a large enterprise, Mollie’s solutions scale to meet your needs.

🔹 Benefits for Online Stores

• Supports 25+ payment methods out of the box: From credit cards to local favorites like iDEAL and Bancontact, Mollie covers a wide range of payment options, ensuring customers can pay using their preferred method.
• Trusted in EU markets: Mollie is particularly popular in the Netherlands, Germany, Belgium, and France, where it supports region-specific payment methods that resonate with local customers.
• Fast and secure payments: Mollie is PCI-DSS compliant, ensuring that all transactions meet the highest security standards for cardholder data protection.
• Easy refunds, recurring payments, and partial captures: Mollie simplifies complex payment processes, allowing merchants to manage refunds, subscriptions, and partial payments effortlessly.
• Built-in fraud detection and monitoring tools: Mollie’s advanced fraud prevention systems help protect your business from fraudulent transactions.
• Transparent fee structure: With no hidden costs, Mollie provides clear pricing, making it easier to manage transaction costs and plan your budget.

🔹 Mollie for Shopware

Mollie offers a dedicated plugin for Shopware 6, officially named “Mollie Payments for Shopware 6.” This plugin is regularly updated to ensure compatibility with the latest Shopware versions and includes robust documentation to assist with setup. Key features of the plugin include:

• One-click checkout: Streamlines the payment process for returning customers, improving conversion rates.
• Custom payment method display: Allows you to customize how payment methods appear in the checkout process for a branded experience.
• Webhook support: Ensures real-time updates for payment status, keeping your store and Mollie in sync.
• Multilingual support: Enables seamless payment experiences for customers in different languages and regions.
• Advanced order syncing: Automatically syncs order data between Shopware and Mollie, reducing manual work and errors.

3. Requirements

Before integrating Mollie into your Shopware 6 store, ensure that your setup meets the following technical and account-related requirements.

🔸 Technical Prerequisites

• Shopware Version: 6.4.0 or higher.
• PHP Version: 7.4 or above.
• Web Server: Apache or NGINX with HTTPS enabled.
• MySQL 5.7+ or MariaDB 10.3+.
• Composer installed on your server (for CLI installation).

🔸 Mollie Account

• A Mollie Business Account (sign up at https://www.mollie.com/).
• Live and Test API Keys from the Mollie Dashboard.

4. Installing the Mollie Plugin

There are two methods to install the Mollie plugin.

🔸 Option 1: Shopware Admin Panel

1. Log into your Shopware 6 Admin Panel.
2. Navigate to Extensions → Store.
3. Search for “Mollie Payments.”
4. Click Install, then Activate.

🔸 Option 2: CLI via Composer

cd /path/to/your/shopware
composer require mollie/shopware6-plugin
bin/console plugin:refresh
bin/console plugin:install --activate MolliePayments
bin/console cache:clear

5. Configuring the Mollie Plugin

🔸 Access the Plugin Settings

1. In Shopware Admin, go to Settings → Plugins → Mollie Payments.
2. Click Configure.

🔸 Connecting Your Mollie Account

1. Copy your Live API Key and Test API Key from the Mollie Dashboard.
2. Paste them into the corresponding fields.
3. Enable Test Mode if you wish to simulate transactions.

🔸 Available Payment Methods

• Credit Card
• PayPal
• Klarna Pay Later / Pay Now
• iDEAL
• Apple Pay
• SEPA Direct Debit
• SOFORT
• Bancontact

🔸 Advanced Settings

• Payment Status Mapping: map Mollie statuses to Shopware order statuses.
• Webhook URL: auto-generated for real-time updates.
• Fallback Options: define behavior if Mollie is temporarily unavailable.

6. Testing the Checkout with Mollie

🔸 Enable Sandbox Mode

1. Toggle Test Mode in plugin settings.
2. Enter your Test API Key.

🔸 Performing Test Transactions

1. Add products to cart and proceed to checkout.
2. Select a Mollie test payment method (e.g., Credit Card or iDEAL).
3. Use the test card 4242 4242 4242 4242 with any future expiry date and CVV.

🔸 Validating Transactions

• Check Orders → Overview in Shopware Admin for correct status.
• Enable debug mode to inspect API responses.
• Review transactions in the Mollie Dashboard.

7. Troubleshooting

Problem	Solution
“API key is invalid”	Double-check that you pasted the correct key (test vs. live).
Webhook not triggering	Ensure your store is publicly accessible and not in maintenance mode.
Payment method not showing	Make sure it’s activated in both Mollie Dashboard and the Shopware plugin.
Orders stay in “open” state	Check your webhook logs in the Mollie Dashboard.

Debugging Tools: Shopware logs ( /var/log/ ), Mollie Dashboard webhook logs, and your browser’s Network tab.

8. Go Live: Activating Live Mode

1. Replace the Test API Key with your Live API Key.
2. Disable Test Mode.
3. Perform a small real transaction to confirm everything works.

Final Checklist

• All desired payment methods are enabled and configured.
• Webhooks are functioning correctly.
• Refund and cancellation processes work in both Shopware and the Mollie Dashboard.
• Staff are trained on payment-related tasks in the Mollie Dashboard.

9. Best Practices & Security

• Use HTTPS for the entire store.
• Keep API keys secret and rotate them periodically.
• Monitor orders and logs daily.
• Train staff to process refunds correctly.
• Update the plugin regularly.
• Enable 3-D Secure for credit-card transactions.

10. Frequently Asked Questions (FAQ)

What should I do if Mollie connection fails?
Verify that the API key matches the mode (Test or Live) and check status.mollie.com for outages.

How much does Mollie charge per transaction?
Fees vary by payment method—see Mollie Pricing for current rates.

How are refunds processed?
Refunds can be handled in Shopware Admin (if enabled) or manually in the Mollie Dashboard.

Can I restrict payment methods to specific countries?
Yes—configure availability by country and currency in both Mollie and the plugin.

Is Mollie compatible with Shopware multi-channel setups?
Yes—configure the plugin separately for each sales channel.