Makes billing cycle anchor configuration available for Checkout Sessions in subscription mode
What’s new
Makes the billing_cycle_anchor_config parameter available in the Checkout Sessions API.
The parameter accepts a required day_of_month property and optional hour, minute, month and second properties to precisely control when the billing cycle resets. billing_cycle_anchor_config is mutually exclusive with billing_cycle_anchor and any trial period parameters.
Impact
You can now set a fixed billing cycle anchor date when creating a subscription mode Checkout Session. If you want all subscribers who sign up through a Checkout Session to be billed on the same calendar date (for example, the 1st of every month) set subscription_data[billing_cycle_anchor_config][day_of_month] to that day when you create the session. See the billing cycle anchor documentation for more details about how anchor dates affect proration and invoice timing.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| billing_cycle_anchor_config | Added | Checkout. Session#create. subscription_data |
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: 2026-06-24. dahlia
- 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.