Skip to main content

How do I integrate with Mollie?

Team MailBlue avatar
Written by Team MailBlue
Updated this week

The integration between Mollie and MailBlue allows you to build stronger customer relationships and promote engagement by creating marketing campaigns based on activities in Mollie. With 'Custom Objects', you can expand the use of historical customer data and communicate with them throughout the purchase cycle and beyond, to increase conversions, reduce customer churn, and foster brand loyalty.


In this article:


How can I set up the integration with Mollie?

Before you start setting up the integration, make sure you have both a MailBlue account and a Mollie account.

Connect Mollie to MailBlue

  1. Log in to your MailBlue account

  2. Navigate to 'Apps' via the left-hand menu

  3. Search for 'Mollie'

  4. Click on 'Add an account'

  5. Click on the Mollie link next to the 'Token' field to obtain your one-time verification code. If you are already logged in to Mollie, the link will take you directly to the code. Otherwise, follow the steps to log in to Mollie and receive your code

  6. Enter the API key and click 'Connect'

Mollie is now successfully connected to your MailBlue account.

Create automation tags

  1. In the 'Choose Resource' dropdown menu, select a Resource you want to use as an automation trigger. For example, 'Payment'.

  2. In the 'Choose Event Type' dropdown menu, select an Event related to the Resource. For example, 'Paid'.

This action automatically creates a series of tags that you can use to trigger an automation sequence.

Assign the email field

  1. In the dropdown menu under 'Mollie', select the Mollie field you want MailBlue to use as the customer's email address. This choice depends on the Mollie API you are using:

    • Customers API: select the field customer.email.

    • Orders API: select the shipping or billing address email, depending on your preference.

  2. Make sure 'Email' is selected in the corresponding MailBlue field.

  3. If desired, you can click on 'Add field mapping' to link more fields.

  4. Click on 'Finish'

Useful to know: In MailBlue, you can create a custom set of fields for Mollie to capture as much information as possible. This allows you to create powerful, targeted marketing campaigns.

How can I use the integration with Mollie?

Once the integration between Mollie and MailBlue is successfully established, you can start using the new features in your account.

How can I view orders from my contacts?

Within the contact profile of your contacts, you now have access to the Mollie dashboard. Here you can view the following data:

  • Mollie Orders

  • Mollie Payments

  • Mollie Refunds

  • Mollie Subscriptions

Once data is available from your Mollie account, it will be displayed in the highlighted red box.

How can I use Mollie in an automation?

If you want to follow up with customers via email after a purchase, it can be useful to set up an automation for this. Due to the direct integration with Mollie, various start triggers are now available that you can use in your product follow-up funnel. These include the following start triggers:

Mollie Subscription is created

Mollie Subscription is updated

Mollie Order is created

Mollie Order is updated

Mollie Payment is created

Mollie Payment is updated

Mollie Refund is created

Mollie Refund is updated

Depending on the trigger you have selected, you also have the option to customise the trigger.

All Mollie triggers with "Mollie ... is created"

Here you can choose to trigger for all subscriptions / orders / payments / refunds, but you can also choose to segment this audience. In the following example, we take the trigger 'Mollie Payment is created', where the 'Payment Status' is 'failed':

This means that the automation only triggers when a customer's payment fails, and cannot be completed with an alternative payment method.

All Mollie triggers with "Mollie ... is updated"

Here you can choose to include every change in the trigger, but you can also choose to be more precise. In the following example, we take the trigger 'Mollie Order is updated', where the 'Order Status' has been changed to 'shipping':

This means that the automation only triggers when you start shipping an order line, or part of the order line.

What data is passed from Mollie to MailBlue?

To understand what data is passed from the integration with Mollie to MailBlue, it is important to first look at the so-called 'Custom Objects', and what this entails.

Custom Objects allow you to model and manage your data in a way that suits your unique business. In the case of Mollie, Custom Objects have been made available for transactions, orders, refunds, and subscriptions. You can use these Custom Objects to activate automations based on events and data in Mollie.

In the previous section of this article (How can I use Mollie in an automation?), we have already shown a few examples of this.

The initial triggers explained there may already give it away, but the Custom Objects are divided into four categories:

  • Refunds

  • Subscriptions

  • Orders

  • Payments

Below we will provide an overview per category of all Custom Objects you can use to create personalised experiences for your customers.

Custom Refund Objects

The 'Custom Refund Objects' display refunds processed through your Mollie account. You can use these, for example, to keep your customers informed about their returns.

Name

Type

Description

Refund Status

Text input

Shows the different statuses of the refund

Refund Description

Text input

Description of the refund

Refund Amount Currency

Text input

The currency of the refund

Refund Amount Value

Text input

The amount that has been refunded. This may be less than the original transaction amount.

Refund Created At

Text input

The date and time when the refund was initiated.

Refund Id

Text input

A unique ID for the refund.

Refund Order Id

Text input

An ID for a refund performed using order lines (conditional).

Refund Payment Id

Text input

An ID for a refund performed at transaction level (conditional).

Custom Subscription Objects

The 'Custom Subscription Objects' can be used for mailings based on your Mollie subscriptions. For example, inform your customers about the upcoming payment date, or start a campaign once the subscription has ended.

Name

Type

Description

Subscription Description

Text input

A description unique to each subscription

Subscription Amount Currency

Text input

Currency of the subscription payment

Subscription Amount Value

Text input

Amount of the subscription payment

Subscription Status

Text input

The current status of the subscription

Subscription TimesRemaining

Numeric

Number of remaining payments for the subscription to complete

Subscription Id

Text input

Specific ID of the subscription

Subscription Start Date

Date

Date of the first payment term

Subscription Interval

Text input

Interval to wait between payments

Subscription Times

Numeric

Total number of payments the subscription needs to complete

Subscription Next Payment Date

Date

Date of the next scheduled payment. Left blank if the last payment is completed

Subscription Created At

Date and time

Date of subscription creation

Subscription Canceled At

Date and time

Date of subscription cancellation

Subscription Method

Text input

Payment method of the subscription

Custom Order Objects

A 'Mollie Order' reflects the order placed by a consumer and includes not only the payment details but also additional information. Orders are often used in eCommerce integrations connected to Mollie.

htmlhtml

Name

Type

Description

Order Created At

Date and Time

Date when the order was created

Order OrderNumber

Text Input

Order description/number

Order Amount Currency

Text Input

Currency of the transaction linked to the order

Order Amount Value

Text input

Amount of the transaction linked to the order

Order Status

Text input

Status of the order at that moment

Order Id

Text input

ID of this specific order

Order ProfileId

Text input

ID of the website profile linked to the order

Order Expired At

Date and Time

Date and time when the order expired (conditional)

Order Completed At

Date and Time

Date and time when the order was completed (conditional)

Order Method

Text Input

Payment method used to pay for the order

Order Amount Refunded Currency

Text Input

Currency of the refund (conditional)

Order Amount Refunded Value

Text input

Amount of the refund (conditional)

Order Amount Captured Currency

Text input

Currency of the amount captured

Order Amount Captured Value

Text input

Amount of the order captured

Order Billing Address Given Name

Text input

Name of the consumer in the billing address

Order Billing Address Family Name

Text input

Last name of the consumer in the billing address

Order Billing Address Email

Text input

Email address of the consumer in the billing address

Order Billing Address Phone

Text input

Phone number of the consumer in the billing address

Order Billing Address Title

Text input

Title of the details of the billing address

Order Billing Address Organization Name

Text input

In case of a business customer, the organization name can be added

Order Billing Address Street And Number

Text input

Street and number of the consumer's billing address

Order Billing Address Street Additional

Text input

Additional information about the consumer's billing address

Order Billing Address Postal Code

Text input

Postal code of the consumer's billing address

Order Billing Address City

Text input

Location of the consumer's billing address

Order Billing Address Region

Text input

Region of the consumer's billing address

Order Billing Address Country

Text input

Country of the consumer's billing address

Order Shipping Address Given Name

Text input

Name of the consumer in the shipping address

Order Shipping Address Family Name

Text input

Last name of the consumer in the shipping address

Order Shipping Address Email

Text input

Email address of the consumer in the shipping address

Order Shipping Address Phone

Text input

Phone number of the consumer in the shipping address

Order Shipping Address Title

Text input

Title of the shipping address details

Order Shipping Address Organization Name

Text input

In case of a business customer, the organization name can be added

Order Shipping Address Street And Number

Text input

Street and number of the consumer's shipping address

Order Shipping Address Street Additional

Text input

Additional information about the consumer's shipping address

Order Shipping Address Postal Code

Text input

Postal code of the consumer's shipping address

Order Shipping Address City

Text input

Shipping address city of the consumer

Order Shipping Address Region

Text input

Region of the shipping address of the consumer

Order Shipping Address Country

Text input

Country of the shipping address of the consumer

Order Consumer Date Of Birth

Text input

Consumer's date of birth

Custom Payment Objects

The payment, unlike the order, contains specified payment details. Follow up with your customers based on a successful or failed payment. Or offer your customers special deals when the transaction amount exceeds a certain value.

Name

Type

Description

Payment Created At

Date and time

Date and time when the payment was created

Payment Description

Text input

The description of the payment, for example created by the e-commerce platform

Payment Amount Currency

Text input

Currency of the transaction

Payment Amount Value

Text input

Transaction amount

Payment Status

Text input

Payment status

Payment Id

Text input

Transaction ID (tr_xxx)

Payment Method

Text input

Payment method selected during checkout

Payment Paid At

Date and time

The moment the transaction moved to the 'paid' status

Payment Order Id

Text input

ID of the linked order (conditional value)

Payment Customer Id

Text input

ID for linked customer (conditional value)

Payment Profile Id

Text input

ID for the Mollie (website) profile linked to the payment

Payment Expired At

Date and time

The moment when the payment has expired (conditional value)

Payment Sequence Type

Text input

In case the payment is used as the first payment to verify a subscription, the value will be displayed as 'first', otherwise it will be empty (conditional value)

Payment Subscription Id

Text input

ID linked to the Mollie subscription

Payment Amount Charged Back Currency

Text input

In case of a chargeback, the currency will be displayed (conditional value)

Payment Amount Charged Back Value

Text Input

In the case of a chargeback, the amount of the chargeback is displayed (conditional value)

Did this answer your question?