使用 Stripe Webhooks 更新数据库内的订阅状态

Question

我正在将 Stripe 支付网关与 ASP.NET Core 3.1 中基于订阅的产品网站集成。

我在 SQL Server 数据库中有一个Subscription 表。它有expiration_date (datetime) 和is_active (bit) 列。

当用户以经常性价格（每月）订阅产品时，我在 expiration_date 列中添加当前日期 + 1 个月。我还在is_active 列中插入1 以指示订阅处于活动状态。

订阅的第一个月过去后，我希望此订阅的is_active 标志的值在数据库中变为0。一旦用户支付了下个月的费用，Current Period 将在条带订阅中更新，is_active 标志的值将再次变为1。

为此，我应该使用 Stripe WebHooks。我想通过 webhook 收到订阅期已结束的通知。我很困惑，因为据我了解，customer.subscription 和 price 的 webhook 事件没有定义在当前订阅期结束时触发的内容。

下图显示下一张发票的当前期间和日期。从文档中我了解到可以使用即将到来的发票事件。但我不明白如何将 webhook 与即将发出的发票一起使用。

所以，我的问题是，在订阅期的一个月的最后一天结束时会触发哪个事件，而在定义新期间时会触发哪个事件？

Answer 1

请参阅 https://stripe.com/docs/billing/invoices/subscription#subscription-renewal 和 https://stripe.com/docs/billing/subscriptions/webhooks#tracking。

当订阅期结束时，会创建一张发票 (invoice.created) 为即将到来的发票收费。因此，当周期结束时，您会收到一个 customer.subscription.updated 事件（因为 current_period_start 和 current_period_end 已更新到新期间）以及为为新期间收费而创建的发票的 invoice.created 事件。

我会这样做

• 收听invoice.created事件
• 处理时，检查billing_reason 是否为subscription_cycle 以区别于其他原因创建的发票https://stripe.com/docs/api/invoices/object#invoice_object-billing_reason
• 从发票中检索引用的订阅 (https://stripe.com/docs/api/subscriptions/retrieve) 并查看 current_period_[start|end] 字段，这是您要查找的信息。

您也可以收听customer.subscription.updated并检查它更新的原因是否是计费周期的变化（通过在previous_attributes of the Event中查找current_period_start）；或者通过invoice.paid而不是invoice.created执行与上述相同的操作，如果您只关心在成功付款时更新您的系统（这就是https://stripe.com/docs/billing/subscriptions/webhooks#tracking方法的作用）