Stripe Checkout Sessions update payment_intent_data in payment mode
Introduced 2026-09-30 · score 0.96
HOW TO USE IT
For an active Checkout Session in payment mode using `ui_mode=elements`, update it with `payment_intent_data` before confirming payment. Set the documented PaymentIntent fields there to change them without recreating the session.
WHY THIS HELPS
When updating PaymentIntent settings for an active Checkout Session in payment mode, modify them before confirming payment without recreating the session.
REQUIREMENTS AND LIMITATIONS
- payment_intent_data: Nested PaymentIntent configuration passed when updating the Checkout Session. The current update reference available here does not document this parameter; the release note says it is accepted for this change.
- description: Arbitrary string attached to the PaymentIntent.
- metadata: Key-value pairs attached to the PaymentIntent; individual keys or all keys can be unset with empty values.
- setup_future_usage: Controls whether the payment method is intended for reuse; allowed values documented on the PaymentIntent update page are `on_session` and `off_session`.
- statement_descriptor: Statement text for a non-card charge; setting it for a card charge returns an error.
- statement_descriptor_suffix: Not documented in the official PaymentIntent update reference page available here.
- ui_mode=elements (required): Required by the release note for this update capability.
- mode=payment (required): Checkout Session mode must be `payment`.
- active state; update before confirmation (required): The release note requires the Checkout Session to be active and the update to occur before payment confirmation.
- Prerequisite: The release note identifies this capability in the 2026-09-30.preview API version; the versioned update reference was inaccessible, so specific setup or preview-access requirements were not confirmed.
- The Checkout Session must use `ui_mode=elements` and be in an active state.
- The session must be in payment mode.
- Update the PaymentIntent configuration before confirming the payment.
- Docs conflict: The currently accessible unversioned Checkout Session update reference documents `metadata`, `collected_information`, and `shipping_options`, but not `payment_intent_data`; it may reflect an older API version, so it does not establish behavior for 2026-09-30.preview. https://docs.stripe.com/api/checkout/sessions/update
FIRST-PARTY EVIDENCE
- https://docs.stripe.com/changelog/endive/2026-09-30/update-payment-intent-data-on-checkout-sessions
- https://docs.stripe.com/api/payment_intents/update
Check the installed version and the source before using it. Entry JSON