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)
Interrogez
GET /v1/providers/enabled pour connaître les rails activés plutôt que de les coder en dur.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 Money aujourd’hui, d’autres rails ensuite : une seule intégration
❌ 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