npm / @stripe/stripe-js
@stripe/stripe-js
What changed in @stripe/stripe-js 2 to 10, from its official release notes, upgrade guides and advisories. Sources checked 2026-11-15.
13 breaking1 deprecations13 new APIs and options1 performance1 behavior and defaults1 tooling6 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli init@stripe/stripe-js 1016 changes
Breaking changes 5
Removes defaultCollapsed from update() types because this layout option cannot be updated.
Removes paymentMethodLogoPosition from update() types because this layout option cannot be updated.
Removed Elements paymentMethodTypes from the types for Endive.
The loader now retries.
Removed the payment request button for Endive.
New APIs and options 7
Adds public types for the pe fieldchange event, making its types available to developers.
Canary Islands NIF was added to the Checkout and Tax ID Element types.
Types were added for the Pricing SDK beta.
EwCS types add update actions for individual and business names.
EwCS types add nameCollection.
Adds new appearance variables for accordion triggers.
Adds the mobile_web client option for WeChat Pay.
Performance 1
Concurrent loadStripe calls now share an in-flight Stripe.js load.
Fixes and other changes 3
Adds the missing RON currency to PMME.
Added types for the BLIK setup confirmer.
Added missing types for confirmPayByBankPayment.
@stripe/stripe-js 91 changes
New APIs and options 1
Adds support for pre-collected consent.
@stripe/stripe-js 88 changes
Breaking changes 4
Types for the Checkout SDK were updated in a breaking change.
Clover elements were removed.
Optional mode parameters for stripe.elements were replaced with a discriminated union.
Types for redirectToCheckout were removed in a breaking change.
New APIs and options 2
Types were added for Condensed Inputs.
confirmAcssDebitSetup() now supports expand.
Fixes and other changes 2
Types were added for the metadata field.
Types for PaymentMethod were fixed for all GA-ed LPMs.
@stripe/stripe-js 72 changes
Tooling 1
Typings were added for developer tools.
Fixes and other changes 1
Elements types were modified to support Checkout Session types for GA.
@stripe/stripe-js 61 changes
Behavior and default changes 1
Acacia v6 is generally available.
@stripe/stripe-js 52 changes
Breaking changes 1
Custom Checkout is renamed to Checkout.
New APIs and options 1
Types for customPaymentMethods are added.
@stripe/stripe-js 44 changes
Breaking changes 1
Removed as a type; replace its usage with ExpressCheckoutPaymentMethodOptionWithAlways.
Deprecations 1
The wallets option is deprecated; use paymentMethods instead.
New APIs and options 2
Extended to include themes for PayPal for Express Checkout Element.
Added to StripeExpressCheckoutElementOptions, extending the original wallets with link, paypal, and amazonPay.
@stripe/stripe-js 31 changes
Breaking changes 1
Fixes ES module imports; update imports when moving to this major release.
@stripe/stripe-js 21 changes
Breaking changes 1
The unsupported
nonetheme was removed.