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_pix_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_pix_payment_method_options objects, used by 404 Stripe operations.

Before and after

WhereBeforeAfter
checkout_pix_payment_method_options.setup_future_usage"none""none", "off_session"
payment_method_options_pix.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.