Stripe checkout：处理订阅付款失败

Question

假设用户的每月订阅已续订，此时将触发

'customer.subscription_updated'

事件。事实上，我将用户的订阅延长了一个月。不过，如果事件

'invoice.payment_failed'

在几天后发生，我会将数据库中名为

'subscriptionNotPaid'

的布尔值更新为

true

，并且订阅的权益在应用程序中被禁用。之后，我该如何再次激活它？什么事件应该表明现在可以安全地在应用程序中重新启用订阅的权益？

预先感谢您的帮助。

Answer 1

为了有效管理您的订阅系统，您需要处理指示客户付款状态的各种 Stripe 事件。这是一个清晰详细的方法：

了解 Stripe 事件 customer.subscription_updated：当客户的订阅更新（例如续订时）时，会触发此事件。此时，您通常会将用户的订阅延长一个月。

invoice. payment_failed：此事件表示付款尝试失败。发生这种情况时，您应该更新数据库以将订阅标记为未付费（subscriptionNotPaid 为 true）并在应用程序中禁用订阅的权益。

重新启用订阅权益 要在付款失败后重新启用订阅权益，您应该监听以下事件：

invoice. payment_succeeded：此事件表示发票（包括之前失败的发票）已成功支付。当您收到此事件时，您应该： 检查此事件是否对应于之前失败的发票。 如果是，请更新数据库以将订阅标记为已付费（subscriptionNotPaid 为 false）。 在您的应用程序中重新启用订阅权益。 详细步骤 处理invoice. payment_failed:

更新您的数据库以将 subscriptionNotPaid 设置为 true。 禁用应用程序中的订阅权益。 处理invoice. payment_succeeded:

验证付款是否针对之前失败的发票。 如果是，请更新数据库以将 subscriptionNotPaid 设置为 false。 在您的应用程序中重新启用订阅权益。 示例场景 想象一下，用户的订阅于 6 月 1 日续订，触发了 customer.subscription_updated 事件，并且您将他们的订阅延长了一个月。如果 6 月 3 日付款失败，则会触发发票. payment_failed 事件，并且您将订阅标记为未付款并禁用福利。随后，6月7日，重试付款并成功，触发invoice. payment_succeeded事件。然后，您检查此成功是否适用于之前失败的付款，将订阅状态更新为已付款，并重新启用福利。

总结 通过仔细处理这些 Stripe 事件，您可以确保您的应用准确反映用户订阅的付款状态，在付款失败时自动禁用福利，并在付款成功时重新启用福利。这为您的用户创造了无缝体验，并保持您的订阅系统稳健可靠。

如果您需要更详细的信息，Stripe 的官方文档提供了有关处理 webhooks 和事件的全面指导。