fix(deps): update dependency stripe to v22 - #13
Conversation
|
Review the following changes in direct dependencies. Learn more about Socket for GitHub.
|
24041e3 to
8b53a66
Compare
8b53a66 to
fde5b39
Compare
fde5b39 to
91b0710
Compare
91b0710 to
c612e50
Compare
c612e50 to
26ae95d
Compare
26ae95d to
5daf41e
Compare
jinhongliang991013
left a comment
There was a problem hiding this comment.
Reviewed the Stripe 18-to-22 upgrade against the locked dependency versions and the repository TypeScript configuration. The current source no longer type-checks after this bump.
| "jspdf": "^3.0.1", | ||
| "resend": "^4.0.0", | ||
| "stripe": "^18.1.0" | ||
| "stripe": "^22.0.0" |
There was a problem hiding this comment.
This major upgrade is not type-compatible with the current Stripe wrapper. I installed the lockfile versions and ran npx tsc --noEmit: the base lock (stripe@18.1.0) passes, while this PR's stripe@22.2.1 fails in src/stripe.ts because apiVersion: '2025-04-30.basil' is no longer assignable to Stripe 22's '2026-05-27.dahlia'; it also introduces Cannot use namespace 'Stripe' as a type and an implicit-any error in the charge mapper. The repository's build script only echoes a message, so CI does not catch this. Please migrate the Stripe initialization/types and API version in the same PR, and add a real typecheck, before merging the dependency bump.
890d599 to
4172d74
Compare
There was a problem hiding this comment.
Stale comment
Risk: high. Not approving this major Stripe v18→v22 dependency bump, which exceeds the low-risk threshold and needs billing code migration alongside the version change. Cursor Bugbot was not present on this PR; assigned riderx for human review.
Sent by Cursor Approval Agent: Pull Request Approver External
4172d74 to
180f437
Compare
180f437 to
e55a23d
Compare
e55a23d to
af85255
Compare
af85255 to
92ebd2c
Compare


This PR contains the following updates:
^18.1.0→^22.0.0Release Notes
stripe/stripe-node (stripe)
v22.5.0Compare Source
#2805 Emit Claude Code plugin hint at module load time
CLAUDECODEorCLAUDE_CODE_CHILD_SESSIONenvironment variables are detected.#2794 add/adjust event parsing helpers
Event/EventNotificationobjects without verifying authenticity. Use them when you've previously verified an event (e.g. you verified, put the event in a queue, and are now processing). Supports events from AWS EventBridge and Azure Event Grid natively.stripe.webhooks.constructEventWithoutVerification(payload)stripe.constructEventWithoutVerification(payload)stripe.parseEventNotificationWithoutVerification(payload)#2799 Add
stripe.major_api_versionconstantv22.4.0Compare Source
This release changes the pinned API version to 2026-07-29.dahlia.
FinancialConnections.Authorizationunrejectmethod on resourceAccountlistmethod on resourcePaymentRecordadministrative_addressandprincipal_place_of_businessonAccount.company,AccountCreateParams.company,AccountUpdateParams.company, andTokenCreateParams.account.companysepa_debit_paymentsonAccountUpdateParams.settingsproof_of_registrationonAccountCreateParams.documents. This field was limited-use and is being deprecated.payouts_actiononAccountRejectParamsmass_transit_parking_taxandparking_taxon enumsTax.Calculation.shipping_cost.tax_breakdown[].tax_rate_details.tax_type,Tax.Calculation.tax_breakdown[].tax_rate_details.tax_type,Tax.CalculationLineItem.tax_breakdown[].tax_rate_details.tax_type, andTax.Transaction.shipping_cost.tax_breakdown[].tax_rate_details.tax_typechapson enumsFundingInstructions.bank_transfer.financial_addresses[].supported_networksandPaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].supported_networkssmart_disputes_managementonAccountSession.components.disputes_list.features,AccountSession.components.payment_details.features,AccountSession.components.payment_disputes.features,AccountSession.components.payments.features,AccountSessionCreateParams.components.disputes_list.features,AccountSessionCreateParams.components.payment_details.features,AccountSessionCreateParams.components.payment_disputes.features, andAccountSessionCreateParams.components.payments.featuresdata_share_onlyon enumsCharge.payment_method_details.card.three_d_secure.result,PaymentAttemptRecord.payment_method_details.card.three_d_secure.result,PaymentRecord.payment_method_details.card.three_d_secure.result, andSetupAttempt.payment_method_details.card.three_d_secure.resultbnp_paribas,citibank, andmbsb_bankon enumsCharge.payment_method_details.fpx.bank,ConfirmationToken.payment_method_preview.fpx.bank,PaymentAttemptRecord.payment_method_details.fpx.bank,PaymentMethod.fpx.bank, andPaymentRecord.payment_method_details.fpx.bankdynamic_tax_ratesonCheckout.SessionCreateParams.line_items[]. This field was limited-use and is being deprecated.setup_future_usageonCheckout.Session.payment_method_options.payco,Checkout.Session.payment_method_options.samsung_pay,Checkout.SessionCreateParams.payment_method_options.payco,Checkout.SessionCreateParams.payment_method_options.samsung_pay,PaymentIntent.payment_method_options.payco,PaymentIntent.payment_method_options.samsung_pay,PaymentIntentConfirmParams.payment_method_options.payco,PaymentIntentConfirmParams.payment_method_options.samsung_pay,PaymentIntentCreateParams.payment_method_options.payco,PaymentIntentCreateParams.payment_method_options.samsung_pay,PaymentIntentUpdateParams.payment_method_options.payco,PaymentIntentUpdateParams.payment_method_options.samsung_pay, andPaymentLinkUpdateParams.payment_intent_dataic_nifon enumsCheckout.Session.customer_details.tax_ids[].type,Invoice.customer_tax_ids[].type,Tax.Calculation.customer_details.tax_ids[].type,Tax.Transaction.customer_details.tax_ids[].type, andTaxId.typebnp_paribas,citibank, andmbsb_bankon enumsConfirmationTokenCreateParams.testHelpers.payment_method_data.fpx.bank,PaymentIntentConfirmParams.payment_method_data.fpx.bank,PaymentIntentCreateParams.payment_method_data.fpx.bank,PaymentIntentUpdateParams.payment_method_data.fpx.bank,PaymentMethodCreateParams.fpx.bank,SetupIntentConfirmParams.payment_method_data.fpx.bank,SetupIntentCreateParams.payment_method_data.fpx.bank, andSetupIntentUpdateParams.payment_method_data.fpx.bankic_nifon enumsCustomerCreateParams.tax_id_data[].type,CustomerCreateTaxIdParams.type,InvoiceCreatePreviewParams.customer_details.tax_ids[].type,Tax.CalculationCreateParams.customer_details.tax_ids[].type, andTaxIdCreateParams.typenetworkonDispute.payment_method_details.cardfinancial_connections.account.expected_deactivation_date_updated,financial_connections.account.supported_payment_method_types_updated,financial_connections.account.upcoming_deactivation,financial_connections.authorization.expected_deactivation_date_updated, andfinancial_connections.authorization.upcoming_deactivationon enumEvent.typelimitsandmanual_entryonFinancialConnections.SessionCreateParamsandFinancialConnections.Sessionrequire_payment_method_supportonFinancialConnections.Session.filtersandFinancialConnections.SessionCreateParams.filtersbank_account_tokenonFinancialConnections.Sessionalipayandmb_wayon enumsInvoice.payment_settings.payment_method_types,InvoiceCreateParams.payment_settings.payment_method_types,InvoiceUpdateParams.payment_settings.payment_method_types,Subscription.payment_settings.payment_method_types,SubscriptionCreateParams.payment_settings.payment_method_types, andSubscriptionUpdateParams.payment_settings.payment_method_typesmass_transit_parking_taxandparking_taxon enumsInvoiceAddLinesParams.lines[].tax_amounts[].tax_rate_data.tax_type,InvoiceLineItemUpdateParams.tax_amounts[].tax_rate_data.tax_type,InvoiceUpdateLinesParams.lines[].tax_amounts[].tax_rate_data.tax_type,TaxRate.tax_type,TaxRateCreateParams.tax_type, andTaxRateUpdateParams.tax_typemetadataonInvoiceCreatePreviewParams.subscription_detailsstripe_internal_erroron enumIssuing.Authorization.request_history[].reasonbusiness_nameonIssuing.Card.shipping,Issuing.CardCreateParams.shipping, andIssuing.CardUpdateParams.shippingcorreoson enumIssuing.Card.shipping.carrierallowed_payment_method_typesonPaymentIntentConfirmParams,PaymentIntentCreateParams,PaymentIntentUpdateParams,PaymentIntent,SetupIntentConfirmParams,SetupIntentCreateParams,SetupIntentUpdateParams, andSetupIntentreferreronPaymentIntentConfirmParams.radar_optionsandPaymentIntentCreateParams.radar_optionsconsent_collectionandshipping_optionsonPaymentLinkUpdateParamscustom_fields,description, andfooteronQuote.invoice_settings,QuoteCreateParams.invoice_settings,QuoteUpdateParams.invoice_settings,SubscriptionSchedule.default_settings.invoice_settings,SubscriptionSchedule.phases[].invoice_settings,SubscriptionScheduleCreateParams.default_settings.invoice_settings,SubscriptionScheduleCreateParams.phases[].invoice_settings,SubscriptionScheduleUpdateParams.default_settings.invoice_settings, andSubscriptionScheduleUpdateParams.phases[].invoice_settingscustomer_accountandcustomeronRefundpayment_methodonRefundandTopuptrialonSubscriptionSchedule.phases[]mass_transit_parking_taxandparking_taxonTax.Registration.country_options.usandTax.RegistrationCreateParams.country_options.usmass_transit_parking_taxandparking_taxon enumTax.RegistrationCreateParams.country_options.us.typemass_transit_parking_taxandparking_taxon enumTax.Registration.country_options.us.typeinitiated_byandpayment_method_optionsonTopupfinancial_connections.account.expected_deactivation_date_updated,financial_connections.account.supported_payment_method_types_updated,financial_connections.account.upcoming_deactivation,financial_connections.authorization.expected_deactivation_date_updated, andfinancial_connections.authorization.upcoming_deactivationon enumsWebhookEndpointCreateParams.enabled_eventsandWebhookEndpointUpdateParams.enabled_events2026-07-29.dahliaon enumWebhookEndpointCreateParams.api_versionadditional_addressesonV2.Core.Account.identity.business_details,V2.Core.AccountCreateParams.identity.business_details,V2.Core.AccountTokenCreateParams.identity.business_details, andV2.Core.AccountUpdateParams.identity.business_detailsFinancialConnectionsAccountExpectedDeactivationDateUpdatedEvent,FinancialConnectionsAccountSupportedPaymentMethodTypesUpdatedEvent, andFinancialConnectionsAccountUpcomingDeactivationEventwith resourceFinancialConnections.AccountFinancialConnectionsAuthorizationExpectedDeactivationDateUpdatedEventandFinancialConnectionsAuthorizationUpcomingDeactivationEventwith resourceFinancialConnections.Authorizationv22.3.2Compare Source
v22.3.1Compare Source
Stripe.HttpClientandStripe.HttpClientResponsetypes now reflect the minimal interface contract rather than the concrete class, making custom HTTP client implementations easier to type correctly.Stripe.StripeConfig,Stripe.CryptoProvider,Stripe.HttpClient,Stripe.HttpClientResponse,Stripe.Webhooks,Stripe.Signature,Stripe.WebhookTestHeaderOptions,Stripe.StripeResource,Stripe.LatestApiVersion,Stripe.HttpAgent,Stripe.HttpProtocol, andStripe.RawErrorTypetype exports that were inadvertently dropped in the v22 type system migration.v22.3.0Compare Source
This release changes the pinned API version to 2026-06-24.dahlia.
#2748 Update generated code
release_detailsonReserve.Holdtax_fundon enumBalanceTransaction.typeBilling.CreditGrant.priorityto be requiredbuyer_idonCharge.payment_method_details.bizum,ConfirmationToken.payment_method_preview.bizum,ConfirmationToken.payment_method_preview.blik,PaymentAttemptRecord.payment_method_details.bizum,PaymentMethod.bizum,PaymentMethod.blik, andPaymentRecord.payment_method_details.bizumtransaction_link_idonCharge.payment_method_details.cardsuion enumsCharge.payment_method_details.crypto.network,PaymentAttemptRecord.payment_method_details.crypto.network, andPaymentRecord.payment_method_details.crypto.networkusdsuion enumsCharge.payment_method_details.crypto.token_currency,PaymentAttemptRecord.payment_method_details.crypto.token_currency, andPaymentRecord.payment_method_details.crypto.token_currencyfingerprintonCharge.payment_method_details.pix,ConfirmationToken.payment_method_preview.pix,PaymentMethod.pix, andSetupAttempt.payment_method_details.pixsunbitonCheckout.Session.payment_method_options,Checkout.SessionCreateParams.payment_method_options,PaymentIntent.payment_method_options,PaymentIntentConfirmParams.payment_method_options,PaymentIntentCreateParams.payment_method_options, andPaymentIntentUpdateParams.payment_method_optionsbilling_cycle_anchor_configonCheckout.SessionCreateParams.subscription_datawechat_payonCheckout.Session.payment_method_optionsmastercard_complianceonDispute.evidence.enhanced_evidence,Dispute.evidence_details.enhanced_eligibility, andDisputeUpdateParams.evidence.enhanced_evidencemastercard_complianceon enumDispute.enhanced_eligibility_typesstatus_detailsonFinancialConnections.Accountvalidatedon enumIdentity.VerificationSession.redaction.statussatispayon enumsInvoiceCreateParams.payment_settings.payment_method_types,InvoiceUpdateParams.payment_settings.payment_method_types,SubscriptionCreateParams.payment_settings.payment_method_types, andSubscriptionUpdateParams.payment_settings.payment_method_typessatispayon enumsInvoice.payment_settings.payment_method_typesandSubscription.payment_settings.payment_method_typesstored_credential_usageonPaymentAttemptRecord.payment_method_details.cardandPaymentRecord.payment_method_details.cardPaymentAttemptRecord.payment_method_details.card.descriptionandPaymentRecord.payment_method_details.card.descriptionto be optionalPaymentAttemptRecord.payment_method_details.card.iinandPaymentRecord.payment_method_details.card.iinto be optionalPaymentAttemptRecord.payment_method_details.card.issuerandPaymentRecord.payment_method_details.card.issuerto be optionalsetup_future_usageonPaymentIntent.payment_method_options.satispay,PaymentIntentConfirmParams.payment_method_options.satispay,PaymentIntentCreateParams.payment_method_options.satispay, andPaymentIntentUpdateParams.payment_method_options.satispayPaymentRecordReportRefundParams.refundedto be optionalsatispayonSetupAttempt.payment_method_detailscustom_fields,description, andfooteronSubscription.invoice_settings,SubscriptionCreateParams.invoice_settings, andSubscriptionUpdateParams.invoice_settingspayment_method_optionsandpayment_methodonTopupCreateParams2026-06-24.dahliaon enumWebhookEndpointCreateParams.api_versionmodeonV2.Commerce.ProductCatalogImportpromotionon enumV2.Commerce.ProductCatalogImport.feed_typesunbit_paymentsonV2.Core.Account.configuration.merchant.capabilities,V2.Core.AccountCreateParams.configuration.merchant.capabilities, andV2.Core.AccountUpdateParams.configuration.merchant.capabilitiescrypto_money_managerandmoney_manageronV2.Core.AccountUpdateParams.identity.attestations.terms_of_servicecrypto_storerandstoreronV2.Core.AccountUpdateParams.identity.attestations.terms_of_servicepromotionon enumV2.Commerce.ProductCatalogImportCreateParams.feed_typesunbit_paymentson enumEventsV2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent.updated_capabilityanomalous_money_movement_request,failed_tax_calculation,financial_account_balance_does_not_support_currency,financial_account_capability_not_enabled, andfinancial_account_capability_restrictedonInvoice.last_finalization_error,PaymentIntent.last_payment_error,SetupAttempt.setup_error,SetupIntent.last_setup_error,StripeError, andTerminal.Reader.action.api_error#2765 fix: CJS companion namespace access for resource types at all depths
Stripe.Price.Recurring,Stripe.Subscription.BillingMode)Stripe.Billing.Alert.Status,Stripe.Terminal.Configuration.Tippingin both ESM and CJS modes.v22.2.3Compare Source
accounts.retrievev22.2.2Compare Source
Stripe.ErrorType.StripeErrorincorrectly being usable as a runtime class (reported in #2661)v22.2.1Compare Source
v22.2.0Compare Source
This release changes the pinned API version to 2026-05-27.dahlia.
V2.Commerce.ProductCatalogImportcreateandretrievemethods on resourceV2.Commerce.ProductCatalogImportbizum_paymentsandscalapay_paymentsonAccount.capabilities,AccountCreateParams.capabilities, andAccountUpdateParams.capabilitiesautomatic_transfer_rules_by_currencyonBalanceSettingUpdateParams.payments.payoutsandBalanceSettings.payments.payoutsstart_of_dayonBalanceSettingUpdateParams.payments.settlement_timingandBalanceSettings.payments.settlement_timingdescriptiononChargeCreateParams.transfer_data,PaymentIntent.transfer_data,PaymentIntentCreateParams.transfer_data, andPaymentIntentUpdateParams.transfer_databizumonCharge.payment_method_details,ConfirmationToken.payment_method_preview,ConfirmationTokenCreateParams.testHelpers.payment_method_data,PaymentAttemptRecord.payment_method_details,PaymentIntent.payment_method_options,PaymentIntentConfirmParams.payment_method_data,PaymentIntentConfirmParams.payment_method_options,PaymentIntentCreateParams.payment_method_data,PaymentIntentCreateParams.payment_method_options,PaymentIntentUpdateParams.payment_method_data,PaymentIntentUpdateParams.payment_method_options,PaymentMethodConfigurationCreateParams,PaymentMethodConfigurationUpdateParams,PaymentMethodConfiguration,PaymentMethodCreateParams,PaymentMethod,PaymentRecord.payment_method_details,SetupIntent.payment_method_options,SetupIntentConfirmParams.payment_method_data,SetupIntentConfirmParams.payment_method_options,SetupIntentCreateParams.payment_method_data,SetupIntentCreateParams.payment_method_options,SetupIntentUpdateParams.payment_method_data, andSetupIntentUpdateParams.payment_method_optionsscalapayonCharge.payment_method_details,Checkout.Session.payment_method_options,Checkout.SessionCreateParams.payment_method_options,ConfirmationToken.payment_method_preview,ConfirmationTokenCreateParams.testHelpers.payment_method_data,PaymentAttemptRecord.payment_method_details,PaymentIntent.payment_method_options,PaymentIntentConfirmParams.payment_method_data,PaymentIntentConfirmParams.payment_method_options,PaymentIntentCreateParams.payment_method_data,PaymentIntentCreateParams.payment_method_options,PaymentIntentUpdateParams.payment_method_data,PaymentIntentUpdateParams.payment_method_options,PaymentMethodConfigurationCreateParams,PaymentMethodConfigurationUpdateParams,PaymentMethodConfiguration,PaymentMethodCreateParams,PaymentMethod,PaymentRecord.payment_method_details,Refund.destination_details,SetupIntentConfirmParams.payment_method_data,SetupIntentCreateParams.payment_method_data, andSetupIntentUpdateParams.payment_method_datamandateonCharge.payment_method_details.twint,PaymentAttemptRecord.payment_method_details.twint, andPaymentRecord.payment_method_details.twintbizumandscalapayon enumsCheckout.SessionCreateParams.excluded_payment_method_types,PaymentIntentConfirmParams.excluded_payment_method_types,PaymentIntentCreateParams.excluded_payment_method_types,PaymentIntentUpdateParams.excluded_payment_method_types,SetupIntentCreateParams.excluded_payment_method_types, andSetupIntentUpdateParams.excluded_payment_method_typesCheckout.SessionCreateParams.payment_method_options.twint.setup_future_usage,PaymentIntentConfirmParams.payment_method_options.twint.setup_future_usage,PaymentIntentCreateParams.payment_method_options.twint.setup_future_usage, andPaymentIntentUpdateParams.payment_method_options.twint.setup_future_usagefromliteral('none')toenum('none'|'off_session')bizumandscalapayon enumCheckout.SessionCreateParams.payment_method_typesCheckout.Session.payment_method_options.twint.setup_future_usageandPaymentIntent.payment_method_options.twint.setup_future_usagefromliteral('none')toenum('none'|'off_session')bizumandscalapayon enumsConfirmationTokenCreateParams.testHelpers.payment_method_data.type,PaymentIntentConfirmParams.payment_method_data.type,PaymentIntentCreateParams.payment_method_data.type,PaymentIntentUpdateParams.payment_method_data.type,SetupIntentConfirmParams.payment_method_data.type,SetupIntentCreateParams.payment_method_data.type, andSetupIntentUpdateParams.payment_method_data.typebizumandscalapayon enumsConfirmationToken.payment_method_preview.typeandPaymentMethod.typebizumandscalapayon enumsCustomerListPaymentMethodsParams.type,PaymentMethodCreateParams.type, andPaymentMethodListParams.typecredited_itemsonInvoiceItem.proration_detailstwinton enumsInvoiceCreateParams.payment_settings.payment_method_types,InvoiceUpdateParams.payment_settings.payment_method_types,SubscriptionCreateParams.payment_settings.payment_method_types, andSubscriptionUpdateParams.payment_settings.payment_method_typesdiscountableonInvoiceCreatePreviewParams.schedule_details.phases[].add_invoice_items[],SubscriptionCreateParams.add_invoice_items[],SubscriptionSchedule.phases[].add_invoice_items[],SubscriptionScheduleCreateParams.phases[].add_invoice_items[],SubscriptionScheduleUpdateParams.phases[].add_invoice_items[], andSubscriptionUpdateParams.add_invoice_items[]billing_schedulesonInvoiceCreatePreviewParams.subscription_details,SubscriptionCreateParams,SubscriptionUpdateParams, andSubscriptionmax_billed_untilon enumsInvoiceCreatePreviewParams.subscription_details.cancel_at,SubscriptionCreateParams.cancel_at, andSubscriptionUpdateParams.cancel_atamount_paid_off_stripeonInvoicetwinton enumsInvoice.payment_settings.payment_method_typesandSubscription.payment_settings.payment_method_typestwintonMandate.payment_method_detailsandSetupAttempt.payment_method_detailsmetadataonPaymentIntent.transfer_data,PaymentIntentCreateParams.transfer_data,PaymentIntentUpdateParams.transfer_data, andSubscription.pending_updatepayment_dataonPaymentIntent.transfer_data,PaymentIntentCreateParams.transfer_data, andPaymentIntentUpdateParams.transfer_databizumandscalapayon enumsPaymentIntent.excluded_payment_method_typesandSetupIntent.excluded_payment_method_typesblik_authorizeonPaymentIntent.next_actionandSetupIntent.next_actionpayment_method_optionsonPaymentLinkCreateParams,PaymentLinkUpdateParams, andPaymentLinkbizumon enumsPaymentLinkCreateParams.payment_method_typesandPaymentLinkUpdateParams.payment_method_typesbizumon enumPaymentLink.payment_method_typesactiveonPaymentMethodConfigurationListParamsbilled_untilonSubscriptionItemdiscountanddiscountsonSubscription.pending_updateverifone_m425,verifone_p630,verifone_ux700, andverifone_v660ponTerminal.ConfigurationCreateParams,Terminal.ConfigurationUpdateParams, andTerminal.Configurationsimulated_verifone_m425,simulated_verifone_p630,simulated_verifone_ux700,simulated_verifone_v660p,verifone_m425,verifone_p630,verifone_ux700, andverifone_v660pon enumTerminal.ReaderListParams.device_typeapi_errorandprint_contentonTerminal.Reader.actionprint_contenton enumTerminal.Reader.action.typesimulated_verifone_m425,simulated_verifone_p630,simulated_verifone_ux700,simulated_verifone_v660p,verifone_m425,verifone_p630,verifone_ux700, andverifone_v660pon enumTerminal.Reader.device_typecustomeronTestHelpers.TestClockCreateParams2026-05-27.dahliaon enumWebhookEndpointCreateParams.api_versionsigneronV2.Core.Account.identity.business_details.documents.proof_of_registration,V2.Core.Account.identity.business_details.documents.proof_of_ultimate_beneficial_ownership,V2.Core.AccountCreateParams.identity.business_details.documents.proof_of_registration,V2.Core.AccountCreateParams.identity.business_details.documents.proof_of_ultimate_beneficial_ownership,V2.Core.AccountTokenCreateParams.identity.business_details.documents.proof_of_registration,V2.Core.AccountTokenCreateParams.identity.business_details.documents.proof_of_ultimate_beneficial_ownership,V2.Core.AccountUpdateParams.identity.business_details.documents.proof_of_registration, andV2.Core.AccountUpdateParams.identity.business_details.documents.proof_of_ultimate_beneficial_ownershipazure_event_gridonV2.Core.EventDestinationCreateParamsandV2.Core.EventDestinationno_azure_partner_topic_existson enumV2.Core.EventDestination.status_details.disabled.reasonazure_event_gridon enumV2.Core.EventDestination.typeazure_event_gridon enumV2.Core.EventDestinationCreateParams.typemeter_event_value_too_many_digitson enumsEventsV1BillingMeterErrorReportTriggeredEvent.reason.error_types[].codeandEventsV1BillingMeterNoMeterFoundEvent.reason.error_types[].codeV2CommerceProductCatalogImportsFailedEvent,V2CommerceProductCatalogImportsProcessingEvent,V2CommerceProductCatalogImportsSucceededEvent, andV2CommerceProductCatalogImportsSucceededWithErrorsEventwith related objectV2.Commerce.ProductCatalogImportpayment_method_microdeposit_processing_errorandsiret_invalidonInvoice.last_finalization_error,PaymentIntent.last_payment_error,SetupAttempt.setup_error,SetupIntent.last_setup_error, andStripeErrorstripe-notifyheader is present in responseV2ListandV2ListPromisetypes to represent API v2 list responses. These types include deprecated fields from the previously returned list shapes. These fields will be removed in the next major release.Stripe.V2.Core.AccountCreateParams.Configuration,Stripe.V2.Core.AccountCreateParams.Dashboard) are now accessible.v22.1.1Compare Source
#2703 Export Decimal type from Stripe namespace
Stripe.Decimalas a usable type in theStripenamespace, enabling type annotations likefunction takesDecimal(d: Stripe.Decimal).#2704 Fix file upload regression: restore multipart request data processor
StripeInvalidRequestErroron the/v1/filesendpoint since v22.v22.1.0Compare Source
This release changes the pinned API version to 2026-04-22.dahlia.
app_distributionandsunbit_paymentsonAccount.capabilities,AccountCreateParams.capabilities, andAccountUpdateParams.capabilitiesbalance_reportandpayout_reconciliation_reportonAccountSession.componentsandAccountSessionCreateParams.componentsfee_credit_funding,inbound_transfer_reversal, andinbound_transferon enumBalanceTransaction.typesunbitonCharge.payment_method_details,ConfirmationToken.payment_method_preview,ConfirmationTokenCreateParams.testHelpers.payment_method_data,PaymentAttemptRecord.payment_method_details,PaymentIntentConfirmParams.payment_method_data,PaymentIntentCreateParams.payment_method_data,PaymentIntentUpdateParams.payment_method_data,PaymentMethodConfigurationCreateParams,PaymentMethodConfigurationUpdateParams,PaymentMethodConfiguration,PaymentMethodCreateParams,PaymentMethod,PaymentRecord.payment_method_details,SetupIntentConfirmParams.payment_method_data,SetupIntentCreateParams.payment_method_data, andSetupIntentUpdateParams.payment_method_dataphantom_cashandusdton enumsCharge.payment_method_details.crypto.token_currency,PaymentAttemptRecord.payment_method_details.crypto.token_currency, andPaymentRecord.payment_method_details.crypto.token_currencylocationandreaderonCharge.payment_method_details.klarna,PaymentAttemptRecord.payment_method_details.klarna, andPaymentRecord.payment_method_details.klarnamandateonCharge.payment_method_details.pix,PaymentAttemptRecord.payment_method_details.pix, andPaymentRecord.payment_method_details.pixmanaged_paymentsonCheckout.SessionCreateParams,Checkout.Session,PaymentIntent,PaymentLinkCreateParams,PaymentLink,SetupIntent, andSubscriptionsunbiton enumsCheckout.SessionCreateParams.excluded_payment_method_types,PaymentIntentConfirmParams.excluded_payment_method_types,PaymentIntentCreateParams.excluded_payment_method_types,PaymentIntentUpdateParams.excluded_payment_method_types,SetupIntentCreateParams.excluded_payment_method_types, andSetupIntentUpdateParams.excluded_payment_method_typesmandate_optionsonCheckout.Session.payment_method_options.pix,Checkout.SessionCreateParams.payment_method_options.pix,PaymentIntent.payment_method_options.pix,PaymentIntentConfirmParams.payment_method_options.pix,PaymentIntentCreateParams.payment_method_options.pix, andPaymentIntentUpdateParams.payment_method_options.pixCheckout.SessionCreateParams.payment_method_options.pix.setup_future_usage,PaymentIntentConfirmParams.payment_method_options.pix.setup_future_usage,PaymentIntentCreateParams.payment_method_options.pix.setup_future_usage, andPaymentIntentUpdateParams.payment_method_options.pix.setup_future_usagefromliteral('none')toenum('none'|'off_session')sunbiton enumCheckout.SessionCreateParams.payment_method_typesfo_vat,gi_tin,it_cf, andpy_rucon enumsCheckout.Session.customer_details.tax_ids[].type,Invoice.customer_tax_ids[].type,Tax.Calculation.customer_details.tax_ids[].type,Tax.Transaction.customer_details.tax_ids[].type, andTaxId.typeCheckout.Session.payment_method_options.pix.setup_future_usageandPaymentIntent.payment_method_options.pix.setup_future_usagefromliteral('none')toenum('none'|'off_session')sunbiton enumsConfirmationTokenCreateParams.testHelpers.payment_method_data.type,PaymentIntentConfirmParams.payment_method_data.type,PaymentIntentCreateParams.payment_method_data.type,PaymentIntentUpdateParams.payment_method_data.type,SetupIntentConfirmParams.payment_method_data.type,SetupIntentCreateParams.payment_method_data.type, andSetupIntentUpdateParams.payment_method_data.typesunbiton enumsConfirmationToken.payment_method_preview.typeandPaymentMethod.typefo_vat,gi_tin,it_cf, andpy_rucon enumsCustomerCreateParams.tax_id_data[].type,CustomerCreateTaxIdParams.type,InvoiceCreatePreviewParams.customer_details.tax_ids[].type,Tax.CalculationCreateParams.customer_details.tax_ids[].type, andTaxIdCreateParams.typesunbiton enumsCustomerListPaymentMethodsParams.type,PaymentMethodCreateParams.type, andPaymentMethodListParams.typepixonInvoice.payment_settings.payment_method_options,InvoiceCreateParams.payment_settings.payment_method_options,InvoiceUpdateParams.payment_settings.payment_method_options,Mandate.payment_method_details,SetupAttempt.payment_method_details,SetupIntent.payment_method_options,SetupIntentConfirmParams.payment_method_options,SetupIntentCreateParams.payment_method_options,SetupIntentUpdateParams.payment_method_options,Subscription.payment_settings.payment_method_options,SubscriptionCreateParams.payment_settings.payment_method_options, andSubscriptionUpdateParams.payment_settings.payment_method_optionsupionInvoice.payment_settings.payment_method_options,InvoiceCreateParams.payment_settings.payment_method_options,InvoiceUpdateParams.payment_settings.payment_method_options,Subscription.payment_settings.payment_method_options,SubscriptionCreateParams.payment_settings.payment_method_options, andSubscriptionUpdateParams.payment_settings.payment_method_optionspixandupion enumsInvoiceCreateParams.payment_settings.payment_method_types,InvoiceUpdateParams.payment_settings.payment_method_types,SubscriptionCreateParams.payment_settings.payment_method_types, andSubscriptionUpdateParams.payment_settings.payment_method_typespixandupion enumsInvoice.payment_settings.payment_method_typesandSubscription.payment_settings.payment_method_typescard_presenceonIssuing.Authorizationallowed_card_presencesandblocked_card_presencesonIssuing.Card.spending_controls,Issuing.CardCreateParams.spending_controls,Issuing.CardUpdateParams.spending_controls,Issuing.Cardholder.spending_controls,Issuing.CardholderCreateParams.spending_controls, andIssuing.CardholderUpdateParams.spending_controlsfulfillment_erroron enumIssuing.Card.cancellation_reasonfulfillment_erroron enumIssuing.Card.replacement_reasonamountandcurrencyonMandate.multi_useamount_to_confirmonPaymentIntentConfirmParamssunbiton enumsPaymentIntent.excluded_payment_method_typesandSetupIntent.excluded_payment_method_typesklarna_display_qr_codeonPaymentIntent.next_actionsunbiton enumsPaymentLinkCreateParams.payment_method_typesandPaymentLinkUpdateParams.payment_method_typessunbiton enumPaymentLink.payment_method_typeslow,not_assessed, andunknownon enumRadar.PaymentEvaluation.signals.fraudulent_payment.risk_levelaccounton enumRadar.ValueListCreateParams.item_typeaccounton enumRadar.ValueList.item_typemotoonSetupAttempt.payment_method_details.cardpix_display_qr_codeonSetupIntent.next_action2026-04-22.dahliaon enumWebhookEndpointCreateParams.api_versionaction_blockedandapproval_requiredonInvoice.last_finalization_error,PaymentIntent.last_payment_error,SetupAttempt.setup_error,SetupIntent.last_setup_error, andStripeErrorv22.0.2Compare Source
parseEventNotificationAsyncto match existing sync functionemitEventBodiesconfig option to include request and response bodies inrequest/responseevents.httpClientconfig type fromHttpClientclass toHttpClientInterfaceinterface.v22.0.1Compare Source
newkeyword is now possible for CJS based TypeScript project. Resolves: 2660Stripeconstructor config parameter to useStripeConfigtype instead ofRecord<string, unknown>, restoring compile-time type safety.authenticatorproperty toStripeConfig.Stripe.API_VERSIONto retain the literal API version type.StripeConfig.stripeContextto acceptStripeContextobjects in addition to strings.rawRequestwith absolute urlsstring[]toWebhookHeadertype for compatibility with expressstring[]to the type ofsignatureparam instripe.webhooks.construct_eventmethod.v22.0.0Compare Source
This release uses the same pinned API version to⚠️ below. There's also a detailed migration guide to simplify your upgrade process.
2026-03-25.dahliaas the last major release. The breaking changes in this release are prefixed withStripe.StripeContextis no longer exported as a type. UseStripe.StripeContextTypeinstead.Stripe.errors.StripeErroris no longer a type. Usetypeof Stripe.errors.StripeErrororStripe.ErrorTypeinstead.new Stripe()to create a StripeClient instead of calling it:#2645⚠️ Remove
stripeMethodand standardize how function args are handled (including removing callback support)async / awaitinsteadRequestOptionsunder theapiKeypropertyparamsandoptionsobjects are no longer mixed. If present on a method,RequestParamsmust always come first andRequestOptionsmust always come second. To supply options without params, passundefinedas the first argument explicitlyStripeResource:createFullPath,createResourcePathWithSymbols,extend,methodand_joinUrlParts. These were mostly intended for internal use and we no longer need themAs a result, the following call patterns are no longer supported:
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:
After:
#2619 Improved TypeScript support in the Node SDK
#2638 Converted V2/Amount.ts to V2/V2Amount.ts
#2635 Updated stripe.spec.ts test and constructEvent.tolerance type
v21.0.1Compare Source
v21.0.0Compare Source
This release changes the pinned API version to⚠️ below). There's also a detailed migration guide to simplify your upgrade process.
2026-03-25.dahliaand contains breaking changes (prefixed withPlease review details for the breaking changes and alternatives in the Stripe API changelog before upgrading.
decimal_stringfields changed type fromstringtoStripe.Decimalin both request params and response objects. Code that reads or writes these fields asstringwill need to useStripe.Decimalinstead (construct viaDecimal.from("1.23"), serialize via.toString()). Affected fields across v1 and v2 APIs:currency_conversion.fx_ratemetric_tons; Climate.Product:metric_tons_availableunit_amount_decimalquantity_decimal,unit_amount_decimalquantity_decimal,unit_amount_decimalquantity_decimal,unit_cost_decimal,gross_amount_decimal,local_amount_decimal,national_amount_decimalamount_decimal,flat_amount_decimal,unit_amount_decimalunit_amount_decimal,flat_amount_decimal(includingcurrency_optionsandtiers)percent_ownershipunit_amount_decimal,flat_amount_decimal,quantity_decimal(where applicable)upi_paymentsonAccount.capabilities,AccountCreateParams.capabilities, andAccountUpdateParams.capabilitiesupionCharge.payment_method_details,Checkout.Session.payment_method_options,Checkout.SessionCreateParams.payment_method_options,ConfirmationToken.payment_method_preview,ConfirmationTokenCreateParams.testHelpers.payment_method_data,Mandate.payment_method_details,PaymentAttemptRecord.payment_method_details,PaymentIntent.payment_method_options,PaymentIntentConfirmParams.payment_method_data,PaymentIntentConfirmParams.payment_method_options,PaymentIntentCreateParams.payment_method_data,PaymentIntentCreateParams.payment_method_options,PaymentIntentUpdateParams.payment_method_data,PaymentIntentUpdateParams.payment_method_options,PaymentMethodConfigurationCreateParams,PaymentMethodConfigurationUpdateParams,PaymentMethodConfiguration,PaymentMethodCreateParams,PaymentMethod,PaymentRecord.payment_method_details,SetupAttempt.payment_method_details,SetupIntent.payment_method_options,SetupIntentConfirmParams.payment_method_data,SetupIntentConfirmParams.payment_method_options,SetupIntentCreateParams.payment_method_data,SetupIntentCreateParams.payment_method_options,SetupIntentUpdateParams.payment_method_data, andSetupIntentUpdateParams.payment_method_optionstempoon enumsCharge.payment_method_details.crypto.network,PaymentAttemptRecord.payment_method_details.crypto.network, andPaymentRecord.payment_method_details.crypto.networkintegration_identifieronCheckout.SessionCreateParamsandCheckout.Sessionupion enumsCheckout.SessionCreateParams.excluded_payment_method_types,PaymentIntent.excluded_payment_method_types,PaymentIntentConfirmParams.excluded_payment_method_types,PaymentIntentCreateParams.excluded_payment_method_types,PaymentIntentUpdateParams.excluded_payment_method_types,SetupIntent.excluded_payment_method_types,SetupIntentCreateParams.excluded_payment_method_types, andSetupIntentUpdateParams.excluded_payment_method_typescryptoonCheckout.SessionCreateParams.payment_method_optionsupion enumCheckout.SessionCreateParams.payment_method_typespending_invoice_item_intervalonCheckout.SessionCreateParams.subscription_dataelements,embedded_page,form, andhosted_pageon enumsCheckout.Session.ui_modeandCheckout.SessionCreateParams.ui_modemarine_carbon_removalon enumClimate.Supplier.removal_pathwayupion enums `ConfConfiguration
📅 Schedule: (UTC)
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR was generated by Mend Renovate. View the repository job log.