Skip to main content

Webhooks

Les webhooks vous permettent de recevoir des notifications en temps réel sur les événements de paiement.
Le webhook est la source de vérité. Ne marquez jamais une commande comme “payée” sans avoir reçu et vérifié un webhook payment.success.

Événements

Format du payload

Headers

Vérification de signature

Le header X-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épondez avec un 200 OK en moins de 5 secondes. Si le traitement est long, faites-le en async.
Utilisez X-SahelPay-Event-ID pour éviter de traiter deux fois le même événement.
Conservez un log de tous les webhooks reçus pour le debug.