API de paiement mobile en Guinée : guide complet pour intégrer Orange Money et MTN MoMo via un orchestrateur (2026)
Orange Money (~71 % du volume) et MTN MoMo (~24 %) exposent les deux API marchandes qui comptent en Guinée, en francs guinéens (GNF), sous la réglementation de la BCRG — le pays n'est membre ni de l'UEMOA ni de la CEMAC. En intégration directe, couvrir les deux opérateurs prend de 3 à 6 mois ; une API orchestrée non-custodial unifie les deux rails, les webhooks et la réconciliation derrière un seul contrat technique.La Guinée compte 7,1 millions de comptes mobile money actifs à 90 jours fin 2025, pour un volume annuel de 138 000 milliards de GNF (≈ 15,3 milliards USD) selon les agrégats de la Banque Centrale de la République de Guinée — avec une projection à 162 000 milliards de GNF pour 2026. L'inclusion financière via wallet atteint 53 % des adultes, contre 18 % pour la banque classique : comme dans la plupart des marchés d'Afrique de l'Ouest, le wallet est le compte par défaut, et le paiement marchand y passe avant la carte.
Une particularité sépare ce marché de ses voisins : la monnaie. La Guinée n'émet pas de franc CFA. Un marchand qui opère aussi au Sénégal ou en Côte d'Ivoire gère donc des flux GNF d'un côté, XOF de l'autre, sans passeport réglementaire entre les deux zones. Ce guide traite ce cas de bout en bout : accès aux API Orange Money et MTN MoMo, cadre BCRG, multi-devises, coûts constatés, et l'arbitrage entre intégration directe et orchestrateur. Pour l'angle marché (agents, usages, tarifs grand public), lisez d'abord notre dossier complet du paiement mobile en Guinée ; pour l'intégration d'Orange seul, notre guide API Orange Money Guinée reste la référence dédiée.
Quels providers de mobile money sont disponibles en Guinée ?
Trois émetteurs agréés se partagent le marché guinéen : Orange Money (leader, ~71 % du volume), MTN MoMo (~24 %) et Cellyn Money (~5 %, opérateur de niche). Les deux premiers exposent seuls une API marchande mature ; tous fonctionnent en GNF, via USSD et application mobile, avec un réseau d'agents pour les dépôts et retraits cash.Orange Money Guinée s'appuie sur 5,1 millions de comptes actifs et 36 000 agents, dont 48 % en zone rurale — la couverture la plus dense du pays, adossée au parc GSM d'Orange Guinée (~58 % de parts de marché télécom). Son API marchande, disponible en REST avec authentification OAuth 2.0 et conformité aux standards GSMA Mobile Money API, dispose d'un sandbox en libre-service depuis 2023 : c'est le rail le plus rapide à prototyper.
MTN MoMo Guinée — le wallet lancé à l'origine sous la marque Areeba — revendique 1,7 million de comptes actifs et 12 500 agents, avec une base fidèle dans les zones minières (Boké, Siguiri) et le long du corridor commercial Conakry–Kankan. Son offre API a été refondue en 2024, alignée sur le portail développeur MoMo du groupe MTN : collections client-vers-marchand et transferts sortants marchand-vers-client (remboursements, paiements de fournisseurs) y suivent le standard groupé présent dans les 17 pays MoMo d'Afrique.
Cellyn Money, la filiale de Celcom Mobile (3e opérateur GSM, ~9 % de parts), concentre ses 300 000 comptes autour de Kankan. Son API est moins mature : pas de sandbox en libre-service, accès via partenaire agrégateur. Pour un marchand, l'ignorer laisse de côté une petite fraction des wallets ; l'intégrer en direct coûte plus cher qu'il ne rapporte — c'est typiquement le rail qu'un orchestrateur ajoute sans effort supplémentaire côté développeur.
| Critère | Orange Money GN | MTN MoMo GN | Cellyn Money |
|---|---|---|---|
| Parts de volume mobile money | ~71 % | ~24 % | ~5 % |
| Comptes actifs 90 j | 5,1 M | 1,7 M | 0,3 M |
| Agents | 36 000 | 12 500 | 3 500 |
| API collections (C2B) | Oui | Oui | Via agrégateur |
| API disbursements (B2C) | Oui | Oui | Limitée |
| Sandbox self-service | Oui (depuis 2023) | Oui (portail refondu 2024) | Non |
| Monnaie | GNF | GNF | GNF |
Comment obtenir l'accès à l'API Orange Money Guinée ?
L'accès passe par le programme marchand d'Orange Guinée Business : inscription développeur et sandbox d'abord, dossier KYB complet et contrat ensuite, production après certification. Le compte marchand Orange s'obtient en 18 à 25 jours ouvrés pour un dossier complet. 1. Inscription développeur et sandbox. La création de compte sur le portail développeur d'Orange donne accès au sandbox en 24 à 48 heures après validation. L'API suit l'architecture REST v2 du groupe : jetons OAuth 2.0, signature des requêtes HMAC-SHA256, webhooks signés sur votre URL de callback. Les credentials de test sont rejetés en production : prévoyez deux configurations dès le départ. 2. Dossier KYB entreprise. Pour passer en production, Orange exige une entreprise immatriculée : RCCM guinéen de moins de 3 mois, NIF, CNI des dirigeants et bénéficiaires effectifs, statuts, relevés bancaires et description du modèle d'usage (e-commerce, facturation de services, remboursements). Depuis 2024, la vérification est durcie : la CNI est croisée avec les bases de sécurité d'État et l'onboarding des comptes entreprise passe par la reconnaissance faciale. Les trois motifs de rejet les plus fréquents restent mécaniques : CNI expirée, RCCM trop ancien, écart de nom entre le NIF et la pièce d'identité du représentant légal. 3. Contrat commercial. Les conditions marchandes — commission sur transaction, volumes, SLA — se négocient dossier par dossier et ne sont pas publiques : budgettez « sur devis », jamais sur un chiffre lu dans un forum. 4. Certification technique. Avant l'émission des clés live, vous validez les scénarios de paiement en sandbox : succès, solde insuffisant, abandon du prompt USSD par le client, expiration de session (5 minutes par défaut), remboursement. Écrivez votre plan de tests avant d'ouvrir le sandbox : l'environnement ne simule pas tous les cas d'échec spontanément. 5. Mise en production. Les clés live sont émises après validation conjointe du commercial et de la technique. En pratique, le chemin critique n'est pas le code mais la file documentaire : comptez deux allers-retours KYB en moyenne sur une première intégration.Notre guide d'intégration API Orange Money Guinée détaille endpoints, payloads, gestion des webhooks et patterns de retry, code à l'appui. Ce guide reste lui sur le choix d'architecture : un opérateur intégré est un premier rail, pas un moyen de paiement national.
Comment intégrer MTN MoMo en Guinée ?
L'intégration MTN MoMo en Guinée suit le programme marchand du groupe MTN : collections et disbursements sur la même API, sandbox accessible via le portail développeur refondu en 2024, compte marchand instruit en 12 à 18 jours ouvrés. C'est le contrat le plus rapide des trois à obtenir.Côté technique, l'API MoMo expose deux familles d'endpoints qui couvrent l'essentiel des besoins d'un marchand. Les collections initient un paiement client-vers-marchand : vous créez la requête, le client confirme sur son téléphone (prompt USSD ou notification dans l'application), et le statut remonte par webhook puis polling. Les disbursements débitent votre wallet marchand pour créditer un client ou un tiers : remboursements, paiements de fournisseurs, salaires, cashback marketing. Les deux familles partagent la même authentification et les mêmes conventions d'erreurs, mais des limites et des flux d'approbation distincts — ne réutilisez pas un code de collections pour traiter un décaissement.
Le parcours d'intégration ressemble à celui d'Orange, avec trois différences qui comptent en projet réel. D'abord, l'authentification : MTN fonctionne par clés API et jetons d'abonnement, là où Orange signe ses requêtes en HMAC — vos deux intégrations n'auront ni les mêmes middlewares, ni les mêmes rotations de secrets. Ensuite, la validation : le workflow d'approbation MoMo impose de rejouer vos scénarios de test devant l'équipe partenaire avant activation live. Enfin, le contrat : le programme est administré au niveau de l'entité MTN Guinée, les conditions commerciales sont propres à chaque pays du groupe — une intégration MoMo validée au Ghana ne vous ouvre rien à Conakry.
Le ticket moyen d'un paiement marchand B2C atteint 245 000 GNF en Guinée et le paiement marchand ne représente que 22 % du volume mobile money national : le marché est largement dominé par le P2P. Autrement dit, vos clients détiennent déjà les deux wallets ; c'est votre backend, pas leur comportement, qui décide si vous captez les deux.
API opérateur directe ou orchestrateur : que choisir en Guinée ?
L'intégration directe se justifie si plus de 90 % de vos paiements proviennent d'un seul opérateur ; dès qu'Orange et MTN doivent coexister, l'orchestrateur réduit deux intégrations à une seule — une API, des webhooks normalisés, une réconciliation, un contrat technique. Le choix porte moins sur la technologie que sur le coût total de possession.| Dimension | Direct Orange + MTN | Via orchestrateur |
|---|---|---|
| Contrats marchands | 2 dossiers KYB, 2 négociations | 1 contrat technique |
| Délai d'accès sandbox | Après contrat marchand | Immédiat |
| Schémas API | 2 (OAuth/HMAC vs clés API) | 1, unifié |
| Webhooks | 2 formats, 2 signatures | Normalisés et signés |
| Réconciliation | 2 relevés à rapprocher | Registre unique |
| Couverture Cellyn Money | 3e contrat, via agrégateur | Inclus au routage |
| Extension Sénégal, Mali, CI | Contrats pays par pays | Même API multi-marchés |
Le raisonnement orchestrateur tient dans ce que le direct duplique. Un orchestrateur non-custodial comme Simiz route chaque paiement vers le bon opérateur à partir du numéro du client, avec un routage fondé sur le taux de succès, la latence et le coût, et une bascule automatique vers le rail disponible quand un opérateur est indisponible. Les fonds restent détenus et réglés par les entités licenciées des opérateurs partenaires : l'orchestrateur n'est jamais custodial sur les fonds des marchands. Votre intégration, elle, parle un seul dialecte : un schéma de création de paiement, des codes d'erreurs communs, des webhooks de paiement normalisés, un registre de réconciliation unique.
Le cas e-commerce guinéen illustre le bon découpage. Une boutique de Conakry qui vend via WhatsApp et réseaux sociaux peut encaisser dès la première semaine avec des liens de paiement — aucune intégration n'est nécessaire — puis basculer sur l'API complète quand les volumes justifient l'automatisation. Les cas d'usage e-commerce documentent cette séquence en deux temps, valable aussi pour la facturation de services et les marketplaces.
Quel cadre réglementaire s'applique en Guinée ?
Le cadre guinéen est national et exclusif : la loi L/2020/040/AN du 3 juin 2020 sur la monnaie électronique et les instructions de la BCRG régissent les wallets, l'ARPT régule le volet télécoms, et aucun texte UEMOA ou CEMAC ne s'applique. Pour un marchand, cela change deux choses : les plafonds et l'immatriculation.Les plafonds de transaction ne sont pas fixés par les opérateurs mais par la BCRG, par palier d'identification, à l'identique chez Orange, MTN et Cellyn : compte anonyme USSD limité à 100 000 GNF par jour, compte vérifié (CNI) à 1 million de GNF par jour et 10 millions par mois, compte entreprise à 5 millions par jour et 100 millions de flux mensuel, et un palier entreprise premium accessible uniquement par dérogation BCRG. Le niveau KYC de votre client borne donc vos paniers : un B2B à 2 millions de GNF exige un payeur de niveau entreprise. Notre article dédié aux plafonds KYC du mobile money guinéen détaille chaque palier et les pièces exigées.
Côté agréments, émettre de la monnaie électronique en Guinée exige un agrément EME de la BCRG : 500 millions de GNF de fonds propres minimum, des ratios de liquidité et un reporting mensuel. Une plateforme d'orchestration n'a pas vocation à détenir ces fonds : elle opère comme PSP non-custodial, le dossier KYB marchand étant collecté une fois puis instruit chez les partenaires licenciés qui exécutent les paiements et détiennent les soldes. C'est aussi ce qui explique l'asymétrie des délais : un orchestrateur déjà contractualisé avec les opérateurs transporte la conformité existante au lieu de la reconstituer pour chaque marchand.
La lutte anti-blanchiment relève de la CENTIF-Guinée, avec un durcissement visible depuis 2024 : croisement des CNI avec les bases de sécurité d'État, reconnaissance faciale à l'onboarding entreprise, gel de plafonds en cas de flux incohérents avec l'activité déclarée. Un marchand qui encaisse via un partenaire déjà agréé hérite de ces dispositifs au lieu de les répliquer.
| Dispositif | Guinée | UEMOA (ex. Sénégal, CI) | CEMAC (ex. Cameroun) |
|---|---|---|---|
| Régulateur monétaire | BCRG | BCEAO | BEAC |
| Monnaie | GNF | XOF | XAF |
| Texte plafonds | Loi L/2020/040/AN + instructions BCRG | Instruction n° 008-05-2015 | Règlements CEMAC/UMAC |
| Régulateur télécoms | ARPT | ARTP nationales | ART nationales |
GNF, XOF, USD : comment gérer le multi-devises depuis la Guinée ?
Les wallets guinéens fonctionnent exclusivement en GNF : tout prix pensé en FCFA ou en USD doit être converti avant d'être présenté au client, et tout règlement transfrontalier introduit une exposition de change. La question monétaire n'est pas un détail de facturation, c'est une décision de produit.Première règle : affichez en GNF. Un client Orange Money ou MTN MoMo paie dans la monnaie de son wallet ; un panier affiché en euros ou en FCFA oblige à une conversion mentale, génère des abandons et brouille la réconciliation. Le GNF ne comporte pas de subdivision courante : des montants entiers, éventuellement arrondis à des seuils psychologiques locaux, convertissent mieux qu'un prix calculé au taux du jour et truffé de décimales.
Deuxième règle : anticipez le point de conversion. Trois situations courantes en Guinée : un marchand local qui s'approvisionne auprès de grossistes en FCFA (corridor Conakry–Dakar ou Conakry–Abidjan) encaisse en GNF et paie en XOF — il est exposé des deux côtés ; une plateforme régionale qui facture l'ensemble de ses marchés affiche un catalogue par devise (GNF en Guinée, XOF en UEMOA) au lieu de convertir à la volée ; une activité financée par la diaspora en USD ou en EUR reçoit des entrées qui finissent en paiements wallet locaux en GNF. Dans les trois cas, la conversion et le règlement relèvent du partenaire bancaire ou du PSP qui détient les comptes dans chaque zone — pas de l'API de l'opérateur, qui ne fait que débiter et créditer des wallets en monnaie locale.
Troisième règle : séparez le prix affiché du taux de change. Votre référence comptable peut être l'USD ou l'XOF ; le client, lui, ne voit que le montant GNF de son débit. Les écarts entre le taux de règlement et le taux de référence deviennent une ligne de P&L à suivre comme les commissions : sans suivi, un corridor actif peut perdre en change ce que la commission transactionnelle rapporte.
Concrètement, le multi-devises se résume à trois décisions prises tôt : la devise d'affichage par marché (GNF chez soi), la devise de règlement des fournisseurs, et la périodicité de conversion. Une API orchestrée multi-pays ne supprime pas la conversion ; elle évite de multiplier les intégrations à mesure que vous ajoutez des marchés en FCFA.
Combien coûte et combien de temps prend une intégration en Guinée ?
Comptez 3 à 6 mois pour couvrir Orange et MTN en intégration directe (dossiers marchands de 12 à 25 jours ouvrés chacun, plus développement et certification), contre quelques jours à quelques semaines via un orchestrateur dont les contrats opérateurs existent déjà. Les commissions marchandes API se négocient sur devis chez les deux opérateurs.Les seuls chiffres publics fiables sont les grilles grand public constatées : Orange pratique de 1,5 % à 0,9 % par tranche avec une commission plafonnée à 25 000 GNF, MTN de 1,2 % à 0,7 % avec un plafond à 18 000 GNF. Les conditions de l'API marchande (MDR, frais de disbursement, conditions de settlement) font l'objet de contrats individuels — tout chiffre précis circulant hors contrat est une invention. Les tarifs de l'orchestrateur, eux, sont publiés et s'appliquent quel que soit le rail sous-jacent.
| Étape | Direct Orange | Direct MTN | Via orchestrateur |
|---|---|---|---|
| Dossier marchand + contrat | 18-25 j ouvrés | 12-18 j ouvrés | KYB en ligne, quelques jours |
| Accès sandbox | Après contrat | Après contrat | Immédiat |
| Développement + certification | 2-4 semaines | 2-4 semaines | Quelques jours |
| Total jusqu'à la production | 3-6 mois (1 rail) | 3-6 mois (1 rail) | 1-2 semaines (2 rails) |
Pour démarrer plus vite, la séquence éprouvée reste : liens de paiement la première semaine, API complète quand les volumes le justifient.
FAQ
Peut-on encaisser Orange Money et MTN MoMo avec une seule API en Guinée ?
Oui. Une API orchestrée route chaque paiement vers Orange Money ou MTN MoMo à partir du numéro du client, avec un schéma de requête, des codes d'erreur et des webhooks unifiés. Les rails restent exécutés par les entités licenciées des opérateurs : l'orchestrateur, non-custodial sur les fonds des marchands, n'en détient aucun.
Faut-il une entreprise immatriculée en Guinée pour encaisser en mobile money ?
En intégration directe, oui : Orange et MTN exigent un RCCM guinéen (ou un représentant local) dans le dossier KYB du compte marchand. En passant par un orchestrateur dont les partenaires sont déjà agréés, la conformité KYB est portée par la chaîne orchestrateur-partenaires licenciés, et vous pouvez encaisser en GNF sans entité locale.
Quel est le montant maximum encaissable par transaction en Guinée ?
Le plafond dépend du palier KYC du client payeur, fixé par la BCRG et identique chez tous les opérateurs : 1 million de GNF par jour pour un compte vérifié, 5 millions par jour et 100 millions par mois pour un compte entreprise, et un palier premium sans cumul mensuel accessible par dérogation BCRG seulement. Côté marchand, un compte entreprise encaisse jusqu'à 25 millions de GNF de solde et 100 millions de flux mensuel.
Le mobile money guinéen fonctionne-t-il en francs CFA ?
Non. La Guinée n'est membre ni de l'UEMOA ni de la CEMAC : les wallets Orange Money, MTN MoMo et Cellyn Money fonctionnent exclusivement en francs guinéens (GNF). Toute lecture en FCFA fausse les prix, les plafonds et la comptabilité ; les conversions avec les marchés voisins en XOF sont des opérations de change, à suivre comme telles.
Combien de temps faut-il pour être en production sur les deux opérateurs guinéens ?
En direct : 3 à 6 mois, dont l'essentiel en démarches contractuelles (deux dossiers KYB, deux négociations commerciales, deux certifications). Via un orchestrateur : une à deux semaines, le sandbox étant immédiat et la certification technique limitée à votre propre intégration.
Passer à l'intégration
Deux API marchandes matures, un cadre BCRG propre à la Guinée, une monnaie sans subdivision, et 3 à 6 mois de démarches en direct contre une à deux semaines en orchestration : l'arbitrage est posé, il ne reste qu'à choisir votre séquence — sandbox dès aujourd'hui, ou liens de paiement pour encaisser cette semaine.
Tester l'API Simiz en sandbox → Parler à un expert technique →Pour les marchés voisins, consultez nos guides d'intégration API pour le Sénégal, le Mali et la Côte d'Ivoire.