Skip to main content

Événements webhook

SahelPay envoie des webhooks pour vous notifier des événements importants.

Événements disponibles

ÉvénementDescription
payment.successPaiement confirmé avec succès
payment.failedPaiement échoué
payment.cancelledPaiement annulé par le client
payment.expiredDélai de paiement expiré
payout.completedPayout envoyé avec succès
payout.failedPayout échoué

Format du payload

{
  "event": "payment.success",
  "version": "v1",
  "timestamp": "2025-12-18T16:37:00.000Z",
  "data": {
    "id": "txn_abc123",
    "amount": 5000,
    "currency": "XOF",
    "status": "SUCCESS",
    "provider": "ORANGE_MONEY",
    "provider_ref": "OM123456789",
    "customer_phone": "+22370123456",
    "metadata": {
      "order_id": "order_123"
    },
    "created_at": "2025-12-18T16:35:00.000Z",
    "updated_at": "2025-12-18T16:37:00.000Z"
  }
}

Headers

HeaderDescription
X-SahelPay-Signaturet=timestamp,v1=signature
X-SahelPay-TimestampTimestamp UNIX (secondes)
X-SahelPay-Event-IDID unique de l’événement
Content-Typeapplication/json

Retry automatique

TentativeDélai
1Immédiat
21 minute
32 minutes
44 minutes
58 minutes