Public preview
Adds pending invoice item interval parameter to update Checkout Sessions Public preview
What’s new
Adds the pending_invoice_item_interval parameter to the update CheckoutSession endpoint. Use it to specify the billing frequency for pending invoice items when using Checkout with subscriptions. You can specify day, week, month or year.
Impact
You can now configure the billing interval for pending invoice items when updating subscription-based payments in Checkout Sessions. That allows you to invoice pending items on a different schedule than the subscription cycle without needing to update the Subscription after the Checkout Session completes.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| pending_invoice_item_interval | Added | Checkout. Session#update. 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-03-25. 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.