New Parameter for Checkout Sessions

Stripe now supports the pending_invoice_item_interval parameter when creating Checkout Sessions. This parameter allows you to configure the billing frequency for pending invoice items independently from your subscription's main billing cycle.

What You Can Do

With this new capability, you can:

• Specify billing intervals of day, week, month, or year for pending invoice items
• Invoice metered usage on a different schedule than the subscription renewal
• Eliminate the need to update the subscription after Checkout completion

This is particularly useful for usage-based billing models where consumption charges may need to be reconciled on a different schedule than recurring subscription fees.

Upgrade Path

To use this feature, you'll need to:

1. Upgrade to the latest API version (2026-03-25.dahlia) in Workbench
2. Update your SDK to the corresponding version (available for Ruby, Python, PHP, Java, Node.js, Go, and .NET)
3. Update webhook endpoints to use the new API version
4. Test your integration thoroughly before deploying
5. Roll back is available for 72 hours if needed

The upgrade can be performed in Workbench with full version rollback capability during the 72-hour grace period.