恢复 Stripe 订阅（并对之前未付费的服务收费）

Question

我有一个网络服务，可以为我的用户发布和托管某些信息。每个用户的编辑界面与他们发布的信息是分开的。我使用 Stripe 订阅进行计费，但我无法找到处理未付费订阅的可行方法。这是我想要实现的逻辑：

\n\n

\n
1. 第一次计费尝试失败后，我的应用程序应锁定用户的编辑界面；相反，它应该向他们提供一个页面，其中包含解决付款问题的选项。但是，他们发布的信息仍将发布，因此延迟付款不会中断访问者的活动。
\n
2. 在最后一次计费尝试失败后，即 15 天后，我的应用程序也应该删除他们发布的信息。此时，用户的编辑界面将被替换为允许他们使用新信用卡重新激活帐户或完全删除帐户的界面。
\n
3. 如果用户选择重新激活帐户，他们不应获得试用期
\n
4. 如果用户重新激活，他们还应该为之前跳过的 15 天付费，方法是将首个计费周期缩短 15 天，或者将相当于 15 天服务的费用添加到首个计费周期中。账单。
\n

\n\n

如果我观察正确的 webhooks\xe2\x80\x94，#1 和 #2 很容易实现，只需将拖欠客户或已删除或未付费订阅的客户的请求重定向到“修复此问题”页面。#3 也很简单\xe2\x80\x94只需创建订阅并将其trial_end设置为now。

\n\n

第 4 点很棘手。如何确定用户的最后一张发票在其订阅被取消之前未支付的时间有多久？如何缩短新订阅的第一个计费周期？或者，我如何按比例计算客户的上一张发票总额以代表我实际提供给他们的部分，以便我可以将该金额添加到新发票中？（我知道我可以在开始新订阅之前创建一个发票项目来收取金额，所以至少这是可能的。）

\n\n

最后，Stripe 的“标记订阅未付费”选项对解决这些问题有帮助吗？看起来它一直在创建发票，但并不尝试对其收费；我不认为这就是我想要的。

\n

Answer 1

您绝对可以通过 Stripe 的订阅来实现这一切。正如您提到的，前两个问题应该通过 webhooks 来解决。您将在您的一端监听invoice.payment_failed以检测付款何时失败，并立即阻止您的 UI 要求您的客户更新他们的卡详细信息。

要更新他们的卡详细信息，您可以使用Stripe Checkout，但不要设置data-amount参数，这样它就不会向您的客户显示价格。下面是一个例子：

<form action="/charge" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js" class="stripe-button"
    data-key="pk_test_XXXX"
    data-image="/square-image.png"
    data-name="Demo Site"
    data-description="Update Card Details"
    data-panel-label="Update Card Details"
    data-label="Update Card Details">
  </script>
</form>

每次您的客户尝试更新其卡时，您都可以使用更新客户 API并在参数中传递新的卡令牌card。这将删除客户的默认卡并将其替换为新卡。它还会尝试支付处于“逾期”状态的每个订阅的最新发票。在您的情况下，这意味着将尝试支付仍处于重试模式的最新发票。这不算重试，可以看作是独立的。如果成功，您只需重新启用 UI，否则您将继续要求客户更新其卡详细信息。

当您达到第四次失败付款时，您将收到一条信息，如果这就是您在仪表板的customer.subscription.canceled重试设置中设置的内容。您可以通过检查事件上的键并确保它是 来检测这是自动取消。在这种情况下，您可以完全阻止客户的 UI/帐户。requestnull

在过去 15 天里，如果我正确理解了您的流程，那么自从您部分锁定 UI 以来，客户实际上无法使用您的应用程序。但是，如果您仍然希望他支付该金额，您应该在数据库中存储客户在 15 天无法使用订阅期间欠您 X 美元的信息。

后来，您的客户终于回来并想要重新启用他的帐户。此时，您通知他付款流程将从今天开始重新开始，并且您将向他收取他之前错过的额外 15 天的费用。为此，我将使用发票项目，它允许您自动向第一张发票添加额外金额。您将按照以下步骤操作：

1. 为您的客户创建$X 的发票项目。
2. 为您的计划设置创建新的订阅，trial_end以防"now"您的计划默认设置了试用期。
3. 这将自动创建计划金额的第一张发票并添加之前创建的发票项目。

这里的另一个解决方案是重新打开最新未付款的已关闭发票并使用Pay Invoice API。当发生这种情况时，您知道您的客户现在向您支付了整整一个月的费用，而不是只欠您 15 天的费用。在这种情况下，您可以创建一个新的订阅并设置 15 天的试用期，以便他在试用后再次开始付费。

我不会在这里使用“标记为未付款”选项，因为您将客户完全锁定在您的应用程序之外。对我来说，当您让客户使用您的应用程序并计划在几个月内向他收取每张发票的费用时，可以使用此功能。例如，这将用于电力提供商，他们会在多个计费周期内保持您的电力供应，并继续尝试向您收取每张发票的费用。

在这种情况下，您的客户实际欠您的金额取决于您允许的重试次数以及每次重试之间的天数。您在这里可以做的是使用created发票上的值，并将其与您获得的当前时间进行比较，customer.subscription.canceled以确定过去了多少时间，并计算此时客户欠您的金额的按比例分配。