调至内容部分
创建账户或登录
Stripe 文档徽标
/
询问人工智能
创建账户登录
开始
付款
销售收入
平台和交易市场
资金管理
开发人员资源
API 和 SDK帮助
概览
版本管理
更改日志
    概览
    Clover
    Basil
    Acacia
    先前版本
升级您的 API 版本
升级 SDK 版本
基础功能
SDK
API
测试
Stripe CLI
项目示例
工具
Stripe 管理平台
Workbench
开发人员管理平台
Stripe Shell
Stripe for Visual Studio Code
功能
工作流程
事件接收端
Stripe 健康警报文件上传
AI 解决方案
代理工具包
模型上下文协议构建代理式 AI SaaS 计费工作流
安全与隐私
安全
Stripebot 网络爬虫
隐私
扩展 Stripe
构建 Stripe 应用程序
使用 Stripe 的应用程序
合作伙伴
合作伙伴生态
合作伙伴认证
美国
简体中文
首页开发人员资源ChangelogClover2025-09-30.preview

Enables prebilling for subscriptions公开预览

What’s new

You can now prebill subscriptions for a longer duration than their current billing period, and choose which subscription items you want to prebill.

Subscriptions must use flexible billing mode to use prebilling.

Impact

You can now prebill subscriptions by setting the billing_schedules parameter in the following APIs:

  • Create a subscription
  • Update a subscription
  • Create a preview invoices

You can configure how long you want to prebill for by using billing_schedules.bill_until, and which prices you want to prebill using billing_schedules.applies_to. You can also identify the date each subscription item has been billed until using subscriptions.items.data.billed_until the field.

Changes

参数更改资源或 端点
billing_schedules已添加
Invoice#create_preview.subscription_detailsSubscriptionSubscription#create
 + 另外 1 个
Subscription#update
billed_until已添加
SubscriptionItem

Upgrade

  1. View your current API version in Workbench.
  2. If you use an SDK, upgrade to the corresponding SDK version for this API version.
    • If you don’t use an SDK, update your API requests to include Stripe-Version: 2025-09-30.preview
  3. Upgrade the API version used for webhook endpoints.
  4. Test your integration against the new version.
  5. If you use Connect, test your Connect integration.
  6. In Workbench, perform the upgrade. You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.

Related changes

  • Adds pagination and updates fields for aggregrated Billing meter usage data
  • Adds the ability to update automatic tax, invoice creation, and invoice settings for Checkout Sessions
  • Adds the unit label parameter to the product data hash
  • Adds support for Billing Cadence, Billing Settings, and Billing Profile
此页面的内容有帮助吗?
是否
  • 需要帮助?联系支持。
  • 查看我们的更改日志。
  • 有问题?联系销售。
  • LLM? Read llms.txt.
  • Powered by Markdoc