Public preview
Enables pre-billing for subscriptions Public preview
What’s new
You can now pre-bill subscriptions for a longer duration than their current billing period, and choose which subscription items you want to pre-bill.
Subscriptions must use flexible billing mode to use prebilling.
Impact
You can now pre-bill 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 pre-bill for by using billing_schedules.bill_until, and which prices you want to pre-bill 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
| Parameters | Change | Resources or endpoints |
|---|---|---|
| billing_schedules | Added | Invoice#create_preview. subscription_details Subscription Subscription#create + 1 more Subscription#update |
| billed_until | Added | SubscriptionItem |
Upgrade
- View your current API version in Workbench.
- 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
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
Learn more about Stripe API upgrades.