Gérer les échecs de génération d'événements webhookVersion bêta publique

Découvrez comment gérer les webhooks qui n’ont pas pu être générés.

Dans de très rares cas, Stripe peut échouer à générer l’objet Événement. Dans ce cas, l’événement est irrécupérable et Stripe ne sera pas le transmettre à vos destinations d’événements ou le rendre disponible dans le Dashboard ou dans l’API List Events. Stripe crée à la place un événement v2.core.health.event_generation_failure.resolved pour vous informer que la génération de l’événement a échoué. Ce guide explique le fonctionnement de l’alerte et les mesures que vous pouvez prendre pour y remédier.

Envoi d’événements ayant échoué

Stripe envoie les événements v2.core.health.event_generation_failure.resolved à la fois à Workbench et à tous les endpoints webhook que vous configurez pour les écouter.

Workbench

Les événements v2.core.health.event_generation_failure.resolved apparaissent à deux endroits dans Workbench :

L’onglet Événements
L’onglet Intégrité

Endpoints de webhook

Suivez le guide de configuration webhook pour enregistrer un endpoint webhook qui écoute les événements légers v2.core.health.event_generation_failure.resolved. Après avoir enregistré le bon endpoint webhook, Stripe lui envoie des événements v2.core.health.event_generation_failure.resolved.

Comment utiliser l’événement d’intégrité

Lorsque Stripe échoue à générer un événement webhook, vous pouvez traiter l’ événement léger généré pour récupérer l’objet v2.core.health.event_generation_failure.resolved, comme illustré dans l’exemple suivant.

{
  "alert_id": "halert_61RFBMa6o6H87usts16RFBM10hSQlYfddqcFoEMR6CPY",
  "grouping_key": "_grouping_s8PgTvizbkORV9z5PhaJSvc4dUcAMmfRpEHKm4EeJ1glsQ5XMf",
  "impact": {
    "event_type": "payment_intent.requires_action",
    "related_object_id": "pi_1QA8PKDTvO5jCVb3TVDZP75a",
    "related_object": {
      "id": "pi_1QA8PKDTvO5jCVb3TVDZP75a",
      "type": "payment_intent",
      "url": "https://dashboard.stripe.com/payment_intents/pi_1QA8PKDTvO5jCVb3TVDZP75a"
    },
  },
  "resolved_at": "2025-10-30T16:05:44.000Z",
  "summary": "We have failed to create a notification for your Stripe account.",
}

L’exemple d’événement fournit les informations suivantes sur l’échec :

Événement échoué : Stripe n’a pas réussi à générer un événement payment_intent.requires_action.
Objet pertinent : le PaymentIntent pour lequel Stripe n’a pas réussi à générer l’événement est pi_1QA8PKDTvO5jCVb3TVDZP75a.
Horodatage :Échec de la génération de l’événement à 2025-10-30T16:05:44.000Z
Type de compte : l’impact n’inclut pas la propriété contextcorrectement, l’événement payment_intent.requires_action ne s’est donc pas produit sur un compte connecté.

Si votre intégration repose sur la réception de webhooks pour l’événement payment_intent.requires_action, celle-ci sera désynchronisée avec l’état de Stripe. Pour effectuer la synchronisation, après avoir reçu un webhook v2.core.health.event_generation_failure.resolved, vous pouvez interroger l’API concernée (ici l’API Payment Intents) pour récupérer l’objet associé :