Webhooks - Raba7ni Developer API

Info: Les webhooks vous permettent de synchroniser vos systèmes externes avec l'activité des membres et du programme de fidélité.

Lister les Événements Webhook

GET Lister les Événements

public

/api/v1/reference/webhook-events

Récupérer la liste de tous les types d'événements webhook disponibles.

Réponse

{
  "success": true,
  "data": {
    "events": {
      "member_joined": "When a new member joins a card",
      "points_earned": "When a member earns points from a purchase",
      "..."
    }
  }
}

Sécurité et Vérification

Pour vérifier que le webhook provient bien de notre serveur, nous incluons une signature HMAC SHA-256 dans l'en-tête X-Webhook-Signature.

Exemple de Vérification (PHP)

$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'];
$secret = 'votre_secret_application';

$computedSignature = hash_hmac('sha256', $payload, $secret);

if (hash_equals($computedSignature, $signature)) {
    // Webhook valide
}

Référence des Événements

Événement	Description	Produit
`member_joined`	Lorsqu'un nouveau membre rejoint une carte	Commun
`member_left`	Lorsqu'un membre quitte une carte	Commun
`claim_request_created`	Lorsqu'un membre soumet une demande de récompense	Loyalty
`claim_request_processed`	Lorsqu'une demande est approuvée ou rejetée	Loyalty
`points_earned`	Lorsqu'un membre gagne des points lors d'un achat	Loyalty
`points_redeemed`	Lorsqu'un membre échange des points contre une récompense	Loyalty
`stamps_added`	Lorsque des tampons sont ajoutés à une carte	Loyalty
`stamps_redeemed`	Lorsque des tampons sont échangés contre une récompense	Loyalty
`cashback_earned`	Lorsqu'un membre gagne du cashback lors d'un achat	Cashback
`cashback_redeemed`	Lorsqu'un membre échange du cashback	Cashback
`coins_issued`	Lorsque des coins sont émis à un membre	Coins
`coins_spent`	Lorsqu'un membre dépense des coins	Coins