Aller au contenu principal

Webhooks — notifications sortantes (Business)

Différent des notifications in-app : ceci envoie une requête HTTP vers votre propre serveur à chaque événement.

GET /api/v1/business/webhooks (ou /business/dashboard/webhooks) 🔒​

{ "data": [ { "id": 3, "url": "https://maboutique.com/webhooks/trustsend", "events": ["mobile_money_deposit.completed"], "active": true, "created_at": "..." } ] }

POST /api/v1/business/webhooks 🔒​

Body

{
  "url": "https://maboutique.com/webhooks/trustsend",
  "events": ["mobile_money_deposit.completed", "mobile_money_payout.failed"]
}

events possibles : mobile_money_deposit.completed, mobile_money_deposit.failed, mobile_money_payout.completed, mobile_money_payout.failed.

Réponse 201

{
  "data": {
    "url": "...", "events": [...], "active": true,
    "secret": "whsec_...",
    "message": "Webhook subscribed. Store the secret securely — used to verify X-Webhook-Signature on delivery."
  }
}

⚠️ secret n'est renvoyé qu'à la création — sert à vérifier l'en-tête X-Webhook-Signature (HMAC) sur chaque livraison reçue.

DELETE /api/v1/business/webhooks/:id 🔒​

GET /api/v1/business/webhooks/:id/deliveries 🔒​

50 dernières tentatives de livraison.

{ "data": [ { "id": 100, "event_type": "mobile_money_deposit.completed", "status": "delivered", "retry_count": 0, "last_error": null, "created_at": "...", "updated_at": "..." } ] }