# 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](https://docs.stripe.com/event-destinations.md).

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

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

#### Webhook

1. Ouvrez l’onglet [Webhooks](https://dashboard.stripe.com/webhooks) dans Workbench.
2. Cliquez sur **Créer une destination**.
3. Sélectionnez la version de l’API pour l’[objet Events](https://docs.stripe.com/api/events.md) que vous souhaitez utiliser.
4. Si vous utilisez [Connect](https://docs.stripe.com/connect.md), 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](https://docs.stripe.com/api/events/types.md) 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.

#### AWS EventBridge

1. Ouvrez l’onglet [Webhooks](https://dashboard.stripe.com/webhooks) dans Workbench.
2. Cliquez sur **Créer une destination**.
3. Sélectionnez la version de l’API pour l’[objet Events](https://docs.stripe.com/api/events.md) que vous souhaitez utiliser.
4. Si vous utilisez [Connect](https://docs.stripe.com/connect.md), 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](https://docs.stripe.com/api/events/types.md) que vous souhaitez envoyer à la destination, puis cliquez sur **Continuer**.
6. Sélectionnez **AWS EventBridge** pour envoyer les événements directement à votre compte AWS.
7. Fournissez votre **Numéro de compte AWS** à Stripe pour y envoyer des événements.
8. Indiquez la **Région AWS** dans laquelle vous souhaitez recevoir les événements.
9. (Facultatif) Incluez un nom et une description de la destination.

#### Azure Event Grid

1. Ouvrez l’onglet [Webhooks](https://dashboard.stripe.com/webhooks) dans Workbench.
2. Cliquez sur **Créer une destination**.
3. Sélectionnez la version de l’API pour l’[objet Events](https://docs.stripe.com/api/events.md) que vous souhaitez utiliser.
4. Si vous utilisez [Connect](https://docs.stripe.com/connect.md), 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](https://docs.stripe.com/api/events/types.md) que vous souhaitez envoyer à la destination, puis cliquez sur **Continuer**.
6. Sélectionnez **Azure Event Grid** pour envoyer les événements directement à votre abonnement Azure.
7. Fournissez votre **ID d’abonnement Azure** et sélectionnez la **région Azure** dans laquelle vous souhaitez recevoir les événements.
8. Fournissez le **nom du groupe de ressources** pour votre Azure Event Grid.
9. (Facultatif) Incluez un nom et une description de la destination.
![Enregistrer un nouvel endpoint de webhook dans l’onglet Webhooks](https://b.stripecdn.com/docs-statics-srv/assets/create-webhook-endpoint.92271ebcb6d3c1f936baaeeda36feafc.png)

## Configurer une destination d’événements existante

Vous pouvez mettre à jour ou supprimer des destinations d’événements dans l’onglet [Webhooks](https://dashboard.stripe.com/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](https://docs.stripe.com/api/v2/core/event_destinations.md) de manière programmatique.

## Afficher les événements remis

Vous pouvez également utiliser la [CLI Stripe](https://docs.stripe.com/cli.md) pour [écouter les événements](https://docs.stripe.com/webhooks.md#test-webhook) directement dans votre terminal.

Pour consulter les envois d’événements :

1. Ouvrez l’onglet [Webhooks](https://dashboard.stripe.com/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 (Envoyé), (En attente) ou (Échec). 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](https://b.stripecdn.com/docs-statics-srv/assets/view-event-deliveries.375483a863ab143a0e92f01fa01c14b0.png)

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](https://docs.stripe.com/sandboxes.md), 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](https://docs.stripe.com/api/events/list.md) 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.](https://b.stripecdn.com/docs-statics-srv/assets/retry-failed-event-deliveries.225753ebf217cd1e9d0798f0c6f0a198.png)

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

## See also

- [Outil interactif pour la création d’endpoints de webhook](https://docs.stripe.com/webhooks/quickstart.md)