Guide d’intégration
Ce guide détaille le flow complet d’intégration SahelPay pour une application marchande.Principes fondamentaux
Architecture
Flow détaillé
1. Créer le paiement (Backend)
Pour les paiements par carte (
CARD, VISA, MASTERCARD, GIM_UEMOA), ajoutez customer_name et customer_email dans le body.2. Rediriger le client
3. Recevoir le webhook
Idempotence
Côté création
UtilisezX-Idempotency-Key basé sur l’order_id :
Côté webhook
Vérifiez si le paiement est déjà traité avant de mettre à jour :Ce que votre app NE DOIT PAS faire
❌ Appeler les providers directement
Orange, Wave, Moov… Tout passe par SahelPay
❌ Calculer des frais
SahelPay gère les frais automatiquement
❌ Créer un wallet
Pas de stockage de solde dans votre app
❌ Marquer PAID sans webhook
Le return_url est pour l’UX uniquement