This release changes the pinned API version to 2026-08-26.dahlia.
-
#1881 Add new
EventNotificationHandlerclass 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
StripeClientand 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
- As part of this work, we've widened some of the types our webhook-related methods take so they play more nicely with the types commonly returned by popular web frameworks (#1888)
-
#1876 Update generated code
- Add support for new resource
billing.FeedbackOption - Add support for
create,deactivate,list,modify, andretrievemethods on resourcebilling.FeedbackOption - Add support for
payment_method_settingsonAccountSession.ComponentandAccountSessionCreateParamsComponent - Add support for
feedback_optionsonBillingPortal.Configuration.Feature.SubscriptionCancel.CancellationReason,billing_portal.ConfigurationCreateParamsFeatureSubscriptionCancelCancellationReason, andbilling_portal.ConfigurationModifyParamsFeatureSubscriptionCancelCancellationReason - Add support for new value
customer_updateon enumsBillingPortal.Session.Flow.typeandbilling_portal.SessionCreateParamsFlowDatum.type - Add support for
customer_updateonBillingPortal.Session.Flow - Add support for
funding_source_grouponCharge.PaymentMethodDetail.Card.Wallet.LinkandCharge.PaymentMethodDetail.Link - Add support for
funding_types_blockedonCheckout.Session.PaymentMethodOption.Card.Restrictionandcheckout.SessionCreateParamsPaymentMethodOptionCardRestriction - Add support for
metadataonConfirmationToken - Add support for
active_entitlementsandcustomer_portalonCustomerSession.ComponentandCustomerSessionCreateParamsComponent - Add support for
countryonFinancialConnections.Session.Filter - Add support for
frozen_fieldsonInvoiceItem - Add support for
billieonInvoice.PaymentSetting.PaymentMethodOption,InvoiceCreateParamsPaymentSettingPaymentMethodOption,InvoiceModifyParamsPaymentSettingPaymentMethodOption,Subscription.PaymentSetting.PaymentMethodOption,SubscriptionCreateParamsPaymentSettingPaymentMethodOption, andSubscriptionModifyParamsPaymentSettingPaymentMethodOption - Add support for new value
billieon enumsInvoice.PaymentSetting.payment_method_types,InvoiceCreateParamsPaymentSetting.payment_method_types,InvoiceModifyParamsPaymentSetting.payment_method_types,Subscription.PaymentSetting.payment_method_types,SubscriptionCreateParamsPaymentSetting.payment_method_types, andSubscriptionModifyParamsPaymentSetting.payment_method_types - ⚠️ Remove support for
cryptogramonPaymentAttemptRecord.PaymentMethodDetail.Card.ThreeDSecureandPaymentRecord.PaymentMethodDetail.Card.ThreeDSecure - Add support for new value
touch_n_goon enumsPaymentIntent.allowed_payment_method_types,PaymentIntentConfirmParams.allowed_payment_method_types,PaymentIntentCreateParams.allowed_payment_method_types,PaymentIntentModifyParams.allowed_payment_method_types,SetupIntent.allowed_payment_method_types,SetupIntentConfirmParams.allowed_payment_method_types,SetupIntentCreateParams.allowed_payment_method_types, andSetupIntentModifyParams.allowed_payment_method_types - Change
PaymentIntent.allowed_payment_method_typesandSetupIntent.allowed_payment_method_typesto be required - Add support for
application_fee_amount,application_fee_percent,on_behalf_of, andtransfer_dataonPaymentLinkModifyParams - Add support for
feedback_optiononSubscription.CancellationDetail,SubscriptionCancelParamsCancellationDetail, andSubscriptionModifyParamsCancellationDetail - Add support for
igiconTax.Registration.CountryOption.At,Tax.Registration.CountryOption.Be,Tax.Registration.CountryOption.Bg,Tax.Registration.CountryOption.Cy,Tax.Registration.CountryOption.Cz,Tax.Registration.CountryOption.De,Tax.Registration.CountryOption.Dk,Tax.Registration.CountryOption.E,Tax.Registration.CountryOption.Ee,Tax.Registration.CountryOption.Fi,Tax.Registration.CountryOption.Fr,Tax.Registration.CountryOption.Gr,Tax.Registration.CountryOption.Hr,Tax.Registration.CountryOption.Hu,Tax.Registration.CountryOption.Ie,Tax.Registration.CountryOption.It,Tax.Registration.CountryOption.Lt,Tax.Registration.CountryOption.Lu,Tax.Registration.CountryOption.Lv,Tax.Registration.CountryOption.Mt,Tax.Registration.CountryOption.Nl,Tax.Registration.CountryOption.Pl,Tax.Registration.CountryOption.Pt,Tax.Registration.CountryOption.Ro,Tax.Registration.CountryOption.Se,Tax.Registration.CountryOption.Si,Tax.Registration.CountryOption.Sk,tax.RegistrationCreateParamsCountryOptionAt,tax.RegistrationCreateParamsCountryOptionBe,tax.RegistrationCreateParamsCountryOptionBg,tax.RegistrationCreateParamsCountryOptionCy,tax.RegistrationCreateParamsCountryOptionCz,tax.RegistrationCreateParamsCountryOptionDe,tax.RegistrationCreateParamsCountryOptionDk,tax.RegistrationCreateParamsCountryOptionE,tax.RegistrationCreateParamsCountryOptionEe,tax.RegistrationCreateParamsCountryOptionFi,tax.RegistrationCreateParamsCountryOptionFr,tax.RegistrationCreateParamsCountryOptionGr,tax.RegistrationCreateParamsCountryOptionHr,tax.RegistrationCreateParamsCountryOptionHu,tax.RegistrationCreateParamsCountryOptionIe,tax.RegistrationCreateParamsCountryOptionIt,tax.RegistrationCreateParamsCountryOptionLt,tax.RegistrationCreateParamsCountryOptionLu,tax.RegistrationCreateParamsCountryOptionLv,tax.RegistrationCreateParamsCountryOptionMt,tax.RegistrationCreateParamsCountryOptionNl,tax.RegistrationCreateParamsCountryOptionPl,tax.RegistrationCreateParamsCountryOptionPt,tax.RegistrationCreateParamsCountryOptionRo,tax.RegistrationCreateParamsCountryOptionSe,tax.RegistrationCreateParamsCountryOptionSi, andtax.RegistrationCreateParamsCountryOptionSk - Add support for new value
2026-08-26.dahliaon enumWebhookEndpointCreateParams.api_version - Add support for error codes
authentication_failure,capability_not_active,expired_payment_method,incorrect_postal_code,invalid_canceled_subscription_fields, andpayment_method_restrictedonInvoice.LastFinalizationError,PaymentIntent.LastPaymentError,SetupAttempt.SetupError,SetupIntent.LastSetupError,StripeError, andTerminal.Reader.Action.ApiError
- Add support for new resource