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

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_BQokikJOvBiI2HlWgH4olfQ2
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 as chaves de API do modo de produção e não as chaves 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 já está pronto para aceitar eventos no modo de produção. Para obter mais informações sobre como configurar seu endpoint de webhook, consulte a API Webhook Endpoint. Para testes em uma área restrita, consulte o Guia de desenvolvimento.