Webhooks

Recevez des notifications HTTP en temps réel pour les événements dans The Wallet Crew.

Les webhooks permettent aux systèmes de recevoir des notifications HTTP en temps réel chaque fois qu’un événement se produit dans l’équipe Wallet. L’enregistrement des webhooks se fait en libre-service via Paramètres → Général → Webhooks dans la console d’administration. Aucune appel API n’est requis pour créer ou gérer des webhooks.

Gérez les webhooks depuis la console

Ouvrir Paramètres → Général → Webhooks. La liste affiche tous les webhooks enregistrés, y compris Description, Point de terminaison, Événements, et Activé état.

Pour créer ou modifier un webhook, ouvrez son formulaire de modification. Le formulaire contient les champs suivants :

• ID — Généré automatiquement et en lecture seule. Utilisez cette valeur pour référencer le webhook via l’API.
• Secret — La clé de signature HMAC utilisée pour vérifier les livraisons. Un bouton afficher/masquer contrôle la visibilité. Stockez cette valeur côté serveur et ne l’exposez jamais dans le code client.
• Activé — Met en pause ou reprend la livraison sans supprimer le webhook.
• Description — Un libellé utilisé comme référence.
• Point de terminaison — L’URL HTTPS qui reçoit POST les requêtes.
• Événements — Une ou plusieurs souscriptions d’événements. Utilisez Ajouter un événement et Supprimer un événement pour gérer la liste.

Syntaxe du filtre d’événements

Chaque Événements entrée est une chaîne. Trois formes sont prises en charge :

Syntaxe	Signification
*	S’abonner à tous les événements.
Carte:*	S’abonner à tous les événements de la Carte catégorie.
Carte:Created	S’abonner à un événement spécifique.

Les jokers et les événements explicites peuvent être combinés dans le même webhook. Par exemple :

• ["Customer:*", "Carte:Created"]
• ["Carte:*", "Redirect:Redirected"]

Validation de la signature

Chaque livraison inclut le x-neostore-signature en-tête. Validez-le côté serveur avec le webhook Secret. Voir le guide du développeur des webhooks pour le modèle de validation complet et la référence de charge utile des événements.

Validez toujours x-neostore-signature sur chaque requête entrante. Ne vous fiez pas uniquement aux listes d’autorisation d’adresses IP réseau.