Ativar ações com webhooks

Adicione um novo endpoint no aplicativo. É possível agir em determinados eventos verificando o campo type do objeto de evento enviado no corpo da solicitação. Em seguida, você pode imprimir na saída padrão para confirmar o funcionamento do webhook.

Inicie o servidor após adicionar o novo 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_4eC39HqLyjWDarjtT1zdp7dc'

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.

Depois de instalar a CLI da Stripe, execute stripe login na linha de comando para gerar um código de emparelhamento para vincular à sua conta Stripe. Pressione Enter para iniciar o navegador e faça login na sua conta Stripe para permitir o acesso. A chave de API gerada é válida por 90 dias, podendo ser modificada ou excluída em Chaves de API no Dashboard.

Teste

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

Se quiser usar uma chave de API existente, use o sinalizador --api-key:

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

Use a CLI para encaminhar eventos ao endpoint do webhook local usando o comando listen.

Supondo que o aplicativo está usando a porta 4242, execute:

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

Em uma guia de terminal diferente, use o comando da CLI trigger para acionar um evento de webhook simulado.

stripe trigger payment_intent.succeeded

O seguinte evento aparece na sua guia listen:

[200 POST] OK payment_intent.succeeded

“O PaymentIntent foi bem-sucedido” aparece na guia do terminal em que o servidor está executando.

Quando estiver pronto para implantar o endpoint do webhook em produção, você precisa fazer o seguinte:

1. Use suas chaves de API do modo de produção, e não as do modo de teste.

2. Configure o endpoint do webhook no Stripe Dashboard ou usando a API.

Para configurar o endpoint no Dashboard, acesse as configurações do webhook.

Clique em Adicionar endpoint e informe o URL do endpoint, a versão da API da Stripe e os eventos específicos que você quer receber da Stripe.

Substitua o segredo do endpoint do webhook no aplicativo com o novo segredo mostrado na visualização do endpoint no Dashboard.

Seu aplicativo está pronto para aceitar eventos de produção. Para obter mais informações sobre a configuração do seu endpoint de webhook, consulte a API Webhook Endpoint. Para testar no modo de teste, consulte o Guia de desenvolvimento.