# Fonctionnement des événements

Découvrez comment Stripe génère les événements et les envoie à votre intégration.

Lorsqu’un changement d’état se produit dans votre compte Stripe, Stripe génère un événement et peut l’envoyer vers une ou plusieurs destinations configurées. Votre application reçoit l’événement, identifie son type et effectue l’action appropriée.

Cette page décrit la structure et l’envoi des événements. Pour obtenir des instructions de configuration propres à chaque destination, consultez ces sections&nbsp;:

- [Endpoints de webhook](https://docs.stripe.com/webhooks.md)
- [Amazon EventBridge](https://docs.stripe.com/event-destinations/eventbridge.md)
- [Azure Event Grid](https://docs.stripe.com/event-destinations/eventgrid.md)

## Génération d’événements

Chaque changement d’état dans Stripe auquel votre intégration peut avoir besoin de réagir génère un [objet](https://docs.stripe.com/api/v2/core/events.md) `Event`. Une même action effectuée sur une ressource Stripe peut générer plusieurs événements. Par exemple, la création d’un nouvel abonnement peut générer un événement `customer.subscription.created` et un événement `payment_intent.succeeded` dans certaines conditions.

Les événements sont envoyés de manière asynchrone vers les destinations d’événements que vous avez configurées. Vous pouvez configurer chaque destination pour recevoir un ensemble précis de types d’événements. Le format et l’envoi de chaque événement dépendent de la configuration de votre destination.

## Destinations d’événements

Stripe envoie les événements vers les destinations que vous avez configurées, qui peuvent être des [endpoints de webhook](https://docs.stripe.com/webhooks.md), [Amazon EventBridge](https://docs.stripe.com/event-destinations/eventbridge.md) ou [Azure Event Grid](https://docs.stripe.com/event-destinations/eventgrid.md). Votre application reçoit ces événements pour pouvoir exécuter des actions de back-end, comme&nbsp;:

- Envoyer une notification aux utilisateurs lorsqu’un client confirme un paiement
- Démarrer un processus interne de rapprochement des litiges lorsqu’un client conteste un paiement
- Accorder l’accès à vos utilisateurs lorsqu’ils effectuent des paiements d’abonnement récurrents réussis

Chaque destination reçoit les événements dans l’un des deux formats suivants&nbsp;: [léger](https://docs.stripe.com/events/how-events-work.md#thin-events) ou [instantané](https://docs.stripe.com/events/how-events-work.md#snapshot-events). Vous choisissez le format lors de la création de la destination.

### Gérer les destinations d’événements

Pour créer, mettre à jour, supprimer ou désactiver une destination d’événements dans le Dashboard, ouvrez l’onglet [Webhooks](https://dashboard.stripe.com/webhooks) dans Workbench ou utilisez l’[API event destinations](https://docs.stripe.com/api/v2/event-destinations/.md). Après avoir désactivé une destination d’événements, Stripe cesse de lui envoyer des événements. Après avoir réactivé une destination, Stripe recommence à lui envoyer des événements.

Pour obtenir des instructions de configuration détaillées propres à chaque destination, consultez&nbsp;:

- [Endpoints de webhook](https://docs.stripe.com/webhooks.md)
- [Amazon EventBridge](https://docs.stripe.com/event-destinations/eventbridge.md)
- [Azure Event Grid](https://docs.stripe.com/event-destinations/eventgrid.md)

### Limites des destinations d’événements

Vous pouvez enregistrer jusqu’à 16&nbsp;destinations d’événements par compte en mode production ou en environnement de test. Lorsque vous enregistrez une destination d’événements instantanés avec une version différente de la version par défaut de l’API de votre compte, vous pouvez enregistrer jusqu’à trois destinations d’événements instantanés avec des versions distinctes.

## Formats d’événements

Stripe envoie les événements dans deux formats&nbsp;:

- **[Événements légers](https://docs.stripe.com/events/how-events-work.md#thin-events)**&nbsp;: Stripe envoie une notification légère contenant le type d’événement et l’ID de la ressource. Votre code peut ensuite, si nécessaire, récupérer l’événement complet ou l’état le plus récent de la ressource associée via l’API.
- **[Événements instantanés](https://docs.stripe.com/events/how-events-work.md#snapshot-events)**&nbsp;: Stripe envoie une charge utile contenant l’objet `Event` complet, y compris un instantané de la ressource associée à un moment donné. Votre code peut éventuellement récupérer l’état le plus récent de la ressource associée via l’API.

### Comparaison

Pour les nouvelles intégrations, utilisez les événements légers. Les événements légers ne sont pas versionnés, ils sont entièrement typés dans les SDK Stripe et ils permettent à votre intégration de récupérer l’état le plus récent de la ressource. La notification elle-même contient des identifiants et des métadonnées sur l’événement, et non l’état de la ressource. Votre code récupère donc la ressource actuelle via l’API.

Utilisez les événements légers lorsque&nbsp;:

- L’intégrité des données est essentielle et votre application doit agir sur les informations les plus récentes.
- Vous souhaitez simplifier la gestion des versions en ne gérant les mises à niveau que côté client.
- Vous développez une application moderne avec vérification des types et souhaitez tirer parti des avantages liés au typage des SDK.

Utilisez les événements instantanés lorsque&nbsp;:

- Un outil tiers ou une intégration nécessite de recevoir la charge utile complète de l’objet `Event`.
- Vous devez vérifier les champs qui ont été modifiés sans effectuer d’appel à l’API ultérieur. Les événements légers incluent les champs modifiés dans le hachage `changes` de l’événement complet, tandis que les événements instantanés contiennent directement `previous_attributes` dans la charge utile.
- Votre intégration nécessite une vue de la ressource à un instant donné et peut fonctionner avec des données à cohérence éventuelle.

Le tableau suivant présente les principales différences entre les deux formats.

| Caractéristiques | Événements instantanés | Événements légers |
| --- | --- | --- |
| Créé par | Changements d’état des ressources des API v1 et v2 | Changements d’état des ressources des API v1 et v2. Consultez le [catalogue des événements légers](https://docs.stripe.com/api/v2/core/events/event-types.md) pour obtenir la liste complète des types pris en charge. |
| Charge utile envoyée | **Volumineuse**&nbsp;: inclut un instantané de l’objet de l’API associé à l’événement | **Légère**&nbsp;: inclut l’ID de l’objet de l’API associé à l’événement dans une notification d’événement léger |
| Accéder à des données supplémentaires | Récupérez la version la plus récente de l’objet via l’API. L’objet contenu dans la charge utile de l’événement peut être obsolète au moment où vous traitez l’événement. | Récupérez l’objet le plus récent via l’API ou récupérez l’[événement](https://docs.stripe.com/api/v2/events.md) complet depuis `v2/events`. La charge utile complète de l’événement peut contenir des informations supplémentaires. Par exemple, la charge utile d’un événement `v1.billing.meter.error_report_triggered` contient des informations sur les types et la fréquence des erreurs générées. |
| Saisie du SDK | Non saisi | Saisi |
| Gestion des versions | Versionné par version d’API | Non versionnés, ce qui vous permet de mettre à niveau votre intégration sans modifier la configuration de votre destination d’événements |
| API pour afficher les événements | [API Events v1](https://docs.stripe.com/api/events.md) | [API Events v2](https://docs.stripe.com/api/v2/events.md) |

Si vous utilisez [Accounts&nbsp;v2](https://docs.stripe.com/connect/accounts-v2/migrate-integration.md), vous pourriez écouter à la fois des événements instantanés et des événements légers.

### Événements légers

Un événement léger envoie une notification légère contenant uniquement les informations d’identification&nbsp;:

- le type d’événement (`type`), qui décrit ce qui s’est produit. Par exemple, `v2.core.account.updated`. Consultez la [liste complète des événements légers](https://docs.stripe.com/api/v2/core/events/event-types.md)
- l’ID de l’événement (`id`), que vous utilisez pour récupérer l’objet `Event` complet.
- un horodatage (`created`), qui indique quand l’événement s’est produit.
- l’ID de la ressource associée (`related_object`), ainsi que le type et l’URL de l’API de cette ressource.

Pour accéder à l’état complet de la ressource ou à des données supplémentaires sur l’événement, votre code doit effectuer un appel à l’API ultérieur à l’aide de ces informations. Pour connaître l’ensemble des propriétés, consultez l’[objet Event](https://docs.stripe.com/api/v2/core/events/object.md).

Les ressources des API v1 et v2 génèrent toutes deux des événements légers. Comme les charges utiles des notifications d’événements légers ne sont pas versionnées, vous pouvez mettre à niveau votre SDK Stripe ou la version de l’API de votre intégration sans modifier la configuration de votre destination d’événements. Les événements et les ressources que vous récupérez via l’API suivent toujours le [comportement standard de gestion des versions de l’API](https://docs.stripe.com/api/versioning.md). Les notifications sont également entièrement typées dans les SDK, de sorte que votre code bénéficie d’une vérification des types à la compilation lors du traitement des événements. Grâce à ces caractéristiques, les événements légers sont le format recommandé pour les nouvelles intégrations.

#### Structure de la charge utile de la notification

L’exemple suivant présente une notification d’événement léger `v2.core.account.updated`. La propriété `id` contient l’ID de l’objet `Event` associé. Le hachage `reason` décrit ce qui a déclenché l’événement, tandis que le hachage `related_object` identifie la ressource associée.

```json
{
  "id": "evt_test_65UIRNU7G1XbhCfOim416TgmEI4ASQ3jHxXt8RFwXoeVwO",
  "object": "v2.core.event",
  "type": "v2.core.account.updated",
  "livemode": false,
  "created": "2026-03-09T13:00:28.435Z",
  "context": null,
  "reason": {
    "type": "request",
    "request": {
      "id": "req_v2y9y15XqG3Futmjg",
      "idempotency_key": "ik_TgmEI3jHxXt8RFw4jS7ve2QcAReDQWBjPAkAEUm"
    }
  },
  "related_object": {
    "id": "acct_1T93Q4Pmpb34Vto6",
    "type": "v2.core.account",
    "url": "/v2/core/accounts/acct_1T93Q4Pmpb34Vto6"
  }
}
```

#### Traitement des notifications d’événements légers

La notification initiale contient un minimum de données. Selon votre cas d’usage, vous pouvez obtenir davantage d’informations sur l’événement ou l’objet, ou traiter immédiatement la notification&nbsp;:

- **Récupérez l’événement complet**&nbsp;: utilisez le SDK ou l’API pour [récupérer l’objet event](https://docs.stripe.com/api/v2/core/events/retrieve.md). L’objet complet comprend deux types de données supplémentaires&nbsp;:

  - Des informations contextuelles sur l’événement dans le hachage `data`. Par exemple, un événement `v1.billing.meter.error_report_triggered` contient des informations détaillées sur les types d’erreurs de validation et leurs récapitulatifs.
  - Les valeurs précédentes des attributs modifiés de la ressource dans le hachage `changes`.

- **Récupérez l’état le plus récent de l’objet associé**&nbsp;: utilisez [related_object.url](https://docs.stripe.com/api/v2/core/events/object.md#v2_event_object-related_object-url) pour récupérer la version la plus récente de la ressource associée à l’événement via le SDK ou l’API.

- **Traitez la notification immédiatement**&nbsp;: si le type d’événement et l’ID de la ressource contenus dans la notification fournissent suffisamment d’informations pour votre cas d’usage, vous pouvez la traiter sans effectuer d’appel à l’API supplémentaire.

Le tableau suivant indique les propriétés disponibles dans la notification d’événement par rapport à l’objet d’événement complet&nbsp;:

| Nom de la propriété | Notification d’événement | Événement |
| --- | --- | --- |
| Type d’événement | ✓ Pris en charge | ✓ Pris en charge |
| ID de la ressource associée | ✓ Pris en charge | ✓ Pris en charge |
| ID d’événement | ✓ Pris en charge | ✓ Pris en charge |
| Horodatage créé | ✓ Pris en charge | ✓ Pris en charge |
| Motif | ✓ Pris en charge | ✓ Pris en charge |
| Modifications | ❌ Non pris en charge | ✓ Pris en charge |
| Données | ❌ Non pris en charge | ✓ Pris en charge |

L’exemple suivant montre comment récupérer l’état le plus récent de l’objet associé directement à partir de la notification d’événement, sans effectuer d’appel à l’API supplémentaire pour récupérer l’événement&nbsp;:

#### Java

```java
com.stripe.model.v2.core.EventNotification eventNotification = client.parseEventNotification(payload, signatureHeader, endpointSecret);
if (eventNotification instanceof V1BillingMeterErrorReportTriggeredEventNotification) {
  V1BillingMeterErrorReportTriggeredEventNotification notif =
      (V1BillingMeterErrorReportTriggeredEventNotification) eventNotification;
  // fetchRelatedObject() makes one network request to fetch the latest version
  // of the object associated with this event (a Meter, in this case).
  // No API call to retrieve the full Event is needed.
  Meter meter = notif.fetchRelatedObject();
}
```

L’exemple suivant montre comment récupérer l’objet Event complet lorsque votre intégration nécessite des données supplémentaires, comme le hachage `data` avec des informations contextuelles ou le hachage `changes` avec les valeurs d’attribut précédentes&nbsp;:

#### Java

```java
com.stripe.model.v2.core.EventNotification eventNotification = client.parseEventNotification(payload, signatureHeader, endpointSecret);
if (eventNotification instanceof V1BillingMeterErrorReportTriggeredEventNotification) {
  V1BillingMeterErrorReportTriggeredEventNotification notif =
      (V1BillingMeterErrorReportTriggeredEventNotification) eventNotification;
  // Use fetchEvent() when you need additional data in the Event object,
  // such as the "data" hash with contextual info or the "changes" hash
  // with previous attribute values.
  com.stripe.model.v2.core.Event event = notif.fetchEvent();
  if (event instanceof V1BillingMeterErrorReportTriggeredEvent) {
    V1BillingMeterErrorReportTriggeredEvent typedEvent =
        (V1BillingMeterErrorReportTriggeredEvent) event;
    String summary = typedEvent.getData().getDeveloperMessageSummary();
  }
}
```

#### Saisie du SDK

Les événements légers et leurs notifications sont entièrement typés dans les SDK Stripe&nbsp;:

- **Notification d’événement**&nbsp;: la charge utile légère initiale est typée comme `{EventType}EventNotification`.
- **Événement**&nbsp;: après avoir récupéré l’événement complet avec `fetchEvent()`, l’objet est typé comme `{EventType}Event`.

### Événements instantanés

Un événement instantané transmet une charge utile contenant l’objet `Event` complet, y compris un instantané à cohérence éventuelle de la ressource mise à jour au moment où l’événement a été généré. Comme cet instantané peut être obsolète au moment où votre application le traite, récupérez la version la plus récente de la ressource via l’API avant d’utiliser ces données.

Les événements instantanés sont versionnés selon la version de l’API. La version de l’API d’une destination d’événements instantanés est définie lors de sa création, et la structure de la charge utile est liée à cette version. Vous devez donc gérer la compatibilité des versions entre la configuration de votre destination et le code de votre intégration. Pour en savoir plus sur la mise à niveau, consultez la section [Mettre à niveau une destination d’événements instantanés](https://docs.stripe.com/events/how-events-work.md#upgrade-versioning) ou le [Guide de gestion des versions de l’API](https://docs.stripe.com/api/versioning.md).

Les événements instantanés sont générés par les ressources des API v1 et v2. Ils incluent une propriété `previous_attributes` qui indique, le cas échéant, les champs qui ont été modifiés. Consultez la [liste complète des événements instantanés](https://docs.stripe.com/api/events/types.md).

Utilisez les événements instantanés lorsque les événements légers ne conviennent pas à votre cas d’usage. Pour en savoir plus, consultez la section [Choisir un format](https://docs.stripe.com/events/how-events-work.md#choosing-event-format).

#### Structure de la charge utile

L’exemple suivant présente un événement instantané `setup_intent.created`, qui inclut la définition complète de l’objet telle qu’elle était au moment où l’événement a été généré&nbsp;:

```json
{
  "id": "evt_1NG8Du2eZvKYlo2CUI79vXWy",
  "object": "event",
  "api_version": "2019-02-19",
  "created": 1686089970,
  "data": {
    "object": {
      "id": "seti_1NG8Du2eZvKYlo2C9XMqbR0x",
      "object": "setup_intent",
      "application": null,
      "automatic_payment_methods": null,
      "cancellation_reason": null,
      "client_secret": "seti_1NG8Du2eZvKYlo2C9XMqbR0x_secret_O2CdhLwGFh2Aej7bCY7qp8jlIuyR8DJ",
      "created": 1686089970,
      "customer": null,
      "description": null,
      "flow_directions": null,
      "last_setup_error": null,
      "latest_attempt": null,
      "livemode": false,
      "mandate": null,
      "metadata": {},
      "next_action": null,
      "on_behalf_of": null,
      "payment_method": "pm_1NG8Du2eZvKYlo2CYzzldNr7",
      "payment_method_options": {
        "acss_debit": {
          "currency": "cad",
          "mandate_options": {
            "interval_description": "First day of every month",
            "payment_schedule": "interval",
            "transaction_type": "personal"
          },
          "verification_method": "automatic"
        }
      },
      "payment_method_types": [
        "acss_debit"
      ],
      "single_use_mandate": null,
      "status": "requires_confirmation",
      "usage": "off_session"
    }
  },
  "livemode": false,
  "pending_webhooks": 0,
  "request": {
    "id": null,
    "idempotency_key": null
  },
  "type": "setup_intent.created"
}
```

#### Gestion des versions des événements instantanés

Les destinations d’événements instantanés utilisent une version de l’API définie explicitement ou la version de l’API par défaut du compte Stripe. Si vous utilisez un SDK pour langage à typage statique (.NET, Java ou Go) pour traiter les événements, la version de l’API configurée sur la destination doit correspondre à celle utilisée pour générer le SDK. Des versions différentes entraînent des erreurs de désérialisation.

Toutes les versions de l’API antérieures à [2024-09-30.acacia](https://docs.stripe.com/changelog/acacia.md#2024-09-30.acacia) comportent des changements majeurs. À partir de la version `2024-09-30.acacia`, Stripe suit un [nouveau processus de publication d’API](https://stripe.com/blog/introducing-stripes-new-api-release-process) dans lequel les versions mensuelles de l’API d’une même version ne comportent aucun changement majeur. Vous pouvez mettre à niveau votre destination d’événements vers n’importe quelle version de cette même version sans modifier le code de votre intégration. Deux fois par an, Stripe publie une nouvelle version nommée qui commence par une version comportant des changements majeurs.

Les événements légers ne sont pas soumis à ces contraintes. Comme les charges utiles des notifications d’événements légers sont stables, vous pouvez mettre à niveau votre SDK ou votre version de l’API sans modifier la configuration de votre destination d’événements.

#### Mettre à niveau une destination d’événements vers une nouvelle version de l’API

Utilisez le [Guide de mise à niveau de l’API](https://docs.stripe.com/upgrades.md) pour mettre à jour vos destinations d’événements et vos endpoints de webhook.

## Autorisations relatives aux événements

Pour afficher un événement dans le Dashboard, attribuez le [rôle d’administrateur ou de développeur](https://docs.stripe.com/get-started/account/teams/roles.md) à votre compte utilisateur. Pour récupérer un événement via l’API, utilisez soit une [clé API secrète](https://docs.stripe.com/keys.md#create-api-secret-key), qui vous permet de visualiser tous les types d’événements par défaut, soit une [clé API limitée](https://docs.stripe.com/keys.md#create-restricted-api-key) en activant l’accès en lecture (`Read`) pour la ressource du type d’événement concerné. Par exemple, vous pouvez accorder l’accès `Read` aux ressources `payment_intent` sur votre clé API limitée pour récupérer `payment_intent.succeeded events` de manière programmatique.

## Rétention des événements

Dans l’onglet **Événements** de Workbench, vous pouvez accéder aux événements des 13&nbsp;derniers mois&nbsp;:

- Événements datant de moins de 15&nbsp;jours&nbsp;: vous pouvez consulter la charge utile complète de l’événement, voir les tentatives d’envoi et renvoyer manuellement ces événements.
- Événements datant de 16 à 30&nbsp;jours&nbsp;: vous pouvez accéder à la charge utile complète de l’événement, mais vous ne pouvez pas les renvoyer ni consulter les tentatives d’envoi.
- Événements datant de plus de 30&nbsp;jours&nbsp;: vous pouvez uniquement consulter un résumé avec des champs tronqués. La réexpédition et l’affichage des tentatives d’envoi ne sont pas disponibles.

Utilisez les API [Retrieve currency](https://docs.stripe.com/api/v2/core/events/retrieve.md) et [List events](https://docs.stripe.com/api/v2/core/events/list.md) pour accéder aux événements avec leur charge utile complète des 30&nbsp;derniers jours.

## Récupérer les types d’événements manquants

Si la liste `enabled_events` de votre destination omet des types d’événements dont votre intégration a besoin, ajoutez ces types et récupérez les événements historiques disponibles. La mise à jour de `enabled_events` n’affecte que les envois futurs. Stripe n’envoie pas automatiquement les événements antérieurs.

Avant de récupérer des événements, vérifiez les [autorisations des événements](https://docs.stripe.com/events/how-events-work.md#event-permissions) et interrogez le contexte du compte qui les a produits. Pour les comptes connectés, utilisez l’[en-tête Stripe-Account](https://docs.stripe.com/connect/authentication.md#stripe-account-header). Pour les comptes d’organisation ou d’autres relations de compte, utilisez l’[en-tête Stripe-Context](https://docs.stripe.com/context.md). Si votre destination reçoit des événements de plusieurs comptes, interrogez le contexte de chaque compte concerné séparément.

1. Mettez à jour `enabled_events` dans le [Dashboard](https://dashboard.stripe.com/webhooks) ou avec l’[API des destinations d’événements](https://docs.stripe.com/api/v2/event-destinations.md) pour inclure les types d’événements manquants.

2. Récupérez et traitez les événements historiques. Les événements qui n’ont pas été envoyés à votre destination peuvent rester disponibles via l’API Events pendant 30&nbsp;jours. Utilisez l’API qui correspond à votre format d’événement&nbsp;:

   - **Événements snapshot**&nbsp;: utilisez [Lister les événements (v1)](https://docs.stripe.com/api/events/list.md) avec le paramètre `type` pour filtrer par type d’événement.
   - **Événements légers**&nbsp;: utilisez [Lister les événements (v2)](https://docs.stripe.com/api/v2/core/events/list.md) avec le paramètre de tableau `types` pour filtrer par type d’événement, puis [récupérez l’événement complet](https://docs.stripe.com/api/v2/core/events/retrieve.md).

   Traitez les objets `Event` renvoyés dans votre intégration. Si vous avez besoin de l’état le plus récent de la ressource, récupérez la ressource associée séparément.

3. Examinez les événements plus anciens dans [Événements](https://dashboard.stripe.com/workbench/events) dans Workbench. Les événements de plus de 30&nbsp;jours ont des résumés avec des champs tronqués, et vous ne pouvez pas récupérer leur charge utile complète ni les renvoyer. Les résumés sont disponibles pendant 13&nbsp;mois maximum. Consultez la section [Rétention des événements](https://docs.stripe.com/events/how-events-work.md#event-retention) pour plus de détails.

### Contraintes de récupération d’Amazon EventBridge

Pour les destinations Amazon EventBridge, vous ne pouvez pas renvoyer manuellement des événements via Stripe. Suivez la procédure de récupération de cette section pour récupérer les événements disponibles des 30&nbsp;derniers jours et les traiter directement dans votre application.

Une archive EventBridge ne peut pas récupérer les événements que Stripe n’a jamais envoyés à votre bus d’événements. Pour apprendre à archiver les événements que le bus reçoit, consultez la section [Comportements d’envoi d’EventBridge](https://docs.stripe.com/event-destinations/eventbridge.md#event-delivery-behaviors).

## Comportements de distribution des événements

Cette section décrit comment Stripe envoie les événements vers les destinations que vous avez configurées.

### Retentatives automatiques

Stripe tente de livrer des événements à votre destination pendant un maximum de trois&nbsp;jours avec un recul exponentiel en mode production. Le cas échéant, vous pouvez voir quand la prochaine tentative aura lieu dans l’onglet **Événements envoyés** de votre destination d’événement. Les livraisons d’événements créées dans un environnement de test sont relancées trois&nbsp;fois en l’espace de quelques heures. Si votre destination a été désactivée ou supprimée lorsque nous effectuons une nouvelle tentative de remise, nous annulons toute relance ultérieure de cet événement. Toutefois, si vous désactivez puis réactivez la destination de l’événement avant que nous ne puissions effectuer la relance, les tentatives ultérieures seront toujours visibles.

### Retentatives manuelles

Vous pouvez relancer manuellement des événements dans le Dashboard Stripe en cliquant sur **Renvoyer** lors de la consultation d’un événement spécifique. Cette opération est possible jusqu’à 15&nbsp;jours après la création de l’événement.

### Ordre des événements

Stripe ne garantit pas la remise des événements dans l’ordre dans lequel ils ont été générés. Par exemple, la création d’un abonnement peut générer les événements suivants&nbsp;:

- `customer.subscription.created`
- `invoice.created`
- `invoice.paid`
- `charge.created` (si un paiement a lieu)

Assurez-vous que la destination de vos événements ne dépend pas de la réception d’événements dans un ordre précis. Les événements de type snapshot enregistrent `created` en secondes, des événements distincts peuvent donc partager un même horodatage. N’utilisez pas `created` pour déterminer l’ordre des événements ou pour savoir si vous avez déjà traité un événement. Suivez plutôt les [ID d’événement](https://docs.stripe.com/api/events/object.md#event_object-id) pour identifier les envois en double. Vous pouvez également utiliser l’API pour récupérer tout objet manquant. Par exemple, vous pouvez récupérer les objets invoice, charge et subscription avec les informations de `invoice.paid` si vous recevez cet événement en premier.

### Gestion des versions de l’API

Lorsque l’événement survient, la version de l’API dans les paramètres de votre compte détermine la version de l’API, et par extension la structure d’un [événement](https://docs.stripe.com/api/events.md), envoyées à votre destination. Par exemple, si votre compte utilise une ancienne version d’API, comme 2015-02-16, et que vous modifiez la version de l’API pour une requête spécifique avec [le contrôle de version](https://docs.stripe.com/api.md#versioning), l’objet [Event](https://docs.stripe.com/api/events.md) généré et envoyé à votre destination est toujours basé sur la version de l’API du 16/02/2015. Vous ne pouvez pas modifier les objets [Event](https://docs.stripe.com/api/events.md) une fois qu’ils ont été créés. Par exemple, si vous mettez à jour un paiement, l’événement de paiement d’origine reste inchangé. Par conséquent, les mises à jour apportées par la suite à la version de l’API de votre compte ne modifient pas de manière rétroactive les objets [Event](https://docs.stripe.com/api/events.md) existants. La récupération d’un ancien [Event](https://docs.stripe.com/api/events.md) par l’appel à `/v1/events` à l’aide d’une version récente de l’API n’a pas non plus de conséquence sur la structure de l’événement reçu. Vous pouvez définir les destinations des événements de test sur votre version d’API par défaut ou sur la version la plus récente de l’API. L’objet [Event](https://docs.stripe.com/api/events.md) envoyé à la destination est structuré en fonction de la version spécifiée pour la destination de l’événement.

## Vérifier l’authenticité des webhooks

Vérifiez toujours que les événements webhook proviennent bien de Stripe avant d’agir en conséquence. Utilisez ces deux mesures de protection&nbsp;:

- **Vérification de la signature**&nbsp;: Stripe signe chaque événement de webhook en incluant une signature dans l’en-tête `Stripe-Signature`. Vérifiez cette signature à l’aide des [bibliothèques officielles](https://docs.stripe.com/events/set-up-events.md#signature-checking) pour confirmer que l’événement n’a pas été envoyé ou modifié par un tiers.
- **Autorisation par liste d’IP**&nbsp;: Stripe envoie les événements webhook depuis une liste définie d’[adresses IP](https://docs.stripe.com/ips.md). Configurez votre serveur ou votre pare-feu pour n’accepter les requêtes webhook que depuis ces adresses.

Pour obtenir des instructions de configuration complètes, consultez la section [Configurer des événements](https://docs.stripe.com/events/set-up-events.md).
