Intégrer Mobile Money sur WooCommerce en Côte d'Ivoire – Guide Complet 2026

📱 Guide Technique 2026

Intégrer Mobile Money sur WooCommerce en Côte d'Ivoire

Orange Money, MTN, Moov et Wave sur votre boutique en ligne — via CinetPay ou FedaPay en moins de 2 heures.

10 min de lecture
Mis à jour : Février 2026
Niveau : Débutant–Intermédiaire
Bonne nouvelle Vous n'avez pas besoin d'un compte séparé chez chaque opérateur. Un agrégateur comme CinetPay ou FedaPay couvre Orange Money, MTN, Moov et Wave avec un seul plugin WooCommerce.

Pourquoi Mobile Money est votre priorité absolue

En Côte d'Ivoire, plus de 72% des transactions e-commerce se font via Mobile Money. Vos clients n'ont pas de carte bancaire, ils paient depuis leur téléphone. Ne pas intégrer Mobile Money, c'est potentiellement exclure 7 acheteurs sur 10.

Les quatre opérateurs principaux à couvrir :

OpérateurPart de marché CISupporté parFrais moy. (marchand)
🟠 Orange Money~45%CinetPay, FedaPay, PayDunya, Paystack CI2–3%
🟡 MTN Mobile Money~25%CinetPay, FedaPay, Paystack CI2–3%
🔵 Wave~20% (croissant)CinetPay, Wave API directe1–2%
🟣 Moov Money~8%CinetPay, FedaPay2–3%

Choisir son agrégateur : CinetPay vs FedaPay vs PayDunya

CritèreCinetPayFedaPayPayDunya
Opérateurs CI couvertsOrange, MTN, Moov, Wave + cartesOrange, MTN, Moov + cartesOrange, MTN, Moov + cartes
Plugin WooCommerce officiel✓ Oui✓ Oui✓ Oui
Sandbox de test✓ Complet✓ Complet~ Partiel
Documentation APITrès complèteComplèteCorrecte
Délai virement marchandT+1 à T+3T+1 à T+2T+2 à T+5
Wave intégré✓ Oui✗ Non✗ Non
💡 Notre recommandation 2026 CinetPay pour sa couverture Wave + cartes en un seul plugin. Si vous avez une clientèle beninoise ou togolaise significative, combinez avec FedaPay (couverture UEMOA élargie).

Configuration pas-à-pas avec CinetPay

1

Ouvrir votre compte CinetPay Business

Sur cinetpay.com > Créer un compte > Type "Entreprise". Documents requis : RCCM, IFU/NCC, pièce d'identité gérant, RIB ou numéro de compte bancaire CI. Durée de vérification : 24 à 72h ouvrables.

2

Récupérer vos clés API

Dashboard CinetPay > Paramètres > Intégrations. Récupérer votre apiKey et votre siteId. Disponibles en mode Sandbox (test) et Production. Ne jamais partager ces clés publiquement.

3

Installer "CinetPay for WooCommerce"

WordPress > Extensions > Ajouter > Rechercher "CinetPay WooCommerce". Ou télécharger depuis le dépôt officiel CinetPay. Activer l'extension. WooCommerce > Paramètres > Paiements > CinetPay.

4

Configurer le plugin

Renseigner apiKey et siteId (mode test d'abord), sélectionner devise XOF, activer les opérateurs souhaités. Configurer l'URL de retour et de notification.

5

Configurer les webhooks IPN

Dashboard CinetPay > Paramètres > Notifications. URL à renseigner : https://votresite.ci/?wc-api=wc_cinetpay. Utiliser l'outil "Tester IPN" de CinetPay pour confirmer la réception.

6

Tests par opérateur (mode Sandbox)

CinetPay fournit des numéros de test par opérateur dans sa documentation. Effectuer minimum 3 tests par opérateur activé : transaction réussie, transaction échouée, remboursement. Vérifier à chaque fois le statut WooCommerce.

7

Passer en mode Production

Remplacer les clés Sandbox par les clés Production dans le plugin. Effectuer une vraie transaction test (petit montant). Vérifier le virement sur votre compte bancaire dans les délais annoncés (T+1 à T+3).

Ajouter Wave séparément (recommandé)

Bien que CinetPay intègre Wave, certaines boutiques préfèrent une intégration directe Wave Marchands pour des frais plus bas (environ 1% vs 2–3% via agrégateur). Voici la démarche :

  • Créer un compte Wave Business sur wave.com/business
  • Activer le paiement marchand en ligne (pièces légales requises)
  • Récupérer les clés API Wave Marchands
  • Utiliser le plugin "Wave WooCommerce" ou développer l'intégration via l'API Wave
  • Configurer le webhook Wave pour les confirmations de paiement

Les erreurs qui coûtent des ventes

  • IPN non configuré — Le client paie, la commande reste "En attente". Il vous appelle en colère, il a déjà débité son Mobile Money.
  • Tests ignorés sur chaque opérateur — Orange Money peut fonctionner parfaitement pendant que MTN échoue silencieusement.
  • Mode sandbox oublié en production — Les paiements semblent réussis (sandbox les accepte tous), mais aucun argent ne rentre.
  • SSL absent ou expiré — CinetPay et tous les agrégateurs sérieux rejettent les sites sans HTTPS.
  • Oublier Wave — En 2026, ne pas proposer Wave sur une boutique abidjanaise, c'est perdre 20% de transactions potentielles.
// Exemple configuration plugin CinetPay WooCommerce (wp-admin)

// WooCommerce > Paramètres > Paiements > CinetPay > Gérer

Activer     : ✓ Oui

Mode        : Sandbox → Production (après tests)

API Key     : votre_api_key_ici

Site ID     : votre_site_id_ici

Devise      : XOF

URL retour  : https://votresite.ci/mon-compte/commandes/

IPN URL     : https://votresite.ci/?wc-api=wc_cinetpay

Opérateurs  : Orange ✓  MTN ✓  Moov ✓  Wave ✓  Visa/MC ✓
📊 Cas réel — E-commerce alimentaire, Yopougon

Une épicerie en ligne à Yopougon n'acceptait que les espèces à la livraison. En intégrant CinetPay (Orange + MTN + Wave), ils ont réduit les commandes annulées de 35% et augmenté leur panier moyen de 22% (les clients commandent davantage quand ils paient à l'avance).

–35%Annulations
+22%Panier moyen
3jPour intégrer

Questions fréquentes

C'est un problème de webhook IPN. Étapes : 1) Vérifiez dans votre dashboard CinetPay que la transaction apparaît comme "réussie". Si oui, le problème est côté WooCommerce. 2) Allez dans WooCommerce > Commandes, ouvrez la commande, cliquez "Vérifier paiement" si disponible. 3) Vérifiez que l'URL IPN est bien renseignée et que votre serveur répond HTTP 200. 4) En dernier recours, passez la commande manuellement en "Traitement" et confirmez le paiement reçu.
Oui, avec des plugins WooCommerce de type "Checkout Fees" qui ajoutent automatiquement les frais selon le mode de paiement sélectionné. Attention : en Côte d'Ivoire, certains opérateurs Mobile Money interdisent contractuellement de facturer ces frais aux clients finaux. Vérifiez les CGU de votre agrégateur avant de l'activer.
Non, le Mobile Money ne supporte pas les prélèvements automatiques (pas de tokenisation des numéros Mobile Money). Pour les abonnements, vous devrez soit demander un paiement manuel chaque période, soit utiliser une solution de paiement par carte qui supporte la tokenisation (via une entité éligible Stripe/Paystack).

Commentaires

Posts les plus consultés de ce blog

Sécurité Paiements WooCommerce CI – 3D Secure, Fraude, SSL – Guide 2026

Résoudre les Blocages de Paiement WooCommerce CI – CinetPay, Paystack, Mobile Money – Guide 2026