# What changed in stripe

> 44 changes in stripe 22 to 23 from its official release notes, upgrade guides and advisories: 12 breaking, 3 security, 22 new APIs and options. Each one cited. Sources checked 2026-10-19. HTML: https://unstale.sh/npm/stripe/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## stripe 23

### Breaking changes

- The reason field changes from string to an enum. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Removes payment_method_types support from Checkout Session creation parameters and several PaymentIntent and SetupIntent parameter types. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- The top-level ErrorType interface export is removed; use .errors, which works as both a type and a value. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Removes countries from Financial Connections.Session.filters and FinancialConnections.SessionCreateParams.filters. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Adds country to Financial Connections session creation filters; countries is removed from session filters and creation filters. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Node.js 18 is no longer supported; Node.js 20 is the minimum supported version. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Removes support for payto on PaymentMethodUpdateParams. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- This mistakenly added function is removed; use stripe.webhooks.constructEventWithoutVerification(payload) for the same functionality. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- The V1-only object, has_more, and url fields are removed from Stripe.V2List<T>; they were never populated. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Responses that stall or are severed before the body is complete now throw StripeConnectionError instead of StripeAPIError. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- V2 request address properties now use operation-specific V2 interfaces instead of shared V1 address parameter types. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- When tolerance is omitted, verifyHeader now uses Webhook.DEFAULT_TOLERANCE for timestamp verification. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)

### New APIs and options

- Adds the Apps.Install resource with create, list, retrieve, uninstall, and update methods. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Snapshot events are now supported for Apps.Install, including created, deleted, and updated events. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Adds allowed_payment_method_types to Checkout Session creation parameters and Checkout.Session. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- The updated_capability enum now includes blik_recurring_payments, satispay_payments, and sequra_payments. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Adds pause support to subscription details when creating an invoice preview. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Adds payment_record to PaymentIntent. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Adds PayPay support across payment method data, payment method details and options, and payment method types. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Adds the ProductCatalog.TrialOffer resource with create, list, retrieve, and update methods. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Adds Sequra support across payment method data, payment method details and options, and payment method types. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Set this environment variable to true to suppress Stripe notices in test and sandbox environments when not running under a detected AI agent; notices remain enabled by default and for AI agents. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Error-code enums on the listed error-bearing fields now support four additional codes. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Adds the pause method to the Subscription resource. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Adds payment_behavior to SubscriptionResumeParams. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Adds pause_schedules to subscription schedule create and update parameters and the SubscriptionSchedule resource. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Adds the Tax.Location resource with create, list, and retrieve methods. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Adds requirements to TaxCode. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Adds the ThreeDSecure.Authentication resource with cancel, create, list, retrieve, and submit methods. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Merchant capabilities now support satispay_payments in account configuration, create parameters, and update parameters. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Capability status code enums now accept eight additional rejection reasons across account capability status details. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Requirement error code enums now accept two additional invalid-address reasons. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Capability restriction enums in current and future requirements now include blik_recurring_payments and satispay_payments. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- V2.Core.Event now supports snapshot_event. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)

### Behavior and default changes

- The pinned API version changes to 2026-09-30.endive. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- EventNotification now supports singleton related objects. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- When tolerance is omitted, verifyHeaderAsync now uses Webhook.DEFAULT_TOLERANCE for timestamp verification. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)

### Fixes and other changes

- Callback clients now use the event's Stripe context and preserve client telemetry, fixing 400 errors when the StripeClient is configured with stripeAccount. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Requests no longer hang when NodeHttpClient is used with Nock 14 or MSW HTTP request interceptors. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)
- Passing 0 now properly skips timestamp tolerance verification instead of applying the default tolerance. (23.0.0) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v23.0.0)

## stripe 22

### Security

- Webhook secrets are validated as non-empty, so empty secrets are rejected. (22.6.2) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v22.6.2)
- Hardens API requestor code against malicious URLs. (22.6.1) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v22.6.1)
- Multipart file uploads use cryptographically secure boundaries. (22.6.1) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v22.6.1)

### Fixes and other changes

- Fixes serialization of schema-coerced values, including Decimal, in GET and DELETE query parameters. (22.6.1) — [release notes](https://github.com/stripe/stripe-node/releases/tag/v22.6.1)