Mollie Payments (extended) Module
- General
- Installation
- Quick Start Configuration
- Set up a different payment journal for each payment method
- Configure vouchers
- How to refund
- How to set up single-click credit card payments
- Manually upgrade module
- Maintenance and Support
The Mollie Odoo standard features have been integrated in native Odoo as of V15.
Here you can find information about how to install, update and configure the Mollie Payment Gateway extension into your Odoo environment.
Please always use the appropriate version for your database version.
Currently supported versions are:
- V17
- V16
- V15
- V14
- V13
- V12
To install this module on Odoo, you need to:
Download the module and add it to your Odoo addons folder or click the ‘deploy on Odoo.sh’ button on the Odoo app store. The name of the module is payment_mollie_official.
The module needs the python dependency “mollie-api-python”. On Odoo.sh add the requirements.txt file to the root of your project or install the dependencies by running this command on your server: “pip3 install -r requirements.txt”.
Afterward, log on to your Odoo server and go to the Apps menu. Turn on debug mode and update the list by clicking on the "Update Apps List" link. Now install the module payment_mollie_official by clicking on the install button.
Note: Should you encounter a '500 internal server error' please refer to section Manually upgrade module
Open Sales > Configuration > Payments > Payment Providers.
Select the Mollie instance.
Fill the API keys and credentials. You can find these on your Mollie dashboard under the Developers menu:
Copy the Live & Test API key into the appropriate fields in Odoo. Copy the Profile ID as well if you want to accept credit card payments. This is mandatory as the Mollie module is using Mollie Components during checkout.
Click on Configuration tab and click on sync payment method button. This will fetch the activated payments that are active on the dashboard. Supported payment icons are fetched or downloaded from the Mollie API automatically.
Note: if changes are made on the Mollie dashboard, the changes will only reflect in Odoo after the Sync Payment methods is clicked again.
The last mandatory setting is to set the default Journal that will be used for the payment transactions. We strongly recommend creating a separate journal for Mollie.
Move the State of the payment provider to ‘Enabled’ and you are good to go! From now on you can accept payments on your webshop or send out payment links.
Mollie is able to specify the journal on which the payments will be booked per payment method. This makes it easier to reconcile the payments within the correct journal. In this example we will set up a different journal for Paypal.
To set this up in the mollie gateway we should first set up our payment journals. Open the invoicing or accounting App. Click on the Configuration / Payments journals.
In this example we will create a new journal “Paypal”.
Once this is done, you can set the journal on the desired payment method in the Mollie payment provider module.
Go to the payment method that you want to link the new journal to.
Link the payment method.
That’s it, now all paypal payments will be set on the correct journal, which will make it easier to reconcile the paypal invoices later.
With Mollie it is possible to accept vouchers as a payment method. To be able to do this we need to let Mollie know which products we are selling. This can be handled on category level or on product level.
To set the type of voucher on category level go to Invoicing / Configuration / Payment Acquirers and choose Mollie.
Open the tab Voucher Configuration and set the corresponding category to match the correct voucher type.
Note: only 1 category can be matched with 1 voucher type.
To set the voucher type on a product. Open the product template and set the voucher type.
Note: the voucher type on the product will overrule the product type set in the category in case there is a conflict.
It is possible to refund your customer directly within Odoo. This is handled by credit notes. Any credit note that is created from a sales order or invoice that was paid with Mollie will show an extra option:
When clicking the button. The pop up will ask you to refund the amount equal to the invoice. If a part of the invoice is non refundable, then the maximum amount refundable will be set. In this example 10€ was paid with a voucher, which is not refundable:
Clicking the create payment button will immediately refund the customer.
There is another way to refund a payment directly, however, the system will not generate a credit note. The credit note will have to be generated manually.
On the payment itself there is a button 'refund'
Clicking the refund button will allow you to select your refund amount
When you have added a new language in Odoo the payment method translations are not updated by default. Go to your payment acquirers > payment methods and sync the payment methods
If you want to personalize the translation, click edit and the default language will appear in the right upper corner of the title of the payment method. Clicking this will allow you to change the proposed translations.
When you want to add new payment icons to a payment method you can search for them in the dropdown or click search more for a more elaborate list. If the required payment icon is not in the list, sync your payment methods again to refresh the list with the most recent icons.
Note: When the payment icons are outdated or the icons of a previous payment provider are still stored there is a way to refresh the look of the icons. To refresh the icons you need to enable the developer mode in odoo (1). Go to Configuration > Payment icons (2) Delete Select all (applicable) icons (3)(4)
Delete the mollie payment methods (5) Resync the payment methods (6)
If you want to add additional fees for payments through Mollie you can configure them under 'Payment Acquirers > Mollie > Tab Fees'. There is a possibility to distinguish between fixed or variable fees for both domestic and international payments. Setting up both fixed and variable fees together is supported. Your personal fee will be added to the total payment fee.
Check the box for add extra fees. 4 fields will appear to configure the specific fees. Note that variables fees are percentage based.
If you want to enable single-click credit card payments through Mollie you can configure them under 'Payment Acquirers > Mollie > Tab Credentials'. Enable the checkbox
This will enable the user to use saved cards on file or enter a new card.
The user can also opt to save their card details.
Whenever there is a deployment on an odoo server, the impacted module(s) need(s) to be reloaded. Sometimes the web view is affected and it is not possible for the user to do the update through the GUI.
In this case please navigate to the Editor in your odoo.sh cockpit
Or if you feel comfortable with Shell commands you can also try this command as an alternative
$ odoo-bin -u payment_mollie_official --stop-after-init
Mollie standard futures are included in native Odoo. For troubleshooting please consult: https://www.odoo.com/documentation/15.0/applications/general/payment_acquirers/mollie.html?highlight=mollie#mollie
For support please contact Mollie support by mail [email protected].
This module is maintained by Applix.
www.applix.be
[email protected]