Open
Conversation
renovate
bot
force-pushed
the
renovate/stripe-21.x
branch
5 times, most recently
from
289e541 to
c72baef
Compare
renovate
bot
force-pushed
the
renovate/stripe-21.x
branch
from
c72baef to
18da4cc
Compare
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
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→21.0.1Release Notes
stripe/stripe-node (stripe)
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 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.typeupion enumsConfirmationToken.payment_method_preview.typeandPaymentMethod.typemetadataonCreditNoteCreateParams.lines[],CreditNoteLineItem,CreditNotePreviewLinesParams.lines[], andCreditNotePreviewParams.lines[]upion enumsCustomerListPaymentMethodsParams.type,PaymentMethodCreateParams.type, andPaymentMethodListParams.typequantity_decimalonInvoiceAddLinesParams.lines[],InvoiceCreatePreviewParams.invoice_items[],InvoiceItemCreateParams,InvoiceItemUpdateParams,InvoiceItem,InvoiceLineItemUpdateParams,InvoiceLineItem, andInvoiceUpdateLinesParams.lines[]levelonIssuing.AuthorizationCreateParams.testHelpers.risk_assessment.card_testing_riskandIssuing.AuthorizationCreateParams.testHelpers.risk_assessment.merchant_dispute_riskrisk_levelonIssuing.AuthorizationCreateParams.testHelpers.risk_assessment.card_testing_riskandIssuing.AuthorizationCreateParams.testHelpers.risk_assessment.merchant_dispute_risklifecycle_controlsonIssuing.CardCreateParamsandIssuing.CardIssuing.Token.network_data.visa.card_reference_idfromstringtostring | nullPaymentAttemptRecord.payment_method_details.card.brandandPaymentRecord.payment_method_details.card.brandfromenumtoenum | nullPaymentAttemptRecord.payment_method_details.card.exp_monthandPaymentRecord.payment_method_details.card.exp_monthfromlongIntegertolongInteger | nullPaymentAttemptRecord.payment_method_details.card.exp_yearandPaymentRecord.payment_method_details.card.exp_yearfromlongIntegertolongInteger | nullPaymentAttemptRecord.payment_method_details.card.fundingandPaymentRecord.payment_method_details.card.fundingfromenum('credit'|'debit'|'prepaid'|'unknown')toenum('credit'|'debit'|'prepaid'|'unknown') | nullPaymentAttemptRecord.payment_method_details.card.last4andPaymentRecord.payment_method_details.card.last4fromstringtostring | nullPaymentAttemptRecord.payment_method_details.card.motoandPaymentRecord.payment_method_details.card.motofrombooleantoboolean | nullcryptogram,electronic_commerce_indicator,exemption_indicator_applied, andexemption_indicatoronPaymentAttemptRecord.payment_method_details.card.three_d_secureandPaymentRecord.payment_method_details.card.three_d_secureupi_handle_redirect_or_display_qr_codeonPaymentIntent.next_actionandSetupIntent.next_actionupion enumsPaymentLink.payment_method_types,PaymentLinkCreateParams.payment_method_types, andPaymentLinkUpdateParams.payment_method_typesrecommended_actionandsignalsonRadar.PaymentEvaluationinsightsonRadar.PaymentEvaluationcrypto_fingerprinton enumsRadar.ValueList.item_typeandRadar.ValueListCreateParams.item_typecanceled_by_retention_policyon enumSubscription.cancellation_details.reason2026-03-25.dahliaon enumWebhookEndpointCreateParams.api_versionV2.Core.EventDestination.events_fromandV2.Core.EventDestinationCreateParams.events_fromfromenum('other_accounts'|'self')tostringservice_period_coupon_with_metered_tiered_item_unsupportedonInvoice.last_finalization_error,PaymentIntent.last_payment_error,SetupAttempt.setup_error,SetupIntent.last_setup_error, andStripeErrorv20.4.1Compare Source
v20.4.0Compare Source
This release changes the pinned API version to
2026-02-25.clover.Reserve.Hold,Reserve.Plan, andReserve.ReleaselocationandreaderonCharge.payment_method_details.card_present,Charge.payment_method_details.interac_present,ConfirmationToken.payment_method_preview.card.generated_from.payment_method_details.card_present,PaymentAttemptRecord.payment_method_details.card_present,PaymentAttemptRecord.payment_method_details.interac_present,PaymentMethod.card.generated_from.payment_method_details.card_present,PaymentRecord.payment_method_details.card_present, andPaymentRecord.payment_method_details.interac_presentlk_vaton 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.typelk_vaton enumsCustomerCreateParams.tax_id_data[].type,CustomerCreateTaxIdParams.type,InvoiceCreatePreviewParams.customer_details.tax_ids[].type,Tax.CalculationCreateParams.customer_details.tax_ids[].type, andTaxIdCreateParams.typereserve.hold.created,reserve.hold.updated,reserve.plan.created,reserve.plan.disabled,reserve.plan.expired,reserve.plan.updated, andreserve.release.createdon enumEvent.typeterminal_wifi_certificateandterminal_wifi_private_keyon enumsFile.purposeandFileListParams.purposeterminal_wifi_certificateandterminal_wifi_private_keyon enumFileCreateParams.purposepay_by_bankon 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_typesdisplay_nameandservice_user_numberonMandate.payment_method_details.bacs_debitPaymentAttemptRecord.payment_method_details.boleto.tax_idandPaymentRecord.payment_method_details.boleto.tax_idfromstringtostring | nullPaymentAttemptRecord.payment_method_details.us_bank_account.expected_debit_dateandPaymentRecord.payment_method_details.us_bank_account.expected_debit_datefromstring | nulltostringtransaction_purposeonPaymentIntent.payment_method_options.us_bank_account,PaymentIntentConfirmParams.payment_method_options.us_bank_account,PaymentIntentCreateParams.payment_method_options.us_bank_account, andPaymentIntentUpdateParams.payment_method_options.us_bank_accountoptional_itemsonPaymentLinkUpdateParamscard_issuer_declineonRadar.PaymentEvaluation.insightspayment_behavioronSubscriptionItemDeleteParamslkonTax.Registration.country_optionsandTax.RegistrationCreateParams.country_optionscellularandstripe_s710onTerminal.ConfigurationCreateParams,Terminal.ConfigurationUpdateParams, andTerminal.Configurationsimulated_stripe_s710andstripe_s710on enumsTerminal.Reader.device_typeandTerminal.ReaderListParams.device_typereserve.hold.created,reserve.hold.updated,reserve.plan.created,reserve.plan.disabled,reserve.plan.expired,reserve.plan.updated, andreserve.release.createdon enumsWebhookEndpointCreateParams.enabled_eventsandWebhookEndpointUpdateParams.enabled_events2026-02-25.cloveron enumWebhookEndpointCreateParams.api_versionReserveHoldCreatedEventandReserveHoldUpdatedEventwith resourceReserve.HoldReservePlanCreatedEvent,ReservePlanDisabledEvent,ReservePlanExpiredEvent, andReservePlanUpdatedEventwith resourceReserve.PlanReserveReleaseCreatedEventwith resourceReserve.Releasestorer_capability_missingandstorer_capability_not_activeonInvoice.last_finalization_error,PaymentIntent.last_payment_error,SetupAttempt.setup_error,SetupIntent.last_setup_error, andStripeErrorv20.3.1Compare Source
UnhandledPromiseRejectionerror on failed V2 List operationsUnhandledPromiseRejectionv20.3.0Compare Source
This release changes the pinned API version to
2026-01-28.clover.Radar.PaymentEvaluationcreatemethod on resourceRadar.PaymentEvaluationadjustable_quantityonLineItemrisk_reservedon enumBalanceTransaction.balance_typereserve_holdandreserve_releaseon enumBalanceTransaction.type2.3.0and2.3.1on enumsCharge.payment_method_details.card.three_d_secure.version,PaymentIntentConfirmParams.payment_method_options.card.three_d_secure.version,PaymentIntentCreateParams.payment_method_options.card.three_d_secure.version,PaymentIntentUpdateParams.payment_method_options.card.three_d_secure.version,SetupAttempt.payment_method_details.card.three_d_secure.version,SetupIntentConfirmParams.payment_method_options.card.three_d_secure.version,SetupIntentCreateParams.payment_method_options.card.three_d_secure.version, andSetupIntentUpdateParams.payment_method_options.card.three_d_secure.versionadyenon 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.bankADYBNL2Aon 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.bicpl_nipon 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.typepl_nipon enumsCustomerCreateParams.tax_id_data[].type,CustomerCreateTaxIdParams.type,InvoiceCreatePreviewParams.customer_details.tax_ids[].type,Tax.CalculationCreateParams.customer_details.tax_ids[].type, andTaxIdCreateParams.typeInvoice.payment_settings.payment_method_options.paytoandSubscription.payment_settings.payment_method_options.paytoto be requiredenforce_arithmetic_validationonPaymentIntentCaptureParams.amount_details,PaymentIntentConfirmParams.amount_details,PaymentIntentCreateParams.amount_details,PaymentIntentIncrementAuthorizationParams.amount_details, andPaymentIntentUpdateParams.amount_detailserroronPaymentIntent.amount_detailsbgnonTerminal.Configuration.tipping,Terminal.ConfigurationCreateParams.tipping, andTerminal.ConfigurationUpdateParams.tippingtopuponTreasury.ReceivedDebit.linked_flowscontact_phoneonV2.Core.AccountCreateParams,V2.Core.AccountTokenCreateParams,V2.Core.AccountUpdateParams, andV2.Core.Accountregistration_dateonV2.Core.Account.identity.business_details,V2.Core.AccountCreateParams.identity.business_details,V2.Core.AccountTokenCreateParams.identity.business_details, andV2.Core.AccountUpdateParams.identity.business_detailsgb_vaton enumsV2.Core.Account.identity.business_details.id_numbers[].type,V2.Core.AccountCreateParams.identity.business_details.id_numbers[].type,V2.Core.AccountTokenCreateParams.identity.business_details.id_numbers[].type, andV2.Core.AccountUpdateParams.identity.business_details.id_numbers[].typerequest_blockedonInvoice.last_finalization_error,PaymentIntent.last_payment_error,SetupAttempt.setup_error,SetupIntent.last_setup_error, andStripeErrorqsdependencyqsdependency, addressing Issue #2117.v20.2.0Compare Source
V2CoreAccountClosedEvent,V2CoreAccountCreatedEvent,V2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent,V2CoreAccountIncludingConfigurationCustomerUpdatedEvent,V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent,V2CoreAccountIncludingConfigurationMerchantUpdatedEvent,V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent,V2CoreAccountIncludingConfigurationRecipientUpdatedEvent,V2CoreAccountIncludingDefaultsUpdatedEvent,V2CoreAccountIncludingFutureRequirementsUpdatedEvent,V2CoreAccountIncludingIdentityUpdatedEvent,V2CoreAccountIncludingRequirementsUpdatedEvent, andV2CoreAccountUpdatedEventwith related objectV2.Core.AccountV2CoreAccountLinkReturnedEventV2CoreAccountPersonCreatedEvent,V2CoreAccountPersonDeletedEvent, andV2CoreAccountPersonUpdatedEventwith related objectV2.Core.AccountPersonv20.1.2Compare Source
v20.1.1Compare Source
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.klarnConfiguration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Enabled.
♻ Rebasing: Whenever PR is behind base branch, 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.