v5.3.0

New features

• Add Issuing disclosure React component (#633)

Fixes

• Add onChange to Shipping and Billing Address Element (#637)

Changed

• [EwCS]: Update storybook with loadActionsResult (#632)

v5.2.0

• v5.1.0
• Add Financial Account for Platforms disclosure React component (#630)

New features

Fixes

Changed

v5.0.0

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

Changed

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

v4.0.1

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)

v3.10.0

Fixes

• Remove broken Travis badge (#612)

Changed

• Add SPM events/types/tests (#613)

v4.0.0

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}};

v3.9.2

Changed

• Fix JSDoc elements link (#608)

v3.9.1

Fixes

• Patch for global JSX namespace deprecation in React 19 (#607)

v3.9.0

New features

• feat: load fonts when they change (#605)