Ir a contenido
Crea una cuenta
 o
inicia sesión
Logotipo de la documentación de Stripe
/
Crear cuenta
Iniciar sesión
ResumenActualiza tu integración
Pagos por Internet
ResumenEncuentra tu caso de usoManaged Payments
Métodos de pago
Interfaces de pago
Escenarios de pago
Pagos en persona
Más allá de los pagos

Cómo activar acciones con webhooks

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

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
Python
PHP
Java
Node.js
Go
.NET
No results
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
const stripe = require('stripe')(
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'
);

// This example uses Express to receive webhooks
const app = require('express')();

// Use body-parser to retrieve the raw body as a buffer
const bodyParser = require('body-parser');

// Match the raw body to content type application/json
app.post('/webhook', bodyParser.raw({type: 'application/json'}), (request, response) => {
  const event = request.body;

  // Handle the event
  switch (event.type) {
    case 'payment_intent.succeeded':
      const paymentIntent = event.data.object;
      console.log('PaymentIntent was successful!');
      break;
    case 'payment_method.attached':
      const paymentMethod = event.data.object;
      console.log('PaymentMethod was attached to a Customer!');
      break;
    // ... handle other event types
    default:
      console.log(`Unhandled event type ${event.type}`);
  }

  // Return a 200 response to acknowledge receipt of the event
  response.json({received: true});
});

app.listen(4242, () => console.log('Running on port 4242'));

Instala y configura la CLI de Stripe

Command Line
homebrew
Instalar desde el origen
No results
# Install Homebrew to run this command: https://brew.sh/
brew install stripe/stripe-cli/stripe

# Connect the CLI to your dashboard
stripe login

Para obtener más opciones de instalación, consulta Empezar con la CLI de Stripe.

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.

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 webhook en Workbench o con la API.

Para configurar tu punto de conexión en Workbench, ve a la pestaña Webhooks.

Haz clic en Añadir destino e introduce la versión de la API Stripe y los eventos específicos que quieres que Stripe envíe. Haz clic en Continuar y selecciona Punto de conexión de webhook de la lista de tipos de destino disponibles. Haz clic en Continuar e introduce la URL de tu punto de conexión, nombre opcional y descripción opcional. Haz clic en Crear destino.

Reemplaza la clave secreta del punto de conexión de webhook en tu aplicación por la nueva clave secreta que se muestra en la vista de detalles de destino en Workbench para 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