Superviser les événements

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. Enregistrez un endpoint de webhook en mode test dans le Dashboard Stripe. Les applications peuvent être installées en mode production et en mode test. Nous recommandons également de configurer un endpoint en mode test pour gérer les événements en mode test. Recommended
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"
    }
  ],
}

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.

É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 :

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.