Webhooks de Connect

Stripe utiliza webhooks para notificar a tu aplicación cuando hay algún evento en tu cuenta. Todas las integraciones de Connect deben establecer un punto de conexión de webhooks para escuchar los eventos de Connect.

Webhooks de Connect

Existen varios tipos de webhooks:

• Los webhooks Account son para actividades en tu propia cuenta (por ejemplo, la mayoría de las solicitudes hechas con tus claves API cuando no te autenticas como otra cuenta de Stripe). Esto incluye todo tipo de cargos, excepto los efectuados directamente en una cuenta conectada.
• Los webhooks Connect son para actividades en cualquier cuenta conectada. Todos los eventos de la cuenta conectada se envían a los webhooks de Connect. Esto incluye el importante evento account.updated para cualquier cuenta conectada y cargos directos.

Al crear tu webhook, asegúrate de que esté correctamente configurado para recibir eventos de webhooks de Connect. Para ello, puedes usar la API estableciendo el parámetro connect en true, al crear el punto de conexión de webhooks, o el Dashboard.

En el caso de los webhooks Connect, solo se envían webhooks de prueba a las URL del webhook de desarrollo, pero los webhooks tanto activos como de prueba se envían a las URL del webhook de producción. Esto se debe a que puedes realizar transacciones en vivo y de prueba en una aplicación de producción. Por esta razón, te recomendamos que verifiques el valor livemode al recibir un webhook de evento para saber qué acción, si la hay, deben tomar los usuarios.

Como indicamos en la referencia sobre el objeto Event, cada evento de una cuenta conectada contendrá también una propiedad account de nivel superior. Esta propiedad identifica la cuenta a la que se envía el webhook y el data[object] al que pertenece. Debido a que estos objetos pertenecen a otras cuentas, debes solicitar las API como la cuenta conectada correspondiente para acceder a ellos.

{
  "id": 
"{{EVENT_ID}}",
  "livemode": true,
  "object": "event",
  "type": "customer.created",
  "account": 
"{{CONNECTED_ACCOUNT_ID}}",
  "pending_webhooks": 2,
  "created": 1349654313,
  "data": {...}
}

Hay varios eventos relacionados con cuentas que Stripe te recomienda escuchar:

# Using Sinatra.
require 'sinatra'
require 'stripe'

set :port, 4242

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

# If you are testing your webhook locally with the Stripe CLI you
# can find the endpoint's secret by running `stripe listen`
# Otherwise, find your endpoint's secret in your webhook settings in
# the Developer Dashboard
endpoint_secret = 'whsec_...'

post '/webhook' do
  payload = request.body.read
  sig_header = request.env['HTTP_STRIPE_SIGNATURE']

  event = nil

  # Verify webhook signature and extract the event.
  # See https://stripe.com/docs/webhooks#verify-events for more information.
  begin
    event = Stripe::Webhook.construct_event(
      payload, sig_header, endpoint_secret
    )
  rescue JSON::ParserError => e
    # Invalid payload.
    status 400
    return
  rescue Stripe::SignatureVerificationError => e
    # Invalid Signature.
    status 400
    return
  end

  if event['type'] == 'account.application.deauthorized'
    application = event['data']['object']
    connected_account_id = event['account']
    handle_deauthorization(connected_account_id, application)
  end

  status 200
end

def handle_deauthorization(connected_account_id, application)
  # Clean up account state.
  puts 'Connected account ID: ' + connected_account_id
  puts application.to_s
end

Los eventos mencionados arriba son los que recomendamos que escuchen las integraciones de Connect, pero existen muchos otros tipos de eventos que te pueden interesar.

Probar webhooks a nivel local

Puedes probar webhooks a nivel local con la CLI de Stripe.

1. Si aún no lo has hecho, instala la CLI de Stripe en tu equipo.

2. Inicia sesión en tu cuenta Stripe y configura la CLI ejecutando stripe login en la línea de comandos.

3. Le permite a tu host local recibir un evento simulado en tu cuenta conectada ejecutando stripe listen --forward-to localhost:{PORT}/webhook en una ventana de terminal y stripe trigger {{EVENT_NAME}} en otra.