Configurer un endpoint de webhook avec WorkbenchBêta
Ce guide explique comment configurer un endpoint de webhook à l’aide de Workbench.
Enregistrer un endpoint de webhook avec Workbench
Pour enregistrer un endpoint de webhook dans Workbench :
- Ouvrez Workbench depuis le Dashboard, puis cliquez sur l’onglet Webhooks.
- Cliquez sur Enregistrer un nouveau endpoint de webhook.
- Sélectionnez la version de l’API pour l’objet Events que vous souhaitez utiliser.
- Si vous utilisez Connect, vous pouvez écouter les événements sur les comptes connectés. Sinon, sélectionnez Événements sur votre compte.
- Sélectionnez les types d’événement à envoyer à un endpoint de webhook, puis cliquez sur Continuer.
- Fournissez l’URL du endpoint vers laquelle Stripe doit envoyer les webhooks ainsi qu’une description facultative du endpoint.
- Cliquez sur Créer une destination pour créer votre endpoint de webhook.
Enregistrement d’un nouveau endpoint de webhook dans l’onglet Webhooks
Configurer un endpoint de webhook existant
Vous pouvez mettre à jour ou supprimer des endpoints de webhook existants dans l’onglet Webhooks de Workbench. Vous pouvez aussi désactiver temporairement un endpoint de webhook enregistré. Stripe ne tente pas d’envoyer à nouveau les événements générés lorsque l’endpoint de webhook concerné est désactivé. Vous pouvez également gérer les endpoints de webhook par programmation.
Afficher les remises d’événements
Pour afficher les remises d’événements, sélectionnez le endpoint du webhook dans Webhooks, puis sélectionnez l’onglet Remises d’événements.
L’onglet Remises d’événements fournit une liste des événements et indique leur état : Delivered
, Pending
ou Failed
. Cliquez sur un événement pour afficher Delivery attempts
, qui inclut le code d’état HTTP des précédentes tentatives de remise et l’heure des remises à venir en attente.
Affichage des tentatives de remise d’événement dans l’onglet Remises d’événements d’un endpoint de webhook.
Réessayer d’envoyer un événement
En mode production, Stripe tente de remettre un événement donné à votre endpoint de webhook pendant 3 jours maximum, avec un allongement exponentiel du délai entre chaque tentative. Dans la section Remises d’événements de votre endpoint de webhook répertorié dans Workbench, vous pouvez voir à quel moment la prochaine tentative aura lieu.
En mode test, Stripe procède à 3 tentatives sur une période de quelques heures. Passé ce délai, vous pouvez retenter manuellement la transmission d’événements individuels à votre endpoint de webhook à l’aide de l’onglet Webhooks de Workbench, en accédant aux remises d’événements répertoriées pour l’endpoint de votre choix. Vous pouvez également envoyer une requête portant sur les événements manqués pour rapprocher les données sur n’importe quelle période.
Nouvelle tentative d’envoi d’événements à l’aide de l’onglet Remises d’événements d’un endpoint de webhook.