Bump stripe from 21.0.1 to 22.0.0 #3961

Sourced from stripe's releases.

v22.0.0

This release uses the same pinned API version to 2026-03-25.dahlia as the last major release. The breaking changes in this release are prefixed with ⚠️ below. There's also a detailed migration guide to simplify your upgrade process.

• #2619 Improved TypeScript support in the Node SDK
  • Moved the types from the partially manually maintained and partially generated types folder to be inline with the implementation in TypeScript files.
  • Removed top-level “stripe” ambient module. This allows import aliasing for the stripe package.
  • ⚠️ Stripe.StripeContext is no longer exported as a type. Use Stripe.StripeContextType instead.
  • ⚠️ Stripe.errors.StripeError is no longer a type. Use typeof Stripe.errors.StripeError or Stripe.ErrorType instead.
  • ⚠️ CJS entry point no longer exports .default or .Stripe as separate properties.
  • ⚠️ Stripe import is now a true ES6 class. Use new Stripe() to create a StripeClient instead of calling it:

// Before
const stripeClient = Stripe("sk_test_...");
// After

const stripeClient = new Stripe("sk_test_...");

• #2645 ⚠️ Remove stripeMethod and standardize how function args are handled (including removing callback support)

  • ⚠️ Refactor how incoming method arguments are parsed. Type signatures for API methods should be much more accurate and reliable now
    • ⚠️ Remove support for providing callbacks to API methods. Use async / await instead
    • ⚠️ Remove support for passing a plain API key as a function arg. If supplied on a per-request basis, it should be in the RequestOptions under the apiKey property
    • ⚠️ Keys from params and options objects are no longer mixed. If present on a method, RequestParams must always come first and RequestOptions must always come second. To supply options without params, pass undefined as the first argument explicitly
    • ⚠️ Removed methods from StripeResource: createFullPath, createResourcePathWithSymbols, extend, method and _joinUrlParts. These were mostly intended for internal use and we no longer need them

  As a result, the following call patterns are no longer supported:

  stripe.customers.retrieve('cus_123', 'sk_test_123')
  stripe.customers.create({name: 'david', host: 'example.com'}, 'sk_test_123')
  stripe.customers.create({apiKey: 'sk_test_123'})
  stripe.customers.list(customers => {
    // do something with customers
  })
  

• #2643 ⚠️ Removed per-request host override. To use a custom host, set it in the client configuration. All requests from that client will use that host.

  Before:

  import Stripe from 'stripe';
  const stripe = new Stripe('sk_test_...');
  const customer = await stripe.customers.create({
  
  email: 'customer@example.com',
  
  }, {host: 'example.com'});
  
  

  After:

  import Stripe from 'stripe';
  

... (truncated)

Sourced from stripe's changelog.

22.0.0 - 2026-04-02

This release uses the same pinned API version to 2026-03-25.dahlia as the last major release. The breaking changes in this release are prefixed with ⚠️ below. There's also a detailed migration guide to simplify your upgrade process.

• #2619 Improved TypeScript support in the Node SDK
  • Moved the types from the partially manually maintained and partially generated types folder to be inline with the implementation in TypeScript files.
  • Removed top-level “stripe” ambient module. This allows import aliasing for the stripe package.
  • ⚠️ Stripe.StripeContext is no longer exported as a type. Use Stripe.StripeContextType instead.
  • ⚠️ Stripe.errors.StripeError is no longer a type. Use typeof Stripe.errors.StripeError or Stripe.ErrorType instead.
  • ⚠️ CJS entry point no longer exports .default or .Stripe as separate properties.
  • ⚠️ Stripe import is now a true ES6 class. Use new Stripe() to create a StripeClient instead of calling it:

// Before
const stripeClient = Stripe("sk_test_...");
// After

const stripeClient = new Stripe("sk_test_...");

• #2645 ⚠️ Remove stripeMethod and standardize how function args are handled (including removing callback support)

  • ⚠️ Refactor how incoming method arguments are parsed. Type signatures for API methods should be much more accurate and reliable now
    • ⚠️ Remove support for providing callbacks to API methods. Use async / await instead
    • ⚠️ Remove support for passing a plain API key as a function arg. If supplied on a per-request basis, it should be in the RequestOptions under the apiKey property
    • ⚠️ Keys from params and options objects are no longer mixed. If present on a method, RequestParams must always come first and RequestOptions must always come second. To supply options without params, pass undefined as the first argument explicitly
    • ⚠️ Removed methods from StripeResource: createFullPath, createResourcePathWithSymbols, extend, method and _joinUrlParts. These were mostly intended for internal use and we no longer need them

  As a result, the following call patterns are no longer supported:

  stripe.customers.retrieve('cus_123', 'sk_test_123')
  stripe.customers.create({name: 'david', host: 'example.com'}, 'sk_test_123')
  stripe.customers.create({apiKey: 'sk_test_123'})
  stripe.customers.list(customers => {
    // do something with customers
  })
  

  If those look familiar, head over to the migration guide to update your code.

• #2643 ⚠️ Removed per-request host override. To use a custom host, set it in the client configuration. All requests from that client will use that host.

  Before:

  import Stripe from 'stripe';
  const stripe = new Stripe('sk_test_...');
  const customer = await stripe.customers.create({
  
  email: 'customer@example.com',
  
  }, {host: 'example.com'});
  
  

  After:

... (truncated)

• 210de11 Bump version to 22.0.0
• f0c33bd Update README.md (#2642)
• cd52c83 ⚠️ Remove stripeMethod and standardize how function args are handled (inclu...
• dafc32c ⚠️ remove support for overriding host per-request (#2643)
• e395b7d Converted V2/Amount.ts to V2/V2Amount.ts (#2638)
• c00ce64 Updated stripe.spec.ts test and constructEvent.tolerance type (#2635)
• 8d8bd30 Improved TypeScript support in the Node SDK (#2619)
• See full diff in compare view