Résoudre les Blocages de Paiement WooCommerce CI – CinetPay, Paystack, Mobile Money – Guide 2026
Résoudre les blocages de paiement WooCommerce CI
Commandes bloquées, IPN non reçu, compte passerelle suspendu, Mobile Money refusé — diagnostic et solution pour chaque problème.
Arbre de diagnostic : identifier votre problème
| Symptôme | Cause probable | Section |
|---|---|---|
| Client a payé → commande en "En attente" | IPN / webhook non configuré ou non reçu | → IPN |
| Paiement refusé côté client | Solde insuffisant, limite dépassée, compte Mobile Money bloqué | → Refus client |
| Page de paiement ne s'ouvre pas | Clé API incorrecte, SSL absent, URL mal configurée | → Configuration |
| Un opérateur fonctionne, pas l'autre | Opérateur non activé ou non supporté dans votre forfait CinetPay | → Opérateurs |
| Compte passerelle suspendu | Documents expirés, activité suspecte, CGU non respectées | → Suspension |
| Virements passerelle non reçus | Coordonnées bancaires incorrectes, délai normal T+1 à T+5 | → Virements |
Problème 1 : Commandes bloquées "En attente" — Résolution IPN
Le webhook IPN (Instant Payment Notification) est le mécanisme par lequel CinetPay/Paystack prévient votre boutique qu'un paiement a été effectué. S'il est mal configuré, WooCommerce ne sait jamais que le client a payé.
Vérifier que le paiement a bien eu lieu
Connectez-vous à votre dashboard CinetPay/Paystack. Cherchez la transaction par montant ou référence. Si elle n'apparaît pas → le client n'a pas finalisé le paiement (ne l'a pas confirmé sur son téléphone). Si elle apparaît comme "réussie" → problème IPN, continuez.
Vérifier l'URL IPN dans le dashboard passerelle
Dans CinetPay : Paramètres > Notifications > URL IPN. L'URL correcte est https://votresite.ci/?wc-api=wc_cinetpay (vérifier dans la documentation du plugin). Tester avec le bouton "Tester IPN" — vous devez recevoir un HTTP 200 en retour.
Vérifier les logs WooCommerce
WooCommerce > État > Journaux. Chercher les fichiers de log liés à votre passerelle (ex: cinetpay-xxxx.log). Des erreurs de parsing ou d'authentification y apparaissent. Vérifier aussi que votre serveur ne renvoie pas une redirection (301) sur l'URL IPN — CinetPay n'aime pas les redirections.
Mettre à jour la commande manuellement (urgence)
En attendant de résoudre l'IPN : WooCommerce > Commandes > [la commande] > Modifier le statut > "Traitement" ou "Terminé". Notez que la commande a été vérifiée manuellement dans le dashboard passerelle. Procéder à la livraison.
Problème 2 : Paiement refusé côté client
| Message d'erreur | Cause | Solution |
|---|---|---|
| "Solde insuffisant" | Client n'a pas assez sur son compte Mobile Money | Informer le client — pas d'action marchand nécessaire |
| "Transaction échouée" | Limite journalière/mensuelle Mobile Money atteinte | Suggérer un autre opérateur ou moyen de paiement |
| "Code OTP incorrect" | Client a mal entré le code SMS | Lui demander de retenter (3 tentatives max, puis blocage temporaire) |
| "Carte refusée" | Carte non activée pour les paiements en ligne, ou 3DS échoué | Suggérer d'activer les paiements en ligne sur sa carte (sa banque) |
| Pas de message, page blanche | Problème côté serveur (timeout, erreur PHP) | Vérifier les logs serveur PHP, contacter l'hébergeur |
Problème 3 : La page de paiement ne s'ouvre pas
- Vérifier que les clés API (apiKey, siteId) sont correctement copiées — sans espace avant/après
- Confirmer que vous utilisez les clés Production (pas Sandbox) si le site est en ligne
- Vérifier que le SSL est actif (https://) — CinetPay bloque les sites en http://
- Tester en navigation privée (les extensions navigateur peuvent bloquer le redirect de paiement)
- Vérifier que le plugin WooCommerce est activé et à jour
- Désactiver temporairement les autres plugins (conflit potentiel) et tester
Problème 4 : Un opérateur Mobile Money ne fonctionne pas
- Vérifier dans le dashboard CinetPay > Intégrations que l'opérateur est bien activé sur votre compte
- Certains opérateurs ont des restrictions géographiques (ex: MTN CI vs MTN Ghana)
- Si vous avez changé d'hébergeur récemment, les IPs peuvent avoir changé — vérifier les whitelist éventuelles
Problème 5 : Compte passerelle suspendu
Identifier la raison de la suspension
Connectez-vous au dashboard — un message d'alerte doit expliquer la raison. Si pas de message, contacter le support par email. Raisons courantes : documents expirés, activité inhabituelle, taux de remboursements élevé.
Préparer les documents à jour
RCCM valide, IFU/NCC à jour, pièce d'identité du gérant non expirée, RIB bancaire actif. Scanner en haute qualité (PDF, minimum 200 DPI).
Contacter le support passerelle
CinetPay : support@cinetpay.com — délai habituel 24–48h ouvrables. Paystack CI : support@paystack.com (chat disponible). Soyez précis sur l'objet et joignez tous les documents dès le premier email.
Problème 6 : Virements passerelle non reçus
Si les transactions apparaissent réussies dans le dashboard mais l'argent n'arrive pas sur votre compte bancaire :
- Vérifier les délais normaux : CinetPay T+1 à T+3, FedaPay T+1 à T+2 (jours ouvrables, hors week-ends)
- Confirmer les coordonnées bancaires dans votre profil passerelle (IBAN/RIB)
- Vérifier le seuil minimum de virement (certaines passerelles ne virent qu'à partir de 5 000 XOF)
- Consulter le dashboard > Virements pour voir l'historique et les statuts
- Contacter le support si aucun virement n'a été initié après 5 jours ouvrables
Une boutique recevait des paiements CinetPay mais aucune commande ne passait en "Traitement" depuis 3 jours. L'IPN fonctionnait en test mais pas en production. Cause : le plugin avait mis en cache l'ancienne URL IPN (http:// au lieu de https://). Après correction de l'URL et vidage du cache, tout est revenu à la normale en moins d'une heure.
Commentaires
Enregistrer un commentaire