Setting up Mollie as your Checkfront payment provider

Learn more about Mollie, including how to set up your account, set up Mollie in Checkfront, make bookings, handle failed transactions, manage payments, and refund transactions.

Mollie Payment Gateway Retirement by December 31, 2024 What is happening? On December 31, 2024, Mollie will retire API V1 for payments and, as a result, will no longer be available as a payment gateway with Checkfront. If your business is currently using this platform, you will need to switch to a new payment gateway. What should I do? We recommend switching to Checkfront Payments, our fully integrated payment gateway. Checkfront Payments offers lower transaction fees compared to Mollie and supports popular global payment methods such as credit and debit cards, Apple Pay, Google Pay, iDeal, and AliPay. By moving to Checkfront Payments, you’ll avoid the risks of last-minute migrations and ensure your payment systems remain up-to-date with the latest security and technology standards.   To switch to Checkfront Payments: You can log into your Checkfront account and follow our step-by-step guide to integrate Checkfront Payments as your new payment gateway. We’re here to support you through this transition. If you have any questions or need help setting up your new payment gateway, please contact us at support@checkfront.com.

Which plans include this feature?

Legacy: Soho, Pro, Plus, Enterprise
Current: Growth (Subscription) and Managed plans only.
→ Learn more about our current plans or how to change your plan.

Where can I find this feature using the top menu?

Manage > Ecommerce Setup > Payment

What more do I need to use this feature?

• Admin permissions are required to manage Payment Providers.

Mollie is a payment provider for Belgium and the Netherlands, offering payment methods such as credit card, iDEAL, Bancontact/Mister cash, PayPal, SCT, SDD, and others. Mollie's services are easy to use and very reliable.

To integrate the payment provider with Checkfront, you must obtain an API Key directly from Mollie. This can be found within your Mollie dashboard, and we'll show you how to do that below.

PSD2 and SCA compliant  This integration is Payment Services Directive 2 (PSD2) compliant, including Strong Customer Authentication (SCA).  Checkfront is prepared to handle any transactions that the payment provider deems applicable.  These measures help reduce fraud and make online payments more secure!  Learn more about PSD2 and SCA here... What is PSD2 and How Will It Impact Your Business?

The following is a limited list of standard payment provider features. Those available with the Mollie and Checkfront integration are marked as supported (✓).

From there, click on the Website Profiles button (3). You must do that now if you haven't created a website profile. Then, once inside the website profile, you have created, click on the API Keys link (4).

You see two fields for API keys, a live API key and a test API key. You will receive a live API key once the team has verified your website profile at Mollie. Until then, you can use the test API key to configure and test the connectivity with Checkfront.

For this user guide, Checkfront was supplied with a test account at Mollie, and as such, our experience and guidance are based on that.

Now that you have an API key from Mollie, it's time to head back to Checkfront and continue the integration there.

From your Checkfront dashboard, navigate to Manage > Ecommerce Setup from the main menu, making sure the Payment tab is selected.

Here you see a list of available payment modules. Locate the Mollie tile from the list.

You find it by clicking on the links in the left side menu labelled Available to [your country] or All. You can also search for the Mollie tile directly in the provided search box.

Hover over the tile, which turns grey, and click.

The configuration window opens with a field to input the API key you just obtained from Mollie. This is a required field, so enter the API key here.

Below is a field where you can change the message displayed on the payment page when a transaction is still pending. Otherwise, you can just leave the message as it is.

Click the blue Activate button when you are ready.

Mollie is now successfully integrated with your Checkfront account and is listed under your section of Active Providers.

Once the payment provider is active, it is ready to use by you and your Customers.

If you're ready to take live payments from your Customers, ensure you have entered your Live API Key into the setup window. If you use the Test API Key, your Customers cannot input their credit card details, and no payments are taken.

When the Customer arrives at the payment page during the booking process, they should see a copy of their invoice and the Mollie payment provider logo to its left. Just underneath this is the green Process Payment button.

The Customer clicks this to continue the booking.

At this point, the Customer is taken to mollie.com, where their payment is processed. They are then asked to choose their method of payment.

Depending on the methods you selected when creating the Website Profile in Mollie, you see a view similar to the one below. For this user guide, we select Credit Card Payment.

Ordinarily, the Customer would now input their credit card details into the system.

Since Checkfront is operating in a test environment for the creation of this user guide, we are not able to show you what that looks like with a real credit card number. Instead, we can simply choose to create a successful or declined transaction.

First of all, we'll go with a successful transaction. Once the payment has been processed, the Customer returns to Checkfront and is presented with a copy of the invoice.

In our scenario, a deposit only is required at booking.

As you can see, the booking status has been changed to Deposit, and the payment has been recorded.

If instead, we'd chosen to fail the transaction, the system would simply return the Customer to the payment method selection window.

Troubleshooting: In our testing, there doesn't appear to be a failed message displayed to the Customer when a transaction doesn't complete. If you discover otherwise in your live environment, please let us know!

Once a successful payment has been recorded, you can review and manage it from within your Checkfront dashboard.

Navigate to the invoice and click on the Transactions tab to review the payment details.

As highlighted below, clicking the Details tab will open a pop-up window containing additional information, such as the Transaction ID.

To view the raw transaction data from Mollie, click on the Query Mollie link.

To refund a transaction, click the Refund button, as highlighted below.

When complete, the Transactions tab updates to reflect the changes.

Since Mollie supports in-app refunds, the transaction is updated in your account, and the payment is returned to the Customer's credit card.