在 Stripe 中创建订阅 - 我很困惑

Question

我为我的用户使用条带订阅，例如，每月 10 美元用于 100 个 API 请求，这是一个标准价格。但是，如果用户使用了 150 个 API 请求，我会向他们收取 10 美元 + 3 美元的费用。对于 200 个及以上的请求，它是 10 美元 + 7 美元。

假设，我在 10 月 9 日订阅了该用户。 11 月 9 日，webhook 事件invoice.created 将通过条带调用。因此，如果用户使用了 150 个 API 请求，我必须在基本价格的基础上再增加 3 美元（根据 Stripe 文档https://support.stripe.com/questions/metered-subscription-billing，我只能在 1 小时内做到这一点）。

  if even.type == 'invoice.created'
    Stripe::InvoiceItem.create(
      customer: stripe_customer_id,
      invoice: event.data.object.invoice
      amount: 300,
      currency: 'usd',
      description: 'additional price'
     )

问题：

1. invoice.created 的活动确实会在 11 月 9 日举行第一次吗？

2. 是在 10 月 9 日至 11 月 9 日的当前 10 美元发票中添加 3 美元的额外价格，还是将其添加到 11 月 9 日至 12 月 9 日的未来发票中？从文档中不清楚。

3. 如何将元数据添加到 10 美元的原始发票？我可以将元数据添加到附加发票，但如果用户使用的 API 请求少于 100 个，我根本不必创建附加发票，因此我不能依赖附加发票。

4. 上面写着

在您的客户订阅之前创建任何发票项目 计划，然后通过更新客户创建订阅 订阅电话。

• 但我会在 10 月 9 日永久订阅该用户！如果一个月还没有过去，我如何在该日期之前或之后（10 月 9 日）创建InvoiceItem，因此不知道用户进行了多少 API 调用（显然，用户在 10 月 9 日进行了，零 API 调用）？我只能在 30 天内创建 InvoiceItems，因为那时我知道要在 10 美元上向他们收取多少费用！ 10 月 9 日，我不知道。我什么都不懂？

Answer 1

每次创建发票时，您都会在 webhook 上收到事件 invoice.created。因此，当您在 11 月 9 日为客户订阅月度计划时，您将在 11 月 9 日、12 月 9 日、1 月 9 日等收到此活动。

订阅的第一张发票（在您创建订阅时生成）始终会立即关闭，因此此时无法添加发票项目。如果这是您想要做的事情（例如设置费），您需要在创建订阅之前创建发票项目。这样，它会自动添加到订阅客户时创建的第一张发票中。

在您的情况下，您希望根据您的客户在刚刚结束的一个月内提出的 API 请求数量为下一张发票添加费用。因此，在invoice.created 事件中，您需要检测是新月份开始还是第一个月。如果是新月份，则需要决定是否必须向用户添加 Invoice Item（基于 API 请求的数量）。

您无法将元数据添加到前一个月的上一张发票中。您只需将发票项目添加到当前发票（开始月份）并添加说明，表明额外的行项目是用于上个月的消费。