Trois façons de brancher WalleoPay à votre activité.
Selon que vous avez un développeur, un site sur mesure ou simplement un lien à envoyer à vos clients, l'intégration ne demande pas le même travail. Voici ce qui existe aujourd'hui, et ce qui est encore en chantier — sans confusion entre les deux.
API REST
DisponibleVous contrôlez tout : création du paiement, page de paiement, suivi, notifications. C'est la voie retenue par les sites sur mesure et les applications mobiles.
Page de paiement hébergée
DisponibleVous créez le paiement, nous vous renvoyons une adresse, vous y redirigez le client. Aucune interface de paiement à écrire de votre côté.
Modules e-commerce
DisponibleUne extension à déposer dans votre boutique, sans écrire de code : WooCommerce, PrestaShop et WHMCS.
Méthode 1
L'API REST, en un appel
Vous authentifiez vos appels avec votre clé secrète. Le mode découle de la clé : une clé commençant par sk_test_ ne déplacera jamais d'argent réel. La création d'un paiement renvoie son identifiant, son état et l'adresse de la page de paiement.
- Montants en francs entiers, minimum 100 FCFA.
- Votre référence de commande voyage avec le paiement et revient dans le webhook.
- Clé d'idempotence pour qu'un appel rejoué ne crée pas un second paiement.
- Détection de l'opérateur exposée séparément si vous voulez l'afficher vous-même.
curl -X POST https://walleopay.com/api/v1/payments \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{
"amount": 7500,
"reference": "B-2291",
"description": "Commande B-2291",
"customer_phone": "670000001",
"notify_url": "https://ma-boutique.cm/walleopay"
}'Méthode 2
Rediriger vers la page de paiement
C'est le chemin le plus court. Vous n'affichez aucun formulaire de paiement, vous ne manipulez aucun numéro de téléphone : votre serveur crée le paiement, redirige, et reprend la main quand le client revient.
Créez le paiement
Un appel serveur à serveur avec le montant, votre référence, l'adresse de retour et l'adresse de notification.
Redirigez le client
Envoyez-le sur le lien renvoyé. La page affiche votre nom de boutique et le montant dû.
Le client valide
Il saisit son numéro, confirme avec son code Mobile Money. La page suit l'opération jusqu'au bout.
Vous êtes notifié
Le webhook prévient votre serveur, le client revient sur votre page de retour. Revérifiez l'état avant de livrer.
$response = Http::withToken($secret)
->post('https://walleopay.com/api/v1/payments', [
'amount' => 7500,
'reference' => 'B-2291',
'notify_url' => 'https://ma-boutique.cm/walleopay',
'return_url' => 'https://ma-boutique.cm/merci',
])->json();
return redirect($response['checkout_url']);const res = await fetch(
`https://walleopay.com/api/v1/payments/${id}`,
{ headers: { Authorization: `Bearer ${secret}` } }
);
const payment = await res.json();
if (payment.status === 'succeeded') {
await livrerLaCommande(payment.reference);
}Ne livrez jamais une commande sur la seule foi du retour du navigateur ou du contenu d'un webhook : interrogez le paiement avec votre clé secrète et fiez-vous à la réponse de l'API. C'est la seule source qui ne peut pas être falsifiée par un tiers.
Méthode 3
Modules prêts à poser
Le code est public sur GitHub : clonez-le, lisez-le, ouvrez une issue si quelque chose cloche. Chaque module vérifie la signature des notifications puis revérifie le paiement auprès de l'API avant de valider la commande — la règle qui évite les fausses commandes payées.
SDK PHP
Bibliothèque PHP sans dépendance pour créer des paiements, vérifier les notifications et demander des reversements.
- PHP 8.1 ou plus récent
- Extensions cURL et JSON
WooCommerce
Extension WordPress qui ajoute MTN Mobile Money, Orange Money et la carte bancaire au tunnel de commande WooCommerce.
- WordPress 6.0 ou plus récent
- WooCommerce 7.0 ou plus récent
- PHP 7.4 ou plus récent
PrestaShop 8
Module de paiement PrestaShop 8, avec page de configuration, retour client revérifié et notification serveur à serveur.
- PrestaShop 8.0 ou plus récent
- PHP 7.4 ou plus récent
WHMCS
Passerelle de paiement WHMCS pour régler les factures en Mobile Money, avec rapprochement automatique.
- WHMCS 8.0 ou plus récent
- PHP 7.4 ou plus récent
SDK Node.js
Bibliothèque serveur Node.js sans dépendance (fetch natif) pour créer des paiements, vérifier les notifications et demander des reversements. Types TypeScript fournis.
- Node.js 18 ou plus récent
SDK Flutter
Paquet Dart/Flutter côté client : ouvre la page de paiement dans un WebView et suit l'état du paiement, sans jamais embarquer de clé secrète dans l'application.
- Flutter 3.19 ou plus récent
- Dart 3.3 ou plus récent
- Android 5.0 (API 21) ou iOS 12 minimum
SDK React
Paquet React côté navigateur : bouton de paiement et suivi d'état en français, sans clé secrète dans le bundle. Redirection ou nouvelle fenêtre, jamais d'iframe.
- React 18 ou plus récent
- Un serveur qui crée le paiement (SDK PHP ou Node.js)
API REST
Documentée, utilisable dès l'inscription.
Page de paiement hébergée
Fournie avec la plateforme, rien à installer.
Ces modules n'ont pas encore été éprouvés en boutique de production : ils sont validés par des tests automatisés et une relecture, pas par des mois d'usage réel. Installez-les d'abord sur un environnement de test, avec vos clés de test, avant de basculer en réel. Signalez-nous le moindre écart, nous corrigeons vite.
Vous ne trouvez pas votre plateforme ?
Site développé sur mesure, application mobile, logiciel de caisse, plateforme de réservation, outil interne : dès qu'un système peut envoyer une requête HTTP, il peut encaisser avec WalleoPay.
Dites-nous ce que vous utilisez
Décrivez votre site ou votre application et le volume que vous prévoyez. Nous vous répondons avec le chemin d'intégration le plus court, et nous tenons compte des demandes pour décider quels modules écrire en premier.
Nous écrireVous êtes développeur ?
Créez un compte, récupérez vos clés de test et faites passer un premier paiement dans la foulée. Aucun contrat, aucune validation préalable n'est nécessaire pour intégrer en mode test.
Obtenir mes clés de testPremière transaction en quelques heures
Le temps d'intégration tient dans une après-midi pour un développeur habitué aux API. Et si vous bloquez, on répond.