what stackpulse tracks
Stripe Node releases from GitHub
StackPulse watches Stripe Node release notes and keeps the original source link close to every summary.
#stacks/stripe-node/library
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.
releases
12
breaking
9
security
0
deprecated
2
migrations
0
upgrade risk
Breaking changes and deprecations
Risky changes are separated from normal feature notes so you can scan upgrade impact before changing production dependencies.
migration notes
Source-backed next steps
Migration steps and recommended actions are only shown when the upstream release notes support them.
# latest_releases
source-backedv22.4.0-alpha.1highbreakingdeprecationfeatureprereleaseJun 24, 2026
v22.4.0-alpha.1
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`
-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`
v22.4.0-beta.1highbreakingfeatureprereleaseJun 24, 2026
v22.4.0-beta.1
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.
-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`.
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
-Remove support for crypto_storer and storer on V2.Core.AccountUpdateParams.identity.attestations.terms_of_service
-Change PaymentRecordReportRefundParams.refunded to be optional
+Add support for release_details on Reserve.Hold
+Add support for fingerprint on Charge.payment_method_details.pix and related objects
+Add support for sunbit on Checkout.Session.payment_method_options and related objects
+Add support for billing_cycle_anchor_config on Checkout.SessionCreateParams.subscription_data
+Add support for custom_fields, description, and footer on Subscription.invoice_settings
v22.2.3mediumfeatureJun 22, 2026
v22.2.3
This release includes a fix for URI path parameter encoding in the accounts.retrieve method.
affected
Users utilizing the accounts.retrieve method may be affected by the URI encoding fix.
action
Update to v22.2.3 if you rely on the accounts.retrieve method.
v22.2.2mediumfeatureJun 18, 2026
v22.2.2
This release focuses on fixing type-related issues in the Stripe Node library, including CJS type exports and incorrect usage of `Stripe.ErrorType.StripeError`. It also addresses shadowed namespaces.
affected
Developers using the Stripe Node library may encounter fixes for type-related issues.
action
Update to v22.2.2 to benefit from the fixes.
v22.3.0-alpha.4highbreakingfeatureprereleaseJun 17, 2026
v22.3.0-alpha.4
Updated generated code for private-preview with new payment method support and several breaking changes.
affected
Developers using removed fields or payment methods will need to update their code.
action
Review breaking changes and update implementations using removed fields or changed enums.
release_signals
-Remove support for `processed_transaction_type` on `Charge.payment_method_details.card.account_funding`
-Remove support for `brand` on `Checkout.Session.current_attempt.payment_method_details.card`
-Remove support for `first6` on gift card related objects
-Remove support for `beneficiary_account` and `beneficiary_details` on money services account funding
-Remove support for `wallet` on payment method options
+Add support for `retrieve` method on resource `Radar.CustomerEvaluation`
+Add support for `tamara` payment method across multiple resources
+Add support for `items` on `Checkout.SessionCreateParams`
+Add support for `fingerprint` on `GiftCard`
+Add support for `blik` on `Mandate.payment_method_details`
v22.2.1mediumfeatureJun 12, 2026
v22.2.1
This release includes fixes for URI encoding of path parameters, improved handling of empty pages in V2ListIterator, and enhancements to the user-agent header.
affected
Developers using path parameters or V2ListIterator may be affected by the fixes.
action
Update to the latest version to benefit from the fixes and enhancements.
release_signals
+Added 'source' field to user-agent header
v22.3.0-alpha.3highbreakingdeprecationfeatureprereleaseJun 10, 2026
v22.3.0-alpha.3
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`
-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`
v22.3.0-alpha.2mediumbreakingfeatureprereleaseJun 3, 2026
v22.3.0-alpha.2
This alpha release introduces support for new resources and methods, including DelegatedCheckout.OrderEvent, V2.Billing.Contract, and V2.Signals.AccountSignal. It also adds new enum values and modifies existing types, such as changes to transaction_type fields.
affected
Developers using the Stripe Node library, particularly those working with DelegatedCheckout, V2.Billing, and V2.Signals resources, will be affected by these changes.
action
Review the changelog and update your code to accommodate the new features and breaking changes.
release_signals
-Removed support for `payment_details` on `PaymentIntentCreateParams.payments_orchestration`
-Changed `Radar.IssuingAuthorizationEvaluationCreateParams.card_details.last4` to be required
-Changed type of `PaymentIntent.payment_details.money_services.transaction_type` from `literal('account_funding')` to `enum('account_funding'|'debt_repayment')`
+Support for new resources: DelegatedCheckout.OrderEvent, DelegatedCheckout.Order, V2.Billing.ContractLicensePricingQuantityChange, V2.Billing.Contract, and V2.Signals.AccountSignal
+Added `retrieve` method for DelegatedCheckout.Order
+Added `list_orders` method for DelegatedCheckout.RequestedSession
+Added `list` and `retrieve` methods for V2.Signals.AccountSignal
+Added `activate`, `cancel`, `create`, `list`, `retrieve`, and `update` methods for V2.Billing.Contract
v22.3.0-alpha.1highbreakingfeatureprereleaseMay 27, 2026
v22.3.0-alpha.1
This release updates the API version to 2026-05-27.private and introduces several changes to the Stripe Node library, including new enum types, required fields, and support for additional payment methods.
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 new enum types and removed fields.
release_signals
-Change type of `Billing.Alert.spend_threshold.group_by` from `literal('pricing_plan_subscription')` to `enum('billing_cadence'|'pricing_plan_subscription')`
-Remove support for `login_failed`, `registration_failed`, `registration_success`, and `type` on `Radar.CustomerEvaluationUpdateParams`
-Remove support for `latest_version` on `V2.Billing.LicenseFee`, `V2.Billing.PricingPlan`, and `V2.Billing.RateCard`
-Remove support for `service_interval_count` and `service_interval` on `V2.Billing.LicenseFee` and `V2.Billing.RateCard`
+Add support for `wechat_pay` on various invoice and subscription payment settings
+Add support for `gift_card` on PaymentIntent payment method options
+Add support for `debit_agreement` on V2.MoneyManagement.ReceivedCredit.stripe_balance_payment
+Add support for new value `chaps` on enum V2.FinancialAddressCreditSimulationCreditParams.network
+Add support for snapshot event `PaymentIntentExpiredEvent` with resource `PaymentIntent`
v22.3.0-beta.1highbreakingfeatureprereleaseMay 27, 2026
v22.3.0-beta.1
This beta release updates the API version to 2026-05-27.private and introduces several new features and breaking changes, including support for new payment methods and enum values.
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 breaking changes and leverage new features.
release_signals
-Change type of `ProductCatalog.TrialOffer.end_behavior.transition.price` from `string` to `expandable(Price)`
-Change `SharedPayment.GrantedToken.agent_details` to be required
-Change type of `SubscriptionItem.billed_until` from `DateTime | null` to `DateTime`
-Change `Subscription.billing_schedules` to be required
-Change type of `V2.MoneyManagement.ReceivedCredit.bank_transfer.gb_bank_account.network` from `literal('fps')` to `enum('chaps'|'fps')`
+Add support for `pause` method on resource `Subscription`
+Add support for `retrieve` method on resource `V2.Iam.ActivityLog`
+Add support for `amount_paid_off_stripe` on `QuotePreviewInvoice`
+Add support for `payment_behavior` on `SubscriptionResumeParams`
+Add support for `status_details` on `Subscription`
v22.2.0highbreakingfeatureMay 27, 2026
v22.2.0
This release updates the Stripe API version to 2026-05-27.dahlia and introduces several new features and enhancements, including support for new payment methods and resources.
affected
Developers using the Stripe Node library and integrating with the Stripe API are affected by these changes.
action
Update to the latest version of the Stripe Node library to take advantage of new features and ensure compatibility with the latest API changes.
release_signals
-Change type of `Checkout.Session.payment_method_options.twint.setup_future_usage` and `PaymentIntent.payment_method_options.twint.setup_future_usage` from `literal('none')` to `enum('none'|'off_session')`
-Add support for new values `bizum` and `scalapay` on enums `ConfirmationToken.payment_method_preview.type` and `PaymentMethod.type`
-Add support for new value `twint` on enums `Invoice.payment_settings.payment_method_types` and `Subscription.payment_settings.payment_method_types`
-Add support for new values `bizum` and `scalapay` on enums `PaymentIntent.excluded_payment_method_types` and `SetupIntent.excluded_payment_method_types`
-Add support for new value `bizum` on enum `PaymentLink.payment_method_types`
+Add support for new resource `V2.Commerce.ProductCatalogImport`
+Add support for `bizum_payments` and `scalapay_payments` on `Account.capabilities`
+Add support for `automatic_transfer_rules_by_currency` on `BalanceSettingUpdateParams.payments.payouts`
+Add support for `start_of_day` on `BalanceSettingUpdateParams.payments.settlement_timing`
+Add support for `description` on `ChargeCreateParams.transfer_data`