Mollie Plus plugin documentation

Mollie plugin for Craft CMS, official version by WHITE Digital Agency

Back to the Mollie Plus plugin page

Requirements

  • This plugin requires Craft CMS 3.1.5 or later.
  • This plugin requires Craft Commerce version 2.0 or later.
  • A valid Mollie account is required. Don't have an account yet? Create a Mollie account.
  • The Craft website should be publicly accessible.
  • To configure the plugin, changing settings should be allowed in Craft (allow admin changes), and a user who is an Admin in Craft.
  • This plugin is compatible with Composer 2.0.

Installation

To install Mollie Plus plugin for Craft CMS, follow these steps:

  1. Open your terminal and go to your Craft project:
    cd /path/to/project
  2. Then tell Composer to load the plugin:
    composer require white-nl/commerce-mollie-plus
  3. Install the plugin via ./craft plugin/install commerce-mollie-plus via the CLI

You can also install the Mollie Plus plugin using the Plugin Store in the Craft Control Panel. Go to Settings → Plugins and click the “Install” button for Commerce Mollie Plus.

"Mollie Plus" versus "Mollie for Craft Commerce"

Mollie plus is a drop-in replacement* for Pixel & Tonic’s Mollie for Commerce plugin. We advise to replace it by Mollie Plus. It will be a seamless transition, since they function similarly.

* The plugin will run completely independently from the Mollie plugin. You even can run both plugins at the same time.

Setup

To add a Mollie payment gateway

  1. Go to Commerce → System Settings → Gateways
  2. Create a new gateway, and set the gateway type to “Mollie Plus”.
  3. You have to provide a valid API Key to make this plugin work. You can obtain it in your Mollie control panel.

Tip: The API Key setting can be set to environment variables. See Environmental Configuration in the Craft docs to learn more about that.

Screenshot 1 General Mollie Plus Settings

Order status to automatically capture payments

When a Craft order status changes to one of defined statuses, any uncaptured Mollie transactions associated with it are going to be captured automatically.

Screenshot 2 Order status Mollie Plus Settings

Add Klarna

To offer Klarna in your checkout, there are no extra plugin settings required. However, make sure you have submitted a request for the Klarna payment methods via the Mollie Control panel.

Mollie Plus supports three Klarna payment methods additionally:

  • Klarna Pay Later
  • Klarna Slice it
  • Klarna Pay Now

Front-end customization

An example payment method selection form comes with the install of the plugin, but can be adjusted to your needs. You can add custom styling, display icons and run custom code.

Troubleshooting

All responses from Mollie are captured in the transaction list of the order, similar to the original Mollie plugin.

Screenshot 4 Troubleshooting Mollie Plus Settings

Limited support for refunding of Klarna transactions

Refunding payments via Craft works via the Mollie Payment API, whilst transactions are created via the Orders API. Refunding of arbitrary amounts via Craft control panel for Klarna transactions, may result in unexpected behaviour. We recommend using the Mollie control panel to refund specific lines of an order.

No support for vouchers

Mollie voucher services are not supported by this plugin.

Top