如何发送付款失败电子邮件

阅读时间： 4 分钟 | 难度： 初学者

概述

当 Stripe 报告付款失败时，WP Simple Pay 可以发送两封电子邮件：

• 付款失败通知 发送给您，即网站管理员。默认开启。
• 付款失败确认 发送给客户。告知他们付款未能处理的原因，并请他们检查详细信息后重试。默认关闭，由您决定是否发送给客户。

这两封电子邮件都会在一次性付款失败和订阅续订失败时发送。卡片被拒、已存档卡片过期或续订重试次数耗尽的情况，将不再被忽视，直到您检查 Stripe。

先决条件

• WP Simple Pay Pro（任何付费许可证）。
• 为您的 Stripe 账户设置了 Webhook。当 Stripe 向您的网站传递 charge.failed 事件时，会发送这两封电子邮件。请参阅 Webhook。
• 使用 WP Simple Pay 创建的付款表单。非 WP Simple Pay 表单产生的失败交易不会发送这些电子邮件。

步骤 1：配置管理员通知

1. 转到 WP Simple Pay → 设置 → 电子邮件。
2. 在选择要配置的电子邮件…下拉菜单中，选择付款失败通知，然后点击配置。
3. 勾选当付款失败时向网站管理员发送通知电子邮件。
4. 在发送至中，输入应接收警报的地址。默认为网站管理员邮箱。多个地址请用逗号分隔。
5. 如需更改，请编辑主题和消息，然后点击保存更改。

默认主题是{site name} 付款失败。默认消息包含客户的电子邮件地址、金额、表单标题、失败原因和失败代码。

步骤 2：开启客户确认（可选）

1. 转到 WP Simple Pay → 设置 → 电子邮件。
2. 选择付款失败确认，然后点击配置。
3. 勾选当付款失败时向客户发送确认电子邮件。
4. 如需更改，请编辑主题和消息，然后点击保存更改。

电子邮件始终发送到客户的电子邮件地址，因此无法更改发送至字段。默认主题是您的付款未能处理。

失败智能标签

两封电子邮件都支持常用的 智能标签，例如 {customer-email}、{total-amount} 和 {form-title}，外加两个描述失败情况的标签：

智能标签	示例	描述
{failure-reason}	您的卡已被拒绝。	付款失败的原因。
{failure-code}	card_declined	Stripe 失败代码。

在客户电子邮件中，{failure-reason} 仅显示面向客户的消息。它从不显示 Stripe 为商家提供的内部注释。如果 Stripe 未提供原因，客户电子邮件将显示“您的付款未能处理。”，管理员电子邮件将显示“未知”。

发送限制

为防止卡测试攻击淹没您的收件箱，或阻止他人利用您的网站向陌生人发送电子邮件，每封电子邮件每表单每小时最多发送 10 次。超出此限制的失败仍会在 Stripe 中记录，但直到一小时过去后才发送电子邮件。

开发人员可以使用以下过滤器更改限制和时间窗口：

• simpay_payment_failure_notification_email_rate_limit 和 simpay_payment_failure_confirmation_email_rate_limit 设置电子邮件数量（默认为 10，0 表示关闭限制）。
• simpay_payment_failure_notification_email_rate_limit_window 和 simpay_payment_failure_confirmation_email_rate_limit_window 设置窗口（以秒为单位，默认为一小时）。

每个过滤器都会收到当前值和付款表单 ID。有关如何安全地添加过滤器的信息，请参阅 添加自定义代码。

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

常见问题解答

当客户在付款表单上刷卡被拒时，他们会收到电子邮件吗？

是的，如果您开启了付款失败确认。Stripe 会报告每一次失败的收费，包括客户在表单上立即看到的拒付。如果您只想让客户知道在他们不在页面上时发生的失败（例如订阅续订），请关闭客户电子邮件，并使用 Stripe 自带的 失败付款电子邮件 来处理续订。

为什么我没有收到失败电子邮件？

检查是否已设置 webhook，以及 Stripe 是否显示 charge.failed 事件已成功发送到您的网站。然后检查表单是否已达到每小时 10 封电子邮件的限制。如果两者都不适用，请参阅 未发送电子邮件收据和/或通知。

WP Simple Pay Lite 是否提供这些电子邮件？

否。付款失败电子邮件是 WP Simple Pay Pro 的一部分，所有付费许可证均可使用。

下一步是什么？

• 电子邮件类型参考 – WP Simple Pay 可以发送的所有电子邮件
• 使用智能标签进行确认页面和电子邮件 – 所有可用的智能标签
• Webhook – 确保 Stripe 可以访问您的网站