Stripe Node release notes, breaking changes, and upgrade notes.
Node.js library for the Stripe API StackPulse turns upstream changelogs into scannable summaries with risky changes, deprecations, migration notes, and source links.
This alpha release introduces several new API fields and enum values while making two previously optional fields required. The changes primarily expand tax, payment, and subscription functionality.
affected
Developers using `PaymentIntent.payment_record` or `Subscription.trial_settings.end_behavior.billing_cycle_anchor` without setting them will be affected.
action
Update code to provide required fields `PaymentIntent.payment_record` and `Subscription.trial_settings.end_behavior.billing_cycle_anchor`.
release_signals
-`PaymentIntent.payment_record` is now required
-`Subscription.trial_settings.end_behavior.billing_cycle_anchor` is now required
+
v22.6.2mediumfeatureSep 9, 2026
v22.6.2
This release introduces validation for webhook secrets to ensure they are non-empty, improving reliability and security.
affected
Developers using webhook secrets in Stripe Node are affected by the new validation.
action
Ensure all webhook secrets are non-empty to avoid validation errors.
This alpha release introduces several new resources and methods, particularly around Radar, Signals, and Tax integrations, while making some breaking changes to existing APIs.
affected
Developers using removed methods or enum values, or relying on the changed types, will be affected.
action
Review breaking changes and update code to use new methods and types where necessary.
release_signals
-Removed support for `execute` and `submit` methods on resource `V2.Core.ApprovalRequest`
-Removed support for value `data_share_only` from enums related to `three_d_secure.result`
v22.6.1highsecuritySep 1, 2026
v22.6.1
This release focuses on security improvements and bug fixes, including hardening API requestor code against malicious URLs and fixing serialization issues for GET and DELETE parameters.
affected
Users relying on GET/DELETE parameter serialization or handling file uploads may be affected.
action
Upgrade to ensure secure handling of file uploads and API requests.
release_signals
!Use cryptographically secure boundaries for multipart file uploads
This release introduces support for new resources and methods, such as `CustomerTaxExemption`, and adds various enhancements to existing features. It also includes several breaking changes, including the removal of support for `sequra_payments` and `sequra` across multiple endpoints.
affected
Users relying on `sequra_payments` or `sequra` functionality will be affected by the breaking changes.
action
Review the breaking changes and update your code to remove references to `sequra_payments` and `sequra`.
release_signals
-Remove support for `sequra_payments` on `Account.capabilities`
-Remove support for `sequra` on `Charge.payment_method_details`, `Checkout.Session.payment_method_options`, and others
This beta release updates the API version to 2026-08-26.preview and introduces several new resources and methods, while also removing or changing some existing features.
affected
Developers using the Stripe Node library may need to update their code to accommodate breaking changes and new features.
action
Review the changelog and update your code to handle the breaking changes and new features introduced in this release.
release_signals
-Removed support for `payment_method_types` on `PaymentIntentConfirmParams`, `PaymentIntentCreateParams`, `PaymentIntentUpdateParams`, `SetupIntentCreateParams`, and `SetupIntentUpdateParams`.
-Changed type of `ProductCatalog.TrialOffer.end_behavior.transition.price` and `ProductCatalog.TrialOffer.price` from `Price` to `deletable($Price)`.
v22.6.0highbreakingfeatureAug 27, 2026
v22.6.0
This release introduces a new `EventNotificationHandler` class for improved thin event management and adds runtime support for discriminated union coercion in V2 API requests and responses. It also includes various updates to generated code and fixes for connection error handling.
affected
Developers using discriminated unions in V2 API requests or handling thin events will be affected.
action
Update to the latest version to leverage new features and ensure compatibility with the latest API changes.
release_signals
-Throws an error when serializing a discriminated union parameter with a missing or non-string discriminator.
-Removed support for `cryptogram` on `PaymentAttemptRecord.payment_method_details.card.three_d_secure` and `PaymentRecord.payment_method_details.card.three_d_secure`.
This alpha release introduces new resources and methods for `PaymentPlan` and `Billing.FeedbackOption`, while removing or changing several existing types and resources. It also adds support for new enum values and features across various Stripe APIs.
affected
Developers using the removed or changed resources and types in their Stripe integration will be affected.
action
Review the breaking changes and update your code accordingly if you are using the affected resources or types.
release_signals
-Removed support for resource `Billing.FeedbackOptions`
-Changed type of `BillingPortal.Configuration.features.subscription_cancel.cancellation_reason.feedback_options` from `Billing.FeedbackOptions` to `Billing.FeedbackOption`
This release introduces support for new resources, methods, and enums, while also making breaking changes to certain enum values and types. It updates the pinned API version to 2026-08-12.preview.
affected
Developers using the Stripe Node library may need to update their code to accommodate breaking changes in enum values and types.
action
Review the breaking changes and update your code accordingly.
release_signals
-Remove support for values `partner_disabled_dispute_rate`, `partner_disabled_responsibilities`, `partner_disabled_restricted_business`, and `partner_disabled_suspected_fraud` from 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`
v22.5.0mediumfeatureAug 10, 2026
v22.5.0
This release introduces new event parsing helpers for pre-verified events and adds a constant for the major API version. It also includes a Claude Code plugin hint for specific environment variables.
affected
Developers using Stripe's Node library for event handling or integrating with Claude Code may be affected.
action
Update to v22.5.0 to utilize new event parsing helpers and the Claude Code plugin hint.
release_signals
+Emit Claude Code plugin hint when `CLAUDECODE` or `CLAUDE_CODE_CHILD_SESSION` environment variables are detected.
+Added `stripe.webhooks.constructEventWithoutVerification(payload)` for pre-verified events.
+Added `stripe.constructEventWithoutVerification(payload)` for pre-verified events.
This alpha release introduces several new features including support for Billing.FeedbackOptions, sequra payments, and various payment method details. It also includes breaking changes to type definitions and required fields.
affected
Developers using the Stripe Node library with Issuing.Authorization.healthcare.verification_status or Radar.PaymentEvaluation.payment_details.payment_method_details.card fields may need to update their code.
action
Review breaking changes and update code accordingly, especially for Issuing.Authorization.healthcare.verification_status and Radar.PaymentEvaluation.payment_details.payment_method_details.card fields.
release_signals
-Change type of `Issuing.Authorization.healthcare.verification_status` from `enum('iias_merchant_exempt'|'iias_merchant_not_certified'|'iias_verified'|'not_verified') | null` to `enum('iias_merchant_exempt'|'iias_merchant_not_certified'|'iias_verified'|'not_verified')`
This alpha release introduces support for new resources and methods related to money management, risk, and signals, while making breaking changes to certain API types and removing deprecated fields.
affected
Developers using the Stripe Node library with custom integrations around gift card brands, financial accounts, or received debit mandates may be affected.
action
Review breaking changes and update integrations accordingly.
release_signals
-Changed type of `ConfirmationToken.payment_method_preview.gift_card.brand` and related fields from `enum` to `literal('svs')`.
-Removed support for `managed_by` on `V2.MoneyManagement.FinancialAccount`.
This beta release updates the Stripe Node library to API version 2026-07-29.preview, introducing new features and breaking changes related to tax handling, payment methods, and resource updates.
affected
Developers using the Stripe Node library for payment processing and tax handling are affected by these changes.
action
Review the breaking changes and update your codebase accordingly before upgrading to this version.
release_signals
-Removed support for `taxes` on various payment-related parameters
-Removed support for `tax_ids` on `Checkout.Session.collected_information`
This release updates the Stripe API version to 2026-07-29.dahlia, introducing several new features and removing deprecated fields. Key changes include new resource support, method additions, and field deprecations.
affected
Users relying on deprecated fields `proof_of_registration` and `dynamic_tax_rates` will need to update their integrations.
action
Update integrations to remove usage of deprecated fields `proof_of_registration` and `dynamic_tax_rates`.
release_signals
-Removed support for `proof_of_registration` on `AccountCreateParams.documents` as it was limited-use and deprecated.
-Removed support for `dynamic_tax_rates` on `Checkout.SessionCreateParams.line_items[]` as it was limited-use and deprecated.
This alpha release introduces support for new resources like `Billing.AlertNotification` and `Crypto.DepositAddress`, along with new methods and enum values. It also includes breaking changes related to `PaymentIntent.allowed_payment_method_types` and `SharedPayment.GrantedToken.payment_method_details`.
affected
Developers using `PaymentIntent.allowed_payment_method_types` or `SharedPayment.GrantedToken.payment_method_details` are affected by breaking changes.
action
Update code to handle `PaymentIntent.allowed_payment_method_types` as an enum and replace `taxes` with `tax_items` in `PaymentIntent.payment_details`.
release_signals
-Changed `PaymentIntent.allowed_payment_method_types` from `string` to `enum`.
-Removed support for `taxes` in `PaymentIntent.payment_details` and replaced with `tax_items`.
This release introduces several new features and removes or modifies existing functionality, particularly around financial connections, payment methods, and resource handling. It also includes breaking changes and deprecations.
affected
Developers using the removed or modified resources and methods will need to update their code.
action
Review the changelog and update your code to accommodate the breaking changes and new features.
release_signals
-Removed support for resource `FrMealVouchersOnboarding` and its methods
-Removed support for `financial_accounts_transactions`, `financial_accounts`, and `recipients_list` on `AccountSessionCreateParams.components`
v22.3.2mediumfeatureJul 16, 2026
v22.3.2
This release introduces a Telemetry UUID to replace the source hash and ensures Error fields are generated.
affected
Developers using the Stripe Node library may need to update their code to accommodate the new Telemetry UUID and generated Error fields.
action
Review the changelog for detailed changes and update your implementation accordingly.
-Removed support for `enabled_delivery_options` on `V2.MoneyManagement.PayoutMethod.bank_account`.
-Added new value `disabled` to enum `V2.MoneyManagement.PayoutMethod.usage_status.payments`.
-Added new value `disabled` to enum `V2.MoneyManagement.PayoutMethod.usage_status.transfers`.
+Added support for new resources: `V2.Core.ApprovalRequest`, `V2.Signals.AccountActivity`, `V2.Signals.AccountEvaluation`, and `V2.Signals.AccountSignal`.
+Added support for `list` and `retrieve` methods on `V2.Signals.AccountSignal`.
+Added support for `create` and `retrieve` methods on `V2.Signals.AccountEvaluation`.
+Added support for `create`, `del`, and `retrieve` methods on `V2.Signals.AccountActivity`.
+Added support for `cancel`, `list`, `retrieve`, and `update` methods on `V2.Core.ApprovalRequest`.
-Removed support for `cryptogram` on `PaymentAttemptRecord.payment_method_details.card.three_d_secure` and `PaymentRecord.payment_method_details.card.three_d_secure`
-Changed type of `ProductCatalog.TrialOffer.end_behavior.transition.price` from `Price` to `deletable($Price)`
-Changed type of `Subscription.cancellation_details.feedback_option` from `Billing.FeedbackOptions` to `Billing.FeedbackOption`
+Added support for new resources `Billing.FeedbackOption` and `PaymentPlan`
+Added support for `create`, `list`, `retrieve`, and `update` methods on resource `PaymentPlan`
+Added support for `subscription_pause` on `BillingPortal.Session.flow`
+Added support for new value `usdt` on enums related to `Crypto.OnrampSession`
+Added support for `active_entitlements` on `CustomerSession.components`
-Remove support for `pricing_group` on `Charge.payment_method_details.link`
-Change type of `EventsV2CoreHealthAuthorizationRateDropFiringEvent.impact.dimensions[].type`, `EventsV2CoreHealthAuthorizationRateDropResolvedEvent.impact.dimensions[].type`, `V2.Core.Health.Alert.authorization_rate_drop.dimensions[].type`, and `V2.Core.Health.AlertHistoryEntry.authorization_rate_drop.dimensions[].type` from `literal('issuer')` to `enum('acquirer'|'issuer')`
-Change type of `V2.MoneyManagement.PayoutIntent.next_action.type` from `literal('handle_failure')` to `enum('confirm'|'handle_failure')`
+Add support for new resource `V2.Tax.OperationsResolveAddressResult`
+Add support for `resolve_address` method on resource `V2.Tax.OperationsResolveAddressResult`
+Add support for `confirm` and `fx_quote` methods on resource `V2.MoneyManagement.PayoutIntent`
+Add support for `customer_update` on `BillingPortal.Session.flow`
+Add support for new value `celo` on enum `Crypto.CustomerConsumerWallet.network`
Changed type of `V2.MoneyManagement.ReceivedDebit.bank_transfer.origin_type` and `payment_method_type` to include `gb_bank_account`.
-Removed support for `payout_intent` on `V2.MoneyManagement.OutboundPaymentCreateParams`.
-Removed support for `id` on `EventsV2SignalsAccountSignalFraudulentMerchantReadyEvent`.
+Added support for new resources: `V2.MoneyManagement.ReceivedDebitMandate`, `V2.Risk.Inquiry`, `V2.Signals.AccountActivity`, and `V2.Signals.AccountEvaluation`.
+Added support for `create`, `retrieve`, `del`, `list`, and `update` methods on new resources.
+Added support for `tempo` value in `Crypto.CustomerConsumerWallet.network` and related enums.
+Added support for `healthcare` and `product_code` fields in `Issuing.Authorization` and `Issuing.Card`.
+Added support for new event notifications related to `V2.MoneyManagement.ReceivedDebit` and `V2.Signals.AccountEvaluation`.