v86.4.0

This release changes the pinned API version to 2026-08-26.dahlia.

• #2410 Add new EventNotificationHandler class for better thin event management

  • We've been putting a lot of time into rethinking the event handling experience in the SDKs. This new class is the culmination of that effort.
  • They're designed for a tight coupling with both StripeClient and the fully-typed nature of thin events. This delivers painless event destination upgrades, in-editor checks for common mistakes, and better code modularity.
  • Now that we've released thin event notifications for v1 objects, these new handlers are our recommended path for all integrations using thin event notifications.
  • See more detailed docs here: https://docs.stripe.com/webhooks/event-notification-handlers

• #2417 Update generated code

  • Add support for new resource BillingFeedbackOption
  • Add support for Deactivate, Get, List, New, and Update methods on resource BillingFeedbackOption
  • Add support for PaymentMethodSettings on AccountSessionComponentsParams and AccountSessionComponents
  • Add support for FeedbackOptions on BillingPortalConfigurationFeaturesSubscriptionCancelCancellationReasonParams and BillingPortalConfigurationFeaturesSubscriptionCancelCancellationReason
  • Add support for CustomerUpdate on BillingPortalSessionFlow
  • Add support for new value customer_update on enum BillingPortalSessionFlow.Type
  • Add support for FundingSourceGroup on ChargePaymentMethodDetailsCardWalletLink and ChargePaymentMethodDetailsLink
  • Add support for FundingTypesBlocked on CheckoutSessionPaymentMethodOptionsCardRestrictionsParams and CheckoutSessionPaymentMethodOptionsCardRestrictions
  • Add support for Metadata on ConfirmationToken
  • Add support for ActiveEntitlements and CustomerPortal on CustomerSessionComponentsParams and CustomerSessionComponents
  • Add support for Country on FinancialConnectionsSessionFilters
  • Add support for FrozenFields on InvoiceItem
  • Add support for Billie on InvoicePaymentSettingsPaymentMethodOptionsParams, InvoicePaymentSettingsPaymentMethodOptions, SubscriptionPaymentSettingsPaymentMethodOptionsParams, and SubscriptionPaymentSettingsPaymentMethodOptions
  • Add support for new value billie on enums InvoicePaymentSettings.PaymentMethodTypes and SubscriptionPaymentSettings.PaymentMethodTypes
  • ⚠️ Remove support for Cryptogram on PaymentAttemptRecordPaymentMethodDetailsCardThreeDSecure and PaymentRecordPaymentMethodDetailsCardThreeDSecure
  • Add support for new value touch_n_go on enums PaymentIntent.AllowedPaymentMethodTypes and SetupIntent.AllowedPaymentMethodTypes
  • Add support for ApplicationFeeAmount, ApplicationFeePercent, OnBehalfOf, and TransferData on PaymentLinkParams
  • Add support for FeedbackOption on SubscriptionCancelCancellationDetailsParams, SubscriptionCancellationDetailsParams, and SubscriptionCancellationDetails
  • Add support for Igic on TaxRegistrationCountryOptionsAtParams, TaxRegistrationCountryOptionsAt, TaxRegistrationCountryOptionsBeParams, TaxRegistrationCountryOptionsBe, TaxRegistrationCountryOptionsBgParams, TaxRegistrationCountryOptionsBg, TaxRegistrationCountryOptionsCyParams, TaxRegistrationCountryOptionsCy, TaxRegistrationCountryOptionsCzParams, TaxRegistrationCountryOptionsCz, TaxRegistrationCountryOptionsDeParams, TaxRegistrationCountryOptionsDe, TaxRegistrationCountryOptionsDkParams, TaxRegistrationCountryOptionsDk, TaxRegistrationCountryOptionsEeParams, TaxRegistrationCountryOptionsEe, TaxRegistrationCountryOptionsEsParams, TaxRegistrationCountryOptionsEs, TaxRegistrationCountryOptionsFiParams, TaxRegistrationCountryOptionsFi, TaxRegistrationCountryOptionsFrParams, TaxRegistrationCountryOptionsFr, TaxRegistrationCountryOptionsGrParams, TaxRegistrationCountryOptionsGr, TaxRegistrationCountryOptionsHrParams, TaxRegistrationCountryOptionsHr, TaxRegistrationCountryOptionsHuParams, TaxRegistrationCountryOptionsHu, TaxRegistrationCountryOptionsIeParams, TaxRegistrationCountryOptionsIe, TaxRegistrationCountryOptionsItParams, TaxRegistrationCountryOptionsIt, TaxRegistrationCountryOptionsLtParams, TaxRegistrationCountryOptionsLt, TaxRegistrationCountryOptionsLuParams, TaxRegistrationCountryOptionsLu, TaxRegistrationCountryOptionsLvParams, TaxRegistrationCountryOptionsLv, TaxRegistrationCountryOptionsMtParams, TaxRegistrationCountryOptionsMt, TaxRegistrationCountryOptionsNlParams, TaxRegistrationCountryOptionsNl, TaxRegistrationCountryOptionsPlParams, TaxRegistrationCountryOptionsPl, TaxRegistrationCountryOptionsPtParams, TaxRegistrationCountryOptionsPt, TaxRegistrationCountryOptionsRoParams, TaxRegistrationCountryOptionsRo, TaxRegistrationCountryOptionsSeParams, TaxRegistrationCountryOptionsSe, TaxRegistrationCountryOptionsSiParams, TaxRegistrationCountryOptionsSi, TaxRegistrationCountryOptionsSkParams, and TaxRegistrationCountryOptionsSk
  • Add support for error codes authentication_failure, capability_not_active, expired_payment_method, incorrect_postal_code, invalid_canceled_subscription_fields, and payment_method_restricted on Error, InvoiceLastFinalizationError, PaymentIntentLastPaymentError, SetupAttemptSetupError, SetupIntentLastSetupError, StripeError, and TerminalReaderActionApiError

See the changelog for more details.