# Gérer les échecs de génération d'événements webhook

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](https://docs.stripe.com/api/v2/core/events/list.md). Stripe crée à la place un événement [v2.core.health.event_generation_failure.resolved](https://docs.stripe.com/api/v2/core/events/event-types.md#v2_event_types-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](https://docs.stripe.com/workbench/overview.md#events)
- L’onglet [Intégrité](https://docs.stripe.com/workbench/health.md)

### Endpoints de webhook

Suivez le [guide de configuration webhook](https://docs.stripe.com/webhooks.md) 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](https://docs.stripe.com/event-destinations.md#thin-events) généré pour récupérer l’objet `v2.core.health.event_generation_failure.resolved`, comme illustré dans l’exemple suivant.

```json
{
  "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é `context`correctement, 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](https://docs.stripe.com/api/payment_intents.md)) pour récupérer l’objet associé :

```curl
curl https://api.stripe.com/v1/payment_intents/pi_1QA8PKDTvO5jCVb3TVDZP75a \
  -u "<<YOUR_SECRET_KEY>>:"
```