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  .

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 Mollie 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 set 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 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

Proceed as follows to set 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 information provided 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

To send all the necessary data to Mollie, 3 separate event procedures are needed. These events are the shipping of the order items, cancellations of orders and the creation of refunds. Mollie needs to be informed if any of these are initiated. Proceed as described in the next chapters to set up the event procedures.

Additionally to the three necessary event procedures Registering shipment, Registering cancellation and Registering refund, which are used to send important data to Mollie, the event Mollie | Payment failed is also available for use. It is an optional event, though. You could use it to determine how orders for which payments are failed are to be handled.

5.1. Registering shipment with Mollie

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 to trigger a shipment.

Filter 1

Order > Payment method

Plugin: Mollie:*

Procedure

Plugin > Mollie:

Register shipment

This event procedure can also be used for delivery orders. The delivery order is then registered with Mollie as a partial shipment.

5.2. Registering cancellations with Mollie

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 to trigger a shipment.

Filter 1

Order > Payment method

Plugin: Mollie:*

Procedure

Plugin > Mollie

Register cancellation

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 .

5.3. Registering refunds with Mollie

If you create a credit note order for an order which was paid with Mollie, Mollie has to be informed about this. 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.

E-Mail-Versand

We recommend to connect the registration of a refund with the status change of an order as an event.

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 to trigger a shipment.

Filter 1

Order > Payment method

Plugin: Mollie:*

Procedure

Plugin > Mollie

Register refund

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. You can optionally set up event procedures with these events in the same way as described above.

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.

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

To top