Guide pratique · E-commerce

Comment intégrer CMI à WooCommerce au Maroc en 7 jours

TL;DR — Brancher la passerelle CMI à WooCommerce au Maroc prend 7 jours : 2 jours d'ouverture du contrat marchand (banque acquéreuse + dossier CMI), 1 jour d'installation plugin, 2 jours de paramétrage 3DS et URLs de retour, 1 jour de tests en sandbox CMI, 1 jour de bascule production. Frais marchand typiques : 1,5–2,2 % par transaction selon volume.

CMI, le passage obligé pour encaisser en MAD

Au Maroc, encaisser en dirhams par carte sur un e-commerce passe quasi systématiquement par le CMI (Centre Monétique Interbancaire) — l'opérateur national qui route les paiements vers les banques acquéreuses (Attijariwafa Bank, BMCE/Bank of Africa, BP, CIH, Société Générale Maroc, Crédit du Maroc).

Les alternatives (Stripe, PayPal, Adyen) ne traitent pas le MAD nativement et facturent en devise étrangère avec change défavorable. Pour un e-commerce qui vise le marché local, CMI n'est pas une option : c'est le rail de paiement par défaut.

Pré-requis avant de démarrer

Une société marocaine immatriculée (RC, ICE, IF, patente), un compte bancaire pro chez une banque acquéreuse, un site WooCommerce en HTTPS avec un certificat SSL valide, et CGV + politique de remboursement publiées. Le CMI vérifie ces éléments avant d'activer la passerelle en production.

Côté technique : WordPress 6+ et WooCommerce 8+, accès SFTP/SSH au serveur, et un environnement de pré-production pour les tests sandbox.

Les 6 étapes de l'intégration

Pré-requis

  • Société marocaine immatriculée (RC, ICE, IF)
  • Compte bancaire pro chez une banque acquéreuse marocaine
  • Site WooCommerce 8+ en HTTPS avec SSL valide
  • CGV et politique de remboursement publiées
  • Accès SFTP/SSH au serveur de production

  1. Étape 1

    Jours 1–2 — Ouverture du contrat marchand

    Dossier déposé auprès de la banque acquéreuse : extrait RC, statuts, KYC dirigeants, RIB, URL du site, description de l'activité. La banque transmet au CMI qui retourne un Store ID, Store Key et accès à la sandbox sous 48–72h ouvrées.

  2. Étape 2

    Jour 3 — Installation du plugin CMI pour WooCommerce

    Installation d'un plugin officiel ou maintenu activement (plusieurs options open-source existent). Configuration des credentials sandbox d'abord. Activation du mode debug pour tracer les requêtes durant les tests.

  3. Étape 3

    Jour 4 — Paramétrage 3D Secure et URLs de retour

    Activation 3DS obligatoire (sinon refus côté banques émettrices). Configuration des trois URLs : OkUrl (succès), FailUrl (échec), CallbackUrl (notification serveur-à-serveur). La CallbackUrl doit retourner un statut HTTP 200 sans redirection.

  4. Étape 4

    Jour 5 — Tests en sandbox CMI

    Banc de tests avec les cartes de test fournies par le CMI : succès, échec 3DS, timeout, refus banque, double soumission. Vérification que chaque cas crée la bonne commande WooCommerce avec le bon statut (processing, failed, on-hold).

  5. Étape 5

    Jour 6 — Validation CMI et passage en production

    Soumission des captures d'écran de tests au CMI pour validation. Une fois validé, le CMI bascule les credentials en production. Mise à jour du plugin avec les credentials prod, désactivation du mode sandbox.

  6. Étape 6

    Jour 7 — Monitoring et premier paiement réel

    Premier paiement réel par un membre de l'équipe (montant minimal). Vérification du virement du CMI vers la banque acquéreuse (J+1 à J+3 selon banque). Mise en place d'alertes sur les échecs de paiement (Slack, WhatsApp, email).

Questions fréquentes

Combien coûte l'intégration CMI ?+
Côté CMI : pas de frais d'installation, mais des frais marchand de 1,5 à 2,2 % par transaction selon le volume négocié avec la banque. Côté intégration : 8 000 à 25 000 MAD selon la complexité (mono-devise vs multi-devise, abonnements, remboursements partiels).
Combien de temps prend l'ouverture du compte marchand ?+
Compter 5 à 15 jours ouvrés selon la banque acquéreuse et la complétude du dossier. Attijariwafa Bank et CIH sont historiquement les plus rapides ; BMCE/Bank of Africa et BP peuvent demander des justificatifs complémentaires pour les nouveaux e-commerçants.
Le CMI accepte-t-il Visa, Mastercard et Amex ?+
Visa et Mastercard nationales (cartes émises au Maroc) sont systématiquement acceptées. Les cartes internationales nécessitent une activation séparée auprès du CMI (frais marchand légèrement supérieurs, autour de 2,5 %). Amex se traite via un contrat dédié American Express Maroc, hors CMI.
Peut-on faire des paiements récurrents (abonnements) via CMI ?+
Oui, via le mécanisme de tokenisation CMI qui stocke la carte côté CMI (jamais chez le marchand). Compatible avec WooCommerce Subscriptions moyennant un connecteur dédié. Le 3DS doit être validé à la première transaction puis n'est rejoué que sur changement de carte.
Que faire si la CallbackUrl ne reçoit rien ?+
Cause la plus fréquente : un WAF (Cloudflare, Wordfence) qui bloque les IPs CMI. Solution : whitelister les plages d'IP CMI documentées, désactiver toute redirection HTTP→HTTPS sur la CallbackUrl, et vérifier que le serveur renvoie bien 200 OK en moins de 30 secondes.

/ À lire ensuite

Un brief technique sur ce sujet ?

Atelier de cadrage gratuit. Un fondateur, pas un commercial.

WhatsAppFormulaire de contact