Mollie

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 is carried out directly within 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 already have an account with Mollie, please register there first.

Currencies supported by Mollie

There are some parameters set by payment providers, among them usually also supported currencies. You can find out which currencies Mollie supports in the Mollie documentation on the Multicurrency page.

2. Setup

With the update to plugin version 2.10.0, the payment provider Mollie has been integrated into the UI. You can find the settings under Setup » Orders » Payment » Payment method settings » Mollie.

Adding a new account:

  1. Open the Setup » Orders » Payment » Payment method settings » 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.

2.1. Account settings

Configuration:

  1. Select an existing configuration from the drop-down list, or

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

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

  4. Save your selection.

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

General settings:

  1. Decide whether you want to allow order notes and activate or deactivate the toggle accordingly.

Payment methods:

  1. 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.
Not all options are available for all payment methods.

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. Decide whether you want to enable Mollie Components, One-click payment and Enable immediate payment response validation, and toggle the switch on or off accordingly.

  3. Save (save) the settings.

Table 1. Options for payment methods
Option Explanation

Mollie Components

With Mollie Components, your customers can enter their credit card details directly during the payment process. This means that they will no longer be redirected to a different page hosted by Mollie at the start of the payment process. You can find more information about Mollie Components on the Mollie website.

One-click payment

With one-click payment, you allow your customers to complete the transaction with just one click, without having to re-enter their payment details.

Enabling immediate payment response validation

If you enable this setting, the system will check for an immediate response from the payment provider: if a payment fails or is declined, no order will be created in Plenty.
Note: This setting does not apply to payments where a response takes a little longer.

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

Unresolved include directive in modules/payment/pages/mollie.adoc - include::_includes:page$kundenklassen-und-versandprofile.adoc[]

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 from PlentyONE 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 must be informed if any of this is put into action. 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-procedure-mollie-transmit-shipment>>.

  5. Save () the settings.

  6. Carry out the additional settings according to <<table-procedure-mollie-transmit-shipment>>.

  7. Select the setting Active ().

  8. Save () the settings.

Table 2. 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 processing times for the various payment methods are specified by Mollie and are listed 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-procedure-mollie-cancellation>>.

  5. Save () the settings.

  6. Carry out the additional settings according to <<table-procedure-mollie-cancellation>>.

  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 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 notify Mollie when a credit note has been created for an order. 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-procedure-mollie-transmit-refunds>>.

  5. Save () the settings.

  6. Carry out the additional settings according to <<table-procedure-mollie-transmit-refunds>>.

  7. Select the setting Active ().

  8. Save () the settings.

Table 4. 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-events-mollie-refunds>>.

  5. Save () the settings.

  6. Carry out the additional settings according to <<table-events-mollie-refunds>>.

  7. Select the setting Active ().

  8. Save () the settings.

Table 5. 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 not 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-events-mollie-shipments>>.

  5. Save () the settings.

  6. Carry out the additional settings according to <<table-events-mollie-shipments>>.

  7. Select the setting Active ().

  8. Save () the settings.

Table 6. 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-event-mollie-failed-payment>>.

  5. Save () the settings.

  6. Carry out the additional settings according to <<table-event-mollie-failed-payment>>.

  7. Select the setting Active ().

  8. Save () the settings.

Table 7. 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 order 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 Mollie 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.