En bref : pour accepter Orange Money sur WooCommerce au Sénégal et en Côte d’Ivoire, avec Wave en plus, vous reliez votre boutique à votre propre compte marchand PawaPay grâce à une extension comme Fosia Pay. Le client saisit son numéro, valide le paiement sur son téléphone (code PIN pour Orange Money, application Wave pour Wave), et la commande passe en payée dès que PawaPay le confirme. Les montants sont encaissés en francs CFA (XOF).
À Dakar, Thiès, Abidjan ou Bouaké, le client qui achète en ligne a rarement une carte bancaire sous la main. Il a son téléphone, et dans ce téléphone, Orange Money, Wave ou un autre portefeuille mobile. Une boutique WooCommerce qui ne propose que la carte perd une partie de ces acheteurs au moment de payer. Ce guide explique ce qui est propre à ces deux pays, comment se passe la validation pour chaque réseau, et comment tester avant d’encaisser de vrais paiements.
Quels réseaux dans chaque pays ?
Fosia Pay passe par PawaPay, le prestataire qui se connecte aux opérateurs Mobile Money. Sur sa page des marchés, PawaPay indique :
- Sénégal : Orange, Wave et Yas (anciennement Free).
- Côte d’Ivoire : MTN, Orange, Moov et Wave.
Un point à vérifier avant de vous lancer : sur sa page des offres, PawaPay classe Orange en Côte d’Ivoire parmi les opérateurs réservés à l’offre Enterprise, avec la mention « coming soon » (bientôt disponible). Au Sénégal, Orange Money n’a pas cette restriction. Dans tous les cas, la disponibilité dépend de ce que PawaPay a activé sur votre compte marchand : demandez la liste à PawaPay avant d’annoncer un réseau à vos clients.
Code PIN ou application : deux façons de valider
Tous les réseaux ne fonctionnent pas de la même manière, et c’est la principale différence à comprendre.
Orange Money, MTN, Moov, Yas : la demande de code PIN
Le client saisit son numéro, une demande de paiement arrive sur son téléphone, il tape son code PIN, c’est terminé. PawaPay appelle ce mode « PROVIDER_AUTH » dans sa documentation.
Wave : la redirection vers l’application
Wave utilise une validation par redirection. D’après la documentation de PawaPay, le client est envoyé vers une page Wave : s’il achète depuis le téléphone où l’application Wave est installée, il est redirigé directement dans l’application pour confirmer ; s’il achète depuis un ordinateur, il voit un code QR à scanner avec son téléphone. Il revient ensuite sur la boutique.
Conseil pratique : indiquez sur votre page de paiement que les clients Wave doivent avoir l’application sur leur téléphone. Cela évite des abandons inutiles.
Installer Fosia Pay et le relier à PawaPay
- Installez l’extension. Fosia Pay Lite est un téléchargement gratuit sur pay.fosiarw.com (bientôt sur WordPress.org). Dans le menu Extensions de WordPress, téléversez le fichier ZIP, puis activez l’extension.
- Connectez PawaPay. Dans WooCommerce, Réglages, Paiements, ouvrez Fosia Pay et collez votre jeton d’API PawaPay de test (sandbox). Copiez l’URL de rappel (callback) affichée et collez-la dans votre tableau de bord PawaPay, puis activez les rappels signés. Le guide Fosia Pay montre chaque écran.
- Encaissez. Le client valide sur son téléphone et Fosia Pay marque la commande comme payée après avoir vérifié la confirmation signée de PawaPay (norme RFC 9421). Une fausse notification ne peut donc pas valider une commande.
Les montants arrivent dans votre propre portefeuille PawaPay. FOSIA ne prend aucune commission : seuls les frais de traitement de PawaPay s’appliquent.
Tester en sandbox avec des numéros sénégalais et ivoiriens
PawaPay publie des numéros de test qui simulent un paiement réussi ou refusé, sans argent réel. Quelques exemples de numéros qui renvoient un paiement réussi :
| Pays | Réseau | Numéro de test (paiement réussi) |
|---|---|---|
| Sénégal | Orange | 221773456789 |
| Sénégal | Free (Yas) | 221763456789 |
| Côte d’Ivoire | Orange | 2250734567890 |
| Côte d’Ivoire | MTN | 2250503456789 |
La même page donne aussi des numéros qui échouent (solde insuffisant, paiement non approuvé), utiles pour voir ce que votre client lira en cas de problème. En sandbox, aucune demande de code PIN n’arrive sur un téléphone : le résultat est simulé. Wave n’apparaît pas dans cette liste de numéros de test ; prévoyez donc un petit paiement réel pour vérifier le parcours Wave une fois en production.
Prix en euros, encaissement en francs CFA
Beaucoup de boutiques ouest-africaines affichent leurs prix en euros ou en dollars pour la diaspora. Avec Fosia Pay, le pays, la devise et le réseau sont lus à partir du numéro de téléphone, et le prix de la boutique est converti dans la devise du client au taux du moment. Le client valide donc un montant en XOF sur son téléphone.
Un détail utile : d’après la liste des opérateurs de PawaPay, les réseaux en XOF au Sénégal et en Côte d’Ivoire n’acceptent pas les décimales. Si vous fixez vos prix directement en francs CFA, choisissez des montants ronds (par exemple 15 000 XOF plutôt que 14 999,50).
Lite ou Pro pour une boutique à Dakar ou Abidjan ?
- Lite, gratuit : paiements illimités sur un site, paiement sur une page sécurisée hébergée par PawaPay, compatible avec la page de commande classique et en blocs.
- Pro, 19,99 $ par an ou 59 $ une fois à vie : paiement natif sur votre page de commande (la demande arrive sur le téléphone sans quitter la boutique), vérification du numéro pendant la saisie, alerte quand un opérateur est en panne, nouvel essai en un geste, remboursements depuis la commande WooCommerce, liens de paiement et affiches QR.
Les licences annuelles ne se renouvellent jamais automatiquement ; sans renouvellement, la boutique continue d’encaisser en mode Lite. Tous les détails sont sur la page des tarifs, avec remboursement complet sous 14 jours. Pour une vue d’ensemble du produit, lisez aussi notre article sur le Mobile Money sur WooCommerce avec Fosia Pay.
Questions fréquentes
Mes clients Wave doivent-ils installer quelque chose ?
Ils doivent avoir l’application Wave sur leur téléphone, car Wave valide les paiements par redirection vers l’application. Depuis un ordinateur, ils scannent un code QR avec ce téléphone.
Puis-je vendre à la fois au Sénégal et en Côte d’Ivoire ?
Oui, avec la même extension et le même compte PawaPay, si PawaPay a activé ces deux marchés et leurs réseaux sur votre compte marchand.
Orange Money est-il disponible partout ?
Pas forcément sur toutes les offres : PawaPay réserve pour l’instant Orange en Côte d’Ivoire à son offre Enterprise. Vérifiez auprès de PawaPay ce qui est activé sur votre compte.
Fosia Pay remplace-t-il le paiement par carte ?
Non. Fosia Pay sert au Mobile Money et fonctionne à côté d’une passerelle carte comme Stripe ou PayPal, pour laisser chaque client choisir.
L’extension est-elle en français ?
Oui, Fosia Pay est disponible en anglais et en français, et le client voit les étapes de validation de son opérateur dans l’une ou l’autre langue.
Prêt à vous lancer ? Téléchargez Fosia Pay Lite et faites vos premiers tests en sandbox. Vous préférez qu’on s’en occupe ? Découvrez nos produits, nos formules Digital-as-a-Service ou réservez un appel gratuit.
