Mollie is a payment gateway 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 gateway with Checkfront, you will need to 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.
Setup in MollieBack to top
From there, click on the Website Profiles button (3). If you haven't created a website profile, you'll need to do that now. Then, once inside the website profile you have created, click on the API Keys link (4).
You will see two fields for API keys, a live API key and a test API key. You will receive a live API key once your website profile has been verified by the team at Mollie. Until then, you are able to use the test API key for the purpose of configuring and testing out the connectivity with Checkfront. For the purpose of this user guide, Checkfront was supplied with a test account at Mollie and as such, our experience and guidance is based on that.
Setup in CheckfrontBack to top
Now that you have an API key from Mollie, it's time to head back over to Checkfront and continue the integration there. From your Checkfront dashboard, navigate to Manage > E-commerce from the main menu. Locate the Mollie payment gateway tile, hover over the name label and click on it.
The configuration window will pop up with a field to input the API key you just obtained from Mollie. This is a required field, so enter the API key in there. Below this is a field where you can change the message that is 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.
Integration is now complete!
Making a BookingBack to top
Once the payment gateway is active, it will be ready to use by you and your customers.
|If you're ready to take live payments from your customers, make sure you have entered your Live API Key into the setup window. If you are using the Test API Key, your customers will not be able to input their credit card details and no payments will be taken.|
When the customer arrives at the payment screen, during the booking process, they should see a copy of their invoice and the Mollie Payment Gateway logo to its left. Just underneath this is the green Process Payment button.
The customer will click on this to continue the booking. At this point, the customer will be taken to mollie.com where their payment will be processed. They will be asked to choose their method of payment. Depending on the methods you selected when creating the Website Profile in Mollie, you will see a view similar to the one below. For the purpose of this user guide, we will 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 transaction or one that is declined.
First of all, we'll go with a successful transaction. Once the payment has processed, the customer will be returned to Checkfront and 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.
Failed TransactionBack to top
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 feel free to let us know!|
Managing PaymentsBack to top
Now that a successful payment has been recorded, you can review and manage it from within your Checkfront dashboard. Navigate to the invoice in question and click on the Transactions tab to review details of the payment.
Clicking on the Details tab, as highlighted below, 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.
Refunding a TransactionBack to top
To refund a transaction, click on the Refund button, as highlighted below.
When complete, the Transactions tab will update to reflect the changes.
|Since Mollie supports in-app refunds, the transaction will be updated in your Mollie account also and the payment will be returned to the customer's credit card.|