Cómo configurar una configuración avanzada de webhook de Stripe

Este documento contiene opciones de configuración avanzadas que no son necesarias para la mayoría de los sitios.
Consulte nuestra documentación de webhooks estándar para la configuración básica.

Los webhooks permiten a Stripe enviar mensajes a su sitio de WordPress. La configuración de webhooks es necesaria para algunas funcionalidades de WP Simple Pay, como el envío de correos electrónicos, la creación de planes de pago a plazos, permitir a los clientes actualizar los detalles de pago de su suscripción y el uso de su integración con AffiliateWP.

Si se omite un Webhook

Un webhook que nunca llega ya no es permanente. Una vez a la hora, WP Simple Pay comprueba en Stripe los registros que pueda haberse omitido y los pone al día: pagos completados mientras el cliente nunca regresó a tu sitio, pagos que tuvieron éxito o se cancelaron más tarde, y reembolsos o retrocesos de cargo aplicados directamente desde el Panel de control de Stripe. Un pago que solía aparecer como marcador de posición pendiente se resuelve por sí solo.

Aún así deberías configurar los webhooks correctamente, ya que la comprobación horaria se ejecuta después de los hechos y cualquier cosa que dependa de una respuesta inmediata (correos electrónicos, planes de pago a plazos) necesita el evento en vivo. Pero no tienes que buscar un solo evento perdido a mano. Puedes confirmar el resultado en Formularios de pago > Transacciones; consulta Cómo usar la página de transacciones.

Añadir el endpoint del webhook

Para añadir los endpoints de webhook apropiados, en tu Panel de Stripe, ve a Desarrolladores → Webhooks.

Haz clic en Añadir endpoint, luego añade la URL que se encuentra en WP Simple Pay → Ajustes → Stripe → Webhooks.

Ahora necesitarás añadir los eventos específicos a los que escuchar haciendo clic en el botón etiquetado como +Seleccionar eventos. Después de hacerlo, puedes copiar y pegar cada evento listado a continuación en el cuadro de búsqueda Seleccionar eventos a enviar → Buscar eventos .

Después de buscar cada término, haz clic en la casilla de verificación para añadirlo y buscar términos adicionales. No hagas clic en Añadir eventos hasta que hayas marcado todos los eventos listados a continuación:

• **cargo.fallido**
• cargo.reembolsado
• charge.succeeded
• checkout.session.completed
• invoice.payment_succeeded
• invoice.upcoming
• payment_intent.processing
• payment_intent.succeeded
• customer.subscription.deleted
• customer.subscription.updated
• charge.dispute.created
• charge.dispute.closed

Los detalles sobre la funcionalidad de cada uno de estos eventos se muestran al final de este documento.

Cuando hayas terminado de añadir eventos, haz clic en Añadir endpoint para completar el proceso. Después de añadir el endpoint, deberías ver la nueva URL listada en la configuración de webhooks.

Configuración del secreto de firma de webhooks

Stripe puede firmar los eventos de webhook que envía a sus endpoints para mayor seguridad, y recomendamos encarecidamente que configure esto.

Para ello, obtenga el secreto de su endpoint de la configuración de webhooks de su Dashboard. Seleccione un endpoint para el que desee obtener el secreto y, a continuación, haga clic en el botón Revelar.

A continuación, copie el secreto de firma del Panel de control de Stripe, vuelva a la pestaña Configuración de Stripe de su administrador de WP y péguelo en el cuadro de texto Secreto del endpoint para el modo de pago actual.

Sus webhooks ya están configurados y son seguros.

Actualmente, WP Simple Pay utiliza los siguientes eventos:

Descripciones de tipos de eventos

invoice.payment_succeeded

• Se utiliza para incrementar los planes de pago a plazos y enviar correos electrónicos de “Confirmación de pago” y “Notificación de pago” correos electrónicos para Suscripciones.
• Expone la acción simpay_webhook_subscription_created para su procesamiento posterior tras una Suscripción correcta.

**payment_intent.succeeded
**

• Envía los correos electrónicos de “Confirmación de pago” y “Notificación de pago” correos electrónicos para pagos únicos.
• Expone la acción simpay_webhook_payment_intent_succeeded para su procesamiento posterior tras un pago correcto

**charge.succeeded
**

• Envía los correos electrónicos de “Confirmación de pago” y “Notificación de pago” correos electrónicos para pagos únicos utilizando Débito ACH.
• Expone la acción simpay_webhook_charge_succeeded para su procesamiento posterior tras un pago correcto

invoice.upcoming

• Envía el recordatorio de correo electrónico de “Próxima factura” correo electrónico para actualizar un método de pago. Más información

checkout.session.completed

• Se utiliza para eliminar registros generados de Stripe Checkout abandonados.
• Expone la acción simpay_webhook_checkout_session_completed para su procesamiento posterior si es necesario.

plan.actualizado

• Se utiliza para garantizar que la lista de Planes de Suscripción esté actualizada al configurar las Opciones de Suscripción.

**cargo.fallido**

• Expone la acción simpay_webhook_charge_failed para su procesamiento posterior tras un fallo en el Cargo.

charge.dispute.created

• Marca el pago correspondiente como disputado mientras el retroceso de cargo esté vigente, de modo que aparezca en la vista Disputados de la página de Transacciones. Requiere WP Simple Pay Pro.
• Expone la acción simpay_webhook_charge_dispute_created para su procesamiento posterior cuando se abre un retroceso de cargo.

charge.dispute.closed

• Restaura el estado anterior del pago cuando la disputa se cierra a tu favor, ya sea porque se ganó, se cerró como consulta o fue evitada por Stripe. Un pago que fue reembolsado parcialmente vuelve a estar parcialmente reembolsado en lugar de simplemente completado. Una disputa perdida permanece disputada, ya que los fondos realmente han sido retirados. Requiere WP Simple Pay Pro.
• Expone la acción simpay_webhook_charge_dispute_closed para su procesamiento posterior cuando se cierra un retroceso de cargo.