Quels moyens de paiement mobile proposer en Côte d’Ivoire ?
En Côte d’Ivoire, vos clients paient avec Orange Money, MTN MoMo, Moov Money ou Wave. Chacun a son compte chez l’un de ces opérateurs, parfois chez plusieurs.
Proposer un seul opérateur, c’est perdre les clients qui n’y ont pas de compte, ou les obliger à un transfert compliqué au moment de payer. L’objectif est donc d’afficher, sur la même page, tous les opérateurs que vos clients utilisent, avec un parcours aussi court que possible.
Selon l’opérateur et le prestataire, le client confirme le paiement en saisissant son code secret sur son téléphone, en validant une demande dans son application ou en suivant un lien de paiement. Dans tous les cas, ce code n’est jamais saisi sur votre site : c’est une bonne nouvelle pour votre sécurité.
Si une partie de vos clients paie depuis l’étranger, pensez aussi à la carte bancaire, et vérifiez que votre prestataire la propose. Pour une boutique complète, avec catalogue, livraison et stock, voyez notre page site e-commerce à Abidjan.
Agrégateur de paiement ou API directe : que choisir ?
Une API (interface de programmation) est la porte par laquelle votre site parle au système de paiement. Deux architectures sont possibles.
L’agrégateur de paiement
Un prestataire unique se connecte aux différents opérateurs à votre place. Vous intégrez une seule API, signez un seul contrat et suivez toutes les transactions dans un seul tableau de bord. L’agrégateur reverse ensuite les montants encaissés sur votre compte, frais déduits.
L’API directe d’un opérateur
Vous contractez avec chaque opérateur, un par un, et développez une intégration pour chacun. Vous gagnez en contrôle et pouvez négocier vos conditions opérateur par opérateur, au prix de démarches et d’une maintenance multipliées. La disponibilité de ces API et leurs conditions d’accès sont à vérifier auprès de chaque opérateur.
| Critère | Agrégateur de paiement | API directe de l’opérateur |
|---|---|---|
| Intégration | Une seule pour plusieurs opérateurs | Une par opérateur, chacune avec ses règles |
| Démarches | Un contrat, un dossier de vérification | Un contrat et un dossier par opérateur |
| Frais | Commission de l’agrégateur, à négocier | Conditions de chaque opérateur, à négocier une par une |
| Suivi | Un tableau de bord pour toutes les transactions | Un espace par opérateur, à consolider vous-même |
| Reversements | Groupés, selon le calendrier de l’agrégateur | Sur chaque compte marchand opérateur |
| Dépendance | Vous dépendez de la disponibilité d’un intermédiaire | Plus de contrôle, mais plus de code à maintenir |
| Pour qui | La plupart des PME, un lancement, plusieurs opérateurs | Gros volumes, besoin très spécifique, un opérateur dominant chez vos clients |
Deux exemples d’agrégateurs, parmi d’autres, indiquent dans leur documentation officielle accepter les opérateurs de Côte d’Ivoire : CinetPay (nouvel onglet) et Flutterwave (nouvel onglet). Cette liste n’est ni exhaustive ni une recommandation : comparez les opérateurs couverts, les frais, le calendrier des reversements et la qualité de la documentation, à vérifier au moment du projet.
Comment se déroule un paiement Mobile Money, étape par étape ?
Vu du client, payer prend quelques secondes. En coulisses, voici ce qui se passe, et ce que votre intégration doit faire à chaque étape.
- Le client valide sa commande et choisit Mobile Money, puis son opérateur.
- Votre serveur crée la transaction chez le prestataire : montant en francs CFA, référence unique de commande, adresse de notification et adresse de retour. Le montant est calculé par votre serveur, jamais repris tel quel du navigateur.
- Le client est dirigé vers la page de paiement du prestataire, ou saisit son numéro dans votre propre interface si le prestataire le permet.
- Il confirme sur son téléphone, avec son code secret ou dans l’application de son opérateur.
- Le prestataire notifie votre serveur dès que le statut change : réussi, échoué, annulé.
- Votre serveur vérifie le statut auprès de l’API du prestataire, contrôle le montant et la référence, puis marque la commande comme payée, une seule fois.
- Le client revient sur votre site ou dans votre application et voit sa confirmation. Un reçu part par e-mail, SMS ou WhatsApp.
- Les fonds sont reversés sur votre compte selon le calendrier du prestataire, et la transaction rejoint votre comptabilité.
Que sont les webhooks, et pourquoi sont-ils indispensables ?
Un webhook est un message automatique que le prestataire envoie à une adresse de votre serveur dès qu’un paiement change de statut. C’est lui, et non la page de retour, qui doit valider la commande.
La raison est simple : entre la confirmation sur le téléphone et le retour sur votre site, beaucoup de choses peuvent arriver. Le client ferme son navigateur, perd le réseau, ou son téléphone s’éteint. S’il a payé, la commande doit être validée quand même.
-
Vérifier chaque notification
N’acceptez pas une notification sur parole : contrôlez sa signature quand le prestataire en fournit une, ou interrogez son API pour confirmer le statut réel avant de valider quoi que ce soit.
-
Traiter chaque paiement une seule fois
Une même notification peut arriver plusieurs fois. Votre système reconnaît la référence déjà traitée et ne livre pas deux fois la même commande.
-
Rattraper les notifications perdues
Une tâche planifiée interroge régulièrement le prestataire sur les paiements restés en attente. Aucun paiement réussi ne reste sans commande.
-
Tout journaliser
Chaque création de transaction, notification et vérification est enregistrée avec sa date. En cas de réclamation, vous retrouvez l’historique en quelques secondes.
Paiements en attente, échoués ou remboursés : comment les gérer ?
Le paiement réussi est le cas facile. La qualité d’une intégration se juge sur tous les autres.
| Statut | Situation typique | Ce que fait votre site |
|---|---|---|
| En attente | Le client n’a pas encore confirmé, ou le réseau est lent | Affiche « paiement en cours », réserve le stock pour une durée limitée, revérifie le statut |
| Réussi | Le paiement est confirmé par le prestataire | Valide la commande, envoie le reçu, déclenche la préparation ou la livraison |
| Échoué | Solde insuffisant, code erroné, délai dépassé | Explique simplement le problème et propose de réessayer ou de choisir un autre opérateur |
| Annulé ou expiré | Le client a renoncé ou n’a jamais confirmé | Libère le stock et garde le panier pour une relance éventuelle |
| Remboursé | Retour produit, annulation, erreur de commande | Met à jour la commande, le stock et la comptabilité, et prévient le client |
Les remboursements méritent une attention particulière : selon le prestataire, ils se font depuis le tableau de bord ou par l’API, en totalité ou en partie, avec des délais variables. Faites-vous préciser ces conditions par écrit avant de choisir votre prestataire.
Comment faire le rapprochement comptable des paiements ?
Le rapprochement consiste à vérifier que chaque vente enregistrée correspond bien à un encaissement, et chaque reversement reçu à un ensemble de ventes. Sans méthode, il devient vite un casse-tête de fin de mois.
- Une référence unique par commande, transmise au prestataire et retrouvée dans ses exports : c’est le fil qui relie tout.
- Trois montants par transaction : le montant payé par le client, les frais du prestataire et le net reversé. Les frais sont comptabilisés en charges, pas déduits discrètement du chiffre d’affaires.
- Un reversement, une liste de ventes : chaque virement reçu sur votre compte est rapproché des transactions qu’il regroupe.
- Une synchronisation automatique entre le prestataire et votre logiciel de gestion, plutôt qu’une ressaisie à partir de fichiers.
C’est ce que nous avons construit dans Madata, l’ERP des PME d’Afrique francophone conçu par notre équipe : le paiement Mobile Money y est intégré aux ventes et à la comptabilité SYSCOHADA. Lire l’étude de cas Madata.
Quel dossier préparer, comment tester et sécuriser les paiements ?
Le dossier marchand
Avant d’activer les paiements réels, le prestataire vérifie l’identité de votre entreprise : c’est le KYC, pour « connaître son client ». Les documents demandés varient d’un prestataire à l’autre. Demandez la liste dès le premier jour et lancez la démarche en parallèle du développement : c’est souvent elle qui fixe la date d’ouverture.
Les tests en environnement de test
Demandez au prestataire s’il fournit un bac à sable, c’est-à-dire un environnement de test avec des clés et des numéros fictifs. Sinon, prévoyez une série de petits paiements réels avant l’ouverture. Dans les deux cas, testez au minimum :
- un paiement réussi sur chaque opérateur proposé
- un paiement échoué, puis réessayé
- un paiement abandonné, qui expire
- une notification reçue deux fois
- une notification jamais reçue
- un client qui ferme la page avant le retour
- un montant modifié dans le navigateur
- un remboursement total et un partiel
Les règles de sécurité
- Les clés secrètes restent sur le serveur, jamais dans le code d’une application mobile ni dans les pages du navigateur.
- Tout passe en HTTPS, y compris l’adresse qui reçoit les notifications.
- Le montant est toujours recalculé côté serveur à partir de la commande, jamais accepté tel qu’envoyé par le navigateur.
- L’accès au tableau de bord du prestataire est limité aux personnes qui en ont besoin, avec double authentification si elle est proposée.
- Les clés sont changées au départ d’un collaborateur ou d’un prestataire.
Et dans une application mobile ? Les règles de l’App Store autorisent un paiement par Mobile Money pour des biens physiques ou des services consommés hors de l’application, comme une livraison ou une réservation (règle 3.1.3(e)). Un contenu numérique consommé dans l’application doit, lui, passer par l’achat intégré d’Apple (règle 3.1.1). Source : App Store Review Guidelines (nouvel onglet). Voir aussi notre page application mobile à Abidjan.
Comment Jingi Agency intègre-t-elle le paiement Mobile Money ?
Nous suivons les cinq mêmes étapes sur chaque projet, adaptées ici à l’encaissement. Le détail de l’offre est sur notre page intégration Mobile Money et API.
-
Cadrage
Opérateurs à proposer, volumes attendus, choix entre agrégateur et API directe, liste des statuts à gérer. Vous recevez un périmètre, un planning et un devis ferme.
-
Conception
Parcours de paiement sur mobile, messages d’erreur, reçus et circuit comptable, validés avec vous avant le code. Le dossier marchand est lancé en parallèle.
-
Développement
Création des transactions, webhooks vérifiés, tâche de rattrapage, remboursements, sur un environnement de test accessible depuis votre téléphone.
-
Mise en ligne
Tests de chaque statut, premiers paiements réels, passage en production et formation de votre équipe au suivi des transactions.
-
Croissance
Suivi des paiements échoués, maintenance, ajout d’un opérateur ou d’un moyen de paiement, automatisation du rapprochement.
Le paiement Mobile Money fait partie de Madata, publié sur l’App Store et Google Play. Parmi nos missions récentes, présentées sans nom de client : un portail client pour un groupe d’assurance et de services, avec cotations en ligne, caisses multi-sociétés, Mobile Money et SMS automatiques. Comme sur tous nos projets, le code, les comptes et la documentation vous sont remis.
Questions fréquentes sur le paiement Mobile Money
Peut-on accepter Orange Money, MTN MoMo, Moov Money et Wave avec une seule intégration ?
Oui, en passant par un agrégateur de paiement. Votre site ou votre application se connecte à une seule API, et l’agrégateur se charge de dialoguer avec chaque opérateur. Vous signez un seul contrat, suivez toutes vos transactions dans un seul tableau de bord et recevez des reversements groupés. Vérifiez simplement que les quatre opérateurs sont bien proposés pour la Côte d’Ivoire.
Combien coûte l’acceptation du Mobile Money sur un site ?
Il y a deux postes. D’abord les frais du prestataire de paiement, en général une commission sur chaque transaction, qui varie selon le prestataire, l’opérateur et vos volumes : à vérifier et à négocier au moment du projet. Ensuite le coût de l’intégration elle-même, qui dépend du parcours, des statuts à gérer et du lien avec votre comptabilité. Il figure dans le devis.
Que se passe-t-il si le client a payé mais que la commande n’est pas validée ?
C’est le cas que l’intégration doit prévoir. La commande est validée par la notification du prestataire, reçue par votre serveur, et non par le retour du client sur le site. Si cette notification se perd, une tâche automatique interroge régulièrement le prestataire sur les paiements restés en attente et met la commande à jour. Votre client n’a rien à faire.
Peut-on rembourser un client qui a payé par Mobile Money ?
Cela dépend du prestataire, et c’est à vérifier avant de signer : remboursement possible ou non depuis le tableau de bord ou par l’API, total ou partiel, délai de traitement. Côté site, le remboursement doit mettre à jour la commande, le stock et la comptabilité, et prévenir le client par e-mail, SMS ou WhatsApp.
Une application iPhone peut-elle encaisser par Mobile Money ?
Oui pour les biens physiques et les services consommés hors de l’application, comme une livraison, une réservation ou une prestation : les règles de l’App Store autorisent alors un autre moyen de paiement, comme le Mobile Money. En revanche, un contenu numérique consommé dans l’application, comme un abonnement premium, doit passer par l’achat intégré d’Apple.
Combien de temps faut-il pour intégrer le Mobile Money ?
Deux délais s’additionnent. La validation de votre compte marchand par le prestataire, qui dépend de votre dossier et ne se maîtrise pas entièrement. Puis l’intégration technique, avec les tests de chaque statut. Lancez la demande de compte marchand dès le début du projet, pendant que le parcours se construit. Le planning précis est fixé lors du cadrage.
Faut-il une entreprise immatriculée pour encaisser en ligne ?
Les prestataires de paiement vérifient l’identité du marchand avant d’activer les paiements réels : c’est ce qu’on appelle le KYC, pour « connaître son client ». Les documents demandés et les profils acceptés varient d’un prestataire à l’autre. Demandez la liste exacte avant de choisir, surtout si vous démarrez votre activité ou si vous êtes entrepreneur individuel.