Stripe订阅支付成功后更新账单周期锚点调整扣费日期的最佳实践

Stripe默认订阅的账单周期锚定初始生效日，不会因为付款重试成功自动顺延，你可以通过调整订阅的billing_cycle_anchor参数实现需求，这是官方推荐的标准方案，操作步骤如下：

• 首先监听Stripe的invoice.paid事件，当重试扣款成功的事件回调触发时，调用订阅更新接口
• 调用接口时配置两个核心参数：
  • billing_cycle_anchor：传入本次扣款成功当日的时间戳，你可以直接传now对应的秒级时间戳，也可以手动指定2021-11-03对应的时间戳
  • proration_behavior：设置为none，避免调整周期时生成按天计算的分段费用，和你按完整服务周期收费的规则匹配
• 以下是Node.js环境下的调用示例：

const stripe = require('stripe')('你的Stripe密钥');

const updatedSubscription = await stripe.subscriptions.update(
  '目标订阅ID',
  {
    billing_cycle_anchor: Math.floor(Date.now() / 1000),
    proration_behavior: 'none'
  }
);

• 配套注意事项：
  • 调整完成后，Stripe会自动按照新的锚定日期计算后续所有账单周期，本次调整后下一期账单日自动变为2021-12-03，后续周期也会按这个日期自动顺延，无需重复操作
  • 不要使用修改订阅过期时间的方案实现该需求，会打乱后续账单生成逻辑，也容易产生多余的未支付草稿账单
  • 如果你开启了Stripe智能重试规则，直接把该调整逻辑加到重试成功的事件处理链路中即可实现全自动化处理

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