MBI Monetico

🎯 Présentation du module

MBI Monetico encaisse vos factures et vos commandes par carte bancaire, en ligne, via Monetico, la solution de paiement du CIC et du Crédit Mutuel. Le module propose un lien de paiement à votre client depuis la fiche de la facture ou de la commande, le conduit sur la plateforme sécurisée de sa banque, puis enregistre le règlement dans Dolibarr dès que le paiement est autorisé. La facture passe au statut payé, l'écriture est rapprochée sur le compte bancaire retenu et votre client reçoit sa confirmation par courriel. Il s'adresse aux entreprises déjà titulaires d'un contrat Monetico Paiement qui veulent encaisser depuis Dolibarr, sans ressaisir leurs règlements.

L'utilisation du module suppose un contrat Monetico Paiement actif auprès du CIC ou du Crédit Mutuel, avec les trois identifiants de boutique délivrés par la banque (numéro de TPE, code société et clé MAC), des pages de notification et de retour joignables depuis Internet en HTTPS, et l'adresse publique de votre instance correctement renseignée dans Dolibarr. Le module ne fonctionne avec aucun autre acquéreur.

🌐 Démo : https://demo.mbicloud.fr 🛒 Découvrez nos autres modules sur Dolistore.

💡 Avantages

• Vos clients règlent en ligne, immédiatement, par carte bancaire.
• Le règlement, le rapprochement bancaire et le passage de la facture au statut payé sont automatiques.
• Le paiement peut partir d'une commande : la facture est créée toute seule à réception du règlement.
• Votre client reçoit sa confirmation de paiement par courriel, facture en pièce jointe, sans intervention de votre part.
• Un mode test permet de valider toute la chaîne avant d'encaisser le premier euro.

⚙️ Fonctionnalités clés

💳 Encaissement par carte bancaire

• Paiement Monetico proposé au client : sur la page de paiement en ligne publique de Dolibarr, avec un bouton dédié et la mention du type de carte accepté.
• Bouton de paiement sur la fiche facture : dès lors que la facture n'est plus au brouillon et qu'il reste un montant à régler.
• Bouton de paiement sur la fiche commande : dès lors que la commande n'est plus au brouillon et qu'aucune facture n'y est rattachée.
• Redirection sécurisée vers la banque : le formulaire de paiement est scellé avec la clé de votre contrat avant d'être présenté au client.

🔄 Enregistrement automatique des règlements

• Règlement enregistré à réception de la confirmation bancaire : création d'un paiement par carte bancaire, rapprochement sur le compte bancaire retenu, passage de la facture au statut payé lorsque le solde est nul.
• Chaîne complète depuis une commande : la commande encore au brouillon est validée, la facture correspondante est créée, le règlement y est enregistré et la commande est classée comme facturée.
• Validation automatique d'une facture au brouillon : effectuée avant l'enregistrement du règlement.
• Facturation possible malgré un article retiré du catalogue : la ligne concernée est reprise en ligne libre plutôt que de bloquer la création de la facture.

✉️ Courriels et traçabilité

• Courriel de confirmation au client : envoyé après encaissement, bâti sur un modèle de message que vous choisissez, avec le PDF de la facture en pièce jointe lorsqu'il existe.
• Traçabilité dans l'agenda : chaque envoi de confirmation est enregistré comme événement, rattaché à la facture et au client.
• Page de retour personnalisée : elle confirme au client l'acceptation ou le refus du paiement, aux couleurs et aux coordonnées de votre société.

🔐 3-D Secure et contrôles préalables

• Options 3-D Secure : vous indiquez à la banque votre souhait en matière d'authentification du porteur — débrayage, challenge souhaité, challenge requis, absence de challenge ou demande d'exemption.
• Contrôle préalable de l'adresse du client : le paiement n'est pas proposé lorsque la rue, le code postal ou la ville sont incomplets, et un message l'indique à l'écran.
• Mode test : il bascule l'ensemble des transactions vers la plateforme d'essai de Monetico.

🛡️ Sécurité et architecture

• Multi-entité : l'entité concernée est transmise de bout en bout, et seuls les comptes bancaires de l'entité en cours sont proposés dans les réglages.
• Contrôle d'authenticité des confirmations bancaires : un sceau calculé avec la clé de votre contrat écarte toute notification non conforme, qui n'est jamais enregistrée.
• Protection contre les doubles encaissements : une confirmation renvoyée deux fois par la banque ne crée jamais un second règlement.
• Traitement fiable de bout en bout : la réponse attendue par la banque est émise dans tous les cas, y compris lorsqu'un autre module provoque une erreur en cours de traitement.
• Administration en quatre onglets : réglages, à propos, historique des modifications et activation, avec l'adresse de notification à recopier dans votre back-office Monetico affichée prête à l'emploi.

🆕 Nouveautés récentes (1.9.3 / 1.9.2 / 1.9.1)

• Le paiement et la page de retour fonctionnent en environnement multi-société, l'entité étant conservée de bout en bout.
• L'écran de réglages ne présente plus que les comptes bancaires de l'entité en cours.
• Les avertissements affichés par les versions récentes de PHP ont disparu.
• L'envoi de l'email de confirmation au client est tracé dans l'agenda, rattaché à la facture et au client concernés, et porte un identifiant de suivi.
• Une commande encore au brouillon est validée automatiquement avant la création de sa facture, à réception du règlement.

✅ Compatibilité

• Dolibarr : 12.0+ (testé jusqu'à Dolibarr 23, aucun maximum de version déclaré)
• PHP : 7.2+
• Contrat bancaire : un contrat Monetico Paiement actif auprès du CIC ou du Crédit Mutuel est obligatoire, avec le numéro de TPE, le code société et la clé MAC fournis par la banque.
• Extensions PHP : json, hash, curl et openssl sont requises.
• Accès réseau : pages de notification et de retour joignables depuis Internet en HTTPS et sans authentification, et accès sortant HTTPS vers le serveur d'activation de MB Informatique.
• Langues : interface disponible en anglais et en français ; les traductions allemande, espagnole et italienne sont partielles.
• Autres modules : aucun module Dolibarr complémentaire n'est requis, et aucune incompatibilité n'est déclarée.

Module version: auto
Editeur/Licence: MB Informatique / GPL-v3
Langage interface: Anglais, Français
Assistance: MB Informatique
Prérequis:

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

🔧 Installation

1. Télécharger l'archive ZIP du module sans la décompresser.
2. Dans Dolibarr, aller dans Accueil > Configuration > Modules/Applications.
3. Ouvrir l'onglet Déployer/Installer un module externe.
4. Envoyer l'archive ZIP du module.
5. Rechercher puis activer MBI Monetico.
6. Ouvrir l'onglet Activation de la page d'administration, saisir la référence de votre commande et activer la licence : tant que le module n'est pas activé, l'écran de réglages reste fermé.
7. Ouvrir l'onglet Réglages et saisir les trois identifiants de boutique fournis par votre banque (numéro de TPE, code société et clé MAC), puis choisir le compte bancaire sur lequel les règlements seront rapprochés.
8. Copier l'adresse de notification affichée en bas de l'écran de réglages et la déclarer dans votre back-office Monetico.
9. Choisir le modèle de courriel de confirmation envoyé au client après encaissement et régler les options 3-D Secure souhaitées.
10. Pour une installation manuelle, déposer le dossier mbimonetico dans /htdocs/custom/.

ℹ️ Remarques d'utilisation

• Le mode de règlement de code CB doit exister dans le dictionnaire des modes de paiement de l'entité concernée.
• L'adresse publique de votre instance doit être correctement renseignée dans la configuration de Dolibarr : c'est elle qui compose les adresses de retour transmises à la banque.
• Un compte bancaire est optionnel : sans compte retenu, le règlement est bien enregistré sur la facture, mais il n'est pas rapproché d'une écriture bancaire. Laisser le modèle de courriel vide désactive l'envoi de la confirmation au client.
• Une base MySQL ou MariaDB apporte la protection la plus stricte contre un double encaissement lorsque deux confirmations arrivent exactement au même instant.
• Certaines options 3-D Secure, en particulier la demande d'exemption pour analyse de risque, nécessitent une option spécifique à votre contrat marchand.
• Il est recommandé d'activer le mode test, de régler une facture de bout en bout pour vérifier que la confirmation de la banque est bien traitée, puis de désactiver le mode test une fois la chaîne complète validée.
• Sauvegarder la base de données et les fichiers Dolibarr avant toute mise à jour, puis installer la nouvelle archive par-dessus la version existante. Certaines versions demandent de désactiver puis réactiver le module pour prendre effet ; le ChangeLog l'indique explicitement en tête de la version concernée.
• La désactivation du module libère l'activation de la licence, efface la référence de commande et la clé de licence conservées localement, et retire les droits et les déclarations du module. Les réglages fonctionnels sont conservés, et les données comptables produites — paiements, écritures bancaires, factures créées depuis des commandes et événements d'agenda — ne sont jamais supprimées.

🎓 Services

• Formation sur le module disponible au tarif de 80 € HT.
• Support et mises à jour inclus pendant la durée de votre licence.

📄 Licence et conditions d'utilisation

Le module est distribué sous licence GNU General Public License v3 ou ultérieure (GPL v3+), dont le texte complet figure dans le fichier COPYING livré avec le module.

Les Conditions Générales d'Utilisation complètes sont livrées avec le module et consultables depuis son onglet « À propos » dans Dolibarr. Nos Conditions Générales de Vente sont accessibles à l'adresse https://www.mb-informatique.fr/cgv.html.

👨 💻 Éditeur

MBI Monetico est un module custom Dolibarr développé par MB Informatique.

Il s'adresse aux entreprises titulaires d'un contrat Monetico Paiement auprès du CIC ou du Crédit Mutuel qui souhaitent encaisser leurs factures et leurs commandes par carte bancaire directement depuis Dolibarr, sans ressaisie et sans outil intermédiaire.

Éditeur : MB Informatique
Contact : info@mb-informatique.fr
Site web : https://www.mb-informatique.fr

🔧 Journal des changements

Version 1.9.3 (24/06/2026)

• Amélioration : les avertissements affichés par les versions récentes de PHP ont disparu.
• Correction : l'écran de réglages ne présente plus que les comptes bancaires de l'entité en cours.
• Compatibilité : le paiement et la page de retour fonctionnent en environnement multi-société, l'entité étant conservée de bout en bout.

Version 1.9.2 (27/05/2026)

• Nouveauté : l'envoi de l'email de confirmation au client est tracé dans l'agenda, rattaché à la facture et au client concernés.
• Amélioration : l'email de confirmation porte un identifiant de suivi, ce qui permet de le retrouver dans les échanges.

Version 1.9.1 (19/05/2026)

• Amélioration : une commande encore au brouillon est validée automatiquement avant la création de sa facture, à réception du règlement.

Version 1.9.0 (20/04/2026)

• Nouveauté : deux réglages permettent d'indiquer à la banque le niveau d'authentification 3-D Secure attendu du porteur de carte.
• Nouveauté : le choix retenu — débrayage, challenge souhaité, challenge requis ou demande d'exemption — est transmis à la banque pour chaque transaction.

Version 1.8.0 (08/04/2026)

• ⚠️ Action requise : désactivez puis réactivez le module après la mise à jour pour prendre en compte les changements apportés par cette version.
• Nouveauté : le paiement peut être lancé depuis une commande ; la facture est créée automatiquement à réception du règlement et la commande classée facturée.
• Nouveauté : un bouton de paiement Monetico apparaît sur la fiche commande, tant qu'aucune facture n'y est rattachée.
• Nouveauté : un nouvel onglet présente l'historique des mises à jour du module.
• Amélioration : l'interface est disponible dans de nouvelles déclinaisons régionales de l'anglais et du français ; les traductions allemande, espagnole et italienne sont partielles.
• Correction : une ligne de commande dont l'article a été supprimé du catalogue n'empêche plus la facturation.

Version 1.6.0 (07/08/2025)

• Nouveauté : le paiement peut être lancé depuis une commande, avec création automatique de la facture correspondante.
• Nouveauté : une option ajoute un bouton de paiement Monetico sur la fiche commande.

Version 1.5.3 (31/10/2024)

• Nouveauté : le paiement en 2, 3 ou 4 fois, signalé à l'écran comme en cours de développement, est proposé avec son échéancier et ses frais éventuels.
• Amélioration : l'écran de réglages accepte des champs de saisie de montants.

Version 1.5.2 (29/05/2024)

• Correction : le paiement des documents établis en multidevises.

Version 1.5.1 (28/05/2024)

• Correction : le compte bancaire sur lequel le règlement est enregistré.
• Correction : la facture jointe à l'email de confirmation n'était pas toujours retrouvée.

Version 1.5 (17/05/2024)

• Amélioration : les paiements réalisés en mode test sont enregistrés comme les paiements réels, ce qui permet de valider le raccordement de bout en bout.
• Correction : lors de l'encaissement, la facture était identifiée par sa référence, ce qui pouvait désigner le mauvais document.

Version 1.4.0 (16/05/2024)

• Amélioration : la présentation de l'interface a été revue.

Version 1.3.0 (15/05/2024)

• Amélioration : les modes de paiement proposés au client ont été corrigés et optimisés.

Version 1.2.0 (05/04/2024)

• Sécurité : la sécurité du module a été renforcée.

Version 1.1.0 (07/03/2024)

• Nouveauté : une option ajoute un bouton de paiement Monetico sur la fiche facture.
• Compatibilité : un problème de compatibilité avec Dolibarr lors du paiement a été corrigé.

Version 1.0.2 (04/09/2023)

• Correction : le paiement pouvait échouer lorsque le document ne portait pas de devise ; l'euro est désormais retenu par défaut.

Version 1.0

• Nouveauté : version initiale du module.