Monetico dans Odoo, branché comme un fournisseur de paiement natif
Monetico est la solution de paiement en ligne du Crédit Mutuel et du CIC. Si votre contrat de vente à distance est chez l'une de ces deux banques, c'est par Monetico que passent vos paiements par carte. Notre module Monetico pour Odoo l'ajoute aux fournisseurs de paiement d'Odoo : la boutique en ligne, les liens de paiement et le portail client encaissent par carte, et chaque paiement arrive dans Odoo rattaché à sa commande et à sa facture.
L'intégration de Monetico dans Odoo pose toujours les mêmes questions : quel produit Monetico figure sur le contrat, quels identifiants saisir, comment le paiement revient dans Odoo, et ce qui se passe quand une notification se perd. Cet article y répond à partir de ce que nous voyons sur les projets de nos clients, depuis 2014.
Dans cet article
- Monetico ou Monetico Retail : lequel est sur votre contrat ?
- Le parcours d'un paiement Monetico dans Odoo
- Ce qu'il faut pour configurer le module
- Paiement différé et capture partielle
- Remboursements depuis Odoo
- Aucune commande payée laissée en devis
- Paiement en 3 fois et abonnements
- Questions fréquentes
Monetico ou Monetico Retail : lequel est sur votre contrat ?
Le Crédit Mutuel et le CIC proposent deux plateformes sous le nom Monetico, et elles ne se connectent pas de la même façon. C'est la première chose à vérifier avec votre conseiller, avant d'acheter quoi que ce soit.
| Monetico Paiement | Monetico Retail | |
|---|---|---|
| Ce que c'est | Le TPE virtuel historique, successeur de CM-CIC p@iement et de CyberMUT | La plateforme plus récente, pilotée par une API REST |
| Identifiants | Numéro de TPE, code société, clé de sécurité | Identifiants d'API de votre compte Retail |
| Points forts | Paiement différé, capture partielle, paiement en 3 fois et récurrent avec nos modules complémentaires | Plus de 35 devises, cartes enregistrées, paiement en N fois, panier transmis pour l'antifraude |
| Notre module | Monetico Payment Provider | Monetico Retail Payment Provider |
La suite de cet article parle de Monetico Paiement, le cas le plus courant chez les PME. Si votre banque vous a ouvert un compte Retail, notre article Monetico Retail pour Odoo détaille ce module.
Vous aviez un ancien connecteur CM-CIC ou CyberMUT sur une version d'Odoo plus ancienne ? Le principe reste le même (TPE, code société, clé), mais la signature des échanges a évolué. Une migration d'Odoo est le bon moment pour repartir sur un module maintenu plutôt que de porter un vieux code.
Le parcours d'un paiement Monetico dans Odoo
- Le client valide son panier, ou ouvre le lien de paiement d'un devis ou d'une facture, et choisit la carte bancaire.
- Odoo l'envoie sur la page de paiement Monetico. La carte est saisie chez Monetico, avec 3D Secure 2 en frictionless ou en challenge selon la banque du porteur. Aucun numéro de carte ne transite par votre serveur.
- Monetico prévient Odoo par une notification serveur à serveur (l'interface « CGI2 »). Le module vérifie le sceau HMAC de chaque notification avant de toucher à la transaction : une notification falsifiée est rejetée.
- La transaction passe à l'état confirmé, la commande est validée et le paiement est rapproché de la facture. Le client revient sur la page de confirmation de votre boutique.
Sur chaque transaction, un onglet Monetico affiche le numéro d'autorisation, la carte masquée, le motif de refus s'il y en a un et la date réelle du paiement transmise par Monetico. Quand un client appelle parce que « ça n'a pas marché », la réponse est dans Odoo, sans aller fouiller le back-office de la banque.
La page de paiement s'affiche dans la langue du client quand Monetico la propose : français, anglais, allemand, espagnol, italien, néerlandais, portugais, suédois ou japonais.
Ce qu'il faut pour configurer le module
Avant l'installation, réunissez :
- Le numéro de TPE (7 caractères) et le code société, indiqués dans le courrier d'ouverture de votre contrat ;
- La clé de sécurité, à récupérer dans le back-office Monetico. Elle sert à sceller les échanges : ne l'envoyez jamais par e-mail en clair ;
- L'URL de retour CGI2 de votre Odoo, à déclarer chez Monetico pour que les notifications arrivent sur votre base ;
- Un TPE de test, que Monetico fournit sur demande, pour valider tout le parcours avant la production.
Dans Odoo, le module se configure dans Facturation (ou Site web) > Configuration > Fournisseurs de paiement, comme Stripe ou PayPal. On saisit les identifiants, on active le fournisseur en mode test, on passe une vraie commande de bout en bout, puis on bascule en production.
Un conseil tiré de l'expérience : testez sur une copie de votre base, pas sur la production. Odoo sait neutraliser une copie pour que les paiements et les e-mails ne partent pas chez de vrais clients ; nous l'expliquons dans notre article sur la base de données neutralisée.
Paiement différé et capture partielle
Si vous expédiez des produits, débiter le client à la commande n'est pas toujours souhaitable. Avec un TPE paramétré en paiement différé, le montant est seulement autorisé quand le client paie. Vous l'encaissez depuis Odoo au moment de l'expédition, ou vous annulez l'autorisation si la commande ne part pas.
Avec l'option paiement partiel de Monetico, vous pouvez aussi encaisser une partie du montant : une commande livrée en deux colis est débitée en deux fois, et le reste est capturé ou annulé plus tard. Tout se fait depuis la transaction dans Odoo.
Remboursements depuis Odoo
Le bouton Rembourser du paiement dans Odoo envoie le remboursement, total ou partiel, sans ouvrir le back-office Monetico. Le module passe par le service « Recrédit » de Monetico et tient compte de ce qui a déjà été remboursé : impossible de rembourser deux fois le même montant par erreur.
Aucune commande payée laissée en devis
Le cas le plus pénible en e-commerce : le client a payé, mais la commande est restée en devis parce que la notification de la banque n'est jamais arrivée (serveur redémarré, pare-feu, maintenance). Le module lance une action planifiée qui interroge Monetico sur le statut réel des transactions en attente et confirme celles qui ont été payées. Vous n'avez pas à les rattraper à la main en fin de journée.
Paiement en 3 fois et abonnements
Deux modules complémentaires s'appuient sur celui-ci, si votre contrat Monetico comporte les options correspondantes :
- Monetico Split Payment pour le paiement en 2, 3 ou 4 fois par carte, avec un paiement comptable par échéance. Voir notre article Paiement en 3 fois Monetico sur Odoo.
- Monetico Recurring Payments pour prélever automatiquement les renouvellements d'abonnement sur la carte enregistrée. Voir Paiement récurrent Monetico sur Odoo.
Côté sécurité, le module suit les évolutions imposées par Monetico. La dernière en date concerne le calcul du sceau MAC : notre module est à jour.
Questions fréquentes
Quelles versions d'Odoo sont prises en charge ?
Odoo 17, 18, 19 et 20, en Community comme en Enterprise. Nous portons le module à chaque nouvelle version.
Le module fonctionne-t-il sur Odoo Online ?
Non, Odoo Online n'accepte pas les modules tiers. Il s'installe sur Odoo.sh ou sur votre propre serveur.
Les données de carte passent-elles par Odoo ?
Non. La carte est saisie sur la page Monetico, avec 3D Secure. Odoo ne reçoit que le résultat du paiement, le numéro d'autorisation et la carte masquée.
Qui signe le contrat avec la banque ?
Vous. Le contrat de vente à distance reste entre vous et le Crédit Mutuel ou le CIC ; le module relie seulement Odoo à votre TPE.
Pouvez-vous l'installer et le configurer pour nous ?
Oui. Nous installons le module, renseignons vos identifiants, testons le parcours avec votre TPE de test puis passons en production avec vous.
Un projet Monetico sur Odoo ?
Installation, reprise d'un ancien connecteur CM-CIC, paiement différé à l'expédition ou règle propre à votre activité : l'équipe qui a écrit le module s'en occupe. Parlons de votre projet, ou consultez tous nos modules de paiement Odoo.