Stripe Checkout Sessions update accepts pending invoice item interval
Introduced 2026-03-25 · score 0.97
HOW TO USE IT
When updating a subscription-based Checkout Session and setting a pending invoice item billing frequency, send `subscription_data[pending_invoice_item_interval][interval]` as `day`, `week`, `month`, or `year`. This lets pending items use a schedule different from the subscription cycle without a later Subscription update.
curl https://api.stripe.com/v1/checkout/sessions/<SESSION_ID> -u "<SECRET_KEY>" -H "Stripe-Version: 2026-03-25.preview" -d "subscription_data[pending_invoice_item_interval][interval]=month"WHY THIS HELPS
When updating a subscription-based Checkout Session, set a billing schedule for pending invoice items that differs from the subscription cycle.
REQUIREMENTS AND LIMITATIONS
- subscription_data: Subscription-related parameters for Checkout Session updates.
- subscription_data[pending_invoice_item_interval][interval] (required): Billing interval. Allowed values: `day`, `week`, `month`, `year`.
- subscription_data[pending_invoice_item_interval][interval_count]: Multiplier for the interval. The official Stripe PHP parameter definition lists this sub-key as optional; the changelog does not describe its behavior.
- Prerequisite: For REST API requests, use API version `2026-03-25.preview` in the `Stripe-Version` header to use this release’s feature.
- Prerequisite: A Stripe secret key is used for authentication in the documented update request.
- Applies to pending invoice items when using Checkout with subscriptions.
FIRST-PARTY EVIDENCE
- https://docs.stripe.com/changelog/dahlia/2026-03-25/adds-pending-invoice-item-interval-parameter-to-checkout-sessions-update
- https://docs.stripe.com/api/checkout/sessions/update?api-version=2026-03-25.preview
- https://github.com/stripe/stripe-php/blob/master/lib/Checkout/Session.php
Check the installed version and the source before using it. Entry JSON