Accepter les paiements en ligne en Côte d'Ivoire : le guide complet

En bref

• En Côte d'Ivoire, la plupart de vos clients paient avec un portefeuille mobile money : Wave, Orange Money, MTN MoMo. La carte bancaire complète l'offre, surtout pour la diaspora.
• Vous pouvez intégrer chaque opérateur séparément ou passer par une passerelle de paiement qui les regroupe derrière une seule API.
• Une intégration fiable repose sur trois règles : créer le paiement côté serveur, attendre le webhook signé avant de livrer, et ne jamais payer deux fois la même commande.

Pourquoi le mobile money est incontournable

Dans l'UEMOA, la BCEAO recensait fin 2024 près de 248,7 millions de comptes de monnaie électronique et environ 11 milliards d'opérations sur l'année. Le mobile money est devenu le premier moyen de paiement numérique de la région, bien devant la carte bancaire.

Pour un site ivoirien, cela signifie que le bouton « Payer avec Wave » ou « Payer avec Orange Money » compte souvent plus que le formulaire de carte. Un client qui ne trouve pas son portefeuille habituel abandonne son panier ou vous écrit sur WhatsApp pour payer « à la main », ce qui vous fait perdre du temps et de la traçabilité.

Les trois façons d'accepter les paiements

1. Le paiement manuel

Le client envoie l'argent sur votre numéro, puis une capture d'écran. C'est gratuit à mettre en place, mais rien n'est automatique : vous vérifiez chaque paiement à la main, les erreurs de montant sont fréquentes et les fraudes par fausse capture existent. Cette méthode ne tient pas au-delà de quelques commandes par jour.

2. L'intégration directe de chaque opérateur

Vous signez avec chaque opérateur, obtenez ses accès techniques et développez une intégration par portefeuille. Vous gardez la main, mais vous multipliez les contrats, les API à maintenir, les formats de notification et les rapprochements comptables.

3. La passerelle de paiement (agrégateur)

Une passerelle comme NguePay regroupe les opérateurs derrière une seule API et un seul tableau de bord. Vous intégrez une fois, et vous proposez Orange Money et la carte, puis Wave et MTN MoMo dès leur ouverture. En échange, la passerelle prélève une commission sur chaque paiement réussi.

Les étapes d'une intégration fiable

1. Ouvrez un compte de test. Travaillez d'abord en sandbox, avec de faux paiements, pour ne jamais tester avec de l'argent réel.
2. Créez le paiement depuis votre serveur. Le montant doit être calculé côté serveur, à partir de votre base de données, jamais à partir d'une valeur envoyée par le navigateur.
3. Utilisez votre numéro de commande comme référence. Une passerelle sérieuse refuse d'encaisser deux fois la même référence, ce qui vous protège des doubles clics et des coupures réseau.
4. Redirigez le client ou laissez-le valider sur son téléphone. Selon le moyen de paiement, le client est redirigé vers une page de paiement (Orange Money, carte) ou reçoit une demande sur son téléphone.
5. Attendez le webhook avant de livrer. Le retour du client sur votre site ne prouve rien : seule la notification serveur signée confirme le paiement.
6. Gérez les échecs. Solde insuffisant, demande ignorée, paiement expiré : proposez au client de réessayer avec un autre moyen de paiement.
7. Passez en live. Une fois votre dossier marchand validé, remplacez vos clés de test par vos clés de production. Le code ne change pas.

Avec NguePay, ces étapes sont détaillées avec des exemples de code dans la documentation de l'API.

Sécuriser vos paiements : les webhooks signés

Le webhook est l'appel que la passerelle envoie à votre serveur quand un paiement change d'état. C'est lui qui doit déclencher la livraison. Trois précautions :

• Vérifiez la signature de chaque webhook avant de le traiter. Chez NguePay, il s'agit d'un HMAC-SHA256 calculé avec votre secret. Une requête sans signature valide doit être rejetée.
• Refusez les webhooks trop anciens (plus de quelques minutes), pour éviter qu'un attaquant ne rejoue une ancienne notification.
• Traitez chaque événement une seule fois. Une passerelle renvoie un webhook si votre serveur ne répond pas : appuyez-vous sur l'identifiant de la transaction pour ne pas livrer deux fois.

La section Webhooks de la documentation donne un exemple complet de vérification en Node.js et en PHP.

Combien ça coûte ?

Les passerelles facturent en général un pourcentage du montant, parfois avec des frais fixes, uniquement sur les paiements réussis. Comparez toujours sur un exemple concret : pour un panier de 25 000 XOF payé avec Orange Money, NguePay prélève 1,5 % + 100 XOF, soit 475 XOF, et vous recevez 24 525 XOF. Le détail des offres est sur la page Tarifs.

Regardez aussi les coûts cachés : frais d'installation, abonnement, frais de reversement, délai avant de recevoir vos fonds. Un tarif bas avec des reversements lents peut peser sur votre trésorerie.

Les erreurs qui coûtent cher

• Livrer sur la page de retour. Un client peut revenir sur votre site sans avoir payé. Attendez toujours le webhook.
• Mettre la clé secrète dans le navigateur ou l'application mobile. Elle donne accès à votre compte : elle reste sur votre serveur.
• Calculer le montant dans le navigateur. Un client malveillant peut le modifier. Calculez-le côté serveur.
• Oublier les numéros de téléphone. En Côte d'Ivoire, les numéros ont 10 chiffres : 07 pour Orange, 05 pour MTN, 01 pour Moov. Un numéro mal saisi fait échouer le paiement.
• Tester en production. Utilisez le sandbox : il simule les succès et les échecs sans débiter personne.

Questions fréquentes