Adds pending invoice item interval parameter to create Checkout Sessions
What’s new
Adds the pending_invoice_item_interval parameter to the create 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 creating 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#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-03-25. 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.