Skip to main content

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 of the payment method is done with an assistant. You also have to carry out a few basic settings in your plentymarkets system so that the payment method is activated in your system.
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. Completing the assistant

After you have installed the plugin the corresponding assistant is available. Proceed as follows to complete the assistant and thus set up the payment method.

Setting up a payment method:

  1. Go to Setup » Assistants » Plugins » [select Plugin set].

  2. Select the assistant Mollie.

  3. Complete the assistant.

The payment method {name-payment-method} is available in your online shop.

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 plentymarkets 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 plentymarkets. In addition, the customers who use Single-click payments are also listed in your Mollie account.

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 {name-payment-method} 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. In case you want to link containers manually, proceed as follows.

Setting up container links:

  1. Go to Plugins » Plugin set overview.

  2. Open the plugin set you want to edit.

  3. Open the plugin Mollie.

  4. Open the Container links.

  5. Select one or more containers in which the previously selected content is to be displayed.
    Pay attention to the explanations given in Table 1.

  6. Save () the settings.
    → The content is linked to the containers.

Table 1. Linking template containers
Content Explanation

Payment button (Mollie)

The containers Order confirmation: Additional payment information and My account: Additional payment information have to be linked to display the payment Mollie payment button in the checkout.

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 () 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 () 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 plentymarkets. 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 2.

  5. Save () the settings.

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

  7. Activate the option 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 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 3.

  5. Save () the settings.

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

  7. Activate the option Active ().

  8. Save () the settings.

Table 3. 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 Working with credit note orders 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 4.

  5. Save () the settings.

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

  7. Activate the option 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 5.

  5. Save () the settings.

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

  7. Activate the option 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 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 6.

  5. Save () the settings.

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

  7. Activate the option 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 failed, was cancelled or is expired.

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 7.

  5. Save () the settings.

  6. Carry out the further settings according to Table 7.

  7. Activate the option 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 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 CMS » 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 CMS » 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 messages and payment methods in the Mollie area.

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

  6. 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.

To top