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
Stripe.api_key = 
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'

require 'stripe'
require 'sinatra'
require 'json'

# Using the Sinatra framework
set :port, 4242

post '/webhook' do
  payload = request.body.read
  event = nil

  begin
    event = Stripe::Event.construct_from(
      JSON.parse(payload, symbolize_names: true)
    )
  rescue JSON::ParserError => e
    # Invalid payload
    status 400
    return
  end

  # Handle the event
  case event.type
  when 'payment_intent.succeeded'
    payment_intent = event.data.object # contains a Stripe::PaymentIntent
    puts 'PaymentIntent was successful!'
  when 'payment_method.attached'
    payment_method = event.data.object # contains a Stripe::PaymentMethod
    puts 'PaymentMethod was attached to a Customer!'
  # ... handle other event types
  else
    puts "Unhandled event type: #{event.type}"
  end

  status 200
end

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

# Connect the CLI to your dashboard
stripe login

For additional install options, see Get started with the Stripe CLI.

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 votre point de terminaison de webhook dans le Dashboard Stripe ou avec l’API.

Pour configurer votre point de terminaison dans le Dashboard, accédez aux paramètres des webhooks.

Cliquez sur Ajouter un point de terminaison et saisissez l’URL de votre point de terminaison, la version de l’API Stripe et les événements spécifiques que vous souhaitez que Stripe envoie.

Remplacez la clé secrète du point de terminaison de webhook de votre application par la nouvelle clé secrète figurant dans la vue du Dashboard de 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.