Stripe Checkout Sessions create adds pending invoice item interval
Introduced 2026-03-25 · score 0.96
HOW TO USE IT
For a subscription Checkout Session, set `subscription_data[pending_invoice_item_interval]` to `day`, `week`, `month`, or `year` to set the billing frequency for pending invoice items. [Stripe changelog](https://docs.stripe.com/changelog/dahlia/2026-03-25/adds-pending-invoice-item-interval-parameter-to-checkout-sessions)
curl https://api.stripe.com/v1/checkout/sessions -u "<YOUR_SECRET_KEY>" -H "Stripe-Version: 2026-03-25.dahlia" --data-urlencode "success_url=https://example.com/success" -d "line_items[0][price]=<PRICE_ID>" -d "line_items[0][quantity]=1" -d "mode=subscription" -d "subscription_data[pending_invoice_item_interval][interval]=month" -d "subscription_data[pending_invoice_item_interval][interval_count]=1"WHY THIS HELPS
Configure a subscription Checkout Session to invoice pending items on a schedule different from the subscription cycle.
BEFORE THIS CHANGE
The changelog says the previous approach was to update the Subscription after the Checkout Session completed to configure the pending invoice item interval.
REQUIREMENTS AND LIMITATIONS
- Version: 2026-03-25.dahlia
- mode (required): Set to `subscription` for a Checkout Session that includes at least one recurring item.
- line_items (required): Items being purchased; required for `subscription` mode.
- subscription_data: Optional subset of parameters passed to subscription creation for Checkout Sessions in `subscription` mode.
- subscription_data.pending_invoice_item_interval: Sets the billing frequency for pending invoice items; supported values: `day`, `week`, `month`, `year`. The docs do not state whether these values are mutually exclusive.
- subscription_data.pending_invoice_item_interval nested fields: Not found in accessible official reference; exact nested field names and any count parameter are undocumented in the pages read.
- Prerequisite: Use Checkout in `subscription` mode with at least one recurring item. The API reference lists `line_items` as required for subscription mode.
- Prerequisite: The API reference gives a prerequisite Price creation example using a recurring monthly Price.
- Applies when using Checkout with subscriptions.
- Supported intervals are `day`, `week`, `month`, and `year`.
FIRST-PARTY EVIDENCE
- https://docs.stripe.com/changelog/dahlia/2026-03-25/adds-pending-invoice-item-interval-parameter-to-checkout-sessions
- https://docs.stripe.com/api/checkout/sessions/create?api-version=2026-03-25.dahlia
Check the installed version and the source before using it. Entry JSON