Cómo enviar correos electrónicos de fallo de pago

Tiempo de lectura: 4 minutos | Dificultad: Principiante

Resumen

WP Simple Pay puede enviar dos correos electrónicos cuando Stripe informa de un pago fallido:

• Notificación de fallo de pago va para ti, el administrador del sitio. Está activada por defecto.
• Confirmación de fallo de pago va para el cliente. Le informa que el pago no pudo ser procesado, le da el motivo y le pide que revise sus datos e intente de nuevo. Está desactivada por defecto, así que tú decides si los clientes la reciben.

Ambos correos electrónicos se envían para pagos únicos fallidos y para renovaciones de suscripción fallidas. Una tarjeta rechazada, una tarjeta caducada registrada o una renovación que se agota de reintentos ya no pasan desapercibidos hasta que revisas Stripe.

Prerrequisitos

• WP Simple Pay Pro (cualquier licencia de pago).
• Webhooks configurados para tu cuenta de Stripe. Ambos correos electrónicos se envían cuando Stripe entrega un evento charge.failed a tu sitio. Consulta Webhooks.
• Un formulario de pago creado con WP Simple Pay. Los cargos fallidos que no provienen de un formulario de WP Simple Pay no envían estos correos electrónicos.

Paso 1: Configurar la notificación de administrador

1. Ve a WP Simple Pay → Ajustes → Correos.
2. En el menú desplegable Seleccionar un correo electrónico para configurar…, elige Notificación de fallo de pago y haz clic en Configurar.
3. Deja marcada la opción Enviar un correo electrónico de notificación al administrador del sitio cuando un pago falle.
4. En Enviar a, introduce la dirección que debe recibir la alerta. Por defecto es el correo electrónico del administrador del sitio. Separa varias direcciones con comas.
5. Edita el Asunto y el Mensaje si lo deseas, luego haz clic en Guardar cambios.

El asunto por defecto es Pago fallido en {nombre del sitio}. El mensaje por defecto incluye la dirección de correo electrónico del cliente, el importe, el título del formulario, el motivo del fallo y el código del fallo.

Paso 2: Activar la confirmación del cliente (Opcional)

1. Ve a WP Simple Pay → Ajustes → Correos.
2. Elige Confirmación de fallo de pago y haz clic en Configurar.
3. Marca Enviar un correo electrónico de confirmación al cliente cuando un pago falle.
4. Edita el Asunto y el Mensaje si lo deseas, luego haz clic en Guardar cambios.

El correo electrónico siempre se envía a la dirección de correo electrónico del cliente, por lo que el campo Enviar a no se puede cambiar. El asunto por defecto es No se pudo procesar tu pago.

Etiquetas inteligentes de fallo

Ambos correos electrónicos admiten las etiquetas inteligentes habituales, como {customer-email}, {total-amount} y {form-title}, además de dos que describen el fallo:

Etiqueta inteligente	Ejemplo	Descripción
{failure-reason}	Tu tarjeta fue rechazada.	Por qué falló el pago.
{failure-code}	tarjeta_rechazada	El código de fallo de Stripe.

En el correo electrónico del cliente, {failure-reason} solo muestra el mensaje destinado a los clientes. Nunca muestra las notas internas de Stripe para el comerciante. Si Stripe no proporciona una razón, el correo electrónico del cliente dice "Su pago no pudo ser procesado." y el correo electrónico del administrador dice "Desconocido".

Límites de envío

Para evitar que un ataque de prueba de tarjetas inunde tu bandeja de entrada, o que se utilice tu sitio para enviar correos electrónicos a extraños, cada correo electrónico se envía como máximo 10 veces por formulario por hora. Los fallos que superan ese límite todavía se registran en Stripe, pero no se envía ningún correo electrónico hasta que haya pasado la hora.

Los desarrolladores pueden cambiar el límite y la ventana de tiempo con estos filtros:

• simpay_payment_failure_notification_email_rate_limit y simpay_payment_failure_confirmation_email_rate_limit establecen el número de correos electrónicos (por defecto 10, 0 desactiva el límite).
• simpay_payment_failure_notification_email_rate_limit_window y simpay_payment_failure_confirmation_email_rate_limit_window establecen la ventana en segundos (por defecto una hora).

Cada filtro recibe el valor actual y el ID del formulario de pago. Consulta Añadir código personalizado para saber cómo añadir un filtro de forma segura.

// Allow up to 25 admin failure notifications per form per hour.
add_filter( 'simpay_payment_failure_notification_email_rate_limit', function() {
	return 25;
} );

Preguntas frecuentes

¿Recibirá el cliente un correo electrónico cuando su tarjeta sea rechazada en el formulario de pago?

Sí, si activas la Confirmación de Fallo de Pago. Stripe informa de cada cargo fallido, incluido un rechazo que el cliente ve en el formulario de inmediato. Si solo quieres que los clientes reciban información sobre fallos que ocurren cuando no están en la página, como las renovaciones de suscripción, deja desactivado el correo electrónico al cliente y gestiona las renovaciones con los propios correos electrónicos de pago fallido de Stripe.

¿Por qué no he recibido un correo electrónico de fallo?

Comprueba que los webhooks estén configurados y que Stripe muestre el evento charge.failed como entregado a tu sitio. Luego, comprueba que el formulario no haya alcanzado el límite de 10 correos electrónicos por hora. Si ninguna de las dos opciones se aplica, consulta No se envían correos electrónicos de recibo y/o notificación.

¿Están estos correos electrónicos disponibles en WP Simple Pay Lite?

No. Los correos electrónicos de fallo de pago forman parte de WP Simple Pay Pro y están disponibles en todas las licencias de pago.

¿Qué Sigue?

• Referencia de tipos de correo electrónico – Todos los correos electrónicos que WP Simple Pay puede enviar
• Uso de etiquetas inteligentes para páginas de confirmación y correos electrónicos – Todas las etiquetas inteligentes disponibles
• Webhooks – Asegúrate de que Stripe pueda acceder a tu sitio