Comment se passera un paiement MTN MoMo
- Vous créez le paiement avec
"provider": "mtn", le montant et le numéro MTN du client. - MTN envoie une demande de paiement sur le téléphone du client, avec le montant à valider.
- Le client valide avec son code MoMo. Aucune redirection n'est nécessaire sur votre site.
- Vous recevez le webhook
payment.succeededoupayment.failedsi le client refuse ou ne répond pas.
Exemple : créer un paiement MTN MoMo (dès l'ouverture)
curl -X POST https://api.sandbox.nguepay.com/api/v1/payments \ -H "Authorization: Bearer sk_sandbox_…" \ -H "Content-Type: application/json" \ -d '{ "amount": 12000, "provider": "mtn", "reference": "CMD-1044", "phone": "+2250500000000" }'
En Côte d'Ivoire, les numéros MTN commencent par 05 (10 chiffres après l'indicatif +225). Le passage en production se fait en changeant l'adresse de l'API et la clé : voir la documentation.
Ce que vous obtiendrez avec NguePay
- Pas d'accès développeur MTN à obtenir. NguePay gérera la connexion à MTN Mobile Money et vous reversera les fonds encaissés.
- Remboursements par API. Vous pourrez rembourser un client MTN MoMo en totalité ou en partie depuis l'API ou le dashboard.
- Virements sortants : vous pourrez payer partenaires et prestataires vers leurs numéros MTN MoMo.
- Un seul code pour tout : Orange Money et la carte passent déjà par le même appel ; MTN MoMo et Wave s'y ajouteront.
Bon à savoir
- Si le client ne valide pas la demande à temps, le paiement passe en échec (
failed) et ne vous coûte rien. - Le numéro doit correspondre à un compte MTN Mobile Money actif en Côte d'Ivoire.
- Montants de 100 à 5 000 000 XOF par paiement.
Questions fréquentes sur l'API MTN MoMo
MTN MoMo est-il disponible sur NguePay ?
Pas encore : MTN MoMo arrive bientôt. En attendant, vous pouvez encaisser avec Orange Money et la carte bancaire. Votre intégration acceptera MTN MoMo sans changement de code.
Faudra-t-il un compte MTN MoMo Developer ?
Non. Vous utiliserez uniquement l'API NguePay, qui gérera la connexion avec MTN pour vous.
Combien coûtera un paiement MTN MoMo ?
Le même tarif que les autres portefeuilles mobile money : 1,5 % + 100 XOF par paiement réussi sur l'offre Démarrage. Voir les tarifs.
Commencez avec Orange Money et la carte
MTN MoMo s'ajoutera à votre intégration dès son ouverture.