Webhooks
Les webhooks vous permettent de recevoir des notifications en temps réel sur les événements de paiement.Événements
Format du payload
Headers
Vérification de signature
Le headerX-SahelPay-Signature a le format : t=timestamp,v1=signature
Retry automatique
SahelPay retente automatiquement les webhooks en cas d’échec :
Après 5 tentatives, le webhook est marqué comme
FAILED.
Bonnes pratiques
Répondre rapidement
Répondre rapidement
Répondez avec un
200 OK en moins de 5 secondes. Si le traitement est long, faites-le en async.Gérer l'idempotence
Gérer l'idempotence
Utilisez
X-SahelPay-Event-ID pour éviter de traiter deux fois le même événement.Logger les événements
Logger les événements
Conservez un log de tous les webhooks reçus pour le debug.