Webhooks
Les webhooks vous permettent de recevoir des notifications en temps réel sur les événements de paiement.Événements
| Événement | Description |
|---|---|
payment.success | Paiement confirmé |
payment.failed | Paiement échoué |
payment.cancelled | Paiement annulé par le client |
payment.expired | Délai de paiement expiré |
Format du payload
Headers
| Header | Description |
|---|---|
X-SahelPay-Signature | Signature HMAC pour vérification |
X-SahelPay-Timestamp | Timestamp UNIX (secondes) |
X-SahelPay-Event-ID | ID unique de l’événement |
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 :| Tentative | Délai |
|---|---|
| 1 | Immédiat |
| 2 | 1 minute |
| 3 | 2 minutes |
| 4 | 4 minutes |
| 5 | 8 minutes |
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.