Update dependency stripe to v20 #1483
Open
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
renovate
bot
force-pushed
the
renovate/stripe-20.x
branch
2 times, most recently
from
b824a4b to
99c6eb7
Compare
renovate
bot
force-pushed
the
renovate/stripe-20.x
branch
2 times, most recently
from
3fe5fd4 to
64b4f3f
Compare
renovate
bot
force-pushed
the
renovate/stripe-20.x
branch
from
64b4f3f to
4d0099b
Compare
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR contains the following updates:
12.18.0->20.1.0Release Notes
stripe/stripe-node (stripe)
v20.1.0Compare Source
This release changes the pinned API version to
2025-12-15.clover.V2.Core.AccountLink,V2.Core.AccountPersonToken,V2.Core.AccountPerson,V2.Core.AccountToken, andV2.Core.Accountcreateandretrievemethods on resourcesV2.Core.AccountPersonTokenandV2.Core.AccountTokencreatemethod on resourceV2.Core.AccountLinkclose,create,list,retrieve, andupdatemethods on resourceV2.Core.Accountcreate,del,list,retrieve, andupdatemethods on resourceV2.Core.AccountPersonpayto_paymentsonAccount.capabilities,AccountCreateParams.capabilities, andAccountUpdateParams.capabilitiessigneronAccountCreateParams.documents.proof_of_registration,AccountCreateParams.documents.proof_of_ultimate_beneficial_ownership,AccountUpdateParams.documents.proof_of_registration, andAccountUpdateParams.documents.proof_of_ultimate_beneficial_ownershipcustomer_accountonBilling.CreditBalanceSummaryRetrieveParams,Billing.CreditBalanceSummary,Billing.CreditBalanceTransactionListParams,Billing.CreditGrantCreateParams,Billing.CreditGrantListParams,Billing.CreditGrant,BillingPortal.SessionCreateParams,BillingPortal.Session,CashBalance,Checkout.SessionCreateParams,Checkout.SessionListParams,Checkout.Session,ConfirmationToken.payment_method_preview,CreditNoteListParams,CreditNote,CustomerBalanceTransaction,CustomerCashBalanceTransaction,CustomerSessionCreateParams,CustomerSession,Customer,Discount,FinancialConnections.Account.account_holder,FinancialConnections.AccountListParams.account_holder,FinancialConnections.Session.account_holder,FinancialConnections.SessionCreateParams.account_holder,InvoiceCreateParams,InvoiceCreatePreviewParams,InvoiceItemCreateParams,InvoiceItemListParams,InvoiceItem,InvoiceListParams,Invoice,PaymentIntentCreateParams,PaymentIntentListParams,PaymentIntentUpdateParams,PaymentIntent,PaymentMethodAttachParams,PaymentMethodListParams,PaymentMethod,PromotionCodeCreateParams,PromotionCodeListParams,PromotionCode,QuoteCreateParams,QuoteListParams,QuoteUpdateParams,Quote,SetupAttempt,SetupIntentCreateParams,SetupIntentListParams,SetupIntentUpdateParams,SetupIntent,SubscriptionCreateParams,SubscriptionListParams,SubscriptionScheduleCreateParams,SubscriptionScheduleListParams,SubscriptionSchedule,Subscription,TaxId.owner,TaxIdCreateParams.owner,TaxIdListParams.owner, andTaxIdmetadataonCheckout.SessionCreateParams.line_items[]andLineItemBilling.CreditBalanceSummaryRetrieveParams.customer,Billing.CreditBalanceTransactionListParams.customer,Billing.CreditGrantCreateParams.customer,BillingPortal.SessionCreateParams.customer,CustomerSessionCreateParams.customer,InvoiceItemCreateParams.customer,PaymentMethodAttachParams.customer, andSubscriptionCreateParams.customerto be optionalbilling_cycle_anchoronBillingPortal.Configuration.features.subscription_update,BillingPortal.ConfigurationCreateParams.features.subscription_update, andBillingPortal.ConfigurationUpdateParams.features.subscription_updatepaytoonCharge.payment_method_details,Checkout.Session.payment_method_options,Checkout.SessionCreateParams.payment_method_options,ConfirmationToken.payment_method_preview,ConfirmationTokenCreateParams.testHelpers.payment_method_data,Invoice.payment_settings.payment_method_options,InvoiceCreateParams.payment_settings.payment_method_options,InvoiceUpdateParams.payment_settings.payment_method_options,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,PaymentMethodUpdateParams,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,SetupIntentUpdateParams.payment_method_options,Subscription.payment_settings.payment_method_options,SubscriptionCreateParams.payment_settings.payment_method_options, andSubscriptionUpdateParams.payment_settings.payment_method_optionsexpected_debit_dateonCharge.payment_method_details.acss_debit,Charge.payment_method_details.au_becs_debit,Charge.payment_method_details.bacs_debit,Charge.payment_method_details.nz_bank_account,Charge.payment_method_details.sepa_debit,Charge.payment_method_details.us_bank_account,PaymentAttemptRecord.payment_method_details.acss_debit,PaymentAttemptRecord.payment_method_details.au_becs_debit,PaymentAttemptRecord.payment_method_details.bacs_debit,PaymentAttemptRecord.payment_method_details.nz_bank_account,PaymentAttemptRecord.payment_method_details.sepa_debit,PaymentAttemptRecord.payment_method_details.us_bank_account,PaymentRecord.payment_method_details.acss_debit,PaymentRecord.payment_method_details.au_becs_debit,PaymentRecord.payment_method_details.bacs_debit,PaymentRecord.payment_method_details.nz_bank_account,PaymentRecord.payment_method_details.sepa_debit, andPaymentRecord.payment_method_details.us_bank_accountmollieon enumsCharge.payment_method_details.ideal.bank,ConfirmationToken.payment_method_preview.ideal.bank,ConfirmationTokenCreateParams.testHelpers.payment_method_data.ideal.bank,PaymentAttemptRecord.payment_method_details.ideal.bank,PaymentIntentConfirmParams.payment_method_data.ideal.bank,PaymentIntentCreateParams.payment_method_data.ideal.bank,PaymentIntentUpdateParams.payment_method_data.ideal.bank,PaymentMethod.ideal.bank,PaymentMethodCreateParams.ideal.bank,PaymentRecord.payment_method_details.ideal.bank,SetupAttempt.payment_method_details.ideal.bank,SetupIntentConfirmParams.payment_method_data.ideal.bank,SetupIntentCreateParams.payment_method_data.ideal.bank, andSetupIntentUpdateParams.payment_method_data.ideal.bankMLLENL2Aon enumsCharge.payment_method_details.ideal.bic,ConfirmationToken.payment_method_preview.ideal.bic,PaymentAttemptRecord.payment_method_details.ideal.bic,PaymentMethod.ideal.bic,PaymentRecord.payment_method_details.ideal.bic, andSetupAttempt.payment_method_details.ideal.bicpaytoon 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_typespaytoon enumCheckout.SessionCreateParams.payment_method_typesline_itemsonCheckout.SessionUpdateParamspaytoon 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.typepaytoon enumsConfirmationToken.payment_method_preview.typeandPaymentMethod.typepaytoon enumsCustomerListPaymentMethodsParams.type,PaymentMethodCreateParams.type, andPaymentMethodListParams.typeinvoiceonCustomerListCustomerBalanceTransactionsParamsrelated_customer_accountonIdentity.VerificationSessionCreateParams,Identity.VerificationSessionListParams, andIdentity.VerificationSessionInvoiceItem.pricing.price_details.priceandInvoiceLineItem.pricing.price_details.pricefromstringtoexpandable(Price)paytoon 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_typessubtotalonInvoiceLineItemauthorization_code,description,iin,installments,issuer,network_advice_code,network_decline_code, andstored_credential_usageonPaymentAttemptRecord.payment_method_details.cardandPaymentRecord.payment_method_details.cardPaymentIntent.transfer_datato be optionalpaytoon enumsPaymentLink.payment_method_types,PaymentLinkCreateParams.payment_method_types, andPaymentLinkUpdateParams.payment_method_typesallow_redisplayonPaymentMethodListParamsreported_byonPaymentRecordProduct.tax_codeto be optional2025-12-15.cloverand2026-01-28.cloveron enumWebhookEndpointCreateParams.api_versionchangesonV2.Core.Eventaccount_token_required_for_v2_accountonInvoice.last_finalization_error,PaymentIntent.last_payment_error,SetupAttempt.setup_error,SetupIntent.last_setup_error, andStripeErrorv20.0.0Compare Source
This release changes the pinned API version to
2025-11-17.clover.gt,gte,lt, andlteonV2.Core.EventListParamsin favor ofcreated.RetrieveandListcalls for/v2endpoints now use indexed format (e.g.,?include[0]=foo&include[1]=bar) instead of repeated parameter format (e.g.,?include=foo&include=bar) when communicating with the Stripe API. This may break any unit tests that expect the latter behavior when setting up a mock server. Instead, they should now expect the former.Tax.AssociationandTerminal.OnboardingLinkfindmethod on resourceTax.Associationcreatemethod on resourceTerminal.OnboardingLinkpayment_method_configurationonBillingPortal.Configuration.features.payment_method_updatetransaction_idonCharge.payment_method_details.ideal,PaymentAttemptRecord.payment_method_details.ideal, andPaymentRecord.payment_method_details.idealfinomon enumsCharge.payment_method_details.ideal.bank,ConfirmationToken.payment_method_preview.ideal.bank,ConfirmationTokenCreateParams.testHelpers.payment_method_data.ideal.bank,PaymentAttemptRecord.payment_method_details.ideal.bank,PaymentIntentConfirmParams.payment_method_data.ideal.bank,PaymentIntentCreateParams.payment_method_data.ideal.bank,PaymentIntentUpdateParams.payment_method_data.ideal.bank,PaymentMethod.ideal.bank,PaymentMethodCreateParams.ideal.bank,PaymentRecord.payment_method_details.ideal.bank,SetupAttempt.payment_method_details.ideal.bank,SetupIntentConfirmParams.payment_method_data.ideal.bank,SetupIntentCreateParams.payment_method_data.ideal.bank, andSetupIntentUpdateParams.payment_method_data.ideal.bankFNOMNL22on enumsCharge.payment_method_details.ideal.bic,ConfirmationToken.payment_method_preview.ideal.bic,PaymentAttemptRecord.payment_method_details.ideal.bic,PaymentMethod.ideal.bic,PaymentRecord.payment_method_details.ideal.bic, andSetupAttempt.payment_method_details.ideal.bictokenized_account_number_deactivatedon enumsConfirmationToken.payment_method_preview.us_bank_account.status_details.blocked.reasonandPaymentMethod.us_bank_account.status_details.blocked.reasoncreatedonCustomerListCustomerBalanceTransactionsParamsandInvoicePaymentListParamsfinancial_connections.account.account_numbers_updatedandfinancial_connections.account.upcoming_account_number_expiryon enumEvent.typeaccount_numbersonFinancialConnections.AccountFinancialConnections.Session.client_secretfromstringtostring | nullfraud_riskonIssuing.AuthorizationCreateParams.testHelpers.risk_assessmentlatest_fraud_warningonIssuing.CardhooksonPaymentIntentCaptureParams,PaymentIntentConfirmParams,PaymentIntentCreateParams,PaymentIntentIncrementAuthorizationParams,PaymentIntentUpdateParams, andPaymentIntentmb_wayandtwintonRefund.destination_detailsfinancial_connections.account.account_numbers_updatedandfinancial_connections.account.upcoming_account_number_expiryon enumsWebhookEndpointCreateParams.enabled_eventsandWebhookEndpointUpdateParams.enabled_eventsFinancialConnectionsAccountAccountNumbersUpdatedEventandFinancialConnectionsAccountUpcomingAccountNumberExpiryEventwith resourceFinancialConnections.Accountv19.3.1Compare Source
TextEncoderinstead ofBufferto ensure support in other JS environmentsBuffer.byteLengthwas causing errors in some runtime environments.v19.3.0Compare Source
capture_methodonPaymentIntent.payment_method_options.card_present,PaymentIntentConfirmParams.payment_method_options.card_present,PaymentIntentCreateParams.payment_method_options.card_present, andPaymentIntentUpdateParams.payment_method_options.card_presentv19.2.1Compare Source
payment_recordto enumInvoicePayment.payment.typev19.2.0Compare Source
This release changes the pinned API version to
2025-10-29.clover.PaymentAttemptRecord,PaymentIntentAmountDetailsLineItem, andPaymentRecordlistandretrievemethods on resourcePaymentAttemptRecordreport_payment_attempt_canceled,report_payment_attempt_failed,report_payment_attempt_guaranteed,report_payment_attempt_informational,report_payment_attempt,report_payment,report_refund, andretrievemethods on resourcePaymentRecordlistmethod on resourcePaymentIntentAmountDetailsLineItemrepresentative_declarationonAccount.company,AccountCreateParams.company,AccountUpdateParams.company, andTokenCreateParams.account.companyBilling.CreditGrantCreateParams.categoryto be optionalpayment_method_configurationonBillingPortal.ConfigurationCreateParams.features.payment_method_updateandBillingPortal.ConfigurationUpdateParams.features.payment_method_updatesolanaon enumCharge.payment_method_details.crypto.networkmb_wayon enumCheckout.SessionCreateParams.excluded_payment_method_typestwintonCheckout.Session.payment_method_optionsandCheckout.SessionCreateParams.payment_method_optionsmb_wayon enumCheckout.SessionCreateParams.payment_method_typescustomon enumsConfirmationToken.payment_method_preview.typeandPaymentMethod.typepayment_record_refundandtypeonCreditNote.refunds[],CreditNoteCreateParams.refunds[],CreditNotePreviewLinesParams.refunds[], andCreditNotePreviewParams.refunds[]customer_sheetandmobile_payment_elementonCustomerSession.componentsandCustomerSessionCreateParams.componentscustomon enumsCustomerListPaymentMethodsParams.type,PaymentMethodCreateParams.type, andPaymentMethodListParams.typeprovideronCustomer.taxbalance_settings.updatedandinvoice.payment_attempt_requiredon enumEvent.typeplatform_terms_of_serviceon enumsFile.purposeandFileListParams.purposeplatform_terms_of_serviceon enumFileCreateParams.purposepayment_recordonInvoiceAttachPaymentParams,InvoicePayment.payment, andInvoicePaymentListParams.paymentInvoicePaymentListParams.payment.typefromliteral('payment_intent')toenum('payment_intent'|'payment_record')customon 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_typesamount_detailsonPaymentIntentCaptureParams,PaymentIntentConfirmParams,PaymentIntentCreateParams,PaymentIntentIncrementAuthorizationParams, andPaymentIntentUpdateParamspayment_detailsonPaymentIntentCaptureParams,PaymentIntentConfirmParams,PaymentIntentCreateParams,PaymentIntentIncrementAuthorizationParams,PaymentIntentUpdateParams, andPaymentIntentdiscount_amount,line_items,shipping, andtaxonPaymentIntent.amount_detailsname_collectiononPaymentLinkCreateParams,PaymentLinkUpdateParams, andPaymentLinkmb_wayon enumsPaymentLink.payment_method_types,PaymentLinkCreateParams.payment_method_types, andPaymentLinkUpdateParams.payment_method_typescryptoonPaymentMethodConfigurationCreateParams,PaymentMethodConfigurationUpdateParams,PaymentMethodConfiguration, andRefund.destination_detailsmb_wayonPaymentMethodConfigurationCreateParams,PaymentMethodConfigurationUpdateParams, andPaymentMethodConfigurationcustomonPaymentMethodCreateParamsandPaymentMethodexcluded_payment_method_typesonSetupIntentCreateParams,SetupIntentUpdateParams, andSetupIntenttwonTax.Registration.country_optionsandTax.RegistrationCreateParams.country_optionsgiponTerminal.Configuration.tipping,Terminal.ConfigurationCreateParams.tipping, andTerminal.ConfigurationUpdateParams.tippinglast_seen_atonTerminal.Readerbalance_settings.updatedandinvoice.payment_attempt_requiredon enumsWebhookEndpointCreateParams.enabled_eventsandWebhookEndpointUpdateParams.enabled_events2025-10-29.cloveron enumWebhookEndpointCreateParams.api_versiongt,gte,lt,lte, andtypesonV2.Core.EventListParamsV2.Core.EventListParams.object_idto be optionalBalanceSettingsUpdatedEventwith resourceBalanceSettingsInvoicePaymentAttemptRequiredEventwith resourceInvoicepayment_intent_rate_limit_exceededonInvoice.last_finalization_error,PaymentIntent.last_payment_error,SetupAttempt.setup_error,SetupIntent.last_setup_error, andStripeErrorv19.1.0Compare Source
#2453 add missing fetchEvent type for UnknownEventNotification
fetchEvent()declaration to theStripe.Events.UnknownEventNotificationinterfaceStripe.Events.fetchRelatedObjectso that it's always defined and returnsnullif there's norelated_object. This fixes the situation where theUnknownEventNotificationsays thatfetchRelatedObject()is defined, but calling it throws an error.#2447 Update param in deprecation docs link
#2444 Update CHANGELOG.md to point to right API version
v19.0.0Compare Source
This release changes the pinned API version to⚠️ below)
2025-09-30.cloverand contains breaking changes (prefixed with#2427 Move
V2.EventAPI resources toV2.Core.EventsStripe.V2toStripe.V2.Core. This enables us to correctly match the API path to the namespaceStripe.V2.EventDestination->Stripe.V2.Core.EventDestinationStripe.V2.Event->Stripe.V2.Core.EventStripe.V2.EventBase->Stripe.V2.Core.EventBaseStripe.V2.Events.RelatedObject->Stripe.V2.Core.Events.RelatedObject#2370 Add strongly typed EventNotifications
We've overhauled how V2 Events are handled in the SDK! This approach should provide a lot more information at authoring and compile time, leading to more robust integrations. As part of this process, there are a number of changes to be aware of.
StripeClient.parseThinEventtoStripeClient.parseEventNotificationand remove theStripe.ThinEventinterface.Stripe.V2.EventNotificationwhich is a union of all possible event notifications instead ofStripe.ThinEvent. When applicable, these event notifications will have therelatedObjectfield and a functionfetchRelatedObject(). They also have afetchEvent()method to retrieve their corresponding event.UnknownEventNotificationto then access therelatedObjectfield and the functionfetchRelatedObject()#2432 Drop support for Node < 16 & clarify policy
#2426 Add
StripeContextobjectStripeContextclass. It can be used anywhere the context option is supplied and gets serialized to a string when making requests.EventNotification(formerly known asThinEvent)'scontextproperty fromstringtoStripeContext#2398⚠️ Build SDK w/ V2 OpenAPI spec
StripeClient.v2namespace) now return aV2DeletedObjectwhich has the id of the object that has been deleted and a string representing the type of the object that has been deleted.StripeClient.v2namespace) from a null union to optional (e.g.prop: string | null->prop?: string).#2420 Fixed file uploading in Bun runtimes
FetchHttpClient(e.g. Bun). This bug affected Node SDK versions between 18.1.0 to 18.5.0.#2405 support more npm tags
betanpm tag. Instead, we'll uselatest,public-preview, orprivate-previewto more closely align with Stripe's release phases#2402, #2413, #2430, #2428 Update generated code based on incoming API changes in the
2025-09-30.cloverAPI version.balance_reportandpayout_reconciliation_reportonAccountSession.componentsandAccountSessionCreateParams.componentssaturdayandsundayfrom enumsAccount.settings.payouts.schedule.weekly_payout_days,AccountCreateParams.settings.payouts.schedule.weekly_payout_days, andAccountUpdateParams.settings.payouts.schedule.weekly_payout_daysexternal_requestandunsupported_business_typeon enumsAccount.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, andPerson.requirements.errors[].codelinkandpay_by_bankonPaymentMethodUpdateParamscoupononDiscount,PromotionCodeCreateParams, andPromotionCode. UseDiscount.source.coupon,PromotionCodeCreateParams.promotion.couponandPromotionCode.couponinstead.Invoice.idto be required.preventedon enumDispute.statusBalanceSettingsretrieveandupdatemethods on resourceBalanceSettingsmb_way_paymentsonAccount.capabilities,AccountCreateParams.capabilities, andAccountUpdateParams.capabilitiessourceonDiscounttrial_update_behavioronBillingPortal.Configuration.features.subscription_update,BillingPortal.ConfigurationCreateParams.features.subscription_update, andBillingPortal.ConfigurationUpdateParams.features.subscription_updatemb_wayonCharge.payment_method_details,ConfirmationToken.payment_method_preview,ConfirmationTokenCreateParams.testHelpers.payment_method_data,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,PaymentMethodCreateParams,PaymentMethod,SetupIntentConfirmParams.payment_method_data,SetupIntentCreateParams.payment_method_data, andSetupIntentUpdateParams.payment_method_databranding_settingsandname_collectiononCheckout.SessionCreateParamsandCheckout.Sessionexcluded_payment_method_typesonCheckout.SessionCreateParams,Checkout.Session,PaymentIntentConfirmParams, andPaymentIntentUpdateParamsunit_labelonCheckout.SessionCreateParams.line_items[].price_data.product_data,InvoiceAddLinesParams.lines[].price_data.product_data,InvoiceLineItemUpdateParams.price_data.product_data,InvoiceUpdateLinesParams.lines[].price_data.product_data, andPaymentLinkCreateParams.line_items[].price_data.product_dataalma,billie, andsatispayonCheckout.Session.payment_method_optionsandCheckout.SessionCreateParams.payment_method_optionsdemo_payonCheckout.SessionCreateParams.payment_method_optionscapture_methodonCheckout.Session.payment_method_options.affirm,Checkout.Session.payment_method_options.afterpay_clearpay,Checkout.Session.payment_method_options.amazon_pay,Checkout.Session.payment_method_options.card,Checkout.Session.payment_method_options.cashapp,Checkout.Session.payment_method_options.klarna,Checkout.Session.payment_method_options.link,Checkout.Session.payment_method_options.mobilepay,Checkout.Session.payment_method_options.revolut_pay,Checkout.SessionCreateParams.payment_method_options.affirm,Checkout.SessionCreateParams.payment_method_options.afterpay_clearpay,Checkout.SessionCreateParams.payment_method_options.amazon_pay,Checkout.SessionCreateParams.payment_method_options.card,Checkout.SessionCreateParams.payment_method_options.cashapp,Checkout.SessionCreateParams.payment_method_options.klarna,Checkout.SessionCreateParams.payment_method_options.link,Checkout.SessionCreateParams.payment_method_options.mobilepay, andCheckout.SessionCreateParams.payment_method_options.revolut_payflexibleonCheckout.SessionCreateParams.subscription_data.billing_mode,InvoiceCreatePreviewParams.schedule_details.billing_mode,InvoiceCreatePreviewParams.subscription_details.billing_mode,Quote.subscription_data.billing_mode,QuoteCreateParams.subscription_data.billing_mode,Subscription.billing_mode,SubscriptionCreateParams.billing_mode,SubscriptionMigrateParams.billing_mode,SubscriptionSchedule.billing_mode, andSubscriptionScheduleCreateParams.billing_modebusiness_nameandindividual_nameonCheckout.Session.collected_information,Checkout.Session.customer_details,CustomerCreateParams,CustomerUpdateParams, andCustomermb_wayon 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.typemb_wayon enumsConfirmationToken.payment_method_preview.typeandPaymentMethod.typemb_wayon enumsCustomerListPaymentMethodsParams.type,PaymentMethodCreateParams.type, andPaymentMethodListParams.typechargeback_loss_reason_codeonDispute.payment_method_details.klarnanet_amountandproration_detailsonInvoiceItemiterationsonInvoiceCreatePreviewParams.schedule_details.phases[],SubscriptionScheduleCreateParams.phases[], andSubscriptionScheduleUpdateParams.phases[]fraud_disputability_likelihoodandrisk_assessmentonIssuing.AuthorizationCreateParams.testHelperssecond_lineonIssuing.Cardmb_wayon enumsPaymentIntent.excluded_payment_method_typesandPaymentIntentCreateParams.excluded_payment_method_typesfr_meal_voucher_conecsonPaymentMethodConfigurationCreateParamsandPaymentMethodConfigurationUpdateParamspromotiononPromotionCodeCreateParamsandPromotionCodeacknowledgedandpayment_never_settledon enumReview.closed_reasonprovideronTax.Settings.defaultsbbpos_wisepad3onTerminal.ConfigurationCreateParams,Terminal.ConfigurationUpdateParams, andTerminal.Configurationaddress_kana,address_kanji,display_name_kana,display_name_kanji, andphoneonTerminal.LocationCreateParams,Terminal.LocationUpdateParams, andTerminal.LocationTerminal.LocationCreateParams.addressto be optionalTerminal.LocationCreateParams.display_nameto be optional2025-09-30.cloveron enumWebhookEndpointCreateParams.api_versionfinancial_connections_account_pending_account_numbersandfinancial_connections_account_unavailable_account_numbersonInvoice.last_finalization_error,PaymentIntent.last_payment_error,SetupAttempt.setup_error,SetupIntent.last_setup_error, andStripeErrorv18.5.0Compare Source
This release changes the pinned API version to⚠️ below)
2025-09-30.cloverand contains breaking changes (prefixed with#2427 Move
V2.EventAPI resources toV2.Core.EventsStripe.V2toStripe.V2.Core. This enables us to correctly match the API path to the namespaceStripe.V2.EventDestination->Stripe.V2.Core.EventDestinationStripe.V2.Event->Stripe.V2.Core.EventStripe.V2.EventBase->Stripe.V2.Core.EventBaseStripe.V2.Events.RelatedObject->Stripe.V2.Core.Events.RelatedObject#2370 Add strongly typed EventNotifications
We've overhauled how V2 Events are handled in the SDK! This approach should provide a lot more information at authoring and compile time, leading to more robust integrations. As part of this process, there are a number of changes to be aware of.
StripeClient.parseThinEventtoStripeClient.parseEventNotificationand remove theStripe.ThinEventinterface.Stripe.V2.EventNotificationwhich is a union of all possible event notifications instead ofStripe.ThinEvent. When applicable, these event notifications will have therelatedObjectfield and a functionfetchRelatedObject(). They also have afetchEvent()method to retrieve their corresponding event.UnknownEventNotificationto then access therelatedObjectfield and the functionfetchRelatedObject()#2432 Drop support for Node < 16 & clarify policy
#2426 Add
StripeContextobjectStripeContextclass. It can be used anywhere the context option is supplied and gets serialized to a string when making requests.EventNotification(formerly known asThinEvent)'scontextproperty fromstringtoStripeContext#2398⚠️ Build SDK w/ V2 OpenAPI spec
StripeClient.v2namespace) now return aV2DeletedObjectwhich has the id of the object that has been deleted and a string representing the type of the object that has been deleted.StripeClient.v2namespace) from a null union to optional (e.g.prop: string | null->prop?: string).#2420 Fixed file uploading in Bun runtimes
FetchHttpClient(e.g. Bun). This bug affected Node SDK versions between 18.1.0 to 18.5.0.#2405 support more npm tags
betanpm tag. Instead, we'll uselatest,public-preview, orprivate-previewto more closely align with Stripe's release phases#2402, #2413, #2430, #2428 Update generated code based on incoming API changes in the
2025-09-30.cloverAPI version.balance_reportandpayout_reconciliation_reportonAccountSession.componentsandAccountSessionCreateParams.componentssaturdayandsundayfrom enumsAccount.settings.payouts.schedule.weekly_payout_days,AccountCreateParams.settings.payouts.schedule.weekly_payout_days, andAccountUpdateParams.settings.payouts.schedule.weekly_payout_daysexternal_requestandunsupported_business_typeon enumsAccount.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, andPerson.requirements.errors[].codelinkandpay_by_bankonPaymentMethodUpdateParamscoupononDiscount,PromotionCodeCreateParams, andPromotionCode. UseDiscount.source.coupon,PromotionCodeCreateParams.promotion.couponandPromotionCode.couponinstead.Invoice.idto be required.preventedon enumDispute.statusBalanceSettingsretrieveandupdatemethods on resourceBalanceSettingsmb_way_paymentsonAccount.capabilities,AccountCreateParams.capabilities, andAccountUpdateParams.capabilitiessourceonDiscounttrial_update_behavioronBillingPortal.Configuration.features.subscription_update,BillingPortal.ConfigurationCreateParams.features.subscription_update, andBillingPortal.ConfigurationUpdateParams.features.subscription_updatemb_wayonCharge.payment_method_details,ConfirmationToken.payment_method_preview,ConfirmationTokenCreateParams.testHelpers.payment_method_data,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,PaymentMethodCreateParams,PaymentMethod,SetupIntentConfirmParams.payment_method_data,SetupIntentCreateParams.payment_method_data, andSetupIntentUpdateParams.payment_method_databranding_settingsandname_collectiononCheckout.SessionCreateParamsandCheckout.Sessionexcluded_payment_method_typesonCheckout.SessionCreateParams,Checkout.Session,PaymentIntentConfirmParams, andPaymentIntentUpdateParamsunit_labelonCheckout.SessionCreateParams.line_items[].price_data.product_data,InvoiceAddLinesParams.lines[].price_data.product_data,InvoiceLineItemUpdateParams.price_data.product_data,InvoiceUpdateLinesParams.lines[].price_data.product_data, andPaymentLinkCreateParams.line_items[].price_data.product_dataalma,billie, andsatispayonCheckout.Session.payment_method_optionsandCheckout.SessionCreateParams.payment_method_optionsdemo_payonCheckout.SessionCreateParams.payment_method_optionscapture_methodonCheckout.Session.payment_method_options.affirm,Checkout.Session.payment_method_options.afterpay_clearpay,Checkout.Session.payment_method_options.amazon_pay,Checkout.Session.payment_method_options.card,Checkout.Session.payment_method_options.cashapp,Checkout.Session.payment_method_options.klarna,Checkout.Session.payment_method_options.link,Checkout.Session.payment_method_options.mobilepay,Checkout.Session.payment_method_options.revolut_pay,Checkout.SessionCreateParams.payment_method_options.affirm,Checkout.SessionCreateParams.payment_method_options.afterpay_clearpay,Checkout.SessionCreateParams.payment_method_options.amazon_pay,Checkout.SessionCreateParams.payment_method_options.card,Checkout.SessionCreateParams.payment_method_options.cashapp,Checkout.SessionCreateParams.payment_method_options.klarna,Checkout.SessionCreateParams.payment_method_options.link,Checkout.SessionCreateParams.payment_method_options.mobilepay, andCheckout.SessionCreateParams.payment_method_options.revolut_payflexibleonCheckout.SessionCreateParams.subscription_data.billing_mode,InvoiceCreatePreviewParams.schedule_details.billing_mode,InvoiceCreatePreviewParams.subscription_details.billing_mode,Quote.subscription_data.billing_mode,QuoteCreateParams.subscription_data.billing_mode,Subscription.billing_mode,SubscriptionCreateParams.billing_mode,SubscriptionMigrateParams.billing_mode,SubscriptionSchedule.billing_mode, andSubscriptionScheduleCreateParams.billing_modebusiness_nameandindividual_nameonCheckout.Session.collected_information,Checkout.Session.customer_details,CustomerCreateParams,CustomerUpdateParams, andCustomermb_wayon 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.typemb_wayon enumsConfirmationToken.payment_method_preview.typeandPaymentMethod.typemb_wayon enumsCustomerListPaymentMethodsParams.type,PaymentMethodCreateParams.type, andPaymentMethodListParams.typechargeback_loss_reason_codeonDispute.payment_method_details.klarnanet_amountandproration_detailsonInvoiceItemiterationsonInvoiceCreatePreviewParams.schedule_details.phases[],SubscriptionScheduleCreateParams.phases[], andSubscriptionScheduleUpdateParams.phases[]fraud_disputability_likelihoodandrisk_assessmentonIssuing.AuthorizationCreateParams.testHelperssecond_lineonIssuing.Cardmb_wayon enumsPaymentIntent.excluded_payment_method_typesandPaymentIntentCreateParams.excluded_payment_method_typesfr_meal_voucher_conecsonPaymentMethodConfigurationCreateParamsandPaymentMethodConfigurationUpdateParamspromotiononPromotionCodeCreateParamsandPromotionCodeacknowledgedandpayment_never_settledon enumReview.closed_reasonprovideronTax.Settings.defaultsbbpos_wisepad3onTerminal.ConfigurationCreateParams,Terminal.ConfigurationUpdateParams, andTerminal.Configurationaddress_kana,address_kanji,display_name_kana,display_name_kanji, andphoneonTerminal.LocationCreateParams,Terminal.LocationUpdateParams, andTerminal.LocationTerminal.LocationCreateParams.addressto be optionalTerminal.LocationCreateParams.display_nameto be optional2025-09-30.cloveron enumWebhookEndpointCreateParams.api_versionfinancial_connections_account_pending_account_numbersandfinancial_connections_account_unavailable_account_numbersonInvoice.last_finalization_error,PaymentIntent.last_payment_error,SetupAttempt.setup_error,SetupIntent.last_setup_error, andStripeErrorv18.4.0Compare Source
This release changes the pinned API version to
2025-07-30.basil.instant_payouts_promotiononAccountSession.componentsandAccountSessionCreateParams.componentsadjustable_quantityonBillingPortal.Configuration.features.subscription_update.products[],BillingPortal.ConfigurationCreateParams.features.subscription_update.products[], andBillingPortal.ConfigurationUpdateParams.features.subscription_update.products[]disabledfrom enumCapability.statustransaction_idonCharge.payment_method_details.cashapporigin_contextonCheckout.SessionCreateParamsandCheckout.SessiontemplateonCheckout.Session.invoice_creation.invoice_data.rendering_options,Checkout.SessionCreateParams.invoice_creation.invoice_data.rendering_options,PaymentLink.invoice_creation.invoice_data.rendering_options,PaymentLinkCreateParams.invoice_creation.invoice_data.rendering_options, andPaymentLinkUpdateParams.invoice_creation.invoice_data.rendering_optionssetup_future_usageonCheckout.Session.payment_method_options.pixandCheckout.SessionCreateParams.payment_method_options.pixnz_bank_accounton enumCheckout.SessionCreateParams.payment_method_typesIdentity.VerificationSession.related_person.accountto be requiredIdentity.VerificationSession.related_person.personto be requireddurationonInvoiceCreatePreviewParams.schedule_details.phases[],SubscriptionScheduleCreateParams.phases[], andSubscriptionScheduleUpdateParams.phases[]InvoiceCreatePreviewParams.subscription_details.cancel_at,SubscriptionCreateParams.cancel_at, andSubscriptionUpdateParams.cancel_atfromDateTimetoDateTime | enum('max_period_end'|'min_period_end')price_dataonPaymentLinkCreateParams.line_items[]PaymentLinkCreateParams.line_items[].priceto be optionalAmerica/Coyhaiqueon enumReporting.ReportRunCreateParams.parameters.timezonestandardonTax.Registration.country_options.ae,Tax.Registration.country_options.au,Tax.Registration.country_options.ch,Tax.Registration.country_options.gb,Tax.Registration.country_options.jp,Tax.Registration.country_options.no,Tax.Registration.country_options.nz,Tax.Registration.country_options.sg,Tax.RegistrationCreateParams.country_options.ae,Tax.RegistrationCreateParams.country_options.al,Tax.RegistrationCreateParams.country_options.ao,Tax.RegistrationCreateParams.country_options.au,Tax.RegistrationCreateParams.country_options.aw,Tax.RegistrationCreateParams.country_options.ba,Tax.RegistrationCreateParams.country_options.bb,Tax.RegistrationCreateParams.country_options.bd,Tax.RegistrationCreateParams.country_options.bf,Tax.RegistrationCreateParams.country_options.bh,Tax.RegistrationCreateParams.country_options.bs,Tax.RegistrationCreateParams.country_options.cd,Tax.RegistrationCreateParams.country_options.ch,Tax.RegistrationCreateParams.country_options.et,Tax.RegistrationCreateParams.country_options.gb,Tax.RegistrationCreateParams.country_options.gn,Tax.RegistrationCreateParams.country_options.is,Tax.RegistrationCreateParams.country_options.jp,Tax.RegistrationCreateParams.country_options.me,Tax.RegistrationCreateParams.country_options.mk,Tax.RegistrationCreateParams.country_options.mr,Tax.RegistrationCreateParams.country_options.no,Tax.RegistrationCreateParams.country_options.nz,Tax.RegistrationCreateParams.country_options.om,Tax.RegistrationCreateParams.country_options.rs,Tax.RegistrationCreateParams.country_options.sg,Tax.RegistrationCreateParams.country_options.sr,Tax.RegistrationCreateParams.country_options.uy,Tax.RegistrationCreateParams.country_options.za, andTax.RegistrationCreateParams.country_options.zwinbound_goodson enumsTax.Registration.country_options.at.standard.place_of_supply_scheme,Tax.Registration.country_options.be.standard.place_of_supply_scheme,Tax.Registration.country_options.bg.standard.place_of_supply_scheme,Tax.Registration.country_options.cy.standard.place_of_supply_scheme,Tax.Registration.country_options.cz.standard.place_of_supply_scheme,Tax.Registration.country_options.de.standard.place_of_supply_scheme,Tax.Registration.country_options.dk.standard.place_of_supply_scheme,Tax.Registration.country_options.ee.standard.place_of_supply_scheme,Tax.Registration.country_options.es.standard.place_of_supply_scheme,Tax.Registration.country_options.fi.standard.place_of_supply_scheme,Tax.Registration.country_options.fr.standard.place_of_supply_scheme,Tax.Registration.country_options.gr.standard.place_of_supply_scheme,Tax.Registration.country_options.hr.standard.place_of_supply_scheme,Tax.Registration.country_options.hu.standard.place_of_supply_scheme,Tax.Registration.country_options.ie.standard.place_of_supply_scheme,Tax.Registration.country_options.it.standard.place_of_supply_scheme,Tax.Registration.country_options.lt.standard.place_of_supply_scheme,Tax.Registration.country_options.lu.standard.place_of_supply_scheme,Tax.Registration.country_options.lv.standard.place_of_supply_scheme,Tax.Registration.country_options.mt.standard.place_of_supply_scheme,Tax.Registration.country_options.nl.standard.place_of_supply_scheme,Tax.Registration.country_options.pl.standard.place_of_supply_scheme,Tax.Registration.country_options.pt.standard.place_of_supply_scheme,Tax.Registration.country_options.ro.standard.place_of_supply_scheme,Tax.Registration.country_options.se.standard.place_of_supply_scheme,Tax.Registration.country_options.si.standard.place_of_supply_scheme,Tax.Registration.country_options.sk.standard.place_of_supply_scheme,Tax.RegistrationCreateParams.country_options.at.standard.place_of_supply_scheme,Tax.RegistrationCreateParams.country_options.be.standard.place_of_supply_scheme,Tax.RegistrationCreateParams.country_options.bg.standard.place_of_supply_scheme,Tax.RegistrationCreateParams.country_options.cy.standard.place_of_supply_scheme,Tax.RegistrationCreateParams.country_options.cz.standard.place_of_supply_scheme,Tax.RegistrationCreateParams.country_options.de.standard.place_of_supply_scheme,Tax.RegistrationCreateParams.country_options.dk.standard.place_of_supply_scheme,Tax.RegistrationCreateParams.country_options.ee.standard.place_of_supply_scheme,Tax.RegistrationCreateParams.country_options.es.standard.place_of_supply_scheme,Tax.RegistrationCreateParams.country_options.fi.standard.place_of_supply_scheme,Tax.RegistrationCreateParams.country_options.fr.standard.place_of_supply_scheme, `Tax.RegistrationCreaConfiguration
📅 Schedule: Branch creation - Monday through Friday ( * * * * 1-5 ) (UTC), Automerge - At any time (no schedule defined).
🚦 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.