• #2839 Update generated code for private-preview
  • Add support for customer_tax_exemption on Tax.Calculation.shipping_cost.tax_breakdown[], Tax.CalculationLineItem.tax_breakdown[], and Tax.Transaction.shipping_cost.tax_breakdown[]
  • Add support for new value data_share_only on enums Charge.payment_method_details.card.three_d_secure.result, PaymentAttemptRecord.payment_method_details.card.three_d_secure.result, PaymentRecord.payment_method_details.card.three_d_secure.result, and SetupAttempt.payment_method_details.card.three_d_secure.result
  • Add support for backdate_start_date on Checkout.Session.items[].subscription and Checkout.SessionCreateParams.items[].subscription
  • Add support for signals on Identity.VerificationReport
  • Add support for network_response_code on Issuing.Authorization.request_history[]
  • Add support for unit_cost_precision on PaymentIntentAmountDetailsLineItem, PaymentIntentCaptureParams.amount_details.line_items[], PaymentIntentConfirmParams.amount_details.line_items[], PaymentIntentCreateParams.amount_details.line_items[], PaymentIntentDecrementAuthorizationParams.amount_details.line_items[], PaymentIntentIncrementAuthorizationParams.amount_details.line_items[], and PaymentIntentUpdateParams.amount_details.line_items[]
  • Change PaymentIntent.payment_record to be required
  • Add support for active on ProductCatalog.TrialOfferListParams
  • Change Subscription.trial_settings.end_behavior.billing_cycle_anchor to be required
  • Add support for new value rtp on enum Treasury.FinancialAccount.financial_addresses[].supported_networks
  • Add support for new value blik_recurring_payments on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability

See the changelog for more details.

• #2841 Validate that webhook secrets are non-empty

See the changelog for more details.

• #2831 Use cryptographically secure boundaries for multipart file uploads
• #2836 update OtherString docstring
• #2835 Fix request coercion for GET and DELETE parameters
  • Fixes serialization of schema-coerced values, including Decimal, in GET and DELETE query parameters.
• #2829 Harden API requestor code against malicious URLs

See the changelog for more details.

• #2825 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, retrieve, and update methods on resource Billing.FeedbackOption
  • Add support for retrieve and update methods on resource V2.Tax.IntegrationConfiguration
  • Add support for retrieve method on resource V2.Signals.PaymentRetrySignal
  • Add support for cancel, create, retrieve, and update methods on resource V2.Signals.PaymentRetryEvaluation
  • Add support for disable method on resource V2.MoneyManagement.PayoutMethod
  • Add support for update method on resource V2.Core.ApprovalRequest
  • ⚠️ Remove support for execute and submit methods on resource V2.Core.ApprovalRequest
  • Add support for sequra_payments on Account.capabilities
  • Add support for disable_stripe_user_authentication on AccountSessionCreateParams.components.payment_method_settings.features
  • Add support for capital_financing_manual_payment on AccountSession.components
  • Add support for feedback_options on BillingPortal.ConfigurationCreateParams.features.subscription_cancel.cancellation_reason and BillingPortal.ConfigurationUpdateParams.features.subscription_cancel.cancellation_reason
  • Add support for new value fundbox_ca_financing on enum Capital.FinancingSummary.details.disclaimer_variant
  • Add support for sequra on Charge.payment_method_details, Checkout.Session.payment_method_options, ConfirmationToken.payment_method_preview, PaymentAttemptRecord.payment_method_details, PaymentIntent.payment_method_options, and PaymentRecord.payment_method_details
  • ⚠️ Remove support for value data_share_only from enums Charge.payment_method_details.card.three_d_secure.result, PaymentAttemptRecord.payment_method_details.card.three_d_secure.result, PaymentRecord.payment_method_details.card.three_d_secure.result, and SetupAttempt.payment_method_details.card.three_d_secure.result
  • Add support for funding_types_blocked on Checkout.SessionCreateParams.payment_method_options.card.restrictions
  • Add support for payment_intent_data on Checkout.SessionUpdateParams
  • ⚠️ Change type of Checkout.Session.payment_method_options.bancontact.setup_future_usage from literal('none') to enum('none'|'off_session')
  • Add support for new value sequra on enums ConfirmationTokenCreateParams.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, and SetupIntentUpdateParams.payment_method_data.type
  • Add support for metadata on ConfirmationToken, V2.Signals.AccountActivityCreateParams, and V2.Signals.AccountActivity
  • Add support for new value sequra on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Add support for active_entitlements and customer_portal on CustomerSessionCreateParams.components
  • 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.last_error.code
  • Add support for new value truemoney on enums Invoice.payment_settings.payment_method_types, InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, QuotePreviewInvoice.payment_settings.payment_method_types, Subscription.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.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, PaymentIntentUpdateParams, SetupIntentCreateParams, and SetupIntentUpdateParams
  • 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, PaymentIntentUpdateParams.allowed_payment_method_types, SetupIntent.allowed_payment_method_types, SetupIntentConfirmParams.allowed_payment_method_types, SetupIntentCreateParams.allowed_payment_method_types, and SetupIntentUpdateParams.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, PaymentIntentUpdateParams.excluded_payment_method_types, SetupIntent.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, and SetupIntentUpdateParams.excluded_payment_method_types
  • Add support for verification_method on PaymentIntent.payment_method_options.bacs_debit, PaymentIntentConfirmParams.payment_method_options.bacs_debit, PaymentIntentCreateParams.payment_method_options.bacs_debit, PaymentIntentUpdateParams.payment_method_options.bacs_debit, SetupIntent.payment_method_options.bacs_debit, SetupIntentConfirmParams.payment_method_options.bacs_debit, SetupIntentCreateParams.payment_method_options.bacs_debit, and SetupIntentUpdateParams.payment_method_options.bacs_debit
  • 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 PaymentLinkUpdateParams
  • 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.usage_limits, SharedPayment.GrantedTokenCreateParams.testHelpers.usage_limits, SharedPayment.IssuedToken.usage_limits, and SharedPayment.IssuedTokenCreateParams.usage_limits
  • Add support for feedback_option on SubscriptionCancelParams.cancellation_details and SubscriptionUpdateParams.cancellation_details
  • Add support for pricing_token on SubscriptionUpdateParams
  • Add support for igic on Tax.RegistrationCreateParams.country_options.at, Tax.RegistrationCreateParams.country_options.be, Tax.RegistrationCreateParams.country_options.bg, Tax.RegistrationCreateParams.country_options.cy, Tax.RegistrationCreateParams.country_options.cz, Tax.RegistrationCreateParams.country_options.de, Tax.RegistrationCreateParams.country_options.dk, Tax.RegistrationCreateParams.country_options.ee, Tax.RegistrationCreateParams.country_options.es, Tax.RegistrationCreateParams.country_options.fi, Tax.RegistrationCreateParams.country_options.fr, Tax.RegistrationCreateParams.country_options.gr, Tax.RegistrationCreateParams.country_options.hr, Tax.RegistrationCreateParams.country_options.hu, Tax.RegistrationCreateParams.country_options.ie, Tax.RegistrationCreateParams.country_options.it, Tax.RegistrationCreateParams.country_options.lt, Tax.RegistrationCreateParams.country_options.lu, Tax.RegistrationCreateParams.country_options.lv, Tax.RegistrationCreateParams.country_options.mt, Tax.RegistrationCreateParams.country_options.nl, Tax.RegistrationCreateParams.country_options.pl, Tax.RegistrationCreateParams.country_options.pt, Tax.RegistrationCreateParams.country_options.ro, Tax.RegistrationCreateParams.country_options.se, Tax.RegistrationCreateParams.country_options.si, and Tax.RegistrationCreateParams.country_options.sk
  • Add support for new value 2026-08-26.dahlia on enum WebhookEndpointCreateParams.api_version
  • Add support for one_time_fees on V2.Billing.ContractCreateParams and V2.Billing.Contract
  • ⚠️ Remove support for payment_method_collection on V2.Core.Account.configuration.merchant.gross_settlement, V2.Core.AccountCreateParams.configuration.merchant.gross_settlement, and `V2.Core.AccountUpdateParams.configuration.merc...

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

• #2807 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, del, and retrieve methods on resource V2.Signals.AccountActivity
  • Add support for cancel, list, retrieve, and update methods on resource V2.Core.ApprovalRequest
  • Add support for disable method on resource V2.MoneyManagement.PayoutMethod
  • Add support for disable_stripe_user_authentication on AccountSessionCreateParams.components.payment_method_settings.features
  • ⚠️ Remove support for payment_method_types on PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentUpdateParams, SetupIntentCreateParams, and SetupIntentUpdateParams
  • ⚠️ Change type of ProductCatalog.TrialOffer.end_behavior.transition.price and ProductCatalog.TrialOffer.price from Price to deletable($Price)
  • Add support for billie on QuotePreviewInvoice.payment_settings.payment_method_options
  • Add support for new value billie on enum QuotePreviewInvoice.payment_settings.payment_method_types
  • Add support for payout_methods on V2.Core.Account.defaults and V2.Core.AccountUpdateParams.defaults
  • Add support for restricted on V2.Core.Vault.GbBankAccount and V2.Core.Vault.UsBankAccount
  • Add support for enabled_delivery_schemes on V2.MoneyManagement.PayoutMethod.bank_account
  • ⚠️ Remove support for enabled_delivery_options on V2.MoneyManagement.PayoutMethod.bank_account
  • ⚠️ Add support for new value disabled on enum V2.MoneyManagement.PayoutMethod.usage_status.payments
  • ⚠️ Add support for new value disabled on enum V2.MoneyManagement.PayoutMethod.usage_status.transfers
  • Add support for new value disabled on enum V2.MoneyManagement.PayoutMethodListParams.usage_status.payments
  • Add support for new value disabled on enum V2.MoneyManagement.PayoutMethodListParams.usage_status.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.last_finalization_error
  • Add support for error code default_payout_method_cannot_be_disabled on CannotProceedError
• #2813 Add non-verified methods to managed handlers

See the changelog for more details.

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

• #2822 Update generated code for private-preview
  • Add support for new resource CustomerTaxExemption
  • Add support for create, del, list, and retrieve methods on resource CustomerTaxExemption
  • ⚠️ Remove support for sequra_payments on Account.capabilities
  • Add support for details on Account.future_requirements.errors[], Account.requirements.errors[], BankAccount.future_requirements.errors[], BankAccount.requirements.errors[], Capability.future_requirements.errors[], Capability.requirements.errors[], Person.future_requirements.errors[], and Person.requirements.errors[]
  • Add support for subscription_pause on BillingPortal.SessionCreateParams.flow_data
  • ⚠️ Remove support for sequra on Charge.payment_method_details, Checkout.Session.payment_method_options, ConfirmationToken.payment_method_preview, PaymentAttemptRecord.payment_method_details, PaymentIntent.payment_method_options, and PaymentRecord.payment_method_details
  • Add support for enablement_details on Checkout.Session.automatic_tax
  • ⚠️ Remove support for value sequra from enums ConfirmationTokenCreateParams.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, and SetupIntentUpdateParams.payment_method_data.type
  • ⚠️ Remove support for value sequra from enums ConfirmationToken.payment_method_preview.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.classifications[]
  • Change type of FinancialConnections.Transaction.classifications[].money_movement from BankConnectionsResourceTransactionResourceClassificationsLabels | null to BankConnectionsResourceTransactionResourceClassificationsLabels
  • Change type of FinancialConnections.Transaction.classifications[].personal_finance from BankConnectionsResourceTransactionResourceClassificationsLabels | null to BankConnectionsResourceTransactionResourceClassificationsLabels
  • ⚠️ Change FinancialConnections.Transaction.classifications[].money_movement to be optional
  • ⚠️ Change FinancialConnections.Transaction.classifications[].personal_finance to be optional
  • Add support for user_consent on Identity.VerificationSessionCreateParams and Identity.VerificationSessionUpdateParams
  • Add support for company_details on Invoice.payment_settings.payment_method_options.billie, PaymentIntent.payment_method_options.billie, PaymentIntentConfirmParams.payment_method_options.billie, PaymentIntentCreateParams.payment_method_options.billie, PaymentIntentUpdateParams.payment_method_options.billie, QuotePreviewInvoice.payment_settings.payment_method_options.billie, and Subscription.payment_settings.payment_method_options.billie
  • Add support for reference on Invoice.payment_settings.payment_method_options.billie, PaymentIntent.payment_method_options.billie, PaymentIntentConfirmParams.payment_method_options.billie, PaymentIntentCreateParams.payment_method_options.billie, PaymentIntentUpdateParams.payment_method_options.billie, and QuotePreviewInvoice.payment_settings.payment_method_options.billie
  • Add support for pos_condition on Issuing.AuthorizationCreateParams.testHelpers and Issuing.Authorization
  • Add support for crypto_wallet on Issuing.CardCreateParams, Issuing.CardUpdateParams, and Issuing.Card
  • Add support for payment_evaluations and payment_method_details on PaymentAttemptRecordReportAuthorizedParams
  • Add support for aade_data on PaymentIntentConfirmParams.payment_method_options.card_present, PaymentIntentCreateParams.payment_method_options.card_present, and PaymentIntentUpdateParams.payment_method_options.card_present
  • ⚠️ Remove support for cancel_at_period_end on Subscription.pending_update
  • Add support for blik_recurring_payments on V2.Core.Account.configuration.merchant.capabilities, V2.Core.AccountCreateParams.configuration.merchant.capabilities, and V2.Core.AccountUpdateParams.configuration.merchant.capabilities
  • Add support for user_access on V2.Iam.ActivityLog.details
  • Add support for new value user_access on enum V2.Iam.ActivityLog.details.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
• #2817 Add non-verified manged handlers

See the changelog for more details.

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

• #2801 Add discriminatedUnion kind to V2RuntimeSchema coercion

  • Adds runtime support for coercing int64/decimal fields within discriminated union variants in V2 API requests and responses.
  • ⚠️ Throws when serializing a discriminated union parameter whose discriminator is missing or is not a string. This avoids skipping coercion entirely which could silently truncate int64 fields above Number.MAX_SAFE_INTEGER.

• #2818 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

• #2815 correctly throw connection errors if the server drops while sending the HTTP response body

  • This change results in new exceptions being thrown instead of hanging indefinitely
  • in an effort to make this change backwards compatible, it doesn't affect a case that was already throwing an error: if the stripe API sends invalid JSON, we were treating it as an API error instead of a connection error.
    • In the next major version, we'll change the exception thrown from StripeAPIError to StripeConnectionError and document it accordingly.

• #2812 Update generated code

  • Add support for new resource Billing.FeedbackOption
  • Add support for create, deactivate, list, retrieve, and update methods on resource Billing.FeedbackOption
  • Add support for payment_method_settings on AccountSession.components and AccountSessionCreateParams.components
  • Add support for feedback_options on BillingPortal.Configuration.features.subscription_cancel.cancellation_reason, BillingPortal.ConfigurationCreateParams.features.subscription_cancel.cancellation_reason, and BillingPortal.ConfigurationUpdateParams.features.subscription_cancel.cancellation_reason
  • Add support for new value customer_update on enums BillingPortal.Session.flow.type and BillingPortal.SessionCreateParams.flow_data.type
  • Add support for customer_update on BillingPortal.Session.flow
  • Add support for funding_source_group on Charge.payment_method_details.card.wallet.link and Charge.payment_method_details.link
  • Add support for funding_types_blocked on Checkout.Session.payment_method_options.card.restrictions and Checkout.SessionCreateParams.payment_method_options.card.restrictions
  • Add support for metadata on ConfirmationToken
  • Add support for active_entitlements and customer_portal on CustomerSession.components and CustomerSessionCreateParams.components
  • Add support for country on FinancialConnections.Session.filters
  • Add support for frozen_fields on InvoiceItem
  • Add support for billie on Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_options
  • Add support for new value billie on enums Invoice.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, and SubscriptionUpdateParams.payment_settings.payment_method_types
  • ⚠️ Remove support for cryptogram on PaymentAttemptRecord.payment_method_details.card.three_d_secure and PaymentRecord.payment_method_details.card.three_d_secure
  • 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, PaymentIntentUpdateParams.allowed_payment_method_types, SetupIntent.allowed_payment_method_types, SetupIntentConfirmParams.allowed_payment_method_types, SetupIntentCreateParams.allowed_payment_method_types, and SetupIntentUpdateParams.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 PaymentLinkUpdateParams
  • Add support for feedback_option on Subscription.cancellation_details, SubscriptionCancelParams.cancellation_details, and SubscriptionUpdateParams.cancellation_details
  • Add support for igic on Tax.Registration.country_options.at, Tax.Registration.country_options.be, Tax.Registration.country_options.bg, Tax.Registration.country_options.cy, Tax.Registration.country_options.cz, Tax.Registration.country_options.de, Tax.Registration.country_options.dk, Tax.Registration.country_options.ee, Tax.Registration.country_options.es, Tax.Registration.country_options.fi, Tax.Registration.country_options.fr, Tax.Registration.country_options.gr, Tax.Registration.country_options.hr, Tax.Registration.country_options.hu, Tax.Registration.country_options.ie, Tax.Registration.country_options.it, Tax.Registration.country_options.lt, Tax.Registration.country_options.lu, Tax.Registration.country_options.lv, Tax.Registration.country_options.mt, Tax.Registration.country_options.nl, Tax.Registration.country_options.pl, Tax.Registration.country_options.pt, Tax.Registration.country_options.ro, Tax.Registration.country_options.se, Tax.Registration.country_options.si, Tax.Registration.country_options.sk, Tax.RegistrationCreateParams.country_options.at, Tax.RegistrationCreateParams.country_options.be, Tax.RegistrationCreateParams.country_options.bg, Tax.RegistrationCreateParams.country_options.cy, Tax.RegistrationCreateParams.country_options.cz, Tax.RegistrationCreateParams.country_options.de, Tax.RegistrationCreateParams.country_options.dk, Tax.RegistrationCreateParams.country_options.ee, Tax.RegistrationCreateParams.country_options.es, Tax.RegistrationCreateParams.country_options.fi, Tax.RegistrationCreateParams.country_options.fr, Tax.RegistrationCreateParams.country_options.gr, Tax.RegistrationCreateParams.country_options.hr, Tax.RegistrationCreateParams.country_options.hu, Tax.RegistrationCreateParams.country_options.ie, Tax.RegistrationCreateParams.country_options.it, Tax.RegistrationCreateParams.country_options.lt, Tax.RegistrationCreateParams.country_options.lu, Tax.RegistrationCreateParams.country_options.lv, Tax.RegistrationCreateParams.country_options.mt, Tax.RegistrationCreateParams.country_options.nl, Tax.RegistrationCreateParams.country_options.pl, Tax.RegistrationCreateParams.country_options.pt, Tax.RegistrationCreateParams.country_options.ro, Tax.RegistrationCreateParams.country_options.se, Tax.RegistrationCreateParams.country_options.si, and Tax.RegistrationCreateParams.country_options.sk
  • 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.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, StripeError, and Terminal.Reader.action.api_error

See the changelog for more details.

• #2810 Update generated code for private-preview
  • Add support for new resources Billing.FeedbackOption and PaymentPlan
  • ⚠️ Remove support for resource Billing.FeedbackOptions
  • Add support for create, list, retrieve, and update methods on resource PaymentPlan
  • Add support for update method on resource V2.MoneyManagement.Transaction
  • Add support for wechat_pay_payments on Account.settings, AccountCreateParams.settings, and AccountUpdateParams.settings
  • ⚠️ Change type of BillingPortal.Configuration.features.subscription_cancel.cancellation_reason.feedback_options from Billing.FeedbackOptions to Billing.FeedbackOption
  • Change BillingPortal.Configuration.features.subscription_cancel.cancellation_reason.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.transaction_details.destination_currency, Crypto.OnrampSessionCreateParams.destination_currency, and Crypto.OnrampSessionListParams.destination_currency
  • Add support for new value usdt on enums Crypto.OnrampSession.transaction_details.destination_currencies and Crypto.OnrampSessionCreateParams.destination_currencies
  • Add support for active_entitlements on CustomerSession.components
  • Add support for shared_payment_issued_token on DelegatedCheckout.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.pending_request.hold_amount_details and Issuing.Authorization.request_history[].hold_amount_details
  • ⚠️ Remove support for cryptogram on PaymentAttemptRecord.payment_method_details.card.three_d_secure and PaymentRecord.payment_method_details.card.three_d_secure
  • ⚠️ Change type of ProductCatalog.TrialOffer.end_behavior.transition.price from Price to deletable($Price)
  • ⚠️ Change type of Subscription.cancellation_details.feedback_option from Billing.FeedbackOptions to Billing.FeedbackOption
  • Add support for cancel_at_period_end on Subscription.pending_update
  • Change Subscription.cancellation_details.feedback_option to be required
  • Add support for igic on Tax.Registration.country_options.at, Tax.Registration.country_options.be, Tax.Registration.country_options.bg, Tax.Registration.country_options.cy, Tax.Registration.country_options.cz, Tax.Registration.country_options.de, Tax.Registration.country_options.dk, Tax.Registration.country_options.ee, Tax.Registration.country_options.es, Tax.Registration.country_options.fi, Tax.Registration.country_options.fr, Tax.Registration.country_options.gr, Tax.Registration.country_options.hr, Tax.Registration.country_options.hu, Tax.Registration.country_options.ie, Tax.Registration.country_options.it, Tax.Registration.country_options.lt, Tax.Registration.country_options.lu, Tax.Registration.country_options.lv, Tax.Registration.country_options.mt, Tax.Registration.country_options.nl, Tax.Registration.country_options.pl, Tax.Registration.country_options.pt, Tax.Registration.country_options.ro, Tax.Registration.country_options.se, Tax.Registration.country_options.si, and Tax.Registration.country_options.sk
  • Add support for metadata on V2.Billing.Contract.pricing_lines.data[].pricing.price_details.pricing_overrides.data[], V2.Billing.Contract.pricing_overrides.data[], V2.Billing.ContractCreateParams.pricing_overrides[], V2.Billing.ContractUpdateParams.pricing_line_actions[].update, V2.Billing.ContractUpdateParams.pricing_override_actions[].add, V2.Billing.ContractUpdateParams.pricing_override_actions[].update, V2.Billing.ContractUpdateParams, and V2.MoneyManagement.Transaction
  • Add support for tax_amount on V2.MoneyManagement.OutboundPaymentQuote.estimated_fees[]
  • Add support for payout_method_options on V2.MoneyManagement.OutboundPaymentQuote.to and V2.MoneyManagement.OutboundPaymentQuoteCreateParams.to
  • Change type of V2.Billing.ContractUpdateParams.pricing_line_actions[].update.pricing.price_details.pricing_override_actions[].update.metadata from string to emptyable(string)
  • Add support for snapshot events PaymentPlanCreatedEvent, PaymentPlanInstallmentDueEvent, PaymentPlanInstallmentPaidEvent, PaymentPlanInstallmentWillBeDueEvent, and PaymentPlanUpdatedEvent with resource PaymentPlan

See the changelog for more details.

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

• #2804 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.MoneyManagement.PayoutIntent
  • ⚠️ Add support for new value partner_disabled on enums Account.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, and Person.requirements.errors[].code
  • ⚠️ Remove support for values partner_disabled_dispute_rate, partner_disabled_responsibilities, partner_disabled_restricted_business, and partner_disabled_suspected_fraud from enums Account.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, and Person.requirements.errors[].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.payment_method_details.link
  • ⚠️ Remove support for pricing_group on Charge.payment_method_details.link
  • Add support for new value celo on enum Crypto.CustomerConsumerWallet.network
  • Add support for new value celo on enums Crypto.OnrampSession.transaction_details.destination_network, Crypto.OnrampSessionCreateParams.destination_network, Crypto.OnrampSessionListParams.destination_network, and Crypto.OnrampTransactionLimitRetrieveParams.destination_network
  • Add support for new value celo on enums Crypto.OnrampSession.transaction_details.destination_networks and Crypto.OnrampSessionCreateParams.destination_networks
  • Add support for celo on Crypto.OnrampSession.transaction_details.wallet_addresses
  • Add support for customer_portal on CustomerSession.components
  • 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.filters
  • Add support for classifications and enrichments on FinancialConnections.Transaction
  • Add support for new values billie, paypay, and vipps on enums Invoice.payment_settings.payment_method_types, InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, QuotePreviewInvoice.payment_settings.payment_method_types, Subscription.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_types
  • Add support for customer_balance on Invoice and QuotePreviewInvoice
  • Add support for billie on Invoice.payment_settings.payment_method_options, QuotePreviewInvoice.payment_settings.payment_method_options, and Subscription.payment_settings.payment_method_options
  • Add support for hold_amount_details and hold_amount on Issuing.Authorization.pending_request and Issuing.Authorization.request_history[]
  • Add support for new values hu and ro on enums Issuing.Cardholder.preferred_locales, Issuing.CardholderCreateParams.preferred_locales, and Issuing.CardholderUpdateParams.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, PaymentRecordReportPaymentAttemptParams.failed.failure_code, and PaymentRecordReportPaymentParams.failed.failure_code
  • Add support for network_decline_code on PaymentAttemptRecordReportFailedParams.payment_method_details.card and PaymentRecordReportPaymentAttemptFailedParams.payment_method_details.card
  • Add support for setup_future_usage on PaymentIntent.payment_method_options.sequra
  • Add support for status on QuotePreviewSubscriptionSchedule.pause_schedules[].pause, QuotePreviewSubscriptionSchedule.pause_schedules[].resume, SubscriptionSchedule.pause_schedules[].pause, and SubscriptionSchedule.pause_schedules[].resume
  • Change SubscriptionScheduleCreateParams.pause_schedules[].pause to be optional
  • Change type of SubscriptionScheduleUpdateParams.pause_schedules[].resume from pause_schedule_update_resume_params to emptyable(pause_schedule_update_resume_params)
  • Add support for acquirer on EventsV2CoreHealthAuthorizationRateDropFiringEvent.impact.dimensions[], EventsV2CoreHealthAuthorizationRateDropResolvedEvent.impact.dimensions[], V2.Core.Health.Alert.authorization_rate_drop.dimensions[], and V2.Core.Health.AlertHistoryEntry.authorization_rate_drop.dimensions[]
  • ⚠️ Change type of EventsV2CoreHealthAuthorizationRateDropFiringEvent.impact.dimensions[].type, EventsV2CoreHealthAuthorizationRateDropResolvedEvent.impact.dimensions[].type, V2.Core.Health.Alert.authorization_rate_drop.dimensions[].type, and V2.Core.Health.AlertHistoryEntry.authorization_rate_drop.dimensions[].type from literal('issuer') to enum('acquirer'|'issuer')
  • Add support for confirmation_method on V2.MoneyManagement.PayoutIntentCreateParams and V2.MoneyManagement.PayoutIntent
  • 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.next_action
  • ⚠️ Change type of V2.MoneyManagement.PayoutIntent.next_action.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.ContractRetrieveParams.include, and V2.Billing.ContractUpdateParams.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 FinancialConnections.Account
  • Add support for event notification V1InvoicePaymentAttemptRequiredEvent with related object Invoice
  • Add support for error type FxQuoteNeedsRefreshError

See the changelog for more details.

• #2805 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.

• #2794 add/adjust event parsing helpers

  • Added methods that return their respective Event/EventNotification objects 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.
    • stripe.webhooks.constructEventWithoutVerification(payload)
    • stripe.constructEventWithoutVerification(payload)
    • stripe.parseEventNotificationWithoutVerification(payload)

• #2799 Add stripe.major_api_version constant

See the changelog for more details.