Stripe订阅每月1号计费周期异常：无法添加使用记录报错

核心原因 #

你遇到的报错Cannot create the usage record with this timestamp because timestamps must be before the subscription's current period end time.，本质是要添加的使用记录时间不在订阅当前计费周期的时间范围内。结合你设置每月1号为计费周期开始的情况，先确认订阅的当前周期时间是关键。

具体排查与解决步骤 #

1. 先确认当前周期的时间范围
   登录Stripe后台找到该订阅，查看「当前周期」的开始和结束时间——这是判断问题的核心依据。

2. 分情况处理：

   • 情况1：当前周期已结束（比如周期是上月1号到当月1号，现在已过1号）
     Stripe不允许给已结束的周期添加使用记录。如果必须收取这部分费用：

     • 用「一次性发票项（One-off invoice item）」手动添加对应金额；
     • 若订阅刚创建不久，可取消后重新创建，确保新订阅的周期覆盖需要记录的时间段。

   • 情况2：当前周期是创建日到下月1号，你要添加1号到创建日之间的使用记录
     Stripe不支持为订阅生效前的时间添加使用记录。同样用「一次性发票项」手动计费即可。
     要是希望后续严格按每月1号计费，创建订阅时需正确设置billing_cycle_anchor为当月1号的时间戳——哪怕是1号之后创建，Stripe会自动将第一个周期调整为当月1号到月底，后续每月1号生成账单。

   • 情况3：使用记录的时间戳超过了当前周期结束时间
     检查你输入的时间，确保它在当前周期结束时间之前，重新尝试创建即可。

关于下一张发票日期为11月1号的说明 #

如果当前周期是当月1号到月底，下一张发票在11月1号生成是正常的；如果当前周期是创建日到11月1号，后续周期会自动切换为每月1号开始，无需额外调整。

内容的提问来源于stack exchange，提问作者Deepak