Cómo automatizar las actualizaciones del estado de los pedidos con Webhooks de Stripe

Webhooks de Stripe Es la realización de la verdaderaEscucha asíncrona del resultado del pago y cambio automático de estado. En este artículo se explica en profundidad cómo configurar los Webhooks de Stripe e implementar un mecanismo de actualización automática del estado de los pedidos en un proyecto real.

I. ¿Qué son los Webhooks de Stripe?

Los webhooks son Raya a tiservidor (ordenador)Un mecanismo para enviar notificaciones de eventos. Cuando se produce un evento, como un pago correcto, la finalización de un reembolso, un cambio de suscripción, etc., Stripe envía una solicitud POST a su URL preestablecida (el punto final Webhook) que contiene los detalles del evento.

¿Cuáles son las ventajas de utilizar Webhooks?

• notificación asíncronaEl estado del pedido puede consultarse sin que el usuario tenga que saltar o actualizar la página.
• actualización en tiempo realLos resultados de los pagos se comunican instantáneamente, lo que aumenta la confianza de los usuarios.
• estable y fiableStripe reintenta automáticamente los eventos webhook fallidos para asegurarse de que el mensaje llega.
• Flexibilidad de ampliaciónsoporta la escucha de docenas de tipos de eventos, tales como payment_intent.succeededycargo.reembolsadoyfactura.pago_fallido etc.

¿Cómo configurar Stripe Webhook endpoint?

Paso 1: Vaya a la página de configuración del Webhook

1. Abra el backend de Stripe:https://dashboard.stripe.com
2. Después de acceder a su cuentaCambiar al modo de prueba(Busque directamente en la barra de búsqueda. Gancho web Puede crearse rápidamente
3. También puede acceder a la página Webhook:
   👉 https://dashboard.stripe.com/test/workbench/webhooks

Paso 2: Crear un "flujo de asistente" para el Webhook

Selección del primer pasoescuchas (conversaciones telefónicas)El tipo de evento del

Eventos marcados recomendados:

formulario	Eventos destacados	instrucciones
PaymentIntent	payment_intent.succeeded	Éxito del pago (a menudo se utiliza para marcar un pedido como pagado)
PaymentIntent	payment_intent.payment_failed	Falta de pago

Una vez seleccionado, haga clic en el botón morado de la esquina inferior derecha de la página:
👉 proceder con

Paso 3: Configurar la información del punto final de Webhook

Paso 1: Seleccione el evento que desea escuchar (recomendado):

• ✅ payment_intent.succeeded(Pago efectuado)
• ✅ payment_intent.payment_failed(Pago fallido)

Paso 2: Seleccione el tipo de receptor

• Seleccione el punto final Webhook y pulse Continuar

Paso 4: Rellenar el receptor de configuración

En este paso verá un formulario que deberá rellenar:

campo	elemento
URL del punto final	Introduzca la dirección de recepción de su servidor, por ejemplohttps://yourdomain.com/webhook/stripe
Descripción (opcional)	Por ejemplo, "Listener de actualización del estado del pedido".

A continuación, haga clic en "Crear un destino" completa la configuración del Webhook.

III. Proceso de actualización automática del estado de los pedidos

1. El cliente envía el pedido y salta al pago

Adjuntar un ID de pedido al crear un PaymentIntent:

\Stripe\PaymentIntent::create([
    'amount' => 29900,
    'currency' => 'usd', 'metadata' => ['order_id' => 'ORDER12345' ]
    
]).

2. El cliente completa el pago y Stripe activa automáticamente el Webhook.

acontecimientos como payment_intent.succeeded Stripe enviará una solicitud a su punto final de webhook.

3. El backend analiza el evento y actualiza el estado del pedido.

poner en práctica 1TP4Evento->tipo Distinguir entre los eventos que invocan la lógica de actualización de pedidos del sistema (escrituras en la base de datos, registro, envío de notificaciones, etc.).

4. Notificación automática a los clientes

existe webhook Está bien en la lógica receptora:

• Enviar correo electrónico de pago correcto
• Notificaciones push
• Notificar al sistema de envío para preparar la logística

IV. Recomendaciones sobre seguridad y puesta en servicio

1. Verificar las firmas de Stripe

Se recomienda habilitar la verificación de la firma del webhook para garantizar que la fuente de datos es auténtica y fiable. Las firmas clave se pueden encontrar en el backend Webhook de Stripe página de configuraciónEncontrado en.

2. Recomendado para el desarrollo local stripe-cli

Utilice la herramienta de comandos para reenviar los eventos de Stripe al servidor local:

stripe listen --forward-to localhost:8000/webhook/stripe

Las simulaciones también se pueden utilizar para probar eventos específicos:

activador de stripe payment_intent.succeeded

V. Lista recomendada de eventos comúnmente admitidos

Tipo de evento	descripciones
payment_intent.succeeded	Pago correcto, a menudo utilizado para confirmar pedidos
payment_intent.payment_failed	Pago fallido, se puede utilizar para recordatorio de reintento
cargo.reembolsado	Reembolso completado, estado actualizado como reembolsado
checkout.session.completed	Pago con éxito (por ejemplo, con Stripe Checkout)
factura.pago_efectuado	Pago correcto de la factura de suscripción
factura.pago_fallido	Fallo en la renovación automática

Encontrará más tipos de eventos en la documentación oficial:
https://stripe.com/docs/api/events/types

VI. Resumen

Webhooks de StripeConstruir unEstable, eficiente, sin intervención humanaEl estado del pedido actualiza automáticamente el sistema. Ya se trate de un pago único, un servicio de suscripción o el procesamiento de reembolsos, Webhook ayuda a que el sistema responda en primer lugar y es un mecanismo básico de los sistemas de comercio electrónico modernos.

Contacte con nosotros
¿No puede leer el tutorial? Póngase en contacto con nosotros para obtener una respuesta gratuita. Ayuda gratuita para sitios personales y de pequeñas empresas	Servicio de atención al cliente WeChat
① Tel: 020-2206-9892
② QQ咨询：1025174874
(iii) Correo electrónico: info@361sale.com
④ Horario de trabajo: de lunes a viernes, de 9:30 a 18:30, días festivos libres