API paiement mobile Niger : choisir son orchestrateur 2026

Le Niger compte 8,7 millions de comptes Mobile Money actifs à 90 jours fin 2025, pour 7 350 milliards FCFA de volume annuel selon les agrégats de la BCEAO et de l'ARCEP Niger. Sur un pays de 27,2 millions d'habitants où à peine 3,1 millions de personnes disposent d'un compte bancaire, 94% des transactions électroniques de détail passent par trois wallets : Airtel Money (~52% du volume), Orange Money (~33%) et Moov Money (~15%). Pour un marchand de Niamey, une fintech de Zinder ou un SaaS qui facture des clients nigériens, l'équation technique est la même : trois contrats commerciaux, trois schémas d'API, trois formats de webhook, ou une seule couche d'orchestration.

Ce guide détaille les services intégrables au Niger, le fonctionnement concret d'un flux de collecte, l'arbitrage entre intégration directe et orchestrateur, les frais réels en FCFA et le cadre réglementaire applicable. Il complète notre guide paiement mobile Niger (angle marché et cas d'usage) et notre analyse des plafonds KYC Mobile Money Niger 2026.

Quels services de paiement mobile peut-on intégrer au Niger ?

La maturité API suit un ordre différent des parts de marché. Orange Money Niger expose l'API marchand la plus aboutie : documentation OpenAPI 3.0, sandbox en libre-service, webhooks documentés. Airtel Money a comblé son retard en 2024-2025 avec une refonte du portail développeur et l'arrivée du SDK Airtel Africa. Moov Money Niger opère encore une API partenaire-only, accessible après négociation commerciale, héritée de la transition SahelCom vers Moov Africa achevée fin 2023. Concrètement : un marchand qui vise 100% du parc wallet doit intégrer Airtel et Orange, et négocier un accès Moov au cas par cas.

L'interopérabilité P2P via le switch national GIM-UEMOA, effective depuis 2023, autorise les transferts entre wallets pour 0,5% plafonnés à 500 FCFA. Elle ne dispense pas le marchand d'intégrer chaque opérateur séparément : l'encaissement marchand reste, lui, toujours individuel par provider. C'est précisément l'écart qu'un orchestrateur vient combler.

Comment fonctionne une API de paiement mobile au Niger ?

Le cycle complet d'un encaissement :

1. Initiation : votre backend envoie montant (en XOF), numéro MSISDN du payeur au format international (+227...) et référence de commande. L'API répond 202 Accepted avec un identifiant de transaction : la requête est acceptée, pas encore payée.
2. Prompt client : l'opérateur pousse un menu USSD ou une notification vers le téléphone du payeur, qui confirme avec son code secret Mobile Money.
3. Statuts intermédiaires : la transaction reste PENDING tant que le client n'a pas validé. Un timeout (client injoignable, PIN non saisi) bascule la transaction en FAILED après 2 à 5 minutes selon l'opérateur.
4. Webhook de confirmation : l'opérateur (ou l'orchestrateur, qui normalise le format) POSTe le statut final sur votre endpoint déclaré : SUCCESS avec la référence, ou FAILED avec le motif (solde insuffisant, PIN erroné, timeout).
5. Vérification : la règle d'or est de ne jamais faire confiance au seul webhook. Un appel de vérification du statut côté API referme les webhooks perdus (panne réseau, endpoint indisponible au moment de l'envoi).

Les latences constatées en production au Niger sont de moins de 5 secondes pour le webhook Airtel, moins de 8 secondes chez Orange, et jusqu'à 30 secondes chez Moov en heure de pointe, la connectivité rurale expliquant l'essentiel de l'écart. Les taux de succès par provider (97,8% Airtel, 98,4% Orange, 96,9% Moov sur les dashboards BCEAO 2025) imposent un traitement d'échec digne de ce nom : le taux de rejet résiduel, entre 1,6% et 3,1%, doit déclencher un chemin de retry ou un moyen de paiement alternatif, pas un message d'erreur sec.

Le point de vigilance technique numéro un reste la vérification du webhook. Un endpoint non protégé permet à n'importe qui de valider des commandes impayées en POSTant un faux statut :

// Verification de signature webhook (pattern generique, Express)
const crypto = require('crypto');

app.post('/webhooks/payment', express.raw({ type: 'application/json' }), (req, res) => {
  const timestamp = req.headers['x-timestamp'];
  const signature = req.headers['x-signature'];

  // HMAC calcule sur "timestamp.body" avec le secret partage
  const expected = crypto
    .createHmac('sha256', process.env.PAYMENT_WEBHOOK_SECRET)
    .update(`${timestamp}.${req.body}`)
    .digest('hex');

  const a = Buffer.from(signature || '');
  const b = Buffer.from(expected);
  if (a.length !== b.length || !crypto.timingSafeEqual(a, b)) {
    return res.status(401).send('Signature invalide');
  }

  const event = JSON.parse(req.body);
  if (dejaTraite(event.id)) return res.status(200).send('OK'); // idempotence

  if (event.status === 'SUCCESS') marquerCommandePayee(event.reference);
  res.status(200).send('OK'); // reponse < 3s, sinon retry emetteur
});

Trois réflexes dans ce code : comparaison à temps constant (timingSafeEqual, jamais === sur un secret), déduplication par identifiant d'événement (les webhooks sont renvoyés en cas d'échec de réception), réponse en moins de 3 secondes avec traitement métier asynchrone. Chaque opérateur nigérien signe différemment (HMAC chez Orange, token partagé chez Airtel, IP allowlist chez Moov) : un orchestrateur a l'avantage d'unifier ces trois schémas en une seule convention de signature.

La sandbox précède obligatoirement la production chez les trois opérateurs. Orange Niger l'ouvre en libre-service sur son portail développeur, Airtel sur dossier après inscription du KYB, Moov sur accord commercial. Comptez une cinquantaine de transactions de test par provider, dont les scénarios d'échec (PIN erronée, solde insuffisant, timeout USSD), avant de demander la graduation.

Intégration directe opérateur vs orchestrateur : que choisir ?

Quels frais et commissions pour encaisser en FCFA au Niger ?

Quatre coûts cachés gonflent la facture au-delà de la commission affichée :

1. Les échecs non relancés. Avec 1,6% à 3,1% de transactions rejetées, un marchand qui ne propose pas de second opérateur au client perd la commande : coût d'acquisition gaspillé, panier abandonné. Un routage avec fallback limite cette perte sans développement spécifique.
2. La réconciliation manuelle. Rapprocher trois journaux d'opérateurs avec trois référentiels de statuts mobilise de 0,5 à 2 jours par semaine d'un contrôleur pour un marchand à volume moyen. C'est le poste le plus sous-estimé du modèle direct.
3. Le change, si vous facturez hors XOF. L'encaissement est nativement en franc CFA UEMOA (code ISO XOF). Un SaaS qui tarifte en euros ou en dollars encaisse en XOF puis convertit : le spread bancaire sur le corridor FCFA oscille entre 1% et 2,5% selon les banques correspondantes, et dope le coût total si la grille tarifaire est en devise étrangère.
4. Le coût d'ingénierie récurrent. Trois API signifient trois mises à jour de contrat, trois rotations de credentials, trois calendriers de maintenance opérateur à suivre. Le temps ingénieur n'apparaît dans aucune commission, il apparaît dans la masse salariale.

Un last mile tarifaire à ne pas confondre : l'interopérabilité P2P à 0,5% (plafonnée à 500 FCFA) concerne les transferts entre particuliers, pas l'encaissement marchand. Elle ne s'applique pas à votre tunnel de paiement.

Une seule API pour Orange Money, Airtel Money et Moov, c'est possible ?

Le routage automatique fonctionne par identification de l'opérateur du numéro : un payeur Airtel déclenche une collection Airtel Money, un payeur Orange une collection Orange Money, sans que votre code ne gère de branchement par provider. Le second bénéfice est le fallback : si un opérateur est indisponible (timeout, erreur 5xx, dégradation mesurée sur sa plateforme), l'orchestrateur peut orienter le paiement vers un autre wallet du même payeur lorsqu'il est identifiable, ou retourner un statut d'échec propre avec proposition de réessai, le marchand étant notifié de l'incident. Sur un marché où un seul opérateur concentre la moitié du volume, cette résilience n'est pas un luxe : une après-midi d'indisponibilité Airtel sans fallback, c'est la moitié du chiffre du jour évaporée. Simiz applique ce routage multi-provider sur le marché nigérien, avec exécution par les EME licenciés et notification webhook au marchand en cas d'incident.

Trois cas d'usage nigériens exploitent directement cette unification :

• E-commerce et delivery : le client paie avec le wallet qu'il a sous la main, le marchand voit un seul flux de commandes, quel que soit l'opérateur. Les payment links Mobile Money permettent même d'encaisser sans site : un lien partagé par WhatsApp ou SMS ouvre le paiement dans le wallet du client.
• SaaS et services par abonnement : facturer des abonnements mensuels en FCFA à des clients répartis sur trois wallets suppose des mandats de prélèvement par opérateur. Un orchestrateur unifie le mandat et le prélèvement récurrent, ce qui simplifie radicalement encaisser des abonnements SaaS en FCFA sur le marché nigérien.
• Marketplaces et reversements : la plateforme encaisse côté client, reverse aux vendeurs en bulk payment, et réconcilie l'ensemble dans un journal unique. Le split multi-vendeurs sur trois opérateurs est le scénario où le développement maison coûte le plus cher.

La limite à connaître : l'orchestrateur unifie la technique, pas la réglementation. Chaque transaction reste exécutée par un EME licencié, avec son propre settlement vers votre compte marchand. Un orchestrateur non-custodial sur les fonds marchands ne fusionne pas les soldes Airtel, Orange et Moov en une seule caisse : il vous donne une seule API et une seule réconciliation, les règlements continuent d'arriver de chaque établissement selon son calendrier (J+1 à J+3 selon l'opérateur).

Quel cadre réglementaire pour encaisser des paiements au Niger ?

Le dispositif applicable à un marchand ou une fintech au Niger s'articule sur quatre textes et trois autorités. Le Règlement UEMOA n°14/2016/CM/UEMOA sur les établissements de monnaie électronique fixe les conditions d'agrément, dont des fonds propres minimums de 500 millions FCFA pour un EME. L'Instruction n°009/05-2011 de la BCEAO encadre les services de paiement électronique. La Directive UEMOA n°01/2019 pose les obligations de lutte contre le blanchiment, avec déclaration des opérations suspectes à la CENTIF-Niger. L'ARCEP Niger supervise quant à elle la qualité de service télécom des trois opérateurs, et publie les indicateurs trimestriels du marché.

Concrètement, pour encaisser en production :

1. Statut marchand : immatriculation au RCCM nigérien (Greffe du Tribunal de Commerce de Niamey ou des Cours d'Appel régionales) et NIF (Numéro d'Identification Fiscale) de la Direction Générale des Impôts. Le sandbox se prototyppe sans société, la production l'exige.
2. KYB opéré par l'EME : pièces d'identité des bénéficiaires effectifs (carte NINA biométrique ou passeport CÉDEAO), relevés bancaires des trois derniers mois, dossier AML/CFT. L'établissement licencié qui exécute vos transactions porte la diligence ; un orchestrateur non-custodial collecte le dossier une fois puis l'instruit chez chaque EME partenaire, il ne remplace pas leur décision d'agrément.
3. Plafonds par niveau de KYC : le plafond entreprise (10 M FCFA de solde, 50 M FCFA de cumul mensuel) et sa déclinaison premium négociée couvrent les marketplaces ; les détails chiffrés sont dans notre analyse des plafonds KYC Niger 2026.
4. Traçabilité : journal d'audit des transactions, conservation des pièces, reporting vers la BCEAO et la CENTIF-Niger en cas d'opérations atypiques.

Pourquoi le modèle non-custodial change l'équation réglementaire : obtenir un agrément EME soi-même demande des fonds propres lourds, des ratios de liquidité et un reporting mensuel BCEAO, sur une trajectoire de plusieurs mois à plusieurs années. S'appuyer sur un orchestrateur dont les partenaires sont déjà agréés ramène le sujet réglementaire à l'onboarding KYB marchand et à l'homologation technique, en quelques semaines, sans que la chaîne d'exécution ne perde en auditabilité : chaque transaction reste rattachable à l'EME qui l'a exécutée. Les données de marché citées tout au long de ce guide proviennent des rapports de supervision de la BCEAO et du GSMA State of the Industry Report on Mobile Money, qui restent les deux références à suivre pour les évolutions 2026.

FAQ

Quel opérateur Mobile Money intégrer en premier au Niger ?

Airtel Money pour la couverture (52% du volume, réseau d'agents à 60% rural), Orange Money pour la maturité API (OpenAPI 3.0, sandbox self-service). Un MVP urbain ciblant les PME de Niamey démarre rentablement sur Orange seul ; toute offre grand public intègre Airtel en premier. Moov Money (15% du volume, API partenaire-only) se négocie en troisième position, sur devis commercial.

Peut-on encaisser du Mobile Money au Niger sans société immatriculée ?

En sandbox, oui : les portails développeurs Orange et Airtel acceptent une inscription individuelle pour tester. En production, non : chaque EME exige un RCCM nigérien à jour et un NIF dans le cadre de son KYB, conformément aux exigences BCEAO. Un entrepreneur individuel peut s'enregistrer au RCCM avec pièce NINA et justificatif, sans créer de société.

Quels documents pour un compte marchand Mobile Money au Niger ?

Extrait RCCM de moins de 3 mois, NIF, statuts de la société, pièce d'identité NINA ou passeport du représentant légal, relevés bancaires des trois derniers mois, et dossier AML/CFT conforme à la Directive UEMOA n°01/2019. La validation prend 14-21 jours ouvrés chez Orange, 21-28 chez Airtel, 30-45 chez Moov. Via un orchestrateur aux contrats cadre déjà signés, un dossier unique instruit chez les trois EME ramène ce délai à quelques semaines au total.

L'orchestrateur détient-il les fonds des marchands ?

Non, pas dans le modèle non-custodial : l'orchestrateur route des ordres de paiement et normalise les statuts, mais les fonds circulent du wallet du client vers l'EME licencié, puis de l'EME vers le compte marchand. La plateforme d'orchestration n'a pas de compte de dépôt intermédiaire, ce qui supprime le risque de contrepartie chez l'orchestrateur. Simiz opère ce modèle : non-custodial sur les fonds marchands, exécution par les EME partenaires licenciés BCEAO.

Une intégration construite pour le Niger sert-elle dans les autres pays UEMOA ?

Oui, avec la même API et la même devise : le franc CFA (XOF) est commun aux huit membres de l'UEMOA, et le routage par préfixe MSISDN (+227 Niger, +223 Mali, +226 Burkina Faso, +228 Togo) étend la couverture sans code supplémentaire. Le contrat commercial reste unique. Pour la même grille d'analyse pays par pays, consultez nos articles orchestrateur Mali et Burkina Faso.

Prêt à exposer une API unique pour le marché nigérien ?

Vous avez la cartographie des trois EME intégrables (Airtel Money, Orange Money, Moov Money), le flux de collecte réel avec ses webhooks et ses latences, les fourchettes de frais en FCFA et le cadre BCEAO applicable. Le choix se résume à deux variables : le coût total de possession de trois intégrations directes (certification, maintenance, réconciliation) et le modèle de détention des fonds (custodial contre non-custodial sur les fonds marchands).