如何配置高级 Stripe Webhook 设置

本文档包含大多数网站不需要的高级设置选项。
_{请参阅我们的 标准 Webhook 文档以了解基本设置。}

Webhook 使 Stripe 能够将消息发送回您的 WordPress 网站。WP Simple Pay 的某些功能需要设置 Webhook，例如发送电子邮件、创建分期付款计划、允许客户更新其订阅付款详细信息以及使用其与AffiliateWP的集成。

添加 Webhook 端点

要添加相应的 Webhook 终结点，请在您的 Stripe Dashboard 中转到开发人员 → Webhooks。

点击 添加终结点，然后添加在WP Simple Pay → 设置 → Stripe → Webhooks 中找到的 URL。

现在您需要通过点击标记为+选择事件的按钮来添加要监听的特定事件。完成此操作后，您可以将下面列出的每个事件复制并粘贴到 选择要发送的事件 → 搜索事件 搜索框中。

搜索每个术语后，点击复选框将其添加，然后搜索其他术语。在选中下面列出的所有事件之前，请勿点击添加事件：

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

本文档底部显示了有关这些事件各自功能的详细信息。

完成添加事件后，点击 添加终结点 以完成此过程。添加终结点后，您应该会在 Webhook 设置中看到新列出的 URL。

配置 Webhook 签名密钥

Stripe 可以对其发送到您端点的 webhook 事件进行签名，以增强安全性，我们强烈建议您进行设置。

为此，请从您的 仪表板的 Webhook 设置中检索您端点的密钥。选择您要获取密钥的端点，然后单击“显示” 按钮。

然后从 Stripe 仪表板复制签名密钥，返回到您 WP 管理员中的“Stripe 设置”选项卡，然后将其粘贴到当前付款模式的“端点密钥”文本框中。

您的 Webhook 现已设置并安全。

目前，WP Simple Pay 使用以下事件：

事件类型说明

invoice.payment_succeeded

• 用于增加分期付款计划并为订阅发送“付款确认”和“付款通知” 电子邮件。
• 公开 simpay_webhook_subscription_created 操作，以便在成功订阅后进行进一步处理。

payment_intent.succeeded

• 为一次性付款发送“付款确认”和“付款通知” 电子邮件。
• 公开 simpay_webhook_payment_intent_succeeded 操作，以便在成功付款后进行进一步处理。

charge.succeeded

• 为使用 ACH 直接付款的一次性付款发送“付款确认”和“付款通知” 电子邮件。
• 公开 simpay_webhook_charge_succeeded 操作，以便在成功付款后进行进一步处理。

invoice.upcoming

• 发送“即将到来的发票” 电子邮件提醒以更新付款方式。 了解更多

checkout.session.completed

• 用于删除生成的已放弃的 Stripe Checkout 记录。
• 公开 simpay_webhook_checkout_session_completed 操作，以便在需要时进行进一步处理。

plan.updated

• 用于确保在配置订阅选项时订阅计划列表是最新的。

charge.failed

• 公开 simpay_webhook_charge_failed 操作，以便在付款失败后进行进一步处理。