PAYATHON 2026

如何在 Chargebee 中将不同订阅的账单日期统一?

支付老李

结论

可以。将两个账单日在每月 7 日的订阅分别改到每月 26 日即可,原本在 26 日续费的订阅不用修改。

Chargebee 的账单日通常取决于订阅当前周期的结束时间。操作时,需要把这两个订阅的下一次周期结束时间(Term End / Next Billing Date)改为目标月份的 26 日。修改完成后,月度订阅通常会在此后每月 26 日续费。

在 Chargebee 后台修改

分别打开两个账单日在 7 日的订阅,并按以下步骤操作:

  1. 进入订阅详情页。
  2. 在操作菜单中找到 Change Term End 或 Change Billing Date。
  3. 将新的周期结束日期设为目标月份的 26 日。
  4. 检查 Chargebee 提供的费用预览。
  5. 根据业务需要,选择是否按比例计费以及是否立即生成发票。
  6. 确认修改。
  7. 对另一个订阅执行相同操作。

菜单名称可能因 Chargebee 站点配置和后台界面版本而异。如果订阅详情页中没有相关操作,请检查当前用户权限、订阅状态,以及站点的 Billing Mode 或 Calendar Billing 设置。

通过 API 修改

使用 Chargebee API v2 时,可以调用订阅的 change_term_end 操作。以下示例将指定订阅的当前周期结束时间改到某个 26 日:

curl https://{site}.chargebee.com/api/v2/subscriptions/{subscription_id}/change_term_end \
  -u {api_key}: \
  -X POST \
  -d term_ends_at=UNIX_TIMESTAMP \
  -d prorate=true

参数含义如下:

  • {site} 是 Chargebee Site 名称。
  • {subscription_id} 是需要调整的订阅 ID。
  • term_ends_at 使用 Unix 时间戳。
  • prorate=true 表示按新的周期长度计算费用差额。

两个订阅需要分别调用一次:

curl https://{site}.chargebee.com/api/v2/subscriptions/subscription_1/change_term_end \
  -u {api_key}: \
  -X POST \
  -d term_ends_at=UNIX_TIMESTAMP_FOR_26TH \
  -d prorate=true

curl https://{site}.chargebee.com/api/v2/subscriptions/subscription_2/change_term_end \
  -u {api_key}: \
  -X POST \
  -d term_ends_at=UNIX_TIMESTAMP_FOR_26TH \
  -d prorate=true

生成 term_ends_at 时,应使用 Chargebee Site 的时区。例如,目标日期是 2026-09-26 00:00:00,需要先按站点时区将其转换为 Unix 时间戳,不能直接按 UTC 处理。

费用如何处理

把账单日从每月 7 日改到每月 26 日,会改变当前账期的长度,可能出现以下情况:

  • 当前周期延长,并收取 7 日至 26 日的按比例费用;
  • 当前周期缩短,并产生按比例退款或 Credit Note;
  • 不按比例计费,只修改下一次续费日期;
  • 立即开票,或将差额计入下一张发票。

最终结果由站点的 Proration、Invoicing、Credit Note 和 Billing Mode 配置决定。正式确认修改前,请以 Chargebee 后台或 API 返回的费用预览为准。

注意事项

  • 每个 subscription 都是独立的计费对象。仅修改客户级别的日期,不会自动同步已有订阅。
  • 目标日期应是合理的未来日期,以免意外缩短已经付费的服务周期。
  • 如果订阅有 Scheduled Changes、未支付发票、试用期、暂停状态或合约期限限制,Chargebee 可能不允许修改,也可能采用不同的计费方式。
  • 启用 Calendar Billing 后,账期还可能受 Account、Plan 或 Site 级别的对齐规则影响,修改前应确认相关配置。
  • 建议先在 Test Site 修改一个同类型订阅,核对下一账单日期、按比例费用、税费和发票生成时间,再处理生产数据。

备注:内容仅供参考。