AccueilJournalJournal · Technique
N° A07 · Technique · API
14 min de lecture
N° A07Journal · Technique

Comment intégrer Orange Money
sur un site e-commerce.

Le guide complet 2026 — de la sandbox à la production, sans plugin tiers.

Intégrer Orange Money sur une boutique en ligne prend entre 2 et 5 jours de développement si vous suivez les étapes dans l'ordre et évitez les pièges courants.

Lecture14 min
CatégorieTechnique
N° A07 / IIntégration step-by-step

Comment intégrer Orange Money sur un site e-commerce en 2026.

L'intégration Orange Money sur un site e-commerce suit 5 étapes principales : création compte développeur, accès sandbox, développement des endpoints backend (initiation + webhook), tests de scénarios, et déploiement en production avec compte marchand actif. En comptant les délais de validation Orange, comptez 1 à 2 semaines entre la demande et la mise en production.

N° A07 / IICompte développeur

Étape 1 — Compte développeur et accès sandbox.

Rendez-vous sur developer.orange.com. Créez un compte et demandez l'accès à l'API Orange Money Cameroun (CM). Une fois approuvé, vous obtenez :

  • Un `client_id` et un `client_secret` pour l'OAuth2
  • L'accès à l'environnement sandbox pour tester sans vraie transaction
  • La documentation de l'API de collection de paiements

Le délai d'approbation est de 2 à 5 jours ouvrés. En attendant, lisez la documentation — elle est en anglais et en français.

N° A07 / IIIBackend : initiation

Backend — initier un paiement et gérer le webhook.

Endpoint d'initiation (côté serveur uniquement — jamais côté client) :

POST sur `/orange/v1/webpayment` avec les paramètres : `merchant_key`, `currency`, `order_id`, `amount`, `return_url`, `cancel_url`, `notif_url` (votre webhook), `lang`, `reference`.

Webhook de confirmation : Orange envoie un POST sur votre `notif_url` avec le statut final. Validez la signature de la requête avant de traiter — c'est la protection contre les faux callbacks. Mettez à jour le statut de commande uniquement après vérification.

Sécurité critique

Ne jamais exposer les credentials Orange Money côté client. Toute la logique d'initiation et de validation doit rester sur votre serveur. Sur Next.js, utilisez les Route Handlers (`app/api/`).

N° A07 / IVErreurs fréquentes

Les erreurs fréquentes à éviter.

  • Webhook non sécurisé — validez toujours la signature. Sans ça, n'importe qui peut simuler un paiement réussi.
  • Timeout trop court — le client met parfois 2 à 3 minutes à valider sur son téléphone. Ne marquez pas la commande comme échouée avant 5 minutes minimum.
  • Double traitement — Orange peut envoyer le webhook plusieurs fois. Rendez votre endpoint idempotent (ignorez les doublons via `order_id`).
  • Passer directement en prod sans tests sandbox — testez tous les scénarios : succès, annulation, timeout, numéro insuffisant.

Vous préférez déléguer ? Notre équipe intègre Orange Money et MTN MoMo nativement sur tous les projets e-commerce. Voir : intégration Mobile Money.

Un projet en tête ?

Premier appel de 45 minutes offert, sans engagement. Devis écrit sous 24h.

WhatsApp< 2hFormulaire de contact