Menu
Sandbox Se connecter

Orange Money · Côte d'Ivoire

API Orange Money Côte d'Ivoire : encaissez en ligne sur une page de paiement sécurisée.

NguePay crée la session de paiement Orange Money. Votre client est redirigé vers la page de paiement Orange, valide avec son compte Orange Money, puis revient sur votre site. Votre serveur est notifié dès que le paiement est confirmé. La carte bancaire passe par la même intégration.

Tester Orange Money en sandbox Voir la documentation

Comment se passe un paiement Orange Money

  1. Votre serveur crée le paiement avec "provider": "orange", le montant en XOF et votre référence de commande.
  2. NguePay renvoie un checkout_url : vous y redirigez votre client.
  3. Le client valide sur la page de paiement Orange Money avec son numéro et son compte, puis revient sur votre site.
  4. Vous recevez le webhook payment.succeeded et vous validez la commande.

Votre site ne manipule ni code secret ni donnée de compte : tout se passe sur la page d'Orange.

Exemple : créer un paiement Orange Money

● sandbox
curl -X POST https://api.sandbox.nguepay.com/api/v1/payments \
  -H "Authorization: Bearer sk_sandbox_…" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 8500,
    "provider": "orange",
    "reference": "CMD-1043",
    "description": "Commande CMD-1043"
  }'

La réponse contient le checkout_url vers la page de paiement Orange Money. Pour passer en production, changez seulement l'adresse de l'API et la clé, comme expliqué dans la documentation.

Pourquoi passer par NguePay pour Orange Money

  • Pas d'intégration opérateur à gérer. Vous n'avez ni contrat ni API Orange Money à maintenir : NguePay s'en charge et vous reverse les fonds.
  • La carte avec le même code. La carte bancaire s'active en changeant le champ provider ; Wave et MTN MoMo s'y ajouteront bientôt.
  • Un statut fiable. Chaque notification d'Orange est authentifiée avant d'être transmise à votre serveur, et les paiements sont rapprochés avec Orange.

Bon à savoir

  • Le client doit avoir un solde Orange Money suffisant. Sinon, le paiement échoue et vous recevez un webhook payment.failed, sans frais pour vous.
  • Les remboursements Orange Money ne sont pas automatiques : ils sont traités manuellement par notre équipe sur demande.
  • Montants de 100 à 5 000 000 XOF par paiement, en francs CFA, sans décimales.

Questions fréquentes sur l'API Orange Money

Comment intégrer Orange Money sur un site web en Côte d'Ivoire ?

Ouvrez un compte NguePay, puis créez un paiement avec le moyen orange. Redirigez le client vers le checkout_url renvoyé : il paie sur la page Orange Money et votre serveur reçoit un webhook signé. Vous pouvez tout tester en sandbox avant de passer en live.

Le client doit-il quitter mon site pour payer avec Orange Money ?

Brièvement : il est redirigé vers la page de paiement sécurisée d'Orange Money, puis revient automatiquement sur votre site une fois le paiement validé ou annulé.

Combien coûte un paiement Orange Money ?

1,5 % + 100 XOF par paiement réussi sur l'offre Démarrage, sans abonnement. Voir les tarifs.

Peut-on rembourser un client Orange Money ?

Oui, mais pas automatiquement : Orange Money ne permet pas le remboursement par API. Faites la demande depuis le dashboard ou par e-mail, notre équipe s'en charge.

Acceptez Orange Money sur votre site

Compte sandbox gratuit, sans engagement.

Créer un compte