Ir a contenido
Crea una cuenta
o
inicia sesión
Logotipo de la documentación de Stripe
/
Pregúntale a la IA
Crear cuenta
Iniciar sesión
Empezar
Pagos
Automatización de finanzas
Plataformas y marketplaces
Gestión del dinero
Herramientas para desarrolladores
Empezar
Pagos
Automatización de finanzas
Empezar
Pagos
Automatización de finanzas
Plataformas y marketplaces
Gestión del dinero
Resumen
Acerca de Stripe Payments
    Resumen
    Divisas
    Pagos rechazados
    Transferencias
    Pagos recurrentes
    Autenticación mediante 3D Secure
    Reembolsar y cancelar pagos
    Saldos y plazos de liquidación
    Recibos
    Administra eventos de webhook
    Preparación para la SCA
Actualiza tu integración
Análisis de pagos
Pagos por Internet
ResumenEncuentra tu caso de usoManaged Payments
Utiliza Payment Links
Crear una página del proceso de compra
Desarrolla una integración avanzada
Desarrolla una integración en la aplicación
Métodos de pago
Añadir métodos de pago
Gestiona los métodos de pago
Proceso de compra más rápido con Link
Interfaces de pago
Payment Links
Checkout
Elements para la web
Elements en la aplicación
Escenarios de pago
Flujos de pagos personalizados
Capacidad adquirente flexible
Orquestación
Pagos en persona
Terminal
Otros productos de Stripe
Financial Connections
Criptomonedas
Climate
InicioPagosAbout Stripe payments

Cómo activar acciones con webhooks

Cómo utilizar webhooks para responder a eventos de pago fuera de línea

Copia la página

Un webhook es un punto de conexión HTTP que recibe eventos desde Stripe.

Los webhooks te permiten recibir notificaciones sobre eventos de pago que suceden fuera de tu flujo de pago, por ejemplo:

  • Pagos realizados correctamente (payment_intent.succeeded)
  • Pagos en disputa (charge.dispute.created)
  • Saldo disponible en tu cuenta de Stripe (balance.available)

Puedes utilizar el Dashboard para acciones puntuales como reembolsar un pago o actualizar la información de un cliente, mientras que los webhooks te ayudan a escalar tu integración de pagos y procesar grandes volúmenes de eventos críticos para la empresa.

Crear tu propio webhook

Puedes crear un controlador de webhooks en tu propio servidor para gestionar todos los flujos de pagos fuera de línea. Comienza por presentar un punto de conexión que pueda recibir solicitudes de Stripe y que utilice la CLI para probar de manera local tu integración. Cada solicitud de Stripe contiene un objeto Event con una referencia al objeto de Stripe que se modificó.

Crear un punto de conexión de 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.

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

Instala y configura la CLI de Stripe

Command Line
homebrew
# 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.

Nota

Puedes crear una configuración específica del proyecto incluyendo la bandera -project-name cuando inicies sesión y cuando ejecutes comandos para ese proyecto.

Prueba

Command Line
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:

Command Line
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)

Prueba tu webhook de manera local

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:

Command Line
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.

Command Line
stripe trigger payment_intent.succeeded

El siguiente evento aparece en tu pestaña listen:

Command Line
[200 POST] OK payment_intent.succeeded

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

OpcionalComprueba la firma del webhook

Implementa tu punto de conexión de webhooks

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 del modo activo, no las 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 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 hacer pruebas en un entorno de prueba, consulta nuestra guía de desarrollo.

¿Te ha sido útil la página?
SíNo
¿Necesitas ayuda? Ponte en contacto con el equipo de soporte.
Únete a nuestro programa de acceso anticipado.
Echa un vistazo a nuestro registro de cambios.
¿Tienes alguna pregunta? Ponte en contacto con el equipo de ventas.
¿LLM? Lee llms.txt.
Con tecnología de Markdoc