← Retour au blog • E-commerce & CMI • ⏱️ 9 min • 📅 10 novembre 2025

Intégration d'une passerelle de paiement CMI sur WooCommerce au Maroc

Guide technique pas à pas pour connecter le Centre Monétique Interbancaire (CMI) à votre boutique WooCommerce : contrats banques marocaines, calcul du hash SHA-512, validation IPN et homologation.

Ali Ouarzazi

Développeur WordPress & full-stack freelance

Au Maroc, accepter les paiements par carte bancaire nationale (Visa, Mastercard, cartes cmi) est un levier majeur pour augmenter le panier moyen et réduire les retours du Cash on Delivery (COD). Pourtant, l'intégration de la passerelle du Centre Monétique Interbancaire (CMI) sur WooCommerce rebute de nombreux marchands en raison des prérequis de sécurité et des étapes d'homologation bancaire. Ce guide vous détaille l'ensemble du processus technique et administratif.

1. Comment fonctionne l'écosystème de paiement CMI sur WooCommerce

Le CMI opère en tant que concentrateur monétique pour l'ensemble des banques marocaines (Attijariwafa bank, Banque Populaire, BMCE Bank of Africa, CIH, Crédit du Maroc, Société Générale Maroc). Le flux s'articule autour d'une redirection sécurisée : l'acheteur sélectionne le paiement par carte sur WooCommerce, est redirigé vers la page sécurisée de paiement hébergée par le CMI, saisit ses informations bancaires sous protocole 3D Secure v2 (validation par SMS OTP de sa banque), puis le CMI envoie une notification serveur à serveur (Callback IPN) à votre boutique pour valider la commande.

💡 Contrat commerçant VAD obligatoire

Pour obtenir vos identifiants CMI, vous devez obligatoirement disposer d'une société enregistrée au Maroc (RC, IF, ICE, Patente), ouvrir un compte professionnel dans une banque marocaine et signer un contrat VAD (Vente à Distance).

2. Prérequis techniques et environnement serveur

Avant de configurer le module, votre serveur d'hébergement doit satisfaire des critères stricts exigés par le cahier des charges de sécurité du CMI. L'absence d'un seul de ces éléments bloque l'homologation : certificat SSL valide (Let's Encrypt ou commercial avec TLS 1.3), PHP 8.1 ou supérieur avec extensions curl, openssl et hash activées, URL de callback accessible publiquement sans blocage Cloudflare ou HTTP Basic Auth, et gestion de la devise en Dirham Marocain (MAD).

✓ Certificat SSL TLS 1.3 valide sur l'ensemble du domaine www.
✓ Boutique WooCommerce configurée en devise Dirham Marocain (MAD).
✓ Pages légales complètes obligatoires (CGV, politique de retour, mentions légales, mentions CMI).
✓ Serveur sans blocage WAF agressif sur les requêtes POST du CMI.

3. Configuration des clés marchandes et du calcul de hash SHA-512

L'authenticité des transactions repose sur une signature cryptographique bidirectionnelle. Lorsque le panier est validé, votre site concatène les paramètres de commande (client ID, montant, devise, URL de retour, identifiant de commande) avec votre clé secrète magasin (Store Key) fournie par le CMI, puis génère une empreinte SHA-512 en base64. Si un seul caractère diffère ou si les montants comportent une décimale imprévue, le CMI renvoie l'erreur "Hash validation failed" et refuse la transaction.

Paramètre CMI	Format attendu	Exemple	Rôle technique
clientid	Numérique 10 chiffres	6000012345	Identifiant commerçant unique CMI
amount	Décimal 2 chiffres après point	450.00	Montant total de la commande
currency	Code ISO numérique CMI	504 (MAD)	Devise de transaction monétique
storeKey	Chaîne alphanumérique secrète	AbC123XyZ!987...	Clé de salage pour le hachage SHA-512
callbackUrl	URL HTTPS directe	https://www.site.com/?wc-api=cmi_ipn	Validation serveur sans intermédiaire

4. Procédure d'homologation bancaire et bascule en production

Le CMI impose une phase d'homologation sur son environnement de bac à sable (Sandbox). Vous recevez un jeu de cartes de test pour simuler un paiement réussi (carte 3D Secure valide), un paiement refusé pour fonds insuffisants, et une annulation par l'utilisateur. Une fois les 3 scénarios validés et le compte-rendu technique signé, le CMI active vos identifiants réels de production.

💡 Règle d'or après homologation

Pensez à remplacer immédiatement l'URL de la passerelle de test (testpayment.cmi.co.ma) par l'URL de production (payment.cmi.co.ma), à saisir la nouvelle clé Store Key de production et à effectuer un test réel de 10 DH avec votre propre carte bancaire.

Conclusion & Plan d'action

L'intégration de la passerelle CMI sur WooCommerce transforme votre boutique en une plateforme de commerce moderne et crédible. En automatisant la validation des commandes et en réduisant les coûts logistiques des impayés, elle constitue un investissement rapidement amorti pour votre activité.

Questions Fréquentes

Quel est le coût moyen d'une transaction par carte avec le CMI ?

Les commissions sont fixées par votre banque marocaine lors de la signature du contrat commerçant VAD. En règle générale, la commission oscille entre 1,5% et 2,5% HT sur les cartes bancaires marocaines, et jusqu'à 3% à 3,5% sur les cartes internationales Visa ou Mastercard.

Peut-on combiner paiement CMI et paiement à la livraison (COD) ?

Oui, c'est même la configuration optimale au Maroc. Le client a le choix sur la page de paiement entre régler directement par carte bancaire en toute sécurité (avec un rabais ou une livraison offerte pour inciter le pré-paiement) ou payer en espèces à la réception de son colis.

Pourquoi la notification de paiement échoue-t-elle parfois ?

L'erreur la plus fréquente provient d'un pare-feu applicatif (Wordfence, Cloudflare ou extensions de sécurité) qui bloque la requête POST automatique du serveur CMI vers votre boutique. Une exception IP sur les serveurs du CMI est indispensable.

À propos de l'auteur : Ali Ouarzazi

Expert technique e-commerce et développement WordPress basé à Marrakech, spécialisé dans l'intégration des passerelles CMI, Stripe et l'optimisation des tunnels de vente.

Découvrir son parcours complet → • LinkedIn • Contacter directement

✨ Prestations & expertises associées

Prestations recommandées en lien avec cet article

Découvrez les prestations techniques d'Ali Ouarzazi pour concrétiser vos projets web :

Passerelles de paiement au Maroc →

Intégration certifiée des passerelles CMI, PayZone, Stripe et gestion du Cash on Delivery.

Découvrir la prestation →

Création de boutique WooCommerce →

Boutiques en ligne WordPress optimisées pour la vente au Maroc et à l'international.

Découvrir la prestation →

Développement e-commerce complet →

Solutions e-commerce clé en main, synchronisation des stocks et tunnels d'achat fluides.

Découvrir la prestation →

Un projet de site web ou d'optimisation SEO ?

Échangez directement avec Ali Ouarzazi. Devis gratuit sous 24h.

💬 WhatsApp (+212 6 13 46 97 92) 🚀 Demander un devis