Passer au contenu principal
MTN MoMo — Collection API.

​
Pays couverts

​
URLs

​
Credentials requis

À renseigner dans Settings → Stores → MTN :

​
Particularités

  • Double authentification : MTN exige à la fois la Ocp-Apim-Subscription-Key (en-tête) et un token OAuth bearer obtenu via POST /collection/token/ en Basic auth (api_user:api_key).
  • Token caché en mémoire avec marge de sécurité de 60 secondes avant expiration.
  • L’en-tête X-Target-Environment: sandbox est obligatoire pour le mode sandbox.
  • L’en-tête X-Reference-Id (UUID) doit être unique par requête — SandPay en génère un automatiquement.
  • Les msisdn sont envoyés sans le + dans le payload (partyId).

​
Codes d’erreur natifs mappés

Les codes natifs MTN sont traduits vers les statuts canoniques SandPay (SUCCESS, PIN_INVALID, INSUFFICIENT_FUNDS, ACCOUNT_BLOCKED, …). Consultez frontend/lib/operators/_errors.ts côté repo pour la table complète.

​
Voir aussi