Mollie

Guided tour available

The guided tour Mollie settings is available for the Mollie menu. The tour shows you the most important functions step by step.
You can find the tour in the bottom left corner of the Setup » Orders » Payment » Mollie menu. Click on rocket_launch Guided tours to start the tour.

With the Mollie plugin, you integrate the Mollie payment methods in your online shop and make them available to your customers. To do so, download the Mollie plugin from the plentyMarketplace. Setup of the payment method is done in the Mollie UI.
The explanations in this section apply after adding the plugin. You can find more information on adding and installing plugins in the Plugins section of the manual.

1. Requirement: Registering with Mollie

To use Mollie, you need a Mollie account and the login data. Without these, the plugin cannot be set up and is not usable. If you don’t have a Mollie account yet, register first .

Currencies supported by Mollie

There are some parameters set by payment providers, among them usually also supported currencies. Which currencies are supported by Mollie can be found in the Mollie documentation on the page Multicurrency.

2. Setup from plugin version 2.10.0

With the update to plugin version 2.100, the payment provider Mollie is integrated into the UI. You can find the settings under Setup » Orders » Payment » Mollie.
An assistant will no longer be available. Instead, use the guided setup that you see under the menu item or these instructions.

Account settings:

  1. Open the Setup » Orders » Payment » Mollie menu.

  2. Click on Add account (add). → A pop-up window will open.

  3. Decide here whether you want to add a ‘productive’ account or a test account. This depends on the type of API key you have received from Mollie.

  4. Enter a name for your account. This is freely selectable and serves to make it easier for you to organise your accounts.

  5. Enter the API key that you received from Mollie.

  6. Save (save) the settings.

  7. Now click on the line of the account you just added to open the account settings.

  8. Add a configuration: Create a new combination of client and plugin set. Each combination can only be used once. A pop-up window opens. → A pop-up window will open.

  9. Select a client and a plugin set from those you have already created in your system.

  10. Save your selection.

Once you have saved your configuration, further settings will appear.

General settings:

  1. Decide whether you want to allow Mollie Components, order notes and the activation of immediate payment verification in the checkout and activate or deactivate the toggle accordingly.

  2. Next, select the payment methods. Here, too, there is a toggle that can be displayed in three different states: Blue - activated, grey - deactivated, or greyed out with no toggle - means that the payment method is not activated in Plenty and you cannot select it here.

If you click on the line of one of the payment methods, you will see the payment method settings on the right-hand side.

Payment method settings:

  1. Select the delivery countries for each payment method, decide the minimum and maximum amount that should be required for the payment method, determine a flat-rate payment method surcharge if required and the position of the payment method in the checkout. If you enter a 1 here, for example, the payment method will appear first for the customer in the checkout.

  2. Save (save) the settings.

Plugin versions before 2.10.0: Completing the assistant

Unresolved include directive in modules/payment/pages/mollie.adoc - include::_includes:partial$assistant-payment-processing.adoc[]

Completing the assistant again

In some cases, you have to complete the assistant again. If you deactivate a Mollie payment method, which is activated in your PlentyONE system, directly via the dashboard in your Mollie account after you have already completed the assistant, you have to complete it again. If you run it again, the settings will match and cannot lead to a misconfiguration.

Single-click payments
With the function Single-click payments, your customers can save their credit card details directly with Mollie by creating a Mollie customer account. This way, they don’t have to enter their payment details every time they buy something and payment processing is faster. If you want to make this function available to your customers, you have to activate it in the assistant.
If you have activated Single-click payments, you can see which of your customers use this function. In this case, a unique ID assigned by Mollie is saved in the corresponding contact data record in PlentyONE. In addition, the customers who use Single-click payments are also listed in your Mollie account.

Enable immediate payment response validation
In the “General settings” step, you will find the option “Activate immediate validation of the payment response”.
The default setting of the toggle is deactivated.
If it is activated, the payment response is checked in the checkout. If the response sends a payment status such as “Open”, “Paid” or “Approved”, an order is created in Plenty after the Mollie process is completed. In case of any other payment status, the customer will be redirected to the checkout page to continue with the checkout process without an order being created in Plenty.

Note that this does not apply to the credit card payment method if the Mollie Components are activated.

Only when using a payment method for several clients: Complete assistant several times

Depending on the configuration of your plugin sets and clients, the Mollie assistant has to be completed more than once. Only this ensures that the Mollie payment methods are configured correctly and all functions such as event procedures and crons run smoothly in the background.

The following tables show you which assistants you have to complete in which plugin set. The upper row displays the configuration of the plugin sets and clients. The second row lists correspondingly, in which set the Mollie assistant has to be completed for which client.

Important: The examples are not about either or. The assistant has to be completed several times for multi-clients because it always also has to be completed in the plugin set which is linked with the main client.

Example 1:

Your plugin sets and clients:

Plugin set 1 is linked with the main client

Plugin set 2 is linked with multi-client 1

Plugin set 3 is linked with multi-client 2

Complete the assistant:

Complete the Mollie assistant in this plugin set for all the clients. This means for the main client, for multi-client 1 and for multi-client 2.

Complete the Mollie assistant in this plugin set for multi-client 1.

Complete the Mollie assistant in this plugin set for multi-client 2.

Example 2:

Your plugin sets and clients:

Plugin set 1 is linked with the main client

Plugin set 2 is linked with multi-client 1 and multi-client 2

Complete the assistant:

Complete the Mollie assistant in this plugin set for all the clients. This means for the main client, for multi-client 1 and for multi-client 2.

Complete the Mollie assistant in this plugin set for multi-client 1 and for multi-client 2.

Example 3:

Your plugin sets and clients:

Plugin set 1 is linked with the main client and to multi-client 1

Plugin set 2 is linked with multi-client 2

Complete the assistant:

Complete the Mollie assistant in this plugin set for all the clients. This means for the main client, for multi-client 1 and for multi-client 2.

Complete the Mollie assistant in this plugin set for multi-client 2.

Example 4:

Your plugin sets and clients:

Plugin set 1 is linked with the main client, with multi-client 1 and with multi-client 2

Complete the assistant:

Complete the Mollie assistant in this plugin set for all the clients. This means for the main client, for multi-client 1 and for multi-client 2.

3. Linking template containers

The containers needed by default on your online shop are automatically linked during setup with the Mollie assistant.

4. Customer classes and shipping profiles

Make sure the payment method is allowed in the customer classes and is not deactivated in the shipping profiles. For this, you should consider first for which customer classes and shipping profiles the payment method should be allowed. This can be set individually.

Permitting the payment method in a customer class:

  1. Go to Setup » CRM » Customer classes.

  2. Open the customer class for which you want to permit the payment method.

  3. Select the payment method from the list Permitted payment methods.

  4. Save (save) the settings.

  5. If needed, repeat these steps for other customer classes as well.

Checking payment method in existing shipping profiles:

  1. Go to Setup » Orders » Shipping » Settings.

  2. Click on the Shipping profiles tab.

  3. Open the shipping profile in which the payment method should be allowed.

  4. Check whether the payment method is selected in the Blocked payment methods area.

  5. Deselect the payment method if you want to allow it for this shipping profile.

  6. Save (save) the settings.

  7. If needed, repeat these steps for shipping profiles as well.

5. Setting up event procedures

Event procedures are part of automations you can set up in PlentyONE. When you use event procedures, a specific event triggers an action for a selection of orders. For further information, refer to the Event procedures page of the manual.

In connection to payment providers such as Mollie, event procedures are also used to transmit important information to the payment provider. Regarding Mollie, there are three necessary and a few optional event procedures. The necessary event procedures should be set up in any case. These are registering the shipment of the order items of an order, registering the cancellation of an order and when a refund is created. Mollie needs to be informed if these are initiated. If a set up event procedure is triggered, the corresponding call is directly executed in the background so that Mollie is informed within a very short time.
Optional event procedures are available to you next to these three necessary ones. You can use these if they fit into your individual workflow.

In the following chapters, an example configuration and an explanation to each event procedure are given. But it is important to configure every event procedure so that it meets your individual requirements.

5.1. Registering shipment with Mollie

Use this event procedure to inform Mollie when you shipped an order that was paid with a Mollie payment method. This is a necessary event procedure.
This event procedure can also be used for delivery orders. The delivery order is then registered with Mollie as a partial shipment.

Setting up an event procedure

  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The Create new event procedure window opens.

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 1.

  5. Save () the settings.

  6. Carry out the additional settings according to Table 1.

  7. Select the setting Active ().

  8. Save () the settings.

Table 1. Event procedure: “Mollie | Register shipment”
Setting Option Selection

Event

Select the event that is to trigger informing Mollie about the shipment, e.g. Outgoing items booked.

Filter 1

Order > Payment method

Select the Mollie payment methods you are using from the list.

Procedure

Plugin > Mollie - Register shipment

5.2. Registering cancellations with Mollie

Use this event procedure to inform Mollie about the cancellation of an order. This is a necessary event procedure.
Note that an order cannot be cancelled as long as a payment is pending. The expiry times for the different payment methods are determined by Mollie and can be found on this page.

Setting up an event procedure

  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The Create new event procedure window opens.

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 2.

  5. Save () the settings.

  6. Carry out the additional settings according to Table 2.

  7. Select the setting Active ().

  8. Save () the settings.

Table 2. Event procedure: “Mollie | Register cancellation”
Setting Option Selection

Event

Select the event that is to trigger informing Mollie about the cancellation, e.g. Status change.

If you selected Status change, then select the order status you are using for cancelled orders from the drop-down list. By default, these are 8 - Cancelled and 8.1 - Cancelled by customer.

Filter 1

Order > Payment method

Select the Mollie payment methods you are using from the list.

Procedure

Plugin > Mollie - Register cancellation

5.3. Registering refunds with Mollie

Use this event procedure to inform Mollie about the creation of a credit note. This is a necessary event procedure. The procedure Mollie | Register refund can be executed based on an order or a credit note order.
Make sure that the order items which are to be refunded are contained in the credit note order. You can find more information about credit note orders in general in the chapter Order type: Credit note of the manual.

Setting up an event procedure

  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The Create new event procedure window opens.

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 3.

  5. Save () the settings.

  6. Carry out the additional settings according to Table 3.

  7. Select the setting Active ().

  8. Save () the settings.

Table 3. Event procedure: "Mollie | Register refund”
Setting Option Selection

Event

Select the event that is to trigger informing Mollie about the refund, e.g. New credit note.

Filter 1

Order > Payment method

Select the Mollie payment methods you are using from the list.

Procedure

Plugin > Mollie - Register refund

5.4. Refund failed or successful

Following the procedure Mollie | Register refund, two additional events are available to illustrate the further process of the order: Mollie refund failed and Mollie refund successful. These are two optional event procedures that can help you with the further order processing.

  • Mollie | Refund failed = Determine what should happen with those orders for which a refund could not be executed.

  • Mollie | Refund successful = Determine what should happen with those orders for which a refund could be executed.

You can optionally create event procedures with these events to define how to proceed with these orders. The following event procedure is an example. You decide which process fits best into your workflow of order processing.

Setting up an event procedure

  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The Create new event procedure window opens.

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 4.

  5. Save () the settings.

  6. Carry out the additional settings according to Table 4.

  7. Select the setting Active ().

  8. Save () the settings.

Table 4. Event procedures “Mollie | Refund failed” and “Mollie | Refund successful”
Setting Option Selection

Event

Mollie - Refund failed

Filter 1

Order > Payment method

Select the Mollie payment methods you are using from the list.

Procedure

Order > Change status

Select the order status from the drop-down list that should be assigned to orders with Mollie payment methods for which an error occurred in the refund process. For example, you could create an own order status for this. This way, you detect the orders which require further processing faster.

5.5. Shipment failed or successful

Following the procedure Mollie | Register shipment, two additional events are available to illustrate the further process of the order: Mollie | Shipment failed and Mollie | Shipment successful. These are two optional event procedures that can help you with the further order processing.

  • Mollie | Shipment failed = Determine what should happen with those orders for which the shipment could not be registered with Mollie.

  • Mollie | Shipment successful = Determine what should happen with those orders for which the shipment could be registered with Mollie.

You can optionally create event procedures with these events to define how to proceed with these orders. The following event procedure is an example. You decide which process fits best into your workflow of order processing.

Setting up an event procedure

  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The Create new event procedure window opens.

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 5.

  5. Save () the settings.

  6. Carry out the additional settings according to Table 5.

  7. Select the setting Active ().

  8. Save () the settings.

Table 5. Event procedures “Mollie | Shipment failed” and “Mollie | Shipment successful”
Setting Option Selection

Event

Mollie - Shipment failed

Filter 1

Order > Payment method

Select the Mollie payment methods you are using from the list.

Procedure

Order > Change status

Select the order status from the drop-down list that should be assigned to orders with Mollie payment methods for which the shipment could not be registered with Mollie. For example, you could create an own order status for this. This way, you detect the orders which require further processing faster.

5.6. Payment failed

In addition, the event Mollie | Payment failed is also available. Using this event is optional. You can use it to determine what should happen with those orders for which the payment has failed.
This event takes effect if a payment fails directly after order creation. This could happen, for example, when an order cannot be retrieved from Mollie, the session was deleted or Mollie has a global problem. So, whenever a payment has failed for technical reasons, has been cancelled, or has expired, but not when a card has expired or been declined.

You can optionally create event procedures with this event to define how to proceed with these orders. The following event procedure is an example. You decide which process fits best into your workflow of order processing.

Setting up an event procedure

  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The Create new event procedure window opens.

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 6.

  5. Save () the settings.

  6. Carry out the additional settings according to Table 6.

  7. Select the setting Active ().

  8. Save () the settings.

Table 6. Event procedure “Mollie | Payment failed”
Setting Option Selection

Event

Mollie - Payment failed

Filter 1

Order > Payment method

Select the Mollie payment methods you are using from the list.

Procedure

Order > Change flag

Select the flag from the drop-down list that should be assigned to the orders with Mollie payment methods, for which a payment failed. This way, you detect the orders which require further processing faster.

6. Editing text elements

You can edit texts of the plugin in the Shop » Multilingualism menu. The texts can be adapted into all available system languages. To do so, proceed as described below.

Adapting language files:

  1. Go to Shop » Multilingualism.

  2. On the left side, select the Source language from the drop-down list.

  3. On the right side, select the Target language from the drop-down list.

  4. Expand the sections PaymentMethods and UI in the Mollie area.

  5. Enter the text for the individual text elements in the area of the target language.

  6. Save (save) the settings.

  7. Deploy the plugin set again to apply these changes.

By selecting German as the Target language, you can adapt the German labels for your online shop. The selected labels are then also applied in the back end, only the addition Plugin: Mollie remains. This way, it remains traceable where a payment method comes from. Reload the back end to see the changes.

Find more information on how to edit online shop texts on the manual page Editing online store texts.