v5.0.0

Compare Source

Stripe.js Clover changelog: https://docs.stripe.com/changelog?category=stripejs

Fixes

• export StripeCheckoutValue from checkout entrypoint #​625 (#​625)

Changed

• Remove Clover element types (#​626)
• [breaking] Update CheckoutProvider to use new shape (#​615)
• [EwCS] update storybook example to v4 (#​622)

v4.0.2

Compare Source

Changed

• Add release candidate logic to publish script (#​618)

v4.0.1

Compare Source

Fixes

• Fix Shipping/BillingAddressElement Render (#​616)

Changed

• Bump sha.js from 2.4.11 to 2.4.12 (#​610)
• Bump cipher-base from 1.0.4 to 1.0.6 (#​614)

v4.0.0

Compare Source

Changed

• [breaking] split out custom checkout imports (#​609)
• Update useCheckout to return loading/error states (#​606)

Upgrade guidance

Import changes

Checkout paths changed:
Note: this only applies to Elements with Checkout Sessions API integrations.

import {useCheckout, PaymentElement} from '@​stripe/react-stripe-js';

to

import {useCheckout, PaymentElement} from '@​stripe/react-stripe-js/checkout';

useCheckout changes

Previously:

• CheckoutProvider renders children if initCheckout succeeded, and null otherwise.
• useCheckout() returns the SDK if initCheckout succeeded, and throws an error otherwise.

Now (>= v4.0.0):

• CheckoutProvider renders children unconditionally.
• useCheckout() returns a disjoint union describing the asynchronous state. The new return value now looks like:

type useCheckout = () =>
  | {type: 'loading'}
  | {
      type: 'success';
      checkout: CheckoutValue;
    }
  | {type: 'error'; error: {message: string}};

v8.0.0

Compare Source

Stripe.js Clover changelog: https://docs.stripe.com/changelog?category=stripejs

New features

• [breaking] Update types for Checkout SDK (#​803)
• Add Types for metadata field (#​808)
• Add Types for Condensed Inputs (#​807)
• Support expand on confirmAcssDebitSetup() (#​811)
• Update checkout.d.ts (#​813)

Fixes

• Fix types for PaymentMethod for all GA-ed LPMs (#​812)

Changed

• Replace optional stripe.elements mode params with discriminated union (#​756)
• Bump cipher-base from 1.0.4 to 1.0.6 in /examples/parcel (#​800)
• Remove Clover elements (#​809)
• [breaking] Remove types for redirectToCheckout (#​806)

v19.1.0

Compare Source

• #​2453 add missing fetchEvent type for UnknownEventNotification

  • Add missing fetchEvent() declaration to the Stripe.Events.UnknownEventNotification interface
  • Tweak Stripe.Events.fetchRelatedObject so that it's always defined and returns null if there's no related_object. This fixes the situation where the UnknownEventNotification says that fetchRelatedObject() is defined, but calling it throws an error.

• #​2447 Update param in deprecation docs link

• #​2444 Update CHANGELOG.md to point to right API version

v19.0.0

Compare Source

This release changes the pinned API version to 2025-09-30.clover and contains breaking changes (prefixed with ⚠️ below)

• #​2427 Move V2.Event API resources to V2.Core.Events

  • ⚠️ Move the below event related interfaces and types from Stripe.V2 to Stripe.V2.Core. This enables us to correctly match the API path to the namespace
    • Stripe.V2.EventDestination -> Stripe.V2.Core.EventDestination
    • Stripe.V2.Event -> Stripe.V2.Core.Event
    • Stripe.V2.EventBase -> Stripe.V2.Core.EventBase
    • Stripe.V2.Events.RelatedObject -> Stripe.V2.Core.Events.RelatedObject

• #​2370 Add strongly typed EventNotifications
  We've overhauled how V2 Events are handled in the SDK! This approach should provide a lot more information at authoring and compile time, leading to more robust integrations. As part of this process, there are a number of changes to be aware of.

  • ⚠️ Rename function StripeClient.parseThinEvent to StripeClient.parseEventNotification and remove the Stripe.ThinEvent interface.
    • This function now returns a Stripe.V2.EventNotification which is a union of all possible event notifications instead of Stripe.ThinEvent. When applicable, these event notifications will have the relatedObject field and a function fetchRelatedObject(). They also have a fetchEvent() method to retrieve their corresponding event.
    • If this union type does not cover a new event notification that you parsed, you can cast it to UnknownEventNotification to then access the relatedObject field and the function fetchRelatedObject()

• #​2432 Drop support for Node < 16 & clarify policy

  • Publish our new language version support policy and add a link to the README.
  • ⚠️ Drop support for Node versions < 16
  • Node 16 support is deprecated and will be removed in the next scheduled major release (March 2026)

• #​2426 Add StripeContext object

  • Add the StripeContext class. It can be used anywhere the context option is supplied and gets serialized to a string when making requests.
  • ⚠️ Change EventNotification (formerly known as ThinEvent)'s context property from string to StripeContext
  • ⚠️ We no longer remove the stripe-context header from /v1 requests and the stripe-account header from /v2 requests. The server may reject a request with both of these headers, so if you're sending both, remove any reference to stripeAccount (since the headers are identical, but context is preferred)

• #​2398 ⚠️ Build SDK w/ V2 OpenAPI spec

  • ⚠️ The delete methods for v2 APIs (the ones in the StripeClient.v2 namespace) now return a V2DeletedObject which has the id of the object that has been deleted and a string representing the type of the object that has been deleted.
  • ⚠️ Change the types of nullable properties in objects returned by v2 APIs (the ones in the StripeClient.v2 namespace) from a null union to optional (e.g. prop: string | null -> prop?: string).

• #​2420 Fixed file uploading in Bun runtimes

  • Fixed issue (#​2416) with file uploads in runtimes using FetchHttpClient (e.g. Bun). This bug affected Node SDK versions between 18.1.0 to 18.5.0.

• #​2405 support more npm tags

  • ⚠️ Starting with this release, we'll no longer be tagging releases with beta npm tag. Instead, we'll use latest, public-preview, or private-preview to more closely align with Stripe's release phases

• #​2402, #​2413, #​2430, #​2428 Update generated code based on incoming API changes in the 2025-09-30.clover API version.

  • ⚠️ Remove support for balance_report and payout_reconciliation_report on AccountSession.components and AccountSessionCreateParams.components
  • ⚠️ Remove support for values saturday and sunday from enums Account.settings.payouts.schedule.weekly_payout_days, AccountCreateParams.settings.payouts.schedule.weekly_payout_days, and AccountUpdateParams.settings.payouts.schedule.weekly_payout_days
    • Add support for new values external_request and unsupported_business_type on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, BankAccount.future_requirements.errors[].code, BankAccount.requirements.errors[].code, Capability.future_requirements.errors[].code, Capability.requirements.errors[].code, Person.future_requirements.errors[].code, and Person.requirements.errors[].code
    • Remove support for link and pay_by_bank on PaymentMethodUpdateParams
  • ⚠️ Remove support for coupon on Discount, PromotionCodeCreateParams, and PromotionCode. Use Discount.source.coupon, PromotionCodeCreateParams.promotion.coupon and PromotionCode.coupon instead.
  • Change Invoice.id to be required.
  • Add support for new value prevented on enum Dispute.status
  • Add support for new resource BalanceSettings
  • Add support for retrieve and update methods on resource BalanceSettings
  • Add support for mb_way_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
  • Add support for source on Discount
  • Add support for trial_update_behavior on BillingPortal.Configuration.features.subscription_update, BillingPortal.ConfigurationCreateParams.features.subscription_update, and BillingPortal.ConfigurationUpdateParams.features.subscription_update
  • Add support for mb_way on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_data, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_data, PaymentIntentCreateParams.payment_method_options, PaymentIntentUpdateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_options, PaymentMethodCreateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data
  • Add support for branding_settings and name_collection on Checkout.SessionCreateParams and Checkout.Session
  • Add support for excluded_payment_method_types on Checkout.SessionCreateParams, Checkout.Session, PaymentIntentConfirmParams, and PaymentIntentUpdateParams
  • Add support for unit_label on Checkout.SessionCreateParams.line_items[].price_data.product_data, InvoiceAddLinesParams.lines[].price_data.product_data, InvoiceLineItemUpdateParams.price_data.product_data, InvoiceUpdateLinesParams.lines[].price_data.product_data, and PaymentLinkCreateParams.line_items[].price_data.product_data
  • Add support for alma, billie, and satispay on Checkout.Session.payment_method_options and Checkout.SessionCreateParams.payment_method_options
  • Add support for demo_pay on Checkout.SessionCreateParams.payment_method_options
  • Add support for capture_method on Checkout.Session.payment_method_options.affirm, Checkout.Session.payment_method_options.afterpay_clearpay, Checkout.Session.payment_method_options.amazon_pay, Checkout.Session.payment_method_options.card, Checkout.Session.payment_method_options.cashapp, Checkout.Session.payment_method_options.klarna, Checkout.Session.payment_method_options.link, Checkout.Session.payment_method_options.mobilepay, Checkout.Session.payment_method_options.revolut_pay, Checkout.SessionCreateParams.payment_method_options.affirm, Checkout.SessionCreateParams.payment_method_options.afterpay_clearpay, Checkout.SessionCreateParams.payment_method_options.amazon_pay, Checkout.SessionCreateParams.payment_method_options.card, Checkout.SessionCreateParams.payment_method_options.cashapp, Checkout.SessionCreateParams.payment_method_options.klarna, Checkout.SessionCreateParams.payment_method_options.link, Checkout.SessionCreateParams.payment_method_options.mobilepay, and Checkout.SessionCreateParams.payment_method_options.revolut_pay
  • Add support for flexible on Checkout.SessionCreateParams.subscription_data.billing_mode, InvoiceCreatePreviewParams.schedule_details.billing_mode, InvoiceCreatePreviewParams.subscription_details.billing_mode, Quote.subscription_data.billing_mode, QuoteCreateParams.subscription_data.billing_mode, Subscription.billing_mode, SubscriptionCreateParams.billing_mode, SubscriptionMigrateParams.billing_mode, SubscriptionSchedule.billing_mode, and SubscriptionScheduleCreateParams.billing_mode
  • Add support for business_name and individual_name on Checkout.Session.collected_information, Checkout.Session.customer_details, CustomerCreateParams, CustomerUpdateParams, and Customer
  • Add support for new values mb_way on enums ConfirmationTokenCreateParams.testHelpers.payment_method_data.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, SetupIntentConfirmParams.payment_method_data.type, SetupIntentCreateParams.payment_method_data.type, and SetupIntentUpdateParams.payment_method_data.type
  • Add support for new values mb_way on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Add support for new values mb_way on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for chargeback_loss_reason_code on Dispute.payment_method_details.klarna
  • Add support for net_amount and proration_details on InvoiceItem
  • Remove support for iterations on InvoiceCreatePreviewParams.schedule_details.phases[], SubscriptionScheduleCreateParams.phases[], and SubscriptionScheduleUpdateParams.phases[]
  • Add support for fraud_disputability_likelihood and risk_assessment on Issuing.AuthorizationCreateParams.testHelpers
  • Add support for second_line on Issuing.Card
  • Add support for new values mb_way on enums PaymentIntent.excluded_payment_method_types and PaymentIntentCreateParams.excluded_payment_method_types
  • Add support for fr_meal_voucher_conecs on PaymentMethodConfigurationCreateParams and PaymentMethodConfigurationUpdateParams
  • Add support for promotion on PromotionCodeCreateParams and PromotionCode
  • Add support for new values acknowledged and payment_never_settled on enum Review.closed_reason
  • Add support for provider on Tax.Settings.defaults
  • Add support for bbpos_wisepad3 on Terminal.ConfigurationCreateParams, Terminal.ConfigurationUpdateParams, and Terminal.Configuration
  • Add support for address_kana, address_kanji, display_name_kana, display_name_kanji, and phone on Terminal.LocationCreateParams, Terminal.LocationUpdateParams, and Terminal.Location
  • Change Terminal.LocationCreateParams.address to be optional
  • Change Terminal.LocationCreateParams.display_name to be optional
  • Add support for new value 2025-09-30.clover on enum WebhookEndpointCreateParams.api_version
  • Add support for error codes financial_connections_account_pending_account_numbers and financial_connections_account_unavailable_account_numbers on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError