Cómo activar acciones con webhooks

Agrega un nuevo punto de conexión en tu aplicación. Puedes actuar sobre determinados eventos marcando el campo type del objeto Event enviado en el cuerpo de la solicitud. Luego, puedes imprimir la salida estándar para asegurarte de que el webhook esté funcionando.

Inicia tu servidor luego de agregar 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_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.

Después de que la CLI de Stripe esté instalada, ejecuta stripe login en la línea de comandos para generar un código de emparejamiento para vincularla a tu cuenta de Stripe. Presiona Intro para iniciar tu navegador e inicia sesión en tu cuenta de Stripe para permitir el acceso. La clave de API que se generó es válida por 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_BQokikJOvBiI2HlWgH4olfQ2
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 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 simulado.

stripe trigger payment_intent.succeeded

En la pestaña listen, aparece el siguiente evento:

[200 POST] OK payment_intent.succeeded

«¡El PaymentIntent se completó con éxito!» aparece en la pestaña del terminal que está ejecutando tu servidor.

Cuando esté todo listo para implementar tu punto de conexión de webhook en modo activo, debes hacer lo siguiente:

1. Usa tus claves de API en modo activo y no tus claves 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 Agregar 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 en directo. Para obtener más información sobre cómo configurar el punto de conexión del webhook, consulta la API Webhook Endpoint. Para realizar pruebas en un entorno de prueba, consulta nuestra guía de desarrollo.