Mollie payments

<< Click to Display Table of Contents >>

Navigation:  Time and invoicing > Invoicing >

Mollie payments

Mill7 offers the possibility to send invoices per email, including a Mollie payment link, which can be used by your client to pay the invoice online.

Mollie is a company that offers online payment services. Payments can be made, for instance, with iDeal, PayPal or credit cards.

 

This function is only available in Mill7 Trust and only for service companies.

 

To use this Mill7 function you need:

1.a Mollie account

2.a Mollie web application of Millogic

 

If you are interested in this possibility, please contact the Millogic help desk.

 

The following subjects will be described below.

1.General settings

2.Linking a bookkeeping to a Mollie account

3.Creating an e-mail containing a Mollie payment link

4.The customer pays via the payment link

5.Error handling

6.Testing

 

General settings

In Mollie

In the Mollie account is registered

1.the bank account received amounts will be paid out to, and;

2.which payment methods are allowed

Changes of these settings cannot be done in Mill7, but should be made in the Mollie account.

 

You may create several Mollie accounts.

Each Mollie account comes with two API keys, a live key for real payments and a test key for testing.
These API keys are essential for linking Mill7 bookkeepings to Mollie accounts.

A Mill7 bookkeeping can be linked to one Mollie account at a time.
 

Mollie web service of Millogic

For the installation of the Mollie web service of Millogic you can contact the Millogic help desk.

The web address of this web service needs to be registered the Mill7 settings.

 

In Mill7

At Settings> Invoicing> E-mail needs to be registered

whether Mollie may be used or not, and;

what the address of Millogic's web service for Mollie is.

 

For linking bookkeepings to Mollie accounts a special option needs to be present in the custom menu.

To add it please go to Supervisor> Adjust custom menu and insert the following line: Link bookkeepings to Mollie accounts, maatwerk.exe /paylinkacc

Only users granted the right Link bookkeepings to Mollie accounts can execute this option in the custom menu.

This function can only be executed in a service company.

 

For all service companies using Mollie accounts the first bank account at Maintenance> Company data needs to be filled in.

The bank account in Mill7 is only used to select a Mollie account.

This is not necessarily the same account as the bank account used in the Mollie account.

 

Linking a bookeeping to a Mollie account

To be able to use the Mollie payment function in a bookkeeping the bookkeeping needs to be linked to a Mollie account.

 

Start the option Link bookkeepings to Mollie accounts in the custom menu. A new window will then be opened.

 

Bank account

In this field the first bank account of the company data will be displayed.
The sole purpose of this bank account is to link the bookkeeping to a Mollie account.

In the Mollie account itself, which is maintained at Mollie's website, you can set the bank account that Mollie will use to pay out received payments.

 

API key

When this field is empty, please enter the API key of the Mollie account to which te bookkeeping needs to be linked.

When a link has been established the program will show the API key. The link can be removed by applying an empty API key.
 

<Apply>

With the Apply button the link will be confirmed.

A connection with the Millogic web application will be established the will store the data. The API key will be stored encrypted.

When the API key is empty the bookkeeping will be detached from the Mollie account.

 

ATTENTION

Every Mollie account is accompanied by two API keys, one live key to create real payments and one test key for testing.

Both can be linked to a bookkeeping, but not a the same time.

While the test key is activated not real payments can be made.

When someone clicks on a payment link while the test key is active is will seem the a payment can be made, but in reality the testing facility of Mollie is being used and no payment can be made.

The payment status of an invoice, however, can be changed by this.

Therefore use the test key only when setting up a Mollie account.

 

Creating an e-mail containing a Mollie payment link

When sending an invoice by e-mail a payment link can be added to e-mail body text.
The use of a user text is mandatory when a adding payment link to an e-mail message.

The payment link will be inserted in the e-mail after the leading text.

Adjust the leading text to let the payment link fit in appropriately.

 

The customer pays via the payment link

The payment link added to the e-mail is shown as {web service address}/index.html?ID=/{ID}. The web service address originates from the settings.

The ID is constructed as follows. debtornumber_invoicenumber_invoicedatenumber_bookkeepingnumber.

 

By clicking on a payment link a command will be sent to Mollie in orde to create a payment session.
Depending on the settings in the Mollie account the customer may be able to select a payment method.

When only one payment method is allowed, according to the settings of the Mollie account, the user will be directed to the web page of that method immediately.

 

When the payment is completed successfully this will be confirmed on the web page.

An invoice paid this way cannot be paid again via Mollie.

 

When a payment is not successful the web page will report this as well.

For Mollie the invoice will remain registered as not paid.

 

Error handling

When something goes wrong during the creation of a payment link it will result in a link with an error code instead of the ID.

These error codes are described in the paragraph Error messages in the manual of the Mollie web service of Millogic.

The payment link cannot be used for payments. Instead, a web page will pop up displaying a short explanation for the error.

 

Some error can be solved in Mill7, other errors have a more technical nature and need to be handled by the manager of the web server.

 

Error codes related to the linking of a bookkeeping to a Mollie account

001: The bank account of the bookkeeping is not registered.

002: The bank account of the bookkeeping is registered, but an API key is missing.

102: No API key present for the bank account registered.

202: No API key present for the bank account registered..

These errors can be solved by linking the bookkeeping concerned to and creating a new e-mail containing a correct payment link.

 

Error reported by Mollie that can possibly be solved in the Mollie account

104: Error message returned by Mollie. The details of the error will be displayed in the web browser.

Examples:

The currency of the invoice is not supported by the payment method used.

The invoice amount exceeds the maximum amount of the selected payment method.

 

Error related to the availability of the Mollie web service

These errors can occur in the following situations.

Creating a payment link to add to an e-mail.
In this case a link will be made with the error code "Error".
Possibly the address of the web service is not set correctly at Settings > Invoicing > E-mail. Adjust the address and create a new e-mail with a new payment link.
When the address is correct, please contact the manager of web server.

Clicking on a payment.
When the payment link is correct but not functioning, it may be that the web service addressed is not active. Please contact the manager of the web server.

 

Other errors

All other errors have a technical background.

You can contact the manager of the web server or your application manager for Mill7.

 

Testing

While setting up of the Mollie web application with the test API key the complete process from Creating an e-mail containing a Mollie payment link to The customer pays via the payment link can be tested.

One bookkeeping can be linked to one Mollie API key and to one Mollie account at a time.

Two bookkeepings with the same bank account can be linked to only one Mollie API key and to one Mollie account at a time.

This is also valid for bookkeepings that exist in testing environments and in production environments with the same bank accounts.

The last link made will apply to both environments.