Paiements WooCommerce : CinetPay, Wave, Stripe et mobile money

Une boutique qui ne sait pas encaisser ne vend pas. C’est l’étape qui transforme un site vitrine en commerce réel : brancher des moyens de paiement que vos clients utilisent vraiment. Pour un marché où le mobile money domine, cela veut dire accepter Orange Money, Wave, MTN et les cartes — idéalement via un seul agrégateur comme CinetPay, complété si besoin par Stripe pour l’international. Ce tutoriel vous fait connecter ces passerelles à « TechBoutique », du mode test jusqu’à l’encaissement réel.

📍 Guide principal de la série : WooCommerce de zéro : créer une boutique en ligne sur WordPress.

Ce que vous allez apprendre

• Comprendre comment fonctionne une passerelle de paiement ;
• Installer et configurer CinetPay pour accepter le mobile money et les cartes ;
• Ajouter Wave et Stripe selon vos besoins ;
• Tester un paiement en mode bac à sable avant le réel ;
• Passer en production en toute sécurité.

Ce que vous allez construire

Un encaissement opérationnel pour « TechBoutique » : CinetPay branché pour accepter Orange Money, Wave, MTN et les cartes bancaires, testé en bac à sable, puis prêt à passer en réel. Vos clients pourront payer avec le moyen qu’ils ont dans la poche.

Prérequis

• Une boutique avec produits et tunnel de commande fonctionnel (voir Panier, commande et comptes clients) ;
• Un compte marchand chez l’agrégateur choisi (CinetPay, Wave, ou Stripe) ;
• Un site en HTTPS — indispensable pour le paiement ;
• Niveau : débutant à intermédiaire.

⏱️ Temps estimé : environ 35 minutes.

Étape 1 — Comprendre une passerelle de paiement

Avant de configurer quoi que ce soit, saisissez le principe : vous ne manipulez jamais directement l’argent ni les données de carte. La passerelle (l’agrégateur) s’en charge pour vous, de façon sécurisée. Le schéma est toujours le même.

Au moment de payer, WooCommerce redirige le client vers la page sécurisée de l’agrégateur (ou affiche un formulaire fourni par lui). Le client paie là, avec Orange Money, Wave ou sa carte. L’agrégateur encaisse, puis notifie votre boutique du résultat — paiement réussi ou échoué — via un appel serveur appelé webhook (ou IPN). WooCommerce met alors la commande à jour automatiquement. Vous n’avez donc ni à stocker de numéro de carte, ni à gérer la sécurité du paiement : c’est tout l’intérêt de passer par un agrégateur reconnu.

✅ Point d’étape — Vous comprenez que la boutique redirige vers l’agrégateur, qui encaisse puis notifie WooCommerce. Cette notification automatique est ce qui valide la commande.

Étape 2 — Installer le module CinetPay

CinetPay est un agrégateur d’Afrique de l’Ouest et centrale particulièrement adapté : un seul compte donne accès à Orange Money, Wave, MTN, Moov et aux cartes bancaires, avec un module WooCommerce officiel. C’est souvent le choix le plus simple pour couvrir tout le mobile money local d’un coup.

Créez d’abord un compte marchand sur le site de CinetPay et récupérez, dans votre tableau de bord marchand, vos deux identifiants : la clé d’API (apikey) et l’identifiant du site (site_id). Installez ensuite le module CinetPay pour WooCommerce — disponible comme extension — puis activez-le. Le principe d’un agrégateur via plugin est toujours le même : on installe le module, on colle ses clés, et la passerelle apparaît au paiement.

✅ Point d’étape — Le module CinetPay est installé et activé ; un nouveau moyen de paiement apparaît dans WooCommerce → Réglages → Paiements. S’il manque, vérifiez l’activation de l’extension.

Étape 3 — Configurer CinetPay avec vos clés

Le module a besoin de vos identifiants pour parler à CinetPay. C’est l’étape où l’on relie boutique et compte marchand. Allez dans WooCommerce → Réglages → Paiements, ouvrez la configuration de CinetPay, et renseignez votre clé d’API et votre site_id.

Choisissez le mode : commencez impérativement par le mode test (bac à sable) pour ne pas manipuler de vrai argent pendant vos essais. Donnez un titre clair que le client verra au paiement, par exemple « Mobile money et carte (CinetPay) ». Enregistrez. Selon le module, vous pouvez aussi indiquer la devise et les canaux acceptés. Le point essentiel : ne collez jamais vos clés ailleurs que dans ce réglage, et ne les partagez pas — ce sont les clés de votre caisse.

✅ Point d’étape — CinetPay est configuré en mode test avec vos clés. Le moyen de paiement « Mobile money et carte » apparaît dans le tunnel de commande.

Étape 4 — Tester un paiement en bac à sable

Jamais de mise en production sans test. Le mode bac à sable simule un paiement sans débit réel, ce qui vous permet de vérifier toute la chaîne. Passez une commande de test sur « TechBoutique » et choisissez le paiement CinetPay.

Vous êtes redirigé vers l’interface de paiement de l’agrégateur, où vous simulez un paiement (avec les moyens de test fournis par CinetPay). De retour sur la boutique, la page de remerciement doit s’afficher, et surtout la commande doit passer automatiquement au statut « En cours » dans votre administration — preuve que la notification (webhook) a bien fonctionné. Si la commande reste « En attente », c’est généralement que l’URL de notification n’est pas joignable : vérifiez que votre site est bien accessible en HTTPS depuis l’extérieur.

✅ Point d’étape — Une commande de test payée via CinetPay passe automatiquement « En cours ». Si elle reste « En attente », le problème vient de la notification serveur, pas du paiement lui-même.

Étape 5 — Ajouter Wave ou Stripe selon le besoin

CinetPay couvre déjà l’essentiel du mobile money local, mais vous pouvez vouloir des passerelles complémentaires. La logique d’installation reste identique : un module, des clés, un test.

Wave propose sa propre API d’encaissement, intéressante si une large part de vos clients l’utilise et que vous voulez des frais maîtrisés ; on installe le module Wave et l’on renseigne ses clés marchandes. Stripe, lui, est la référence pour les cartes internationales : utile si vous vendez au-delà de la sous-région. On peut très bien proposer plusieurs passerelles côte à côte — CinetPay pour le mobile money local, Stripe pour les cartes étrangères — et laisser le client choisir au paiement. Multiplier les options pertinentes augmente le taux de conversion, à condition de ne pas noyer le client sous dix choix.

Étape 6 — Passer en production

Une fois les tests concluants, le passage en réel est rapide mais demande de la rigueur. Retournez dans la configuration de la passerelle et basculez du mode test au mode production (live). Remplacez, si nécessaire, les clés de test par les clés de production fournies par l’agrégateur.

Faites alors une vraie commande de faible montant avec votre propre moyen de paiement, pour confirmer que tout fonctionne en conditions réelles : l’argent arrive bien, la commande se valide, la notification passe. Vérifiez aussi que votre compte marchand est bien activé côté agrégateur (certains exigent une validation d’identité, le KYC, avant d’encaisser pour de vrai). Une fois ce test réel réussi, « TechBoutique » encaisse réellement. Surveillez les premières commandes de près pour réagir vite en cas d’anomalie.

Choisir entre agrégateur et passerelle directe

Une question revient toujours : faut-il un agrégateur comme CinetPay, ou brancher chaque moyen de paiement directement ? Les deux approches se défendent, et le bon choix dépend de votre situation.

L’agrégateur (CinetPay, PayDunya…) réunit de nombreux canaux — Orange Money, Wave, MTN, Moov, cartes — sous un seul compte, un seul module et un seul contrat. L’intégration est rapide, la couverture large, et vous n’avez qu’un interlocuteur. En contrepartie, l’agrégateur prélève sa propre commission, qui s’ajoute parfois à celle de l’opérateur. C’est le choix idéal pour démarrer vite et couvrir tout le marché local sans multiplier les démarches.

La passerelle directe (l’API d’un opérateur précis, comme Wave) peut offrir des frais plus bas sur ce canal, mais demande une intégration et un contrat par moyen de paiement. C’est pertinent quand un canal représente l’essentiel de vos ventes et que vous voulez optimiser ses frais. Beaucoup de boutiques combinent les deux : un agrégateur pour la couverture générale, et une intégration directe pour le moyen de paiement le plus utilisé. Mesurez vos volumes réels avant d’optimiser : tant que le chiffre est modeste, la simplicité d’un agrégateur l’emporte presque toujours.

Sécuriser ses clés et protéger ses clients

Manipuler des paiements impose une hygiène de sécurité stricte — c’est l’argent de vos clients et la réputation de votre boutique qui sont en jeu. Quelques règles ne souffrent aucune exception.

D’abord, vos clés d’API (apikey, site_id, clés secrètes des passerelles) se traitent comme des mots de passe critiques : elles ne vivent que dans le réglage sécurisé de l’extension, jamais dans un fichier public, jamais dans un dépôt de code partagé, jamais envoyées par messagerie. Si une clé fuite, régénérez-la immédiatement depuis le tableau de bord de l’agrégateur. Ensuite, le HTTPS sur tout le site est obligatoire : sans lui, les données transitent en clair et les redirections de paiement échouent.

Bonne nouvelle : en passant par un agrégateur reconnu, vous ne stockez jamais les numéros de carte de vos clients — c’est l’agrégateur, certifié pour cela, qui les gère sur ses serveurs sécurisés. Vous êtes ainsi déchargé de l’essentiel des contraintes de conformité, à condition de ne pas contourner ce mécanisme. Gardez enfin WooCommerce et vos extensions à jour : une faille dans un module de paiement obsolète est exactement le genre de porte que vous ne voulez pas laisser ouverte. Ces réflexes, simples mais constants, sont ce qui sépare une boutique sûre d’un incident coûteux.

Pièges fréquents

Réalités du terrain

Le choix de la passerelle est d’abord une question de frais et de couverture. Comparez les commissions par transaction et privilégiez les moyens que vos clients utilisent réellement : dans la sous-région, un client qui ne voit pas Orange Money ou Wave au paiement abandonne souvent. Un agrégateur comme CinetPay a l’avantage de réunir ces canaux sous un seul contrat et un seul module, ce qui simplifie la vie. Côté sécurité, le HTTPS est non négociable, et vos clés d’API se traitent comme des mots de passe : jamais dans le code public, jamais partagées. Enfin, testez toujours en bac à sable, puis avec une petite commande réelle — c’est le seul moyen d’être sûr que l’argent arrive vraiment.

Récapitulatif

Vous savez désormais comment fonctionne une passerelle, comment installer et configurer CinetPay pour encaisser le mobile money et les cartes, comment ajouter Wave ou Stripe, tester en bac à sable et passer en production en sécurité. « TechBoutique » encaisse pour de vrai. Il reste à finaliser l’expérience d’achat et la logistique : livraison, taxes et e-mails, dans le tutoriel suivant.

Aide-mémoire

À vous de jouer

Défi : configurez CinetPay en mode test, passez une commande payée en bac à sable, et vérifiez dans l’administration que la commande passe automatiquement « En cours » grâce à la notification.

Tutoriels associés

• Panier, commande et comptes clients — le parcours en amont du paiement.
• Livraison, taxes et e-mails de la boutique — la suite.

Pour aller plus loin

• 🔝 Revenir au guide principal : WooCommerce de zéro : créer une boutique en ligne sur WordPress.
• Documentation officielle : docs.cinetpay.com (module WooCommerce) et woocommerce.com/document/payments.

FAQ

CinetPay permet-il d’accepter Orange Money et Wave ensemble ?
Oui. CinetPay est un agrégateur : un seul compte et un seul module donnent accès à Orange Money, Wave, MTN, Moov et aux cartes, sans contrat séparé pour chaque canal.

Faut-il du HTTPS pour encaisser ?
Oui, c’est indispensable. Sans certificat SSL, les redirections de paiement échouent et la sécurité n’est pas assurée.

Pourquoi ma commande reste-t-elle « en attente » après un paiement réussi ?
Parce que la notification serveur (webhook) de l’agrégateur n’a pas atteint votre site. Vérifiez qu’il est joignable publiquement en HTTPS.

Peut-on proposer plusieurs passerelles ?
Oui. On peut activer CinetPay pour le mobile money local et Stripe pour les cartes internationales, et laisser le client choisir — sans toutefois multiplier les options à l’excès.