v15.7.0a2

• #1893 Update generated code for private-preview
  • Add support for new resources radar.BillingEvaluation, v2.signals.PaymentRetryEvaluation, v2.signals.PaymentRetrySignal, and v2.tax.IntegrationConfiguration
  • Add support for create method on resource radar.BillingEvaluation
  • Add support for create, deactivate, list, modify, and retrieve methods on resource billing.FeedbackOption
  • Add support for modify and retrieve methods on resource v2.tax.IntegrationConfiguration
  • Add support for retrieve method on resource v2.signals.PaymentRetrySignal
  • Add support for cancel, create, modify, and retrieve methods on resource v2.signals.PaymentRetryEvaluation
  • Add support for disable method on resource v2.money_management.PayoutMethod
  • Add support for modify method on resource v2.core.ApprovalRequest
  • ⚠️ Remove support for execute and submit methods on resource v2.core.ApprovalRequest
  • Add support for disable_stripe_user_authentication on AccountSessionCreateParamsComponentPaymentMethodSettingFeature
  • Add support for capital_financing_manual_payment on AccountSession.Component
  • Add support for sequra_payments on Account.Capability
  • Add support for feedback_options on billing_portal.ConfigurationCreateParamsFeatureSubscriptionCancelCancellationReason and billing_portal.ConfigurationModifyParamsFeatureSubscriptionCancelCancellationReason
  • Add support for new value fundbox_ca_financing on enum Capital.FinancingSummary.Detail.disclaimer_variant
  • Add support for sequra on Charge.PaymentMethodDetail, Checkout.Session.PaymentMethodOption, ConfirmationToken.PaymentMethodPreview, PaymentAttemptRecord.PaymentMethodDetail, PaymentIntent.PaymentMethodOption, and PaymentRecord.PaymentMethodDetail
  • ⚠️ Remove support for value data_share_only from enums Charge.PaymentMethodDetail.Card.ThreeDSecure.result, PaymentAttemptRecord.PaymentMethodDetail.Card.ThreeDSecure.result, PaymentRecord.PaymentMethodDetail.Card.ThreeDSecure.result, and SetupAttempt.PaymentMethodDetail.Card.ThreeDSecure.result
  • Add support for funding_types_blocked on checkout.SessionCreateParamsPaymentMethodOptionCardRestriction
  • Add support for payment_intent_data on checkout.SessionModifyParams
  • ⚠️ Change type of Checkout.Session.PaymentMethodOption.Bancontact.setup_future_usage from literal('none') to enum('none'|'off_session')
  • Add support for new value sequra on enums ConfirmationTokenCreateParamsPaymentMethodDatum.type, PaymentIntentConfirmParamsPaymentMethodDatum.type, PaymentIntentCreateParamsPaymentMethodDatum.type, PaymentIntentModifyParamsPaymentMethodDatum.type, SetupIntentConfirmParamsPaymentMethodDatum.type, SetupIntentCreateParamsPaymentMethodDatum.type, and SetupIntentModifyParamsPaymentMethodDatum.type
  • Add support for metadata on ConfirmationToken, V2.Signals.AccountActivity, and v2.signals.AccountActivityCreateParams
  • Add support for new value sequra on enums ConfirmationToken.PaymentMethodPreview.type and PaymentMethod.type
  • Add support for active_entitlements and customer_portal on CustomerSessionCreateParamsComponent
  • Add support for new value sequra on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for address_match_confidence and name_match_confidence on Identity.VerificationReport.Email and Identity.VerificationReport.Phone
  • Add support for domain_country, email_exists_confidence, observed_domain_tenure_days, observed_email_tenure_days, and phone_match_confidence on Identity.VerificationReport.Email
  • Add support for new values email_address_mismatch, email_name_mismatch, email_ownership_unverified, email_phone_mismatch, and email_short_tenure on enum Identity.VerificationReport.Email.Error.code
  • Add support for carrier, line_type, and observed_phone_tenure_days on Identity.VerificationReport.Phone
  • Add support for new values phone_address_mismatch, phone_invalid_line_type, phone_invalid, phone_name_mismatch, phone_ownership_unverified, phone_short_tenure, and phone_unsupported_country on enum Identity.VerificationReport.Phone.Error.code
  • Add support for new values email_address_mismatch, email_name_mismatch, email_ownership_unverified, email_phone_mismatch, email_short_tenure, phone_address_mismatch, phone_invalid_line_type, phone_invalid, phone_name_mismatch, phone_ownership_unverified, phone_short_tenure, and phone_unsupported_country on enum Identity.VerificationSession.LastError.code
  • Add support for new value truemoney on enums Invoice.PaymentSetting.payment_method_types, InvoiceCreateParamsPaymentSetting.payment_method_types, InvoiceModifyParamsPaymentSetting.payment_method_types, QuotePreviewInvoice.PaymentSetting.payment_method_types, Subscription.PaymentSetting.payment_method_types, SubscriptionCreateParamsPaymentSetting.payment_method_types, and SubscriptionModifyParamsPaymentSetting.payment_method_types
  • Add support for new value merchant_canceled on enums PaymentAttemptRecordReportCanceledParams.reason and PaymentRecordReportPaymentAttemptCanceledParams.reason
  • ⚠️ Remove support for payment_method_types on PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentModifyParams, SetupIntentCreateParams, and SetupIntentModifyParams
  • Add support for new value touch_n_go on enums PaymentIntent.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, and SetupIntentModifyParams.allowed_payment_method_types
  • Add support for new value sequra on enums PaymentIntent.excluded_payment_method_types, PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentModifyParams.excluded_payment_method_types, SetupIntent.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, and SetupIntentModifyParams.excluded_payment_method_types
  • Add support for verification_method on PaymentIntent.PaymentMethodOption.BacsDebit, PaymentIntentConfirmParamsPaymentMethodOptionBacsDebit, PaymentIntentCreateParamsPaymentMethodOptionBacsDebit, PaymentIntentModifyParamsPaymentMethodOptionBacsDebit, SetupIntent.PaymentMethodOption.BacsDebit, SetupIntentConfirmParamsPaymentMethodOptionBacsDebit, SetupIntentCreateParamsPaymentMethodOptionBacsDebit, and SetupIntentModifyParamsPaymentMethodOptionBacsDebit
  • Change PaymentIntent.allowed_payment_method_types and SetupIntent.allowed_payment_method_types to be required
  • Add support for application_fee_amount, application_fee_percent, on_behalf_of, and transfer_data on PaymentLinkModifyParams
  • Add support for canceled on PaymentRecordReportPaymentAttemptParams and PaymentRecordReportPaymentParams
  • ⚠️ Change type of ProductCatalog.TrialOffer.price from $Price to deletable($Price)
  • ⚠️ Change ProductCatalog.TrialOffer.name to be optional
  • Add support for recurring on SharedPayment.GrantedToken.UsageLimit, SharedPayment.IssuedToken.UsageLimit, shared_payment.GrantedTokenCreateParamsUsageLimit, and shared_payment.IssuedTokenCreateParamsUsageLimit
  • Add support for feedback_option on SubscriptionCancelParamsCancellationDetail and SubscriptionModifyParamsCancellationDetail
  • Add support for pricing_token on SubscriptionModifyParams
  • Add support for igic on 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, and tax.RegistrationCreateParamsCountryOptionSk
  • Add support for new value 2026-08-26.dahlia on enum WebhookEndpointCreateParams.api_version
  • Add support for one_time_fees on V2.Billing.Contract and v2.billing.ContractCreateParams
  • ⚠️ Remove support for payment_method_collection on V2.Core.Account.Configuration.Merchant.GrossSettlement, v2.core.AccountCreateParamsConfigurationMerchantGrossSettlement, and v2.core.AccountModifyParamsConfigurationMerchantGrossSettlement
  • Add support for payout_methods on V2.Core.Account.Default and v2.core.AccountModifyParamsDefault
  • Add support for reason on V2.Core.ApprovalRequest
  • ⚠️ Remove support for description on V2.Core.ApprovalRequest
  • Add support for api_key, type, and `u...

v15.6.1

• #1896 Harden API requestor code against malicious URLs
• #1898 Use cryptographically secure boundaries for multipart file uploads
• #1860 Dispatch discriminated union fields to their variant class

See the changelog for more details.

v15.7.0b1

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

• #1858 Update generated code for beta
  • Add support for new resources v2.core.ApprovalRequest, v2.signals.AccountActivity, v2.signals.AccountEvaluation, and v2.signals.AccountSignal
  • Add support for list and retrieve methods on resource v2.signals.AccountSignal
  • Add support for create and retrieve methods on resource v2.signals.AccountEvaluation
  • Add support for create, delete, and retrieve methods on resource v2.signals.AccountActivity
  • Add support for cancel, list, modify, and retrieve methods on resource v2.core.ApprovalRequest
  • Add support for disable method on resource v2.money_management.PayoutMethod
  • Add support for disable_stripe_user_authentication on AccountSessionCreateParamsComponentPaymentMethodSettingFeature
  • ⚠️ Remove support for payment_method_types on PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentModifyParams, SetupIntentCreateParams, and SetupIntentModifyParams
  • ⚠️ Change type of ProductCatalog.TrialOffer.EndBehavior.Transition.price and ProductCatalog.TrialOffer.price from $Price to deletable($Price)
  • Add support for billie on QuotePreviewInvoice.PaymentSetting.PaymentMethodOption
  • Add support for new value billie on enum QuotePreviewInvoice.PaymentSetting.payment_method_types
  • Add support for payout_methods on V2.Core.Account.Default and v2.core.AccountModifyParamsDefault
  • Add support for restricted on V2.Core.Vault.GbBankAccount and V2.Core.Vault.UsBankAccount
  • Add support for enabled_delivery_schemes on V2.MoneyManagement.PayoutMethod.BankAccount
  • ⚠️ Remove support for enabled_delivery_options on V2.MoneyManagement.PayoutMethod.BankAccount
  • ⚠️ Add support for new value disabled on enum V2.MoneyManagement.PayoutMethod.UsageStatus.payments
  • ⚠️ Add support for new value disabled on enum V2.MoneyManagement.PayoutMethod.UsageStatus.transfers
  • Add support for new value disabled on enum v2.money_management.PayoutMethodListParamsUsageStatus.payments
  • Add support for new value disabled on enum v2.money_management.PayoutMethodListParamsUsageStatus.transfers
  • Add support for event notifications V2CoreApprovalRequestApprovedEvent, V2CoreApprovalRequestCanceledEvent, V2CoreApprovalRequestCreatedEvent, V2CoreApprovalRequestExpiredEvent, V2CoreApprovalRequestFailedEvent, V2CoreApprovalRequestRejectedEvent, and V2CoreApprovalRequestSucceededEvent with related object v2.core.ApprovalRequest
  • Add support for event notification V2SignalsAccountEvaluationCompleteEvent with related object v2.signals.AccountEvaluation
  • 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 QuotePreviewInvoice.LastFinalizationError
  • Add support for error code default_payout_method_cannot_be_disabled on CannotProceedError
• #1878 Add non-verified methods to managed handlers

See the changelog for more details.

v15.7.0a1

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

• #1884 Update generated code for private-preview
  • Add support for new resource CustomerTaxExemption
  • Add support for create, delete, list, and retrieve methods on resource CustomerTaxExemption
  • Add support for details on Account.FutureRequirement.Error, Account.Requirement.Error, BankAccount.FutureRequirement.Error, BankAccount.Requirement.Error, Capability.FutureRequirement.Error, Capability.Requirement.Error, Person.FutureRequirement.Error, and Person.Requirement.Error
  • ⚠️ Remove support for sequra_payments on Account.Capability
  • Add support for subscription_pause on billing_portal.SessionCreateParamsFlowDatum
  • ⚠️ Remove support for sequra on Charge.PaymentMethodDetail, Checkout.Session.PaymentMethodOption, ConfirmationToken.PaymentMethodPreview, PaymentAttemptRecord.PaymentMethodDetail, PaymentIntent.PaymentMethodOption, and PaymentRecord.PaymentMethodDetail
  • Add support for enablement_details on Checkout.Session.AutomaticTax
  • ⚠️ Remove support for value sequra from enums ConfirmationTokenCreateParamsPaymentMethodDatum.type, PaymentIntentConfirmParamsPaymentMethodDatum.type, PaymentIntentCreateParamsPaymentMethodDatum.type, PaymentIntentModifyParamsPaymentMethodDatum.type, SetupIntentConfirmParamsPaymentMethodDatum.type, SetupIntentCreateParamsPaymentMethodDatum.type, and SetupIntentModifyParamsPaymentMethodDatum.type
  • ⚠️ Remove support for value sequra from enums ConfirmationToken.PaymentMethodPreview.type and PaymentMethod.type
  • ⚠️ Remove support for value sequra from enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for credit on FinancialConnections.Transaction.Classification
  • Change type of FinancialConnections.Transaction.Classification.money_movement from nullable(BankConnectionsResourceTransactionResourceClassificationsLabels) to BankConnectionsResourceTransactionResourceClassificationsLabels
  • Change type of FinancialConnections.Transaction.Classification.personal_finance from nullable(BankConnectionsResourceTransactionResourceClassificationsLabels) to BankConnectionsResourceTransactionResourceClassificationsLabels
  • ⚠️ Change FinancialConnections.Transaction.Classification.money_movement to be optional
  • ⚠️ Change FinancialConnections.Transaction.Classification.personal_finance to be optional
  • Add support for user_consent on identity.VerificationSessionCreateParams and identity.VerificationSessionModifyParams
  • Add support for company_details on Invoice.PaymentSetting.PaymentMethodOption.Billie, PaymentIntent.PaymentMethodOption.Billie, PaymentIntentConfirmParamsPaymentMethodOptionBillie, PaymentIntentCreateParamsPaymentMethodOptionBillie, PaymentIntentModifyParamsPaymentMethodOptionBillie, QuotePreviewInvoice.PaymentSetting.PaymentMethodOption.Billie, and Subscription.PaymentSetting.PaymentMethodOption.Billie
  • Add support for reference on Invoice.PaymentSetting.PaymentMethodOption.Billie, PaymentIntent.PaymentMethodOption.Billie, PaymentIntentConfirmParamsPaymentMethodOptionBillie, PaymentIntentCreateParamsPaymentMethodOptionBillie, PaymentIntentModifyParamsPaymentMethodOptionBillie, and QuotePreviewInvoice.PaymentSetting.PaymentMethodOption.Billie
  • Add support for pos_condition on Issuing.Authorization and issuing.AuthorizationCreateParams
  • Add support for crypto_wallet on Issuing.Card, issuing.CardCreateParams, and issuing.CardModifyParams
  • Add support for payment_evaluations and payment_method_details on PaymentAttemptRecordReportAuthorizedParams
  • Add support for aade_data on PaymentIntentConfirmParamsPaymentMethodOptionCardPresent, PaymentIntentCreateParamsPaymentMethodOptionCardPresent, and PaymentIntentModifyParamsPaymentMethodOptionCardPresent
  • ⚠️ Remove support for cancel_at_period_end on Subscription.PendingUpdate
  • Add support for blik_recurring_payments on V2.Core.Account.Configuration.Merchant.Capability, v2.core.AccountCreateParamsConfigurationMerchantCapability, and v2.core.AccountModifyParamsConfigurationMerchantCapability
  • Add support for user_access on V2.Iam.ActivityLog.Detail
  • Add support for new value user_access on enum V2.Iam.ActivityLog.Detail.type
  • Add support for new value user_access_started on enum V2.Iam.ActivityLog.type
  • Add support for new value user_access on enum v2.iam.ActivityLogListParams.action_groups
  • Add support for new value user_access_started on enum v2.iam.ActivityLogListParams.actions
  • Add support for new value blik_recurring_payments on enum EventsV2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent.updated_capability
• #1880 Add non-verified manged handlers

See the changelog for more details.

v15.6.0

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

• #1881 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
  • 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, and retrieve methods on resource billing.FeedbackOption
  • Add support for payment_method_settings on AccountSession.Component and AccountSessionCreateParamsComponent
  • Add support for feedback_options on BillingPortal.Configuration.Feature.SubscriptionCancel.CancellationReason, billing_portal.ConfigurationCreateParamsFeatureSubscriptionCancelCancellationReason, and billing_portal.ConfigurationModifyParamsFeatureSubscriptionCancelCancellationReason
  • Add support for new value customer_update on enums BillingPortal.Session.Flow.type and billing_portal.SessionCreateParamsFlowDatum.type
  • Add support for customer_update on BillingPortal.Session.Flow
  • Add support for funding_source_group on Charge.PaymentMethodDetail.Card.Wallet.Link and Charge.PaymentMethodDetail.Link
  • Add support for funding_types_blocked on Checkout.Session.PaymentMethodOption.Card.Restriction and checkout.SessionCreateParamsPaymentMethodOptionCardRestriction
  • Add support for metadata on ConfirmationToken
  • Add support for active_entitlements and customer_portal on CustomerSession.Component and CustomerSessionCreateParamsComponent
  • Add support for country on FinancialConnections.Session.Filter
  • Add support for frozen_fields on InvoiceItem
  • Add support for billie on Invoice.PaymentSetting.PaymentMethodOption, InvoiceCreateParamsPaymentSettingPaymentMethodOption, InvoiceModifyParamsPaymentSettingPaymentMethodOption, Subscription.PaymentSetting.PaymentMethodOption, SubscriptionCreateParamsPaymentSettingPaymentMethodOption, and SubscriptionModifyParamsPaymentSettingPaymentMethodOption
  • Add support for new value billie on enums Invoice.PaymentSetting.payment_method_types, InvoiceCreateParamsPaymentSetting.payment_method_types, InvoiceModifyParamsPaymentSetting.payment_method_types, Subscription.PaymentSetting.payment_method_types, SubscriptionCreateParamsPaymentSetting.payment_method_types, and SubscriptionModifyParamsPaymentSetting.payment_method_types
  • ⚠️ Remove support for cryptogram on PaymentAttemptRecord.PaymentMethodDetail.Card.ThreeDSecure and PaymentRecord.PaymentMethodDetail.Card.ThreeDSecure
  • Add support for new value touch_n_go on enums PaymentIntent.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, and SetupIntentModifyParams.allowed_payment_method_types
  • Change PaymentIntent.allowed_payment_method_types and SetupIntent.allowed_payment_method_types to be required
  • Add support for application_fee_amount, application_fee_percent, on_behalf_of, and transfer_data on PaymentLinkModifyParams
  • Add support for feedback_option on Subscription.CancellationDetail, SubscriptionCancelParamsCancellationDetail, and SubscriptionModifyParamsCancellationDetail
  • Add support for igic on Tax.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, and tax.RegistrationCreateParamsCountryOptionSk
  • Add support for new value 2026-08-26.dahlia on enum WebhookEndpointCreateParams.api_version
  • 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 Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, StripeError, and Terminal.Reader.Action.ApiError

See the changelog for more details.

v15.6.0a2

• #1875 Update generated code for private-preview
  • Add support for new resources PaymentPlan and billing.FeedbackOption
  • ⚠️ Remove support for resource billing.FeedbackOptions
  • Add support for create, list, modify, and retrieve methods on resource PaymentPlan
  • Add support for modify method on resource v2.money_management.Transaction
  • Add support for wechat_pay_payments on Account.Setting, AccountCreateParamsSetting, and AccountModifyParamsSetting
  • ⚠️ Change type of BillingPortal.Configuration.Feature.SubscriptionCancel.CancellationReason.feedback_options from $Billing.FeedbackOptions to $Billing.FeedbackOption
  • Change BillingPortal.Configuration.Feature.SubscriptionCancel.CancellationReason.feedback_options to be required
  • Add support for subscription_pause on BillingPortal.Session.Flow
  • Add support for new value subscription_pause on enum BillingPortal.Session.Flow.type
  • Add support for new value usdt on enums Crypto.OnrampSession.TransactionDetail.destination_currency, crypto.OnrampSessionCreateParams.destination_currency, and crypto.OnrampSessionListParams.destination_currency
  • Add support for new value usdt on enums Crypto.OnrampSession.TransactionDetail.destination_currencies and crypto.OnrampSessionCreateParams.destination_currencies
  • Add support for active_entitlements on CustomerSession.Component
  • Add support for shared_payment_issued_token on delegated_checkout.RequestedSessionConfirmParams
  • Add support for new values payment_plan.created, payment_plan.installment_due, payment_plan.installment_paid, payment_plan.installment_will_be_due, and payment_plan.updated on enum Event.type
  • Add support for managed_payments on InvoiceCreateParams, InvoiceItemCreateParams, InvoiceItem, Invoice, and QuotePreviewInvoice
  • Add support for payment_plan on Invoice
  • Add support for estimated_fee_details and estimated_fee on Issuing.Authorization.PendingRequest.HoldAmountDetail and Issuing.Authorization.RequestHistory.HoldAmountDetail
  • ⚠️ Remove support for cryptogram on PaymentAttemptRecord.PaymentMethodDetail.Card.ThreeDSecure and PaymentRecord.PaymentMethodDetail.Card.ThreeDSecure
  • ⚠️ Change type of ProductCatalog.TrialOffer.EndBehavior.Transition.price from $Price to deletable($Price)
  • ⚠️ Change type of Subscription.CancellationDetail.feedback_option from $Billing.FeedbackOptions to $Billing.FeedbackOption
  • Add support for cancel_at_period_end on Subscription.PendingUpdate
  • Change Subscription.CancellationDetail.feedback_option to be required
  • Add support for igic on Tax.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, and Tax.Registration.CountryOption.Sk
  • Add support for metadata on V2.Billing.Contract.PricingLine.Datum.Pricing.PriceDetail.PricingOverride.Datum, V2.Billing.Contract.PricingOverride.Datum, V2.MoneyManagement.Transaction, v2.billing.ContractCreateParamsPricingOverride, v2.billing.ContractModifyParamsPricingLineActionUpdate, v2.billing.ContractModifyParamsPricingOverrideActionAdd, v2.billing.ContractModifyParamsPricingOverrideActionUpdate, and v2.billing.ContractModifyParams
  • Add support for tax_amount on V2.MoneyManagement.OutboundPaymentQuote.EstimatedFee
  • Add support for payout_method_options on V2.MoneyManagement.OutboundPaymentQuote.To and v2.money_management.OutboundPaymentQuoteCreateParamsTo
  • Change type of v2.billing.ContractModifyParamsPricingLineActionUpdatePricingPriceDetailPricingOverrideActionUpdate.metadata from string to emptyable(string)
  • Add support for snapshot events payment_plan.created, payment_plan.installment_due, payment_plan.installment_paid, payment_plan.installment_will_be_due, and payment_plan.updated with resource PaymentPlan

See the changelog for more details.

v15.5.1

• #1879 better document StripeObject's to_dict behavior

See the changelog for more details.

v15.6.0a1

This release changes the pinned API version to 2026-08-12.preview.

• #1873 Update generated code for private-preview
  • Add support for new resource v2.tax.OperationsResolveAddressResult
  • Add support for resolve_address method on resource v2.tax.OperationsResolveAddressResult
  • Add support for confirm and fx_quote methods on resource v2.money_management.PayoutIntent
  • ⚠️ Add support for new value partner_disabled on enums Account.FutureRequirement.Error.code, Account.Requirement.Error.code, BankAccount.FutureRequirement.Error.code, BankAccount.Requirement.Error.code, Capability.FutureRequirement.Error.code, Capability.Requirement.Error.code, Person.FutureRequirement.Error.code, and Person.Requirement.Error.code
  • ⚠️ Remove support for values partner_disabled_dispute_rate, partner_disabled_responsibilities, partner_disabled_restricted_business, and partner_disabled_suspected_fraud from enums Account.FutureRequirement.Error.code, Account.Requirement.Error.code, BankAccount.FutureRequirement.Error.code, BankAccount.Requirement.Error.code, Capability.FutureRequirement.Error.code, Capability.Requirement.Error.code, Person.FutureRequirement.Error.code, and Person.Requirement.Error.code
  • Add support for customer_update on BillingPortal.Session.Flow
  • Add support for new value customer_update on enum BillingPortal.Session.Flow.type
  • Add support for funding_source_group on Charge.PaymentMethodDetail.Link
  • ⚠️ Remove support for pricing_group on Charge.PaymentMethodDetail.Link
  • Add support for new value celo on enum Crypto.CustomerConsumerWallet.network
  • Add support for new value celo on enums Crypto.OnrampSession.TransactionDetail.destination_network, crypto.OnrampSessionCreateParams.destination_network, crypto.OnrampSessionListParams.destination_network, and crypto.OnrampTransactionLimitsRetrieveParams.destination_network
  • Add support for new value celo on enums Crypto.OnrampSession.TransactionDetail.destination_networks and crypto.OnrampSessionCreateParams.destination_networks
  • Add support for celo on Crypto.OnrampSession.TransactionDetail.WalletAddress
  • Add support for customer_portal on CustomerSession.Component
  • Add support for applied_to_invoice and type on CustomerCreateCustomerBalanceTransactionParams
  • Add support for classification_state and enrichment_state on FinancialConnections.Account
  • Add support for country on FinancialConnections.Session.Filter
  • Add support for classifications and enrichments on FinancialConnections.Transaction
  • Add support for new values billie, paypay, and vipps on enums Invoice.PaymentSetting.payment_method_types, InvoiceCreateParamsPaymentSetting.payment_method_types, InvoiceModifyParamsPaymentSetting.payment_method_types, QuotePreviewInvoice.PaymentSetting.payment_method_types, Subscription.PaymentSetting.payment_method_types, SubscriptionCreateParamsPaymentSetting.payment_method_types, and SubscriptionModifyParamsPaymentSetting.payment_method_types
  • Add support for customer_balance on Invoice and QuotePreviewInvoice
  • Add support for billie on Invoice.PaymentSetting.PaymentMethodOption, QuotePreviewInvoice.PaymentSetting.PaymentMethodOption, and Subscription.PaymentSetting.PaymentMethodOption
  • Add support for hold_amount_details and hold_amount on Issuing.Authorization.PendingRequest and Issuing.Authorization.RequestHistory
  • Add support for new values hu and ro on enums Issuing.Cardholder.preferred_locales, issuing.CardholderCreateParams.preferred_locales, and issuing.CardholderModifyParams.preferred_locales
  • Add support for new values authentication_failure, expired_payment_method, incorrect_cvc, incorrect_number, incorrect_postal_code, insufficient_funds, payment_method_restricted, and processing_error on enums PaymentAttemptRecordReportFailedParams.failure_code, PaymentRecordReportPaymentAttemptFailedParams.failure_code, PaymentRecordReportPaymentAttemptParamsFailed.failure_code, and PaymentRecordReportPaymentParamsFailed.failure_code
  • Add support for network_decline_code on PaymentAttemptRecordReportFailedParamsPaymentMethodDetailCard and PaymentRecordReportPaymentAttemptFailedParamsPaymentMethodDetailCard
  • Add support for setup_future_usage on PaymentIntent.PaymentMethodOption.Sequra
  • Add support for status on QuotePreviewSubscriptionSchedule.PauseSchedule.Pause, QuotePreviewSubscriptionSchedule.PauseSchedule.Resume, SubscriptionSchedule.PauseSchedule.Pause, and SubscriptionSchedule.PauseSchedule.Resume
  • Change SubscriptionScheduleCreateParamsPauseSchedule.pause to be optional
  • Change type of SubscriptionScheduleModifyParamsPauseSchedule.resume from pause_schedule_update_resume_params to emptyable(pause_schedule_update_resume_params)
  • Add support for acquirer on EventsV2CoreHealthAuthorizationRateDropFiringEvent.Impact.Dimension, EventsV2CoreHealthAuthorizationRateDropResolvedEvent.Impact.Dimension, V2.Core.Health.Alert.AuthorizationRateDrop.Dimension, and V2.Core.Health.AlertHistoryEntry.AuthorizationRateDrop.Dimension
  • ⚠️ Change type of EventsV2CoreHealthAuthorizationRateDropFiringEvent.Impact.Dimension.type, EventsV2CoreHealthAuthorizationRateDropResolvedEvent.Impact.Dimension.type, V2.Core.Health.Alert.AuthorizationRateDrop.Dimension.type, and V2.Core.Health.AlertHistoryEntry.AuthorizationRateDrop.Dimension.type from literal('issuer') to enum('acquirer'|'issuer')
  • Add support for confirmation_method on V2.MoneyManagement.PayoutIntent and v2.money_management.PayoutIntentCreateParams
  • Add support for estimated_fees and fx_quote on V2.MoneyManagement.PayoutIntent
  • Add support for debited on V2.MoneyManagement.PayoutIntent.From
  • Add support for confirm on V2.MoneyManagement.PayoutIntent.NextAction
  • ⚠️ Change type of V2.MoneyManagement.PayoutIntent.NextAction.type from literal('handle_failure') to enum('confirm'|'handle_failure')
  • Add support for credited on V2.MoneyManagement.PayoutIntent.To
  • Add support for new value one_time_fees on enums v2.billing.ContractActivateParams.include, v2.billing.ContractCancelParams.include, v2.billing.ContractCreateParams.include, v2.billing.ContractListParams.include, v2.billing.ContractModifyParams.include, and v2.billing.ContractRetrieveParams.include
  • Add support for event notification V1BalanceSettingsUpdatedEvent with related object BalanceSettings
  • Add support for event notification V1BillingCreditBalanceTransactionCreatedEvent with related object billing.CreditBalanceTransaction
  • Add support for event notifications V1BillingCreditGrantCreatedEvent and V1BillingCreditGrantUpdatedEvent with related object billing.CreditGrant
  • Add support for event notifications V1BillingMeterCreatedEvent, V1BillingMeterDeactivatedEvent, V1BillingMeterReactivatedEvent, and V1BillingMeterUpdatedEvent with related object billing.Meter
  • Add support for event notifications V1FinancialConnectionsAccountAccountNumbersUpdatedEvent, V1FinancialConnectionsAccountExpectedDeactivationDateUpdatedEvent, V1FinancialConnectionsAccountSupportedPaymentMethodTypesUpdatedEvent, V1FinancialConnectionsAccountUpcomingAccountNumberExpiryEvent, and V1FinancialConnectionsAccountUpcomingDeactivationEvent with related object financial_connections.Account
  • Add support for event notification V1InvoicePaymentAttemptRequiredEvent with related object Invoice
  • Add support for error type FxQuoteNeedsRefreshError

See the changelog for more details.

v15.5.0

• #1874 Add async iteration to v2 list auto-pagination

  • Adds async for support to v2 ListObject.auto_paging_iter().

• #1869 Surface object property on EventNotification

• #1867 Emit Claude Code plugin hint at module load time

  • Emits new Claude Code plugin hint when CLAUDECODE or CLAUDE_CODE_CHILD_SESSION environment variables are detected.

• #1855 add/adjust event parsing helpers

  • Added methods that return their respective Event/EventNotification class instances without verifying authenticity. Use them when you've previously verified an event (e.g. you verified, put the event in a queue, and are now processing). Supports events from AWS EventBridge and Azure Event Grid natively.
    • Webhook.construct_event_without_verification(payload)
    • StripeClient.construct_event_without_verification(payload)
    • StripeClient.parse_event_notification_without_verification(payload)
  • Added WebhookSignature.generate_signature_header(payload, secret, timestamp=None), which computes a full Stripe-Signature header for the given payload. Useful for unit tests!

• #1863 Add stripe.major_api_version constant

See the changelog for more details.

v15.5.0a2

• #1859 Update generated code for private-preview

  • Add support for new resource billing.FeedbackOptions
  • Add support for sequra_payments on Account.Capability
  • Add support for feedback_options on BillingPortal.Configuration.Feature.SubscriptionCancel.CancellationReason
  • Add support for sequra on Charge.PaymentMethodDetail, Checkout.Session.PaymentMethodOption, ConfirmationToken.PaymentMethodPreview, PaymentAttemptRecord.PaymentMethodDetail, PaymentIntent.PaymentMethodOption, and PaymentRecord.PaymentMethodDetail
  • Add support for retrieval_reference_number on Charge.PaymentMethodDetail.CardPresent, ConfirmationToken.PaymentMethodPreview.Card.GeneratedFrom.PaymentMethodDetail.CardPresent, PaymentAttemptRecord.PaymentMethodDetail.CardPresent, PaymentMethod.Card.GeneratedFrom.PaymentMethodDetail.CardPresent, and PaymentRecord.PaymentMethodDetail.CardPresent
  • Add support for pricing_group on Charge.PaymentMethodDetail.Link
  • Add support for tax_rates on Checkout.Session.ShippingOption, checkout.SessionCreateParamsShippingOption, and checkout.SessionModifyParamsShippingOption
  • ⚠️ Add support for new value daikin on enums Checkout.Session.AutomaticSurcharge.provider and PaymentLink.AutomaticSurcharge.provider
  • Add support for funding_types_blocked on Checkout.Session.PaymentMethodOption.Card.Restriction
  • Add support for new value sequra on enums ConfirmationTokenCreateParamsPaymentMethodDatum.type, PaymentIntentConfirmParamsPaymentMethodDatum.type, PaymentIntentCreateParamsPaymentMethodDatum.type, PaymentIntentModifyParamsPaymentMethodDatum.type, SetupIntentConfirmParamsPaymentMethodDatum.type, SetupIntentCreateParamsPaymentMethodDatum.type, and SetupIntentModifyParamsPaymentMethodDatum.type
  • Add support for new value sequra on enums ConfirmationToken.PaymentMethodPreview.type and PaymentMethod.type
  • Add support for new value sequra on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for healthcare on issuing.AuthorizationCaptureParamsPurchaseDetail, issuing.AuthorizationCreateParams, issuing.TransactionCreateForceCaptureParamsPurchaseDetail, and issuing.TransactionCreateUnlinkedRefundParamsPurchaseDetail
  • Change type of Issuing.Authorization.Healthcare.verification_status from nullable(enum('iias_merchant_exempt'|'iias_merchant_not_certified'|'iias_verified'|'not_verified')) to enum('iias_merchant_exempt'|'iias_merchant_not_certified'|'iias_verified'|'not_verified')
  • Add support for is_anomalous on PaymentAttemptRecordReportGuaranteedParams
  • Add support for new value sequra on enums PaymentIntent.excluded_payment_method_types, PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentModifyParams.excluded_payment_method_types, SetupIntent.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, and SetupIntentModifyParams.excluded_payment_method_types
  • Add support for aade_data on PaymentIntent.PaymentMethodOption.CardPresent
  • Change Radar.PaymentEvaluation.PaymentDetail.PaymentMethodDetail.Card.first6 to be required
  • Change Radar.PaymentEvaluation.PaymentDetail.PaymentMethodDetail.Card.last4 to be required
  • Add support for feedback_option on Subscription.CancellationDetail
  • Add support for application on V2.Payments.OffSessionPayment
  • Add support for status on v2.money_management.FinancialAccountStatementListParams
  • Change v2.billing.ContractCreateParams.pricing_lines to be optional

• #1865 Merge to private-preview

  No user-facing changes — this is a merge commit only.

See the changelog for more details.