MBI Monetico

🎯 Module Overview

MBI Monetico collects card payments online for your invoices and sales orders through Monetico, the payment solution of CIC and Crédit Mutuel. Your customer pays from a link sent to them, and the settlement is recorded in Dolibarr as soon as the bank authorises the transaction: payment creation, bank reconciliation, invoice switched to paid, and creation of the invoice when the payment starts from a sales order. It is aimed at companies that already hold a Monetico Paiement contract and want to collect payments from Dolibarr without re-entering anything.

An active Monetico Paiement contract with CIC or Crédit Mutuel is required, together with the three shop credentials issued with it (terminal number, company code and MAC key). The module's notification and return pages must be reachable from the Internet over HTTPS without prior authentication, as Monetico's servers call the first one and your customer's browser lands on the second, and the notification address shown in the settings screen must be declared in your Monetico back office. The module works with no other acquirer.

🌐 Demo: https://demo.mbicloud.fr 🛒 Discover our other modules on Dolistore.

💡 Benefits

• Your customers pay online, immediately, with no data re-entry on your side.
• The settlement, the bank entry and the paid status of the invoice are handled automatically.
• A payment can be started from a sales order: the invoice is created for you once the money arrives.
• Your customer receives a confirmation email with the invoice PDF attached, and the send is traced in the agenda.
• A test mode lets you validate the whole chain before collecting a single euro.

⚙️ Key Features

💳 Online card collection

• Monetico payment method: added to the payment methods recognised by Dolibarr's public online payment page, with a dedicated Pay with Monetico button showing the accepted card type.
• Payment button on the invoice card: available for any non-draft invoice with an outstanding balance, it opens the Monetico payment link in a new tab.
• Payment button on the sales order card: available for any non-draft order that has no invoice attached yet.
• Test mode: every transaction is routed to Monetico's test platform instead of the production one, so the whole chain can be validated before going live.

🧾 Settlement and accounting

• Automatic settlement recording: when the bank notifies the result, a card payment is created for the outstanding amount, reconciled with the configured bank account, and the invoice switches to paid once the balance reaches zero.
• Invoice creation from the sales order: the order is validated if it is still a draft, the invoice is created and settled, then the order is classified as billed.
• Draft invoice validated automatically: the invoice is validated before the settlement is recorded.
• Removed products no longer block invoicing: an order line whose product has been deleted from the catalogue is carried over as a free-text line.

✉️ Customer emails and tracking

• Confirmation email: sent to your customer after collection, built on the email template of your choice, with the invoice PDF attached when it exists.
• Agenda tracking: the confirmation email is logged as an event linked to the invoice and to the customer.
• Return page: displayed in your company's colours and contact details, confirming acceptance or announcing refusal to the customer.

🛡️ Security and architecture

• Multi-entity: the entity is carried end to end, from the redirection to the bank through to the notification and the return page, and the bank accounts offered in the settings are limited to the current entity.
• Sealed payment request: the form presented to your customer is signed with your contract key before being submitted to the bank.
• Authenticity check: every notification is verified through a seal computed with your contract key, and a notification that does not match is never recorded.
• Reliable handling of bank notifications: a notification replayed by the bank never creates a second settlement, and the response expected by Monetico is always returned, even if another module fails during processing.
• 3-D Secure preferences: your wish as a merchant — no preference, challenge requested, challenge required, no challenge, or one of three exemption requests — is transmitted to the bank on every transaction, along with an option to force 3-D Secure off.
• Address check before payment: the payment is refused upfront, with an on-screen message, when the customer's street, postcode or town is missing.
• Payment link security settings: a security key that can be generated at random, and the option of a different key for each payment link.

🛠️ Administration

• Four administration tabs: settings, about, changelog and activation.
• Notification address ready to copy: displayed at the bottom of the settings screen, to be declared in your Monetico back office.
• Licence management: from the activation tab, enter your order reference, check the licence status and purchase date, force a re-check, detach the instance, and be told when a newer version has been published.
• Payment in 2, 3 or 4 instalments: under development, the related settings are visible in the settings screen and flagged as such.

🆕 Recent updates (1.9.3 / 1.9.2 / 1.9.1)

• Warnings raised by recent PHP versions no longer appear.
• The settings screen now only lists the bank accounts of the current entity, and payment and the return page work in a multi-company setup, the entity being kept from end to end.
• Sending the confirmation email to the customer is logged in the agenda, linked to the related invoice and customer.
• The confirmation email carries a tracking identifier, so it can be found again among the exchanges.
• An order still in draft is validated automatically before its invoice is created, when payment is received.

✅ Compatibility

• Dolibarr: 12.0+ (tested up to Dolibarr 23) — no maximum version is declared.
• PHP: 7.2+, with the json, hash, curl and openssl extensions.
• Monetico Paiement contract: required, with CIC or Crédit Mutuel, together with the three shop credentials issued with it (terminal number, company code and MAC key). The module works with no other acquirer.
• Internet-reachable pages: required, the notification and return pages must be reachable over HTTPS without prior authentication, and the notification address must be declared in your Monetico back office.
• Outbound HTTPS access: required, to MB Informatique's activation service, used to activate the module and to confirm the licence periodically.
• CB payment method: required, it must exist in the payment methods dictionary of the entity concerned.
• Dolibarr public address and instance identifier: required, the return addresses sent to the bank are built from the first one, and no activation is possible without the second.
• Dolibarr bank account: optional, without one the payment is still recorded on the invoice but is not reconciled with a bank entry.
• Invoice-sending email template: optional, needed only if you want the confirmation email to be sent to your customer.
• MySQL or MariaDB: recommended, they enable the lock guarding against a double collection; on another engine a replayed notification is still filtered out, but two strictly simultaneous notifications are not.
• Interface languages: English and French. German, Spanish and Italian translations are partial.
• No other Dolibarr module is required, and no incompatibility is declared. The module fits into the standard Dolibarr interface, without overriding the core.

Module version: auto
Publisher/Licence: MB Informatique / GPL-v3
User interface language: English, French
Help/Support: MB Informatique
Prerequisites:

• Dolibarr min version: auto
• Dolibarr max version: auto

🔧 Installation

1. Download the module's ZIP archive without extracting it.
2. In Dolibarr, go to Home > Setup > Modules/Applications.
3. Open the Deploy/Install external module tab.
4. Upload the module's ZIP archive.
5. Find and enable MBI Monetico.
6. Open the module's Activation tab and enter the order reference received with your purchase: the settings screen stays closed until the licence is valid.
7. Configure the module from its administration page: the three credentials issued with your Monetico contract (terminal number, company code and MAC key), the bank account on which settlements will be recorded, the email template used for the confirmation email, and your 3-D Secure preference.
8. Copy the notification address displayed at the bottom of the settings screen and declare it in your Monetico back office.
9. (Optional) For a manual installation, drop the mbimonetico folder into /htdocs/custom/.

ℹ️ Usage notes

• An active Monetico Paiement contract with CIC or Crédit Mutuel is required, together with the three shop credentials issued with it: terminal number, company code and MAC key.
• The notification and return pages must be reachable from the Internet over HTTPS, without prior authentication: a firewall or an access restriction placed in front of Dolibarr breaks automatic collection.
• Outbound HTTPS access to MB Informatique's activation service is required. Without it the licence can no longer be re-checked and the module stops offering payment; payments already authorised by the bank are still recorded.
• Enable test mode first, pay an invoice end to end to check that the bank's notification is properly processed, then disable test mode once the whole chain has been validated.
• Some 3-D Secure exemption requests depend on a specific option being present on your merchant contract, and instalment payments require your terminal and your contract to allow them on the bank's side.
• The interface is available in English and French; German, Spanish and Italian translations are partial.
• Back up the database and the Dolibarr files before any update, and read the ChangeLog: some versions require disabling and re-enabling the module to take effect, which is stated explicitly at the top of the version concerned. The module has no table of its own and no SQL migration to run.
• Disabling the module releases the licence activation and removes the module's declarations. Your functional settings — terminal number, company code, MAC key, bank account, email template, 3-D Secure and instalment options — are kept and found again as they were when you re-enable it. Data produced by the module is kept as well: payments, bank entries, invoices created from sales orders and agenda events are accounting records and are never deleted.

🎓 Services

• Training on the module is available at €80 excl. VAT.
• Support and updates included for the duration of your license.

📄 Licence and terms of use

The module is distributed under the GNU General Public License v3 or later (GPL v3+), the full text of which is provided in the COPYING file delivered with the module.

The complete Terms of Use are delivered with the module and can be read from its “About” tab in Dolibarr. Our Terms and Conditions of Sale are available at https://www.mb-informatique.fr/cgv.html.

👨 💻 Publisher

MBI Monetico is a custom Dolibarr module developed by MB Informatique.

It is aimed at companies holding a Monetico Paiement contract with CIC or Crédit Mutuel who want to collect card payments for their invoices and sales orders directly from Dolibarr, without re-entering their settlements and without an intermediate tool.

Publisher: MB Informatique
Contact: info@mb-informatique.fr
Website: https://www.mb-informatique.fr

🛠 CHANGELOG

UPDATE 1.9.3 (2026-06-24)

• Improved: warnings raised by recent PHP versions no longer appear.
• Fixed: the settings screen now only lists the bank accounts of the current entity.
• Compatibility: payment and the return page work in a multi-company setup, the entity being kept from end to end.

UPDATE 1.9.2 (2026-05-27)

• New: sending the confirmation email to the customer is logged in the agenda, linked to the related invoice and customer.
• Improved: the confirmation email carries a tracking identifier, so it can be found again among the exchanges.

UPDATE 1.9.1 (2026-05-19)

• Improved: an order still in draft is validated automatically before its invoice is created, when payment is received.

UPDATE 1.9.0 (2026-04-20)

• New: two settings let you tell the bank which level of 3-D Secure cardholder authentication you expect.
• New: the selected choice — disabled, challenge preferred, challenge required or exemption request — is sent to the bank for every transaction.

UPDATE 1.8.0 (2026-04-08)

• ⚠️ Action required: disable then re-enable the module after updating to apply the changes introduced by this version.
• New: payment can be started from an order; the invoice is created automatically on payment and the order is set as billed.
• New: a Monetico payment button appears on the order card, as long as no invoice is linked to it.
• New: a new tab shows the update history of the module.
• Improved: the interface is available in further regional variants of English and French; German, Spanish and Italian translations are partial.
• Fixed: an order line whose product was removed from the catalogue no longer prevents invoicing.

UPDATE 1.6.0 (2025-08-07)

• New: payment can be started from an order, with automatic creation of the matching invoice.
• New: an option adds a Monetico payment button on the order card.

UPDATE 1.5.3 (2024-10-31)

• New: payment in 2, 3 or 4 instalments, flagged on screen as under development, is offered with its schedule and its possible extra fees.
• Improved: the settings screen accepts amount input fields.

UPDATE 1.5.2 (2024-05-29)

• Fixed: payment of documents issued in a multi-currency context.

UPDATE 1.5.1 (2024-05-28)

• Fixed: the bank account on which the payment is recorded.
• Fixed: the invoice attached to the confirmation email was not always found.

UPDATE 1.5 (2024-05-17)

• Improved: payments made in test mode are recorded like real ones, which allows the connection to be validated end to end.
• Fixed: on payment, the invoice was identified by its reference, which could designate the wrong document.

UPDATE 1.4.0 (2024-05-16)

• Improved: the presentation of the interface has been reworked.

UPDATE 1.3.0 (2024-05-15)

• Improved: the payment methods offered to the customer have been fixed and optimised.

UPDATE 1.2.0 (2024-04-05)

• Security: the security of the module has been strengthened.

UPDATE 1.1.0 (2024-03-07)

• New: an option adds a Monetico payment button on the invoice card.
• Compatibility: a compatibility issue with Dolibarr during payment has been fixed.

UPDATE 1.0.2 (2023-09-04)

• Fixed: payment could fail when the document carried no currency; the euro is now used by default.

UPDATE 1.0

• New: initial version of the module.