Vous vendez en ligne au Cameroun et vos clients vous demandent de payer par Orange Money. Aujourd'hui, vous leur donnez un numéro, ils envoient, vous vérifiez à la main, puis vous validez la commande. Cela fonctionne — jusqu'au jour où vous recevez trente commandes, où deux clients envoient le mauvais montant et où un troisième affirme avoir payé sans que rien n'arrive.

Cet article explique comment brancher Orange Money directement sur votre boutique WooCommerce, de sorte que la commande passe au statut « payée » toute seule, au moment où le client valide sur son téléphone.

Ce dont vous avez besoin avant de commencer

Une boutique WordPress avec WooCommerce déjà installé et fonctionnel
Un compte marchand ViaziPay dont l'identité a été vérifiée
Vos deux clés d'API, disponibles dans votre espace marchand
Un site accessible depuis internet — un site en local ne peut pas recevoir les notifications de paiement

Ce dernier point mérite qu'on s'y arrête, parce qu'il est la cause la plus fréquente d'une intégration qui « ne marche pas ». Le paiement est confirmé de façon asynchrone : ViaziPay appelle votre site pour lui annoncer le résultat. Si votre boutique tourne sur votre ordinateur, personne ne peut l'appeler, et la commande reste éternellement en attente.

Deux façons de procéder

Le module WooCommerce, si vous ne codez pas

Un module prêt à installer est disponible depuis votre espace marchand, rubrique Intégration. Vous le téléchargez, vous l'installez comme n'importe quelle extension WordPress, et vous renseignez vos deux clés dans ses réglages. C'est le chemin le plus court : comptez une dizaine de minutes.

Le module ajoute Orange Money à la liste des moyens de paiement proposés au moment de la commande, et se charge lui-même de passer la commande en « payée » lorsque la confirmation arrive.

L'API, si vous avez un développeur

Si votre boutique est sur mesure, ou si vous voulez maîtriser le parcours, l'intégration directe demande deux appels.

Premier appel : ouvrir le paiement. Au moment où le client valide son panier, votre serveur envoie une requête à ViaziPay avec le montant et l'identifiant de la commande.

order_id — l'identifiant de votre commande, cinq caractères au minimum
amount — le montant, à partir de 10 FCFA
currency — XAF
return_url — où renvoyer le client après un paiement réussi
cancel_url — où le renvoyer s'il abandonne
notif_url — l'adresse que ViaziPay appellera pour vous annoncer le résultat

L'authentification se fait par vos deux clés, la publique et la privée, transmises ensemble dans l'en-tête d'autorisation. La clé privée ne doit jamais apparaître dans le code de votre page : elle reste sur votre serveur.

Second appel : recevoir la confirmation. C'est ViaziPay qui appelle cette fois, sur l'adresse que vous avez indiquée. Votre code y lit le résultat et met la commande à jour.

Les quatre erreurs qui reviennent le plus souvent

Se fier à la page de retour

Le client revient sur votre site après avoir payé, et la tentation est grande de marquer la commande comme réglée à ce moment-là. C'est une erreur : cette adresse est une adresse publique, que n'importe qui peut ouvrir. Seule la notification serveur à serveur fait foi.

Ne pas traiter le rejeu

Une notification peut arriver deux fois — un réseau qui hésite, une réponse trop lente de votre côté, et l'appel est retenté. Si votre code décrémente un stock à chaque notification reçue, vous décrémenterez deux fois. La parade tient en une ligne : avant d'agir, vérifiez que la commande n'est pas déjà marquée comme payée.

Ne pas vérifier le montant

Le montant qui vous revient dans la notification doit être comparé à celui de la commande dans votre base. C'est une vérification de dix secondes à écrire, et elle vous protège d'un client qui aurait modifié le montant dans la page avant l'envoi.

Oublier les cas d'échec

Un paiement peut échouer : solde insuffisant, expiration du délai, client qui refuse sur son téléphone. Prévoyez ces cas dès le début plutôt qu'après le premier client mécontent, et affichez un message qui explique quoi faire ensuite.

Combien de temps cela prend-il réellement

Avec le module, une matinée en comptant les tests. En intégration directe, comptez une journée de développement pour un développeur qui connaît déjà votre boutique : la partie technique est courte, c'est la recette qui prend du temps — et c'est normal, il s'agit d'argent.

Testez au minimum ces quatre situations avant d'ouvrir à vos clients : un paiement réussi, un paiement refusé, un client qui abandonne en cours de route, et une notification qui arrive deux fois.

Et les autres moyens de paiement

Le même mécanisme couvre MTN Mobile Money, la carte bancaire et la cryptomonnaie : seule l'adresse d'appel change, les paramètres et la logique de notification sont identiques. Une fois Orange Money branché, ajouter MTN prend quelques minutes.

C'est d'ailleurs l'intérêt principal : une seule intégration, une seule réconciliation en fin de journée, un seul interlocuteur — au lieu d'un contrat et d'un relevé par opérateur.