Destinations d'événementsBêta
Envoyez des événements depuis Stripe vers des endpoints de webhook et des services dans le cloud.
Configurez une destination d’événement pour envoyer des événements Stripe vers plusieurs types de destinations, dont des endpoints de webhook et Amazon Eventbridge.
Cas d’usage![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Lors de la création d’intégrations Stripe , vous pouvez souhaiter que vos applications reçoivent les événements en temps réel depuis vos comptes Stripe, afin de permettre à vos systèmes back-end de répondre et d’exécuter les actions nécessaires en conséquence.
Avec une destination d’événement, Stripe transfère les données d’événement en temps réel depuis votre compte, ce qui vous permet d’exécuter des actions back-end, telles que les suivantes :
- Envoi d’une notification aux utilisateurs lorsqu’un client confirme un paiement
- Démarrage d’un processus interne de rapprochement des litiges lorsqu’un client conteste un paiement
- Octroi d’un accès à votre utilisateur lorsqu’il effectue des paiements d’abonnement récurrents
Types de destinations pris en charge![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Envoyez des événements à un compte AWS à l’aide d’Amazon EventBridge, ou envoyez-les à un endpoint HTTPS par l’intermédiaire d’endpoints de webhook.
Présentation des événements![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Stripe génère des données d’événement pour vous informer de l’activité de votre compte.
Lorsqu’un événement se produit, Stripe génère un nouvel objet Event. Une fois que votre destination a reçu l’événement, votre application peut exécuter des actions back-end (par exemple, appeler l’API de votre fournisseur pour prévoir une livraison quand vous recevez un événement payment_
).
L’événement que nous envoyons à votre destination d’événements fournit un aperçu de l’objet modifié. Il peut inclure une propriété previous_
qui indique le changement, le cas échéant.
Consultez la liste complète des types d’événements que nous envoyons à votre destination d’événement.
Une seule requête d’API peut entraîner la création de plusieurs événements. Par exemple, la création d’un nouvel abonnement pour un client peut se traduire par la génération des événements customer.
et payment_
. Sélectionnez les événements auxquels vous souhaitez vous abonner pour chaque destination d’événements.
Exemple de charge utile d’un événement![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
La charge utile suivante est un exemple d’événement invoice.
qui se déclenche lorsque vous créez un nouvel abonnement.
{ "object": { "id": "in_1KnN0G589O8KAxCGfVSpD0Pj", "object": "invoice", "account_country": "US",
Autorisations relatives aux événements![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Pour afficher un événement dans le Dashboard, attribuez le rôle d’administrateur ou de développeur à votre compte utilisateur. Pour récupérer un événement via l’API, utilisez soit une clé API secrète, qui vous permet de visualiser tous les types d’événements par défaut, soit une clé API limitée 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_
sur votre clé API limitée pour récupérer payment_
de façon programmatique.
Rétention des événements![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Vous pouvez accéder aux événements créés au cours des 13 derniers mois dans l’onglet Événements de Workbench. Cependant, vous ne pouvez renvoyer ou consulter manuellement que les tentatives d’envoi datant de moins de 15 jours dans la section Événements envoyés. Pour les événements datant de plus de 30 jours, vous pouvez accéder à une synthèse, qui ne comprend que des champs tronqués des données d’origine de l’événement.
Vous pouvez accéder aux événements des 30 derniers jours à l’aide des API Retrieve event et API List event.
Désactiver une destination d’événements![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Vous pouvez désactiver une destination d’événements. Une fois cette fonctionnalité désactivée, Stripe cessera d’envoyer des événements vers cette destination. Une fois que vous avez réactivé une destination, Stripe reprend l’envoi des événements vers cette destination.