Avviare operazioni con l'ausilio dei webhook

Aggiungi un nuovo endpoint alla tua applicazione. Per rispondere a determinati eventi, verifica il campo type dell’oggetto dell’evento inviato nel corpo della richiesta. Quindi scegli l’output standard per assicurarti che il webhook funzioni.

Avvia il tuo server dopo aver aggiunto il nuovo endpoint.

# 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.

Una volta installata la CLI di Stripe, esegui stripe login nella riga di comando per generare un codice di associazione da collegare al tuo account Stripe. Premi Invio per avviare il browser e accedere al tuo account Stripe per consentire l’accesso. La chiave API generata è valida 90 giorni. Puoi modificarla o eliminarla nella sezione Chiavi API nella Dashboard.

di prova

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

Se vuoi utilizzare una chiave API esistente, utilizza il flag --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)

Utilizza la CLI per inoltrare gli eventi al tuo endpoint del webhook locale utilizzando il comando listen.

Se la tua applicazione viene eseguita sulla porta 4242, esegui il seguente comando:

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

In un’altra scheda del terminale, utilizza il comando trigger della CLI per attivare un evento webhook fittizio.

stripe trigger payment_intent.succeeded

Il seguente evento appare nella scheda listen:

[200 POST] OK payment_intent.succeeded

“Il PaymentIntent è andato a buon fine” viene visualizzato nella scheda del terminale del tuo server.

Quando avrai la possibilità di distribuire l’endpoint del webhook nell’ambiente di produzione, dovrai procedere come segue:

1. Utilizza le tue chiavi API in modalità live e non quelle di test.

2. Configura l’endpoint weebhook nella Dashboard Stripe o con l’API.

Per configurare l’endpoint nella Dashboard, accedi alle impostazioni del webhook.

Fai clic su Aggiungi endpoint e inserisci l’URL dell’endpoint, la versione dell’API Stripe e gli eventi specifici che vuoi che Stripe ti invii.

Sostituisci la chiave privata dell’endpoint del webhook nella tua applicazione con la nuova chiave privata mostrata nella vista Dashboard del tuo endpoint.

La tua applicazione è pronta per accettare gli eventi in modalità live. Per ulteriori informazioni sulla configurazione dell’endpoint del webhook, consulta la sezione sull’API Webhook Endpoint. Per i test in una sandbox, consulta la nostra Guida allo sviluppo.