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.

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:

• charge.failed
• cargo.reembolsado
• charge.succeeded
• checkout.session.completed
• invoice.payment_succeeded
• invoice.upcoming
• payment_intent.processing
• payment_intent.succeeded
• customer.subscription.deleted
• customer.subscription.updated

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.

pago_intento.exitoso

• 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

cargo.exitoso

• 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.

charge.failed

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