Déclencher des actions avec les webhooks

Ajoutez un nouveau point de terminaison à votre application. Pour réagir à certains événements, consultez le champ type de l’objet de l’événement envoyé dans le corps de la requête. Ensuite, choisissez la sortie standard pour nous assurer que le webhook fonctionne.

Après avoir ajouté votre nouveau point de terminaison, redémarrez le serveur.

// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
const stripe = require('stripe')(
'sk_test_BQokikJOvBiI2HlWgH4olfQ2');

// This example uses Express to receive webhooks
const app = require('express')();

// Use body-parser to retrieve the raw body as a buffer
const bodyParser = require('body-parser');

// Match the raw body to content type application/json
app.post('/webhook', bodyParser.raw({type: 'application/json'}), (request, response) => {
  const event = request.body;

  // Handle the event
  switch (event.type) {
    case 'payment_intent.succeeded':
      const paymentIntent = event.data.object;
      console.log('PaymentIntent was successful!');
      break;
    case 'payment_method.attached':
      const paymentMethod = event.data.object;
      console.log('PaymentMethod was attached to a Customer!');
      break;
    // ... handle other event types
    default:
      console.log(`Unhandled event type ${event.type}`);
  }

  // Return a 200 response to acknowledge receipt of the event
  response.json({received: true});
});

app.listen(4242, () => console.log('Running on port 4242'));

# Install Homebrew to run this command: https://brew.sh/
brew install stripe/stripe-cli/stripe

# Connect the CLI to your dashboard
stripe login

Pour découvrir des méthodes d’installation supplémentaires, consultez la section Démarrer avec l’interface de ligne de commande Stripe.

Une fois l’interface de ligne de commande de Stripe installée, exécutez stripe login dans la ligne de commande pour générer un code de jumelage afin d’y associer votre compte Stripe. Appuyez sur Entrée pour lancer votre navigateur et connectez-vous à votre compte Stripe afin d’autoriser l’accès. La clé API générée est valide pendant 90 jours. Vous pouvez modifier ou supprimer la clé à la section Clés API du Dashboard.

Test

stripe login
Your pairing code is: humour-nifty-finer-magic
Press Enter to open up the browser (^C to quit)

Si vous souhaitez utiliser une clé API existante, utilisez l’indicateur --api-key :

stripe login --api-key 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
Your pairing code is: humour-nifty-finer-magic
Press Enter to open up the browser (^C to quit)

Utilisez l’interface de ligne de commande pour transmettre des événements à votre point de terminaison de webhook local à l’aide de la commande listen.

Si votre application est exécutée sur le port 4242, exécutez :

stripe listen --forward-to http://localhost:4242/webhook

Dans un autre onglet du terminal, utilisez la commande d’interface de ligne de commande trigger pour déclencher un événement de webhook fictif.

stripe trigger payment_intent.succeeded

L’événement suivant apparaît dans l’onglet listen :

[200 POST] OK payment_intent.succeeded

“PaymentIntent was successful!” (Le PaymentIntent a réussi!) apparaît dans l’onglet du terminal que votre serveur exécute.

Pour mettre en production votre point de terminaison de webhook, vous devez procéder comme suit :

1. Utilisez vos clés d’API en mode production et non vos clés de test.

2. Configurez le point de terminaison de votre accroche web dans Workbench ou avec l’API.

To configure your endpoint in Workbench, go to the Webhooks tab.

Cliquez sur Ajouter une destination et entrez la version de l’API Stripe et les événements spécifiques que vous souhaitez que Stripe envoie. Cliquez sur Continuer et sélectionnez ¨Point de terminaison de l’accroche web dans la liste des types de destinations disponibles. Cliquez sur Continuer et entrez l’URL de votre point de terminaison, le nom optionnel et la description optionnelle. Cliquez sur Créer une destination.

Remplacez le secret du point de terminaison de l’accroche web dans votre application par le nouveau secret indiqué dans la vue détaillée de la destination dans Workbench pour votre point de terminaison.

Votre application est maintenant prête à accepter des événements en direct. Pour obtenir plus d’informations sur la configuration de votre point de terminaison de webhook, consultez l’API Webhook Endpoint. Pour les tests dans un bac à sable, consultez notre guide de développement.