DevTalents

Intégration Monetico dans Odoo : module de paiement CB pour Crédit Mutuel et CIC

Une passerelle de paiement puissante utilisée par plus de 400 000 commerçants
Ines MlaouhiaAgence Odoo DevTalents
  • 7 min de lecture
Intégration Monetico dans Odoo : module de paiement CB pour Crédit Mutuel et CIC Billy, la mascotte de DevTalents, examine l'article à la loupe

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.

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

  1. Le client valide son panier, ou ouvre le lien de paiement d'un devis ou d'une facture, et choisit la carte bancaire.
  2. 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.
  3. 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.
  4. 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 :

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.

Un projet Odoo en tête ?

Parlez-nous-en : nous vous répondons sous 48 h avec une première analyse.

Parlons de votre projet
Billy, la mascotte de DevTalents, répond à un message sur son téléphone