Configurer les webhooks

​

Activer les webhooks

Les webhooks sont une fonctionnalité sur abonnement et doivent être activés sur le compte avant de pouvoir enregistrer des endpoints.

1. Dans la barre latérale du tableau de bord, allez dans Settings → Developers
2. Dans le panneau Webhooks, cliquez sur Enable Webhooks
3. Une fois les webhooks activés, ce même bouton devient Manage Webhooks et ouvre directement la page des webhooks

Si le compte n’a pas de forfait incluant les webhooks, la page affiche un bouton Upgrade to enable webhooks au lieu de l’écran de configuration.

​

Ajouter un endpoint

La page des webhooks intègre un portail webhook sécurisé, et la gestion des endpoints se fait dans ce portail intégré, pas dans les écrans propres à storekit.

1. Ouvrez la page des webhooks (Settings → Developers → Manage Webhooks)
2. Dans le portail intégré, ajoutez un nouvel endpoint
3. Saisissez l’URL de votre endpoint (par ex. https://example.com/webhooks/storekit)
4. Sélectionnez les types d’événements que vous souhaitez recevoir
5. Enregistrez votre endpoint

​

Exigences pour l’endpoint

Votre endpoint doit :

• Être accessible publiquement via HTTPS
• Accepter les requêtes POST
• Renvoyer un code de statut 2xx dans un délai de 15 secondes
• Avoir la protection CSRF désactivée pour cette route

​

Choisir les types d’événements

Vous pouvez vous abonner à des types d’événements spécifiques ou recevoir tous les événements. Nous vous recommandons de ne vous abonner qu’aux événements dont vous avez besoin afin de minimiser le trafic inutile. Consultez la page Événements webhook pour la liste complète des événements disponibles.

​

Tester votre endpoint

Avant la mise en production, testez votre endpoint pour vous assurer qu’il fonctionne correctement :

1. Envoyez un événement de test depuis le portail webhook intégré
2. Vérifiez que votre endpoint reçoit le webhook de test
3. Vérifiez que votre endpoint renvoie une réponse 2xx