Bienvenue sur SahelPay
SahelPay est une API technique de paiement au Mali : documentation, sandbox, webhooks signés et idempotence. Un seul moyen de paiement est disponible : le mobile money au Mali (ORANGE_MONEY). Toute autre valeur de provider est rejetée avec une erreur 400.
Pourquoi SahelPay ?
API REST
Une intégration unique pour les paiements mobile money
Confirmation vérifiée
Un paiement n’est confirmé qu’après contrôle auprès de l’opérateur
Checkout hébergé
Page de paiement hébergée par SahelPay, retour automatique vers votre site après confirmation
Webhooks fiables
Notifications signées avec retry automatique
Idempotence
X-Idempotency-Key sur chaque création : un retry ne crée jamais de doublonSandbox gratuite
Testez toute l’intégration sans abonnement
Abonnements clients
Plans récurrents et portail client self-service
SDKs officiels
JavaScript, PHP, Python
Flow de paiement
Premiers pas
1
Demander l'accès
L’ouverture de compte se fait sur demande : écrivez à support@sahelpay.africa
2
Récupérer vos clés API
Dans le dashboard, section Développeurs → Clés API
3
Intégrer en sandbox
Suivez le guide de démarrage rapide. La sandbox est gratuite.
4
Passer en production
Sur demande, après validation et contrat distinct : voir Passer en production.
Environnements
L’accès à la production est soumis à une validation et à des conditions distinctes précisant son périmètre et les rôles de chaque partie. Voir Passer en production.
Méthode de paiement
Utilisez toujours une clé
sk_test_... pour vos tests. Pour simuler un paiement sans aucun appel opérateur, envoyez metadata.sahelpay_mock: true (option mock des SDKs).Fonctionnalités principales
- Paiements : création et suivi de paiements mobile money avec checkout hébergé
- Liens de paiement : liens réutilisables à montant fixe ou libre
- Webhooks : notifications signées pour chaque changement de statut
- Idempotence : création rejouable sans doublon
- Programme Partenaires SPAY : SahelPay vend en son nom les produits validés de votre catalogue
- Abonnements clients et Customer Portal
SAHEL PAY TECHNOLOGIES (SPAY) n’est pas une banque ni un établissement de paiement agréé par la BCEAO.