Superviser les événements

Les applications peuvent utiliser les Webhooks pour recevoir des alertes sur les événements qui se produisent sur les comptes de leurs utilisateurs. Cela permet aux développeurs d’applications de synchroniser les informations ou de déclencher des actions dans leur application lors d’un changement.

Démarrer

1. Gérez les événements webhook dans le back-end de votre application.
2. Enregistrez un endpoint de webhook dans le Dashboard Stripe et sélectionnez Écouter les événements sur les comptes connectés.
3. Recommended Enregistrez un endpoint de webhook de test dans le Dashboard Stripe. Vous pouvez installer des applications en mode production, en mode test ou dans un environnement de test. Nous vous recommandons également de configurer un endpoint de test pour gérer les événements de test.
4. Ajoutez les autorisations nécessaires à votre application en exécutant stripe apps grant permission pour chacune d’entre elles.
   Command Line

   stripe apps grant permission "PERMISSION_NAME" "EXPLANATION"

   Remplacez :
   • PERMISSION_NAME avec le nom de l’autorisation.
   • EXPLANATION avec une explication relative à l’autorisation d’accès. Les utilisateurs voient cette explication lorsqu’ils installent votre application.

Vous devez ajouter l’autorisation event_read, ainsi que toutes les autorisations associées aux événements spécifiques que vous souhaitez gérer. Pour plus d’informations sur les autorisations requises pour un événement particulier, consultez la rubirque Autorisations pour les événements.

Par exemple, si vous souhaitez gérer les événements payment_intent.succeeded et setup_intent.succeeded, exécutez les commandes suivantes :

stripe apps grant permission "event_read" "Read webhook event data"
stripe apps grant permission "checkout_session_read" "Read Checkout Session data in webhook events"
stripe apps grant permission "payment_intent_read" "Read PaymentIntent data in webhook events"
stripe apps grant permission "setup_intent_read" "Read SetupIntent data in webhook events"

Après avoir exécuté ces commandes, le fichier du manifeste de votre application pourrait ressembler à ce qui suit :

{
  "id": "com.example.app",
  "version": "1.2.3",
  "name": "Example App",
  "icon": "./example_icon_32.png",
  "permissions": [
    {
      "permission": "event_read",
      "purpose": "Read webhook event data"
    }
    {
      "permission": "checkout_session_read",
      "purpose": "Read Checkout Session data in webhook events"
    }
    {
      "permission": "payment_intent_read",
      "purpose": "Read PaymentIntent data in webhook events"
    }
    {
      "permission": "setup_intent_read",
      "purpose": "Read SetupIntent data in webhook events"
    }
  ],
}

Surveiller les événements de votre compte

Pour recevoir les événements d’une application qui n’est accessible qu’aux utilisateurs de votre compte :

1. Gérez les événements webhook dans le back-end de votre application.
2. Enregistrez un endpoint de webhook dans le Dashboard Stripe.

Recevoir des notifications d’événement concernant votre application

Écoutez les événements (comme les installations et désinstallations des utilisateurs) sur votre application Stripe en utilisant des webhooks entrants pour permettre à votre intégration de déclencher automatiquement des réactions sur votre back-end, telles que :

• La création de comptes utilisateur
• La mise à jour d’autorisations
• La désactivation d’un compte utilisateur et la suppression des données

Outre les types d’événements pris en charge par Stripe, les applications Stripe prennent en charge les événements suivants :

Tester des webhooks localement

Vous pouvez tester des webhooks en local pour :

• Une application qui n’est accessible qu’aux utilisateurs de votre compte et qui écoute les événements sur votre propre compte
• Une application disponible sur le Stripe App Marketplace et qui écoute les événements sur les comptes qui ont installé votre application

Pour tester des webhooks en local :

1. Installez la CLI Stripe.

2. Authentifiez votre compte :

   Command Line

   stripe login

3. Ouvrez deux fenêtres de terminal :

   • Dans une fenêtre de terminal, configurez le transfert d’événements :

     Publication sur l'App Marketplace

     Privé pour votre compte uniquement

     Command Line

     stripe listen --forward-connect-to localhost:{{PORT}}/webhook

   • Dans l’autre fenêtre de terminal, déclenchez des événements pour tester votre intégration des webhooks :

     Publication sur l'App Marketplace

     Privé pour votre compte uniquement

     Command Line

     stripe trigger --stripe-account {{EVENT_NAME}}

Pour plus d’informations, consultez notre documentation relative au test d’un point de terminaison de webhook.