@stripe/react-stripe-js

Releases

1. 6.8.220 Aug 2026
   Release notes

   • Strengthen Checkout Sessions README guidance (#698)

   New features

   Fixes

   Changed

   Open source →
2. 6.8.110 Aug 2026
   Release notes

   Changed

   • Bump postcss from 8.5.22 to 8.5.26 (#696)
   • Bump fast-uri from 3.1.4 to 3.1.5 (#697)
   • Upgrade storybook to v10 (#694)
   • Update Demos to move from Payment Intents -> Checkout Sessions emphasis (#695)
   • bump prettier version (#693)

   Open source →
3. 6.8.015 Jul 2026
   Release notes

   Changed

   • Add Terms Element (#691)

   Open source →
4. 6.7.01 Jul 2026
   Release notes

   Changed

   • Bump stripe.js version to 9.9.0 (#690)
   • Bump js-yaml from 3.14.2 to 3.15.0 (#689)
   • Bump @babel/core from 7.14.3 to 7.29.6 (#688)
   • Close project to external pull requests (#687)

   Open source →
5. 6.6.02 Jun 2026
   Release notes

   New features

   • AP for EwPI: Add CSE to base types in react-stripe-js (#682)

   Open source →
6. 6.5.029 May 2026
   Release notes

   New features

   • Return event handler result from wrapper (#681)
   • Expose onCancel prop on Checkout ExpressCheckoutElement (#680)

   Open source →
7. 6.4.018 May 2026
   Release notes

   New features

   • Add availablepaymentmethodschange functionality (#674)

   Fixes

   • Bump stripe.js version to 9.5.0 (#676)
   • Bump @babel/plugin-transform-modules-systemjs from 7.13.8 to 7.29.4 (#675)

   Changed

   Open source →
8. 6.3.027 Apr 2026
   Release notes

   New features

   PR #672

   • Added useCheckoutElements(): use this inside <CheckoutElementsProvider>.
   • Added useCheckoutForm(): use this inside <CheckoutFormProvider>.
   • Both new hooks throw a clear runtime error if called under the wrong provider.
   • useCheckout() is now deprecated in favor of the two hooks above. It will keep working under both providers for backward compatibility and is planned for removal in the next major release (v7.0.0).

   Open source →
9. 6.2.014 Apr 2026
   Release notes

   New features

   • add contactDetails element (#670)

   Changes

   • Bump lodash from 4.17.23 to 4.18.1 (#669)

   Open source →
10. 6.1.030 Mar 2026
    Release notes

    New features

    • feat: add React components for Stripe Issuing Elements (#664)

    Changed

    • Bump picomatch from 2.2.2 to 2.3.2 (#666)
    • Bump handlebars from 4.7.7 to 4.7.9 (#668)

    Open source →
11. 6.0.026 Mar 2026
    Release notes

    Changed

    • Type updates for Dahlia (#665)
    • Update react providers for the upcoming checkout sdk changes (#658)
    • point to stripe-js V9 RC + rename to createEmbeddedCheckoutPage (#660)

    Open source →
12. 6.0.0-rc.224 Mar 2026pre-release

    Nothing published for this version

13. 6.0.0-rc.123 Mar 2026pre-release

    Nothing published for this version

14. 6.0.0-rc.018 Mar 2026pre-release

    Nothing published for this version

15. 5.6.12 Mar 2026
    Release notes

    Fixes

    • Fail fast if hub GitHub auth is invalid during publish (#656)

    Changed

    • Bump rollup from 4.22.4 to 4.59.0 (#657)

    Open source →
16. 5.6.028 Jan 2026
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    New features

    • update stripe package (#655)

    Changed

    • Bump lodash from 4.17.21 to 4.17.23 (#652)

    Open source →
17. 5.5.026 Jan 2026
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    New features

    • Add full PaymentFormElement props and options support (#654)

    Fixes

    Open source →
18. 5.4.124 Nov 2025
    Release notes

    Changed

    • Bump min-document from 2.19.0 to 2.19.2 (#644)
    • Bump js-yaml from 3.14.1 to 3.14.2 (#641)

    Open source →
19. 5.4.018 Nov 2025
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    New features

    • Add PaymentForm Element (#643)
    • Removes beta comment from CurrencySelector element. (#642)
    • Export disclosure components with typing (#640)

    Open source →
20. 5.3.027 Oct 2025
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    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)

    Open source →
21. 5.2.07 Oct 2025
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

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

    New features

    Fixes

    Changed

    Open source →
22. 5.0.01 Oct 2025
    Release notes

    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)

    Open source →
23. 5.0.0-rc.115 Sept 2025pre-release

    Nothing published for this version

24. 5.0.0-rc.010 Sept 2025pre-release

    Nothing published for this version

25. 4.0.29 Sept 2025
    Release notes

    Changed

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

    Open source →
26. 4.0.18 Sept 2025
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    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)

    Open source →
27. 4.0.02 Sept 2025
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

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

    Open source →
28. 3.10.03 Sept 2025
    Release notes

    Fixes

    • Remove broken Travis badge (#612)

    Changed

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

    Open source →
29. 3.9.225 Aug 2025
    Release notes

    Changed

    • Fix JSDoc elements link (#608)

    Open source →
30. 3.9.118 Aug 2025
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    Fixes

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

    Open source →
31. 3.9.01 Aug 2025
    Release notes

    New features

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

    Open source →
32. 3.8.128 Jul 2025
    Release notes

    Changed

    • Update docs link Elements.tsx (#602)

    Open source →
33. 3.8.022 Jul 2025
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    New features

    • Add Tax ID Element Types (#604)

    Fixes

    • Bump pbkdf2 from 3.1.1 to 3.1.3 (#599)
    • Migrate to stale action from stable bot (#600)
    • adds check for prerequisites (#590)

    Changed

    Open source →
34. 3.7.02 May 2025
    Release notes

    New features

    • Export CheckoutContextValue type for useCheckout hook (#588)

    Fixes

    • Fix clean publish bug (#583)
    • Fix issue with ignored appearance changes. (#589)

    Changed

    Open source →
35. 3.6.01 Apr 2025
    Release notes

    Changed

    • Update stripe-js dep to v7 (#582)

    Open source →
36. 3.5.119 Mar 2025
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    • Preserve Session Proxy returned from useCheckout hook (#579)

    New features

    Fixes

    • Add actions to session to preserve proxy

    Changed

    Open source →
37. 3.5.017 Mar 2025
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    • Remove silent flag (#578)
    • Fix publish signed commit check #697 (#577)
    • Update implementation for Elements with Checkout Session beta 6 (#576)

    New features

    Fixes

    Changed

    Open source →
38. 3.4.011 Mar 2025
    Release notes

    Changed

    • Update @stripe/stripe-js peer dependency (#573)

    Open source →
39. 3.3.03 Mar 2025
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    New features

    Fixes

    • Push release commit and tag before creating release (#560)
    • Fix lagging version in build (#556)

    Changed

    • Bump store2 from 2.12.0 to 2.14.4 (#563)

    Open source →
40. 3.1.113 Dec 2024
    Release notes

    Fixes

    • fix: correct invalid react version constraint (#555)

    Open source →
41. 3.1.012 Dec 2024
    Release notes

    New features

    • Support React 19 (#552)

    Changed

    • Bump nanoid from 3.3.4 to 3.3.8 (#553)
    • Bump elliptic from 6.5.3 to 6.6.0 (#538)

    Open source →
42. 3.0.019 Nov 2024
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    New features

    • Rename CustomCheckoutProvider to CheckoutProvider (#544)

    Fixes

    Changed

    Open source →
43. 2.9.011 Nov 2024
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    New features

    • Add currency selector element support (#539)
    • Add onLineItemsChange option to EmbeddedCheckoutProvider (#536)

    Open source →
44. 2.8.14 Oct 2024
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    Fixes

    • Bump express from 4.19.2 to 4.21.0 (#528)
    • Bump rollup from 4.12.0 to 4.22.4 (#529)

    Open source →
45. 2.8.014 Aug 2024
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    New features

    • Update EmbeddedCheckoutProvider prop types (#525)

    Fixes

    Changed

    Open source →
46. 2.7.32 Jul 2024
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    Fixes

    • Bump ws from 7.4.6 to 7.5.10 (#508)

    Open source →
47. 2.7.227 Jun 2024
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    • chore(deps): update @stripe/stripe-js to support v4 (#513)
    • v2.7.1

    New features

    Fixes

    Changed

    Open source →
48. 2.7.16 May 2024
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    Fixes

    • Run @arethetypeswrong/cli in CI + before publish (#493)
    • Bump tar from 6.1.11 to 6.2.1 (#490)

    Open source →
49. 2.7.08 Apr 2024
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    New features

    • Add onLoadError to card and cardNumber elements (#488)

    Fixes

    • Remove cart Element (#487)

    Changed

    • Bump express from 4.17.1 to 4.19.2 (#486)
    • Update @stripe/stripe-js dev dependency (#489)

    Open source →
50. 2.6.214 Mar 2024
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    Fixes

    • Fix dependency (#484)

    Open source →
51. 2.6.114 Mar 2024
    Release notes

    Changed

    • Bump es5-ext from 0.10.53 to 0.10.63 (#475)
    • @stripe/stripe-js 3.0.9 (#483)

    Open source →
52. 2.6.011 Mar 2024
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    New features

    • Update stripe-js for Custom Checkout types (#479)
    • upgrade rollup (#480)
    • Add support for fetchClientSecret param to Embedded Checkout (#481)

    Fixes

    Changed

    Open source →
53. 2.5.126 Feb 2024
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    New features

    Fixes

    • Remove cyclic dependency (#474)

    • Bump ip from 1.1.5 to 1.1.9 (#473)

    Changed

    Open source →
54. 2.5.012 Feb 2024
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    Changed

    • update peer dependency (#471)

    Open source →
55. 2.4.021 Nov 2023
    Release notes

    New features

    • Upgrade stripe-js dependency with Appearance API variable name type changes (#462)

    Changed

    • Bump browserify-sign from 4.2.1 to 4.2.2 (#453)

    Open source →
56. 2.3.213 Nov 2023
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    New features

    Fixes

    Changed

    • update publish script to check for github token (#452)
    • Remove beta flag for stripe js (#451)
    • Update @stripe/stripe-js dev dependency (#449)

    Open source →
57. 2.3.12 Oct 2023
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    Fixes

    • catch unmount errors (#446)

    Open source →
58. 2.3.012 Sept 2023
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    New features

    • Add support for Embedded Checkout (beta) (#440)

    Fixes

    Changed

    • Throw error when CustomCheckoutContext value is null. (#444)

    Open source →
59. 2.2.08 Sept 2023
    Release notes

    <!-- Please group the following commits into one of the sections below. --> <!-- Remove empty sections when done. -->

    New features

    • Add CustomCheckoutProvider (#439)

    Fixes

    Changed

    • extract some utils (#438)
    • Remove mentions of ECE being in beta (#436)

    Open source →
60. 2.1.28 Aug 2023
    Release notes

    Changed

    • upgrade stripe-js to 2.0.0 and peerDep (#430)

    Open source →