Stripe：使用billing_cycle_anchor时订阅周期起始日期异常求助

你已经搞定了首次按比例计费的部分，但后续周期起始时间不符合预期的问题，核心原因是把billing_cycle_anchor设成了当月最后一天，导致Stripe将这个时间作为下一个周期的起始点。要实现「付款日到当月月底收按比例费用，之后每月1日启动新周期」的需求，你需要同时设置两个关键参数：billing_cycle_anchor（下月1日）和proration_date（当月月底）。

修改后的代码 #

var date = new Date();
// 计算当月最后一天的UTC零点时间戳（作为按比例计费的截止日期）
var lastDay = Date.UTC(date.getFullYear(), date.getMonth() + 1, 0);
var monthLastDay = Math.floor(lastDay / 1000);
// 计算下个月1日的UTC零点时间戳（作为后续计费周期的锚点）
var nextMonthFirstDay = Date.UTC(date.getFullYear(), date.getMonth() + 1, 1);
var nextMonthFirstDayTs = Math.floor(nextMonthFirstDay / 1000);

let subscription = {
  metadata: metadata,
  billing_cycle_anchor: nextMonthFirstDayTs,
  proration_date: monthLastDay,
  proration_behavior: 'create_prorations' // 显式开启按比例计费，避免默认行为变动
};

为什么这样生效？ #

1. proration_date: monthLastDay：告诉Stripe，首次按比例计费的截止日期是当月最后一天（比如你例子中的2018年5月31日UTC零点），这样会精准收取从付款日（5月16日）到5月31日的按比例金额，和你当前的预期一致。
2. billing_cycle_anchor: nextMonthFirstDayTs：把后续的计费周期锚定在下个月1日（比如2018年6月1日UTC零点），这样第一个完整周期就是6月1日到6月30日，之后每个月1日都会自动启动新的计费周期，完全匹配你的需求。

效果验证 #

以你提供的时间戳为例：

• monthLastDay为1527724800（2018-05-31T00:00:00Z），对应首次计费截止日
• nextMonthFirstDayTs为1527811200（2018-06-01T00:00:00Z），对应第一个完整周期的起始日

设置完成后，Stripe会：

• 立即生成一张从5月16日到5月31日的按比例账单
• 从6月1日开始，每月1日自动生成当月全价账单，周期为当月1日到当月最后一天

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