Driftwatch

Stripe / Stripe API /

Breakingdirection flip: their tools call this safe

setup_future_usage can now return "off_session"

What changed

Producer-side tools call this additive. It breaks exhaustive switches, strict parsers and generated client enums.

Affects setup_future_usage on checkout_bancontact_payment_method_options reachable from 15 operations.

New value: off_session.

can now return "off_session"

Who is affected

Code that reads Stripe's checkout_bancontact_payment_method_options objects, used by 426 Stripe operations.

Before and after

WhereBeforeAfter
checkout_bancontact_payment_method_options.setup_future_usage"none""none", "off_session"
payment_intent_payment_method_options_blik.setup_future_usage"none""none", "off_session"

Code that breaks

switch (response.setup_future_usage) {
  // existing branches …
  // no branch for "off_session"
  default:
    throw new Error("unexpected setup_future_usage");
}

Based on Stripe’s published API specification. How severity is decided.