Le pas-à-pas d'une intégration API officielle, avec les pièges à éviter et les vrais coûts en sandbox.
L'intégration Orange Money est plus simple qu'on ne le croit — mais uniquement si vous passez par les APIs officielles et non par des plugins tiers.
Sur WordPress ou Shopify, vous trouverez des plugins qui promettent d'ajouter Orange Money en « 5 minutes ». Ne les utilisez pas. Voici pourquoi :
Ils ne sont pas certifiés par Orange Cameroun. Ils utilisent des APIs non documentées qui peuvent changer sans préavis — votre paiement casse le lendemain d'une mise à jour.
La traçabilité est nulle. En cas de litige avec un client, vous n'avez pas accès aux logs de transaction côté opérateur. Votre recours est quasi-inexistant.
Les frais cachés. La plupart des plugins prennent une commission sur chaque transaction, en plus des frais Orange. Vous payez deux fois.
Orange Money Cameroun propose une API REST documentée, accessible après création d'un compte développeur sur le portail Orange Developer. Voici les éléments clés :
Avant toute intégration, vous devez avoir un compte marchand Orange activé. Ce compte est différent de votre compte Orange Money personnel. La procédure prend 3 à 7 jours ouvrés — prévoir cette latence dans votre planning.
L'API expose trois endpoints clés : /token (authentification OAuth2), /requesttopay (initier un paiement), /requesttopay/{referenceId} (vérifier le statut). Le flux est simple : vous demandez un paiement, l'utilisateur reçoit une notification sur son téléphone, il confirme avec son PIN, vous recevez un webhook de confirmation.
Le webhook de confirmation est la partie critique. Vous devez : vérifier la signature HMAC de chaque webhook pour éviter les faux positifs, gérer les retentatives (Orange peut envoyer le même webhook plusieurs fois), et implémenter une vérification du statut côté API si vous ne recevez pas de webhook dans les 60 secondes.
En production camerounaise, les utilisateurs sont souvent sur 3G ou même 2G. Le délai entre la demande de paiement et la confirmation peut atteindre 2 à 3 minutes. Votre UI doit gérer cet état d'attente clairement — un spinner + message rassurant.
Orange propose un environnement sandbox complet — utilisez-le jusqu'à ce que chaque scénario passe à 100%. Les scénarios à tester impérativement :
Premier appel de 45 minutes offert, sans engagement. Devis écrit sous 24h.