Accéder directement au contenu
Créez un compte
ou
connecter-vous
Logo de la documentation Stripe
/
Demander à l'assistant IA
Créez un compte
Connectez-vous
Démarrer
Paiements
Revenus
Plateformes et places de marché
Gestion de fonds
Ressources pour les développeurs
Aperçu
Gestion des versions
Journal des modifications
Mettre à niveau votre version de l'API
Actualiser votre version du SDK
Outils
SDK
API
Tests
Workbench
    Présentation
    Cas d'usage
    Gérer les destinations d'événements
    Alertes et indicateurs sur la santé de l'intégration
    Explorateur API et shell
    Raccourcis clavier
Destinations d'événements
Workflows
CLI Stripe
Shell Stripe
Dashboard des développeurs
Boîte à outils des agents
Intégrer des LLMStripe pour Visual Studio CodeAlertes d'intégrité de StripeChargements de fichiers
Sécurité et confidentialité
Sécurité
Confidentialité
Extensions Stripe
Stripe Apps
Connecteurs Stripe
Partenaires
Partner ecosystem
Certification des partenaires
AccueilRessources pour les développeursWorkbench

Gérer les destinations d'événements

Utilisez Workbench pour configurer des destinations d'événements et recevoir des événements de Stripe.

Ce guide décrit comment configurer une destination d’événement à l’aide de Workbench.

Si vous souhaitez avoir une vue d’ensemble et connaître les bonnes pratiques en matière de réception d’événements concernant votre compte Stripe, consultez le guide des événements de webhook.

Créer une nouvelle destination d’événements

Vous pouvez créer de nouvelles destinations d’événements pour les endpoints de webhook et les destinations AWS EventBridge.

  1. Ouvrez l’onglet Webhooks dans Workbench.
  2. Cliquez sur Créer une destination.
  3. Sélectionnez la version de l’API pour l’objet Events que vous souhaitez utiliser.
  4. Si vous utilisez Connect, vous pouvez écouter les événements sur les comptes connectés. Sinon, choisissez Événements sur votre compte.
  5. Sélectionnez les types d’événements que vous souhaitez envoyer à la destination, puis cliquez sur Continuer.
  6. Sélectionnez Webhook pour envoyer des événements à un endpoint HTTPS.
  7. Fournissez l’URL du endpoint vers laquelle Stripe doit envoyer les webhooks ainsi qu’une description facultative du endpoint.
  8. Cliquez sur Créer une destination pour créer votre endpoint de webhook.
Enregistrer un nouvel endpoint de webhook dans l’onglet Webhooks

Configurer une destination d’événements existante

Vous pouvez mettre à jour ou supprimer des destinations d’événements dans l’onglet Webhooks. Vous pouvez aussi temporairement désactiver une destination. Stripe ne tentera pas de renvoyer les événements générés si la destination est désactivée. Vous pouvez également gérer les destinations d’événements de manière programmatique.

Afficher les événements remis

Écouter avec la CLI Stripe

Vous pouvez également utiliser l’interface de ligne de commande Stripe pour écouter des événements directement dans votre terminal.

Pour consulter les envois d’événements :

  1. Ouvrez l’onglet Webhooks dans Workbench.
  2. Sélectionnez la destination de l’événement.
  3. Cliquez sur l’onglet Envois d’événements.

L’onglet Événements envoyés fournit une liste d’événements et indique s’ils sont à l’état Delivered, Pending ou Failed. Cliquez sur un événement pour afficher les tentatives d’envoi, qui comprennent le code d’état HTTP des précédentes tentatives d’envoi et l’heure des envois à venir en attente.

Afficher les tentatives d'envoi d'événements dans l'onglet Envois d'événements d'un endpoint de webhook

Affichez les tentatives d’envoi d’événements dans l’onglet Envois d’événements d’un endpoint de webhook.

Relancer l’envoi d’un événement

En mode production, Stripe tente d’envoyer 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 Envois d’événements de votre endpoint de webhook répertorié dans Workbench, vous pouvez voir à quel moment la prochaine tentative aura lieu.

Dans un environnement de test, Stripe procède à trois tentatives sur une période de quelques heures. Passé ce délai, vous pouvez retenter manuellement l’envoi d’événements individuels à votre endpoint de webhook à l’aide de l’onglet Webhooks de Workbench, en accédant aux Événements envoyés répertoriés 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.

Réessayez d'envoyer les événements via l'onglet Envois d'événements à l'aide d'un endpoint de webhook.

Réessayez d’envoyer les événements via l’onglet Envois d’événements à l’aide d’un endpoint de webhook.

Voir aussi

  • Outil interactif pour la création d’endpoints de webhook
Cette page vous a-t-elle été utile ?
OuiNon
Besoin d'aide ? Contactez le service Support.
Rejoignez notre programme d'accès anticipé.
Consultez notre log des modifications.
Des questions ? Contactez l'équipe commerciale.
LLM ? Lire llms.txt.
Propulsé par Markdoc