Cómo activar acciones con webhooks

Añade un nuevo punto de conexión en tu aplicación. Puedes actuar sobre determinados eventos corroborando el campo type del objeto Event enviado en el cuerpo de la solicitud. Después, podrás usar la salida estándar para asegurarte de que tu webhook funciona.

Inicia tu servidor tras añadir el nuevo punto de conexión.

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

Después de que hayas instalado la CLI de Stripe, ejecuta stripe login en la línea de comandos para generar un código de emparejamiento para vincularla a tu cuenta de Stripe. Pulsa Intro para iniciar tu navegador e inicia sesión en tu cuenta de Stripe para permitir el acceso. La clave de API que se genera es válida durante 90 días. Puedes modificarla o eliminarla desde Claves de API en el Dashboard.

Prueba

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

Si quieres utilizar una clave de API existente, utiliza la marca --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)

Utiliza la CLI para reenviar eventos a tu punto de conexión de webhooks local con el comando listen.

Si asumimos que tu aplicación está funcionando en un puerto 4242, ejecuta:

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

En otra pestaña del terminal, utiliza el comando trigger de la CLI para activar un evento de webhook ficticio.

stripe trigger payment_intent.succeeded

El siguiente evento aparece en tu pestaña listen:

[200 POST] OK payment_intent.succeeded

“¡PaymentIntent se completó correctamente!” aparece en la pestaña del terminal que está ejecutando tu servidor.

Cuando tengas todo listo para implementar tu punto de conexión de webhook en modo activo, deberás hacer lo siguiente:

1. Utiliza las claves de API para modo activo, no las claves para modo de prueba.

2. Configura tu punto de conexión de webhooks en el Dashboard de Stripe o con la API.

Para configurar tu punto de conexión en el Dashboard, ve a la configuración de webhooks.

Haz clic en Añadir un punto de conexión e introduce la dirección URL de tu punto de conexión, la versión de la API de Stripe y los eventos específicos que quieres que Stripe envíe.

Reemplaza la clave secreta del punto de conexión de webhooks en tu aplicación con la nueva clave secreta presentada en la vista del Dashboard de tu punto de conexión.

Tu aplicación ya está lista para aceptar eventos activos. Para obtener más información sobre cómo configurar tu punto de conexión de webhooks, consulta la API Webhook Endpoint. Para realizar pruebas en modo de prueba, consulta nuestra guía de desarrollo.