Déclencher des actions avec les webhooks

Ajoutez un nouvel endpoint à 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 nouvel endpoint, 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

Pour davantage d’options d’installation, consultez la page consacrée à l’interface de ligne de commande Stripe.

Une fois l’interface de ligne de commande 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 (CLI) pour transmettre des événements à votre endpoint 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 trigger de la CLI 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 endpoint de webhook, vous devez procéder comme suit :

1. Utilisez vos clés API de production et non pas vos clés de test.

2. Configurez votre endpoint de webhook dans le Dashboard Stripe ou avec l’API.

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

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

Remplacez la clé secrète du endpoint de webhook de votre application par la nouvelle clé secrète figurant dans la vue du Dashboard de votre endpoint.

Votre application peut désormais accepter des événements en mode production. Pour plus d’informations sur la configuration de votre endpoint de webhook, consultez l’API Webhook Endpoint. Pour effectuer des tests dans un environnement de test, consultez notre guide de développement.