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?
- How can I use the integration with Mollie?
- What data is transferred from Mollie to MailBlue?
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
- Log in to your MailBlue account
- Navigate to 'Apps' via the left-hand menu
- Search for 'Mollie'
- Click on 'Add an account'
- 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
- Enter the API key and click 'Connect'
Mollie is now successfully connected to your MailBlue account.
Create automation tags
- In the 'Choose Resource' dropdown menu, select a Resource you want to use as an automation trigger. For example, 'Payment'.
- 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
- 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.
- Make sure 'Email' is selected in the corresponding MailBlue field.
- If desired, you can click on 'Add field mapping' to link more fields.
- 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) |