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 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`
-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')`
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`
This alpha release updates the Stripe API version to 2026-07-08.preview and introduces several new features, including support for gift card operations, new tax types, and additional payment methods. It also includes breaking changes and removals of deprecated fields.
affected
Developers using the Stripe Node library, especially those utilizing `Checkout.Session.collected_information` or `V2.Billing.Contract`, will be affected by the breaking changes.
action
Review the breaking changes and update your code accordingly to ensure compatibility with the new version.
release_signals
-Removed support for `tax_ids` on `Checkout.Session.collected_information`
-Removed support for `one_time_fees` on `V2.Billing.ContractCreateParams` and `V2.Billing.Contract`
This release introduces support for new crypto-related resources and methods, along with updates to existing APIs. It also includes several breaking changes and deprecations, particularly around enum values and optional fields.
affected
Developers using the Stripe Node SDK, particularly those working with crypto-related features or specific enum values, will be affected by these changes.
action
Review the breaking changes and deprecations to ensure compatibility with your existing codebase.
release_signals
-Added new value `tax_fund` to enum `BalanceTransaction.type`.
-Changed `Billing.CreditGrant.priority` to be required.
This release introduces support for several new resources and methods, while also removing or modifying some existing ones. The API version has been updated to 2026-06-24.preview, and there are significant changes to the billing contract and core account configurations.
affected
Developers using the Stripe Node library, especially those working with billing contracts and core account configurations, will be affected by these changes.
action
Review the breaking changes and deprecations carefully and update your code accordingly.
release_signals
-Remove support for resource `V2.Billing.ContractLicensePricingQuantityChange`
-Remove support for `performance_location_details` on `Tax.TransactionLineItem`
This beta release updates the Stripe Node library to support the 2026-06-24.preview API version, introducing new features like redaction support across multiple resources and new enum values for financial connections and money management. It also includes breaking changes such as the removal of certain enum values and event notifications.
affected
Developers using the Stripe Node library and relying on removed enum values or event notifications will be affected.
action
Review the breaking changes and update your code to use the new supported values and features.
release_signals
-Remove support for value `invoice_payment.detached` from enum `WebhookEndpointUpdateParams.enabled_events`.
-Remove support for `storer` on `V2.Core.Account.configuration` and related params.
v22.3.0highbreakingfeatureJun 24, 2026
v22.3.0
This release updates the pinned API version to 2026-06-24.dahlia and introduces new payment method options, enums, and fields across various Stripe objects.
affected
Users handling billing, payments, and account configurations will be affected by the changes.
action
Review the changelog and update any integration code to handle new required fields and enum values.
release_signals
-Change Billing.CreditGrant.priority to be required
-Remove support for stored_credential_usage on PaymentAttemptRecord.payment_method_details.card and PaymentRecord.payment_method_details.card
-Change various card-related fields to be optional in PaymentAttemptRecord and PaymentRecord
This release introduces support for new resources like GiftCard, TaxFund, and various methods, while removing deprecated features and making significant type changes.
affected
Developers using the Stripe Node library, especially those relying on deprecated features like `money_services` or `liquid_asset`, will be affected.
action
Review the breaking changes and update your code to use the new features and types.
release_signals
-Removed support for `money_services` on `ChargeCaptureParams.payment_details`, `ChargeUpdateParams.payment_details`, and `PaymentIntentCaptureParams.payment_details`
+
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`
-Change `Radar.PaymentEvaluation.payment_details.payment_method_details.card.first6` to be required
-Change `Radar.PaymentEvaluation.payment_details.payment_method_details.card.last4` to be required
+Add support for new resource `Billing.FeedbackOptions`
+Add support for `sequra_payments` on `Account.capabilities`
+Add support for `feedback_options` on `BillingPortal.Configuration.features.subscription_cancel.cancellation_reason`
+Add support for `sequra` on various payment method details and options
+Add support for `retrieval_reference_number` on various card present payment method details
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`.
Removed support for `deactivation` on `GiftCardOperation` and its enum value.
-Removed support for `stored_credential_usage` on `PaymentAttemptRecord.payment_method_details.card` and `PaymentRecord.payment_method_details.card`.
-Changed `PaymentAttemptRecord.payment_method_details.card.description` and `PaymentRecord.payment_method_details.card.description` to be optional.
!Removed support for `deactivation` on `GiftCardOperation`.
!Removed support for value `invoice_payment.detached` from enums `WebhookEndpointCreateParams.enabled_events` and `WebhookEndpointUpdateParams.enabled_events`.
+Added support for new resources: `Crypto.CustomerConsumerWallet`, `Crypto.CustomerPaymentToken`, `Crypto.Customer`, `Crypto.OnrampSession`, and `Crypto.OnrampTransactionLimits`.
+Added `list` and `retrieve` methods for `Crypto.Customer`.
+Added `checkout`, `create`, `list`, `quote`, and `retrieve` methods for `Crypto.OnrampSession`.
+Added `retrieve` method for `Crypto.OnrampTransactionLimits`.
+Added support for `redaction` on multiple resources including `Card`, `Charge`, `Checkout.Session`, and `PaymentIntent`.
-Change type of `V2.Billing.Contract.one_time_fees` from `array(an object)` to `an object`
-Change type of `V2.Billing.Contract.pricing_lines` from `array(an object)` to `an object`
-Change type of `V2.Billing.Contract.pricing_overrides` from `array(an object)` to `an object`
!Remove support for `contract_line_details`, `contract_value_details`, and `license_quantities` on `V2.Billing.Contract`
!Remove support for `contract_billing_details` on `V2.Billing.Contract.billing_settings` and `V2.Billing.ContractCreateParams.billing_settings`
!Remove support for value `storer` from enums `V2.Core.Account.applied_configurations`, `V2.Core.AccountCloseParams.applied_configurations`, and `V2.Core.AccountListParams.applied_configurations`
!Remove support for `consumer_storer` on `V2.Core.Account.identity.attestations.terms_of_service`, `V2.Core.AccountCreateParams.identity.attestations.terms_of_service`, and `V2.Core.AccountUpdateParams.identity.attestations.terms_of_service`
!Remove support for `crypto_storer` on `V2.Core.Account.identity.attestations.terms_of_service`, `V2.Core.AccountCreateParams.identity.attestations.terms_of_service`, and `V2.Core.AccountTokenCreateParams.identity.attestations.terms_of_service`
+Add support for new resources `V2.Billing.ContractPricingLineQuantityChange`, `V2.Core.Health.AlertHistoryEntry`, `V2.Core.Health.Alert`, `V2.MoneyManagement.FinancialAddressDebitSimulation`, and `V2.MoneyManagement.PayoutIntent`
+Add support for `report_offer_acceptance` method on resource `Issuing.CreditUnderwritingRecord`
+Add support for `provisional_credit` test helper method on resource `Issuing.Dispute`
+Add support for `report_early_fraud_warning` method on resource `PaymentAttemptRecord`
+Add support for `search` method on resource `PaymentRecord`
-Remove support for `maximum_rps` on `V2.Core.BatchJobCreateParams` and `V2.Core.BatchJob`.
-Remove support for `swift_code` on `V2.MoneyManagement.FinancialAddress.credentials.us_bank_account`.
-Remove support for event notifications `V2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent` and `V2CoreAccountIncludingConfigurationStorerUpdatedEvent`.
+Add support for `redaction` on `Card`, `Charge`, `Checkout.Session`, and other resources.
+Add support for `disclaimer_variant` on `Capital.FinancingOffer` and `Capital.FinancingSummary.details`.
+Add support for `active` on `FinancialConnections.Account.status_details` and `FinancialConnections.Authorization.status_details`.
+Add support for `pause` on `InvoiceCreatePreviewParams.subscription_details`.
+Add support for `release_details` on `Reserve.Hold`.
Changed type of `PaymentAttemptRecord.processor_details.type` and `PaymentRecord.processor_details.type` from `literal('custom')` to `enum('custom'|'fiserv_valuelink'|'givex'|'svs')`
-Removed support for `liquid_asset` on `PaymentIntentConfirmParams.payment_method_options.card.payment_details.money_services.account_funding` and related params
-Changed type of `V2.Core.FeeBatch.adjustments.tax_adjustment` from `amount` to `an object`
-Changed type of `V2.Core.FeeBatch.amount`, `V2.Core.FeeBatch.collection_records[].amount`, and related fields from `amount` to `an object`
!Removed support for `reauthorization` and `reauthorize_before` on `PaymentIntent.advanced_feature_details`
+Support for new resources `GiftCardOperation`, `GiftCard`, and `TaxFund`
+Added `retrieve` method for `GiftCardOperation`
+Support for `activate`, `cashout`, `check_balance`, `create`, `reload`, `retrieve`, and `void_operation` methods on `GiftCard`
+Added `list` and `retrieve` methods for `TaxFund`
+Support for `update_crypto_refund_address` method on `PaymentIntent`