Intégrer Airtel Money et Moov Money à son site au Gabon

Par Gabon Connect

Intégrer Airtel Money et Moov Money à un site, c’est relier votre serveur aux plateformes de paiement des deux opérateurs pour que le client paie depuis son téléphone, sans carte bancaire. Le client reçoit une demande sur son mobile, la valide avec son code secret, et votre site reçoit la confirmation. Ce guide décrit ce qu’il faut prévoir, dans l’ordre.

Pourquoi le Mobile Money plutôt que la carte bancaire

Au Gabon, une grande partie de vos clients paie avec son téléphone et n’a pas de carte bancaire utilisable en ligne. Un site qui n’accepte que la carte perd ces clients au moment exact où ils veulent payer. Proposer Airtel Money et Moov Money, c’est accepter le moyen de paiement qu’ils ont déjà dans la poche.

Les deux réseaux coexistent : un client Moov ne paie pas avec Airtel Money, et l’inverse. Un parcours de paiement sérieux propose donc les deux, et laisse le client choisir son opérateur avant de saisir son numéro.

Accéder aux API des opérateurs

Airtel publie sa documentation technique sur son portail développeurs, developers.airtel.africa. Le Gabon y figure dans la liste des pays, et le choix du Gabon renvoie vers developers.airtel.ga, qui demande de créer un compte avant de consulter la documentation. La rubrique d’encaissement s’appelle « Collection » et le paiement déclenché sur le téléphone du client y porte le nom de « USSD push ».

Pour Moov Money au Gabon, nous n’avons pas trouvé de documentation publique de l’API marchande à la date de mise à jour de ce guide. L’accès se négocie avec Moov Africa Gabon, qui ouvre le compte marchand et transmet les éléments techniques.

Deuxième voie : passer par un agrégateur de paiement local, qui a déjà signé avec les deux opérateurs et expose une seule interface pour les deux. Vous gagnez en délai et en simplicité, vous payez une commission à l’intermédiaire, et vous dépendez de sa disponibilité. Le bon choix dépend de votre volume et du temps que vous pouvez consacrer aux démarches.

  • Compte marchand ouvert au nom de la société, avec ses pièces (RCCM, NIF).
  • Identifiants de test, puis identifiants de production après validation.
  • Adresse de retour (callback) de votre serveur, déclarée auprès de l’opérateur ou de l’agrégateur.

Le parcours de paiement, étape par étape

Voici le parcours que nous mettons en place, tel qu’il fonctionne sur les plateformes que nous exploitons pour nos clients, notamment l’encaissement d’abonnements logiciels décrit dans nos réalisations.

  1. Le serveur crée la facture et calcule le montant. Le navigateur ne fixe jamais le prix : un montant envoyé par le client peut être modifié.
  2. Le client choisit Airtel Money ou Moov Money et saisit son numéro.
  3. Le serveur envoie la demande de paiement à l’opérateur, qui la fait apparaître sur le téléphone du client.
  4. Le client valide avec son code secret sur son téléphone. Votre site n’a jamais accès à ce code.
  5. L’opérateur notifie votre serveur du résultat. Le serveur vérifie la notification, puis marque la facture comme payée.
  6. Le client voit la confirmation à l’écran et reçoit son reçu.

Entre l’étape 3 et l’étape 5, il s’écoule le temps que met le client à valider. La page doit donc attendre sans bloquer : un message clair (« Validez le paiement sur votre téléphone »), puis une vérification régulière de l’état de la facture.

Les points de sécurité à ne pas négliger

  • Montant calculé côté serveur, jamais lu depuis le formulaire.
  • Notification de l’opérateur vérifiée avant d’être crue : signature, origine, montant et référence comparés à la facture.
  • Une même notification reçue deux fois ne crédite qu’une fois. Les opérateurs peuvent renvoyer un message.
  • Clés d’accès stockées sur le serveur, hors du code publié et hors du navigateur.
  • Journal de chaque tentative : qui, combien, quel opérateur, quel résultat. C’est lui qui tranche un litige.

Sur nos projets, ce module est couvert par des tests automatisés : un paiement accepté, un paiement refusé, une notification en double, une notification falsifiée. C’est la partie du site où une erreur coûte de l’argent, elle mérite d’être testée à chaque mise à jour.

Quand la demande n’aboutit pas

Une demande de paiement peut échouer pour des raisons banales : solde insuffisant, téléphone éteint, réseau faible, client qui ne valide pas à temps. Le site doit le dire en clair et proposer de réessayer, sans recréer une seconde facture.

Nous ajoutons aussi un lien de paiement de secours, envoyé au client quand la demande directe n’aboutit pas. Il peut payer plus tard, depuis un autre téléphone, sans repasser par tout le parcours.

Rapprochement et comptabilité

Un encaissement n’est terminé que lorsqu’il apparaît au bon endroit dans vos comptes. Chaque paiement porte une référence qui relie la facture, la transaction de l’opérateur et le reçu. Le rapprochement automatique compare ce que votre site a enregistré avec ce que l’opérateur a réellement versé, et signale les écarts.

Pour une place de marché, il faut aller plus loin : bloquer les fonds jusqu’à la livraison, puis répartir entre vendeur et livreur. Nous l’avons construit pour l’un de nos clients, avec reçus en PDF et historique des paiements.

Où placer le paiement : site, application ou lien

Le même raccordement aux opérateurs peut servir plusieurs points de vente. Le serveur reste unique, ce sont les écrans qui changent.

  • Sur un site : un bouton de paiement au moment de la commande ou de la facture, sans création de compte obligatoire si votre activité le permet.
  • Dans une application mobile : le même parcours, avec l’avantage que le numéro du client est souvent déjà connu.
  • Par lien : un lien de paiement envoyé par SMS, e-mail ou WhatsApp, utile pour une facture ponctuelle ou une relance.

Commencez par le point qui porte le plus de chiffre d’affaires. Les autres se branchent ensuite sur le même serveur, sans refaire l’intégration.

Tester avant d’ouvrir au public

Un paiement se teste comme un circuit complet, du clic du client jusqu’à l’écriture en comptabilité. Les opérateurs et les agrégateurs fournissent en général un environnement d’essai, distinct de la production, avec ses propres identifiants.

  1. Paiement accepté : la facture passe à « payée » une seule fois et le reçu part.
  2. Paiement refusé ou abandonné : la facture reste ouverte et le client peut réessayer.
  3. Notification reçue deux fois : un seul crédit.
  4. Notification falsifiée ou montant différent : rejetée et journalisée.
  5. Serveur indisponible pendant quelques minutes : les paiements validés entre-temps sont bien rattrapés.

Après l’ouverture, surveillez les premiers jours de près : le taux de demandes qui aboutissent, les délais de notification et les réclamations. Ce sont eux qui disent si le parcours est clair pour vos clients.

Les frais de transaction

Chaque paiement encaissé supporte des frais, fixés par l’opérateur ou par l’agrégateur dans votre contrat marchand. Ils ne font pas partie de notre prestation et varient selon le contrat, le volume et le canal choisi.

Demandez la grille exacte avant de signer, et décidez qui les supporte : vous, ou le client par un montant ajusté. Ce choix se règle dans le serveur, au moment où il calcule la facture, et doit être affiché clairement au client avant qu’il valide.

Délais et budget

Notre prestation « Passerelle de paiement Mobile Money » est proposée à partir de 551 200 FCFA HT, pour un délai indicatif de 7 à 14 jours une fois les accès obtenus. Le prix exact dépend de votre site, du nombre de parcours de paiement et du besoin de rapprochement.

Le délai le plus long n’est souvent pas technique : c’est l’ouverture du compte marchand chez l’opérateur. Lancez cette démarche dès le début du projet.

Si vous devez réunir plusieurs moyens de paiement sur un site, une application et une place de marché, la prestation « Système de paiement multicanal » est proposée à partir de 2 754 200 FCFA HT.

Questions fréquentes

Peut-on accepter Airtel Money et Moov Money sur le même site ?

Oui. Ce sont deux intégrations distinctes, une par opérateur, ou une seule si vous passez par un agrégateur qui couvre les deux. Le client choisit son opérateur avant de saisir son numéro.

Où trouver la documentation de l’API Airtel Money pour le Gabon ?

Sur le portail développeurs d’Airtel Africa, developers.airtel.africa. Le choix du Gabon renvoie vers developers.airtel.ga, qui demande la création d’un compte pour accéder à la documentation.

Existe-t-il une documentation publique de l’API Moov Money Gabon ?

Nous n’en avons pas trouvé à la date de mise à jour de ce guide. L’accès technique se demande à Moov Africa Gabon lors de l’ouverture du compte marchand.

Le client doit-il saisir son code secret sur mon site ?

Non. Il valide le paiement sur son propre téléphone. Votre site ne voit jamais son code secret.

Que se passe-t-il si le client ne valide pas la demande ?

La transaction reste en attente puis échoue. Le site l’annonce clairement, propose de réessayer et peut envoyer un lien de paiement de secours.

Combien coûte l’intégration ?

Notre passerelle de paiement Mobile Money est proposée à partir de 551 200 FCFA HT. Les frais de l’opérateur ou de l’agrégateur s’ajoutent et sont facturés par eux.

Peut-on tester l’intégration avant de l’ouvrir aux clients ?

Oui. Les opérateurs et les agrégateurs fournissent en général un environnement d’essai avec ses propres identifiants. Nous y vérifions les paiements acceptés, refusés, en double et falsifiés avant la mise en service.

Faut-il une société immatriculée ?

Oui pour un compte marchand : l’opérateur ou l’agrégateur demande les pièces de la société, dont le RCCM et le NIF.

La prestation liée

Passerelle Paiement Mobile Money (API)

Prix indicatif, délai et détail de la prestation sur sa fiche.

Voir la fiche

Sources

  1. Portail développeurs Airtel Africa (choix du pays, puis compte requis pour le Gabon)(developers.airtel.africa)
  2. Documentation Airtel, rubrique Collection, USSD push(developers.airtel.africa)
  3. Nos réalisations : encaissement d’abonnements et paiements d’une place de marché par Mobile Money(gabonconnect.com)
En direct
« C'est formidable de voir comment Gabonova s'engage à accompagner ses clients dans leur projet immobilier à Libreville. La sécurité et la négociation sont des aspects si importants dans ce domaine. J'aime l'idée que rien n'est laissé au hasard, cela rassure vraiment les futurs acheteurs! »laurent.boutillier · il y a 3 mois« Jolie »Visiteur · il y a 3 mois« Super »Visiteur · il y a 3 mois« Tres interesantes »Visiteur · il y a 3 mois« Bonne opportunité 👌🏽 »Visiteur · il y a 3 mois« Très belle maison »Visiteur · il y a 3 mois« Very helpful and great service! »Elin Nilsson · il y a 3 mois« Très belle initiative !🤩 »Visiteur · il y a 9 mois« 👏👏👏 »jeansebastiencampos · il y a 10 mois« 👏🎉 »call_me_hertaa · il y a 11 mois« 📊👍👏👏 »oyoky_off · il y a 11 mois« 📊👍🇬🇦 »Visiteur · il y a 11 mois
Logo

Société internationale de transformation digitale et d'innovation technologique, implantée à Libreville et à Madrid.

Entreprise du numérique immatriculée au Gabon (Gabon Connect S.A.R.L.U., RCCM GA-LBV-01-2025-B13-00283) et en Espagne (Gabon Connect España, NIF B88909304), éditrice de Gabonova et de Wiigo.

Nos implantations

LibrevilleGabon Connect S.A.R.L.U.160, Rue Cheikh Ahmadou Bamba Mbacké, Bd Triomphal, B.P. 5817
MadridGabon Connect España, S.L.U.Calle Eduardo Chillida 225, 28051 Madrid

© 2026 Gabon Connect. Tous droits réservés.