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.

v15.5.0a1

This release changes the pinned API version to 2026-07-29.preview.

• #1854 Update generated code for private-preview
  • Add support for new resources v2.money_management.ReceivedDebitMandate, v2.risk.Inquiry, v2.signals.AccountActivity, and v2.signals.AccountEvaluation
  • 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 list, modify, and retrieve methods on resource v2.risk.Inquiry
  • Add support for cancel, list, and retrieve methods on resource v2.money_management.ReceivedDebitMandate
  • Add support for rate_cards on Billing.CreditGrant.ApplicabilityConfig.Scope, billing.CreditBalanceSummaryRetrieveParamsFilterApplicabilityScope, and billing.CreditGrantCreateParamsApplicabilityConfigScope
  • ⚠️ Change type of ConfirmationToken.PaymentMethodPreview.GiftCard.brand, GiftCard.brand, GiftCardCreateParams.brand, PaymentMethod.GiftCard.brand, terminal.ReaderActivateGiftCardParams.brand, terminal.ReaderCashoutGiftCardParams.brand, terminal.ReaderCheckGiftCardBalanceParams.brand, and terminal.ReaderReloadGiftCardParams.brand from enum('fiserv_valuelink'|'givex'|'svs') to literal('svs')
  • Add support for new value tempo on enum Crypto.CustomerConsumerWallet.network
  • Add support for new value tempo 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 tempo on enums Crypto.OnrampSession.TransactionDetail.destination_networks and crypto.OnrampSessionCreateParams.destination_networks
  • Add support for tempo on Crypto.OnrampSession.TransactionDetail.WalletAddress
  • Add support for new value try_again_later on enum GiftCardOperation.failure_code
  • Add support for healthcare on Issuing.Authorization
  • Add support for product_code on Issuing.Card, issuing.CardCreateParams, and issuing.CardModifyParams
  • Add support for product_graduation_state on Issuing.Card
  • Add support for cvc and number on radar.PaymentEvaluationCreateParamsPaymentDetailPaymentMethodDetailCard
  • Change radar.PaymentEvaluationCreateParamsPaymentDetailPaymentMethodDetailCard.first6 to be optional
  • Change radar.PaymentEvaluationCreateParamsPaymentDetailPaymentMethodDetailCard.last4 to be optional
  • Add support for card on Radar.PaymentEvaluation.PaymentDetail.PaymentMethodDetail
  • ⚠️ Change type of terminal.ReaderCollectPaymentMethodParamsCollectConfig.gift_card_brand and terminal.ReaderProcessPaymentIntentParamsProcessConfig.gift_card_brand from enum('fiserv_valuelink'|'givex'|'svs') to literal('svs')
  • Add support for gift_card on terminal.ReaderPresentPaymentMethodParams
  • Add support for new value gift_card on enum terminal.ReaderPresentPaymentMethodParams.type
  • Add support for amount_due and customer_balance_applied on V2.Billing.Intent.AmountDetail
  • ⚠️ Change type of V2.Core.AccountEvaluation.evaluations_triggered from literal('fraudulent_website') to enum('fraudulent_website'|'user_account_sharing'|'user_multi_accounting')
  • Add support for gross_settlement on V2.Core.Account.Configuration.Merchant, v2.core.AccountCreateParamsConfigurationMerchant, and v2.core.AccountModifyParamsConfigurationMerchant
  • ⚠️ Change type of V2.MoneyManagement.DebitDispute.BankTransfer.network from literal('ach') to enum('ach'|'bacs')
  • Add support for new values beneficiary_unrecognized, mandate_canceled_by_stripe, mandate_canceled, no_advance_notice, originator_requested, and signature_invalid on enum V2.MoneyManagement.DebitDispute.BankTransfer.reason
  • ⚠️ Remove support for managed_by on V2.MoneyManagement.FinancialAccount
  • Add support for payout_intent on V2.MoneyManagement.OutboundPayment
  • Add support for settles_at on V2.MoneyManagement.ReceivedDebit
  • Add support for gb_bank_account on V2.MoneyManagement.ReceivedDebit.BankTransfer
  • ⚠️ Change type of V2.MoneyManagement.ReceivedDebit.BankTransfer.origin_type from literal('us_bank_account') to enum('gb_bank_account'|'us_bank_account')
  • ⚠️ Change type of V2.MoneyManagement.ReceivedDebit.BankTransfer.payment_method_type from literal('us_bank_account') to enum('gb_bank_account'|'us_bank_account')
  • Add support for new value scheduled on enum V2.MoneyManagement.ReceivedDebit.status
  • Add support for new value no_mandate on enum V2.MoneyManagement.ReceivedDebit.StatusDetail.Failed.reason
  • Add support for target_date on V2.Payments.OffSessionPayment and v2.payments.OffSessionPaymentCreateParams
  • Add support for account_evaluation, fraudulent_website, payment_delinquency_exposure, user_account_sharing, and user_multi_accounting on V2.Signals.AccountSignal
  • Add support for new values fraudulent_website, user_account_sharing, and user_multi_accounting on enums V2.Signals.AccountSignal.type and v2.signals.AccountSignalListParams.type
  • Change type of v2.money_management.FinancialAddressDebitSimulationDebitParams.network from literal('ach') to enum('ach'|'bacs')
  • Add support for received_debit_mandate on v2.money_management.ReceivedDebitListParams
  • ⚠️ Remove support for payout_intent on v2.money_management.OutboundPaymentCreateParams
  • Change type of v2.core.AccountEvaluationCreateParams.signals from literal('fraudulent_website') to enum('fraudulent_website'|'user_account_sharing'|'user_multi_accounting')
  • ⚠️ Remove support for id on EventsV2SignalsAccountSignalFraudulentMerchantReadyEvent
  • Add support for event notifications V2MoneyManagementReceivedDebitCreatedEvent and V2MoneyManagementReceivedDebitScheduledEvent with related object v2.money_management.ReceivedDebit
  • Add support for event notifications V2MoneyManagementReceivedDebitMandateCanceledEvent, V2MoneyManagementReceivedDebitMandateCreatedEvent, V2MoneyManagementReceivedDebitMandateExpiredEvent, V2MoneyManagementReceivedDebitMandatePendingCancellationEvent, and V2MoneyManagementReceivedDebitMandateUpdatedEvent with related object v2.money_management.ReceivedDebitMandate
  • Add support for event notification V2SignalsAccountEvaluationCompleteEvent with related object v2.signals.AccountEvaluation
  • Add support for event notifications V2SignalsAccountSignalFraudulentWebsiteReadyEvent and V2SignalsAccountSignalPaymentDelinquencyExposureReadyEvent with related object v2.signals.AccountSignal

See the changelog for more details.

v15.5.0b1

This release changes the pinned API version to 2026-07-29.preview.

• #1838 Update generated code for beta
  • Add support for list and retrieve methods on resource product_catalog.TrialOffer
  • Add support for tax_items on ChargeCaptureParamsPaymentDetailCarRentalDatumTotalTax, ChargeCaptureParamsPaymentDetailFlightDatumTotalTax, ChargeCaptureParamsPaymentDetailLodgingDatumTotalTax, ChargeModifyParamsPaymentDetailCarRentalDatumTotalTax, ChargeModifyParamsPaymentDetailFlightDatumTotalTax, ChargeModifyParamsPaymentDetailLodgingDatumTotalTax, PaymentIntent.PaymentDetail.CarRentalDatum.Total.Tax, PaymentIntent.PaymentDetail.FlightDatum.Total.Tax, PaymentIntent.PaymentDetail.LodgingDatum.Total.Tax, PaymentIntentCaptureParamsPaymentDetailCarRentalDatumTotalTax, PaymentIntentCaptureParamsPaymentDetailFlightDatumTotalTax, PaymentIntentCaptureParamsPaymentDetailLodgingDatumTotalTax, PaymentIntentConfirmParamsPaymentDetailCarRentalDatumTotalTax, PaymentIntentConfirmParamsPaymentDetailFlightDatumTotalTax, PaymentIntentConfirmParamsPaymentDetailLodgingDatumTotalTax, PaymentIntentCreateParamsPaymentDetailCarRentalDatumTotalTax, PaymentIntentCreateParamsPaymentDetailFlightDatumTotalTax, PaymentIntentCreateParamsPaymentDetailLodgingDatumTotalTax, PaymentIntentModifyParamsPaymentDetailCarRentalDatumTotalTax, PaymentIntentModifyParamsPaymentDetailFlightDatumTotalTax, and PaymentIntentModifyParamsPaymentDetailLodgingDatumTotalTax
  • ⚠️ Remove support for taxes on ChargeCaptureParamsPaymentDetailCarRentalDatumTotalTax, ChargeCaptureParamsPaymentDetailFlightDatumTotalTax, ChargeCaptureParamsPaymentDetailLodgingDatumTotalTax, ChargeModifyParamsPaymentDetailCarRentalDatumTotalTax, ChargeModifyParamsPaymentDetailFlightDatumTotalTax, ChargeModifyParamsPaymentDetailLodgingDatumTotalTax, PaymentIntent.PaymentDetail.CarRentalDatum.Total.Tax, PaymentIntent.PaymentDetail.FlightDatum.Total.Tax, PaymentIntent.PaymentDetail.LodgingDatum.Total.Tax, PaymentIntentCaptureParamsPaymentDetailCarRentalDatumTotalTax, PaymentIntentCaptureParamsPaymentDetailFlightDatumTotalTax, PaymentIntentCaptureParamsPaymentDetailLodgingDatumTotalTax, PaymentIntentConfirmParamsPaymentDetailCarRentalDatumTotalTax, PaymentIntentConfirmParamsPaymentDetailFlightDatumTotalTax, PaymentIntentConfirmParamsPaymentDetailLodgingDatumTotalTax, PaymentIntentCreateParamsPaymentDetailCarRentalDatumTotalTax, PaymentIntentCreateParamsPaymentDetailFlightDatumTotalTax, PaymentIntentCreateParamsPaymentDetailLodgingDatumTotalTax, PaymentIntentModifyParamsPaymentDetailCarRentalDatumTotalTax, PaymentIntentModifyParamsPaymentDetailFlightDatumTotalTax, and PaymentIntentModifyParamsPaymentDetailLodgingDatumTotalTax
  • Add support for tax_id on Checkout.Session.CollectedInformation
  • ⚠️ Remove support for tax_ids on Checkout.Session.CollectedInformation
  • Add support for new value disabled on enum financial_connections.SessionCreateParamsManualEntry.mode
  • Add support for mode on FinancialConnections.Session.ManualEntry
  • Add support for name on issuing.CardholderModifyParams
  • Add support for new value ic_nif on enums OrderCreateParamsTaxDetailTaxId.type and OrderModifyParamsTaxDetailTaxId.type
  • ⚠️ Add support for new value ic_nif on enums Order.TaxDetail.TaxId.type and QuotePreviewInvoice.CustomerTaxId.type
  • Add support for new values alipay and mb_way on enum QuotePreviewInvoice.PaymentSetting.payment_method_types
  • Add support for custom_fields, description, and footer on QuotePreviewSubscriptionSchedule.DefaultSetting.InvoiceSetting and QuotePreviewSubscriptionSchedule.Phase.InvoiceSetting
  • Add support for trial on QuotePreviewSubscriptionSchedule.Phase
  • ⚠️ Remove support for acss_debit, afterpay_clearpay, alipay, alma, amazon_pay, au_becs_debit, bacs_debit, bancontact, billie, bizum, blik, boleto, card_present, cashapp, crypto, customer_balance, eps, fpx, giropay, gopay, grabpay, id_bank_transfer, ideal, interac_present, kakao_pay, konbini, kr_card, mb_way, mobilepay, multibanco, naver_pay, nz_bank_account, oxxo, p24, pay_by_bank, payco, paynow, paypal, paypay, payto, pix, promptpay, qris, rechnung, revolut_pay, samsung_pay, satispay, scalapay, sepa_debit, shopeepay, sofort, stripe_balance, sunbit, swish, twint, upi, us_bank_account, wechat_pay, and zip on SharedPayment.GrantedToken.PaymentMethodDetail
  • ⚠️ Remove support for values acss_debit, afterpay_clearpay, alipay, alma, amazon_pay, au_becs_debit, bacs_debit, bancontact, billie, bizum, blik, boleto, card_present, cashapp, crypto, custom, customer_balance, eps, fpx, giropay, gopay, grabpay, id_bank_transfer, ideal, interac_present, kakao_pay, konbini, kr_card, mb_way, mobilepay, multibanco, naver_pay, nz_bank_account, oxxo, p24, pay_by_bank, payco, paynow, paypal, paypay, payto, pix, promptpay, qris, rechnung, revolut_pay, samsung_pay, satispay, scalapay, sepa_debit, shopeepay, sofort, stripe_balance, sunbit, swish, twint, upi, us_bank_account, wechat_pay, and zip from enum SharedPayment.GrantedToken.PaymentMethodDetail.type
  • Add support for use_stripe_sdk on SharedPayment.IssuedToken and shared_payment.IssuedTokenCreateParams
  • Add support for redirect_to_url on SharedPayment.IssuedToken.NextAction
  • ⚠️ Change type of SharedPayment.IssuedToken.NextAction.type from literal('use_stripe_sdk') to enum('redirect_to_url'|'use_stripe_sdk')
  • Add support for livemode on Tax.Location
  • Add support for source on V2.Iam.ActivityLog.Detail.UserRole
  • Add support for payout on V2.MoneyManagement.ReceivedCredit.BalanceTransfer
  • ⚠️ Remove support for payout_v1 on V2.MoneyManagement.ReceivedCredit.BalanceTransfer
  • Add support for new value payout on enum V2.MoneyManagement.ReceivedCredit.BalanceTransfer.type
  • ⚠️ Change V2.MoneyManagement.ReceivedDebit.BankTransfer.us_bank_account to be optional
  • Add support for error codes us_bank_account_microdeposits_cannot_be_confirmed and us_bank_account_microdeposits_cannot_be_sent on ControlledByAlternateResourceError

See the changelog for more details.