Breaking Change: Radios Option Type Enforcement

When using Stripe's Payment Element, you can no longer pass boolean values to the options.layout.radios configuration parameter. This change requires developers to explicitly specify one of four enum values instead.

Required Action

If your code currently sets options.layout.radios to true or false, you must update it to use one of these enum values:

• always - Radios always display
• auto - Automatic behavior based on context
• if_multiple - Radios display only when multiple options exist
• never - Radios never display

Impact and Error Handling

Attempting to set options.layout.radios to any value outside the enum list now throws an integration error. This is part of a broader set of breaking changes to Stripe's JavaScript library, including updates to the Address Element, Payment Element future usage configuration, and the removal of deprecated methods.

Timeline

Developers should audit their Payment Element implementations immediately to identify and update any boolean assignments to this configuration parameter.