v15.1.0a3

• #1789 Update generated code for private-preview
  • Add support for payment_record on ApplicationFee.FeeSource
  • Add support for fleet_data on ChargeCaptureParamsPaymentDetail, ChargeModifyParamsPaymentDetail, PaymentIntent.PaymentDetail, PaymentIntentAmountDetailsLineItem.PaymentMethodOption.Card, PaymentIntentCaptureParamsAmountDetailLineItemPaymentMethodOptionCard, PaymentIntentCaptureParamsPaymentDetail, PaymentIntentConfirmParamsAmountDetailLineItemPaymentMethodOptionCard, PaymentIntentConfirmParamsPaymentDetail, PaymentIntentCreateParamsAmountDetailLineItemPaymentMethodOptionCard, PaymentIntentCreateParamsPaymentDetail, PaymentIntentDecrementAuthorizationParamsAmountDetailLineItemPaymentMethodOptionCard, PaymentIntentIncrementAuthorizationParamsAmountDetailLineItemPaymentMethodOptionCard, PaymentIntentModifyParamsAmountDetailLineItemPaymentMethodOptionCard, and PaymentIntentModifyParamsPaymentDetail
  • Add support for beneficiary_account, beneficiary_details, sender_account, and sender_details on ChargeCaptureParamsPaymentDetailMoneyServiceAccountFunding, ChargeModifyParamsPaymentDetailMoneyServiceAccountFunding, PaymentIntentCaptureParamsPaymentDetailMoneyServiceAccountFunding, PaymentIntentConfirmParamsPaymentDetailMoneyServiceAccountFunding, PaymentIntentCreateParamsPaymentDetailMoneyServiceAccountFunding, and PaymentIntentModifyParamsPaymentDetailMoneyServiceAccountFunding
  • Change type of ChargeCaptureParamsPaymentDetailMoneyService.transaction_type, ChargeModifyParamsPaymentDetailMoneyService.transaction_type, PaymentIntentCaptureParamsPaymentDetailMoneyService.transaction_type, PaymentIntentConfirmParamsPaymentDetailMoneyService.transaction_type, PaymentIntentCreateParamsPaymentDetailMoneyService.transaction_type, and PaymentIntentModifyParamsPaymentDetailMoneyService.transaction_type from literal('account_funding') to emptyable(literal('account_funding'))
  • ⚠️ Add support for new value requires_action on enum DelegatedCheckout.RequestedSession.status
  • Add support for bizum on Invoice.PaymentSetting.PaymentMethodOption, InvoiceCreateParamsPaymentSettingPaymentMethodOption, InvoiceModifyParamsPaymentSettingPaymentMethodOption, QuotePreviewInvoice.PaymentSetting.PaymentMethodOption, Subscription.PaymentSetting.PaymentMethodOption, SubscriptionCreateParamsPaymentSettingPaymentMethodOption, and SubscriptionModifyParamsPaymentSettingPaymentMethodOption
  • ⚠️ Add support for new value bizum 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 quantity_precision on PaymentIntentAmountDetailsLineItem, PaymentIntentCaptureParamsAmountDetailLineItem, PaymentIntentConfirmParamsAmountDetailLineItem, PaymentIntentCreateParamsAmountDetailLineItem, PaymentIntentDecrementAuthorizationParamsAmountDetailLineItem, PaymentIntentIncrementAuthorizationParamsAmountDetailLineItem, and PaymentIntentModifyParamsAmountDetailLineItem
  • Add support for liquid_asset and wallet on PaymentIntentConfirmParamsPaymentMethodOptionCardPaymentDetailMoneyServiceAccountFunding, PaymentIntentConfirmParamsPaymentMethodOptionCardPresentPaymentDetailMoneyServiceAccountFunding, PaymentIntentCreateParamsPaymentMethodOptionCardPaymentDetailMoneyServiceAccountFunding, PaymentIntentCreateParamsPaymentMethodOptionCardPresentPaymentDetailMoneyServiceAccountFunding, PaymentIntentModifyParamsPaymentMethodOptionCardPaymentDetailMoneyServiceAccountFunding, and PaymentIntentModifyParamsPaymentMethodOptionCardPresentPaymentDetailMoneyServiceAccountFunding
  • Add support for shared_payment_granted_token on PaymentMethod
  • ⚠️ Change type of Radar.CustomerEvaluation.event_type from string to enum('login'|'registration')
  • ⚠️ Change type of Radar.CustomerEvaluation.Signal.AccountSharing.risk_level and Radar.CustomerEvaluation.Signal.MultiAccounting.risk_level from string to enum
  • Add support for data on Radar.PaymentEvaluation.ClientDeviceMetadataDetail and radar.PaymentEvaluationCreateParamsClientDeviceMetadataDetail
  • Add support for sunbit on SharedPayment.GrantedToken.PaymentMethodDetail
  • ⚠️ Add support for new value sunbit on enum SharedPayment.GrantedToken.PaymentMethodDetail.type
  • ⚠️ Remove support for values bm_crn, bo_tin, bt_tpn, co_nit, ec_ruc, eg_tin, gh_tin, gy_tin, hn_rtn, jm_trn, jo_crn, ke_pin, ky_crn, lk_tin, mo_tin, mv_tin, ng_tin, pa_ruc, ph_tin, py_ruc, sl_tin, sv_nit, uy_ruc, vg_cn, and za_tin from enums V2.Core.Account.Identity.BusinessDetail.IdNumber.type, v2.core.AccountCreateParamsIdentityBusinessDetailIdNumber.type, v2.core.AccountModifyParamsIdentityBusinessDetailIdNumber.type, and v2.core.AccountTokenCreateParamsIdentityBusinessDetailIdNumber.type
  • ⚠️ Remove support for values bm_pp, bo_ci, bt_cid, eg_tin, gh_pin, gy_tin, hn_rtn, jm_trn, jo_pin, ky_pp, lk_nic, mo_bir, mt_nic, mv_tin, pa_ruc, ph_tin, py_ruc, si_pin, sv_nit, and vg_pp from enums V2.Core.Account.Identity.Individual.IdNumber.type, V2.Core.AccountPerson.IdNumber.type, v2.core.AccountCreateParamsIdentityIndividualIdNumber.type, v2.core.AccountModifyParamsIdentityIndividualIdNumber.type, v2.core.AccountPersonCreateParamsIdNumber.type, v2.core.AccountPersonModifyParamsIdNumber.type, v2.core.AccountPersonTokenCreateParamsIdNumber.type, and v2.core.AccountTokenCreateParamsIdentityIndividualIdNumber.type
  • Add support for error type CannotProceedError

See the changelog for more details.

v15.1.0b2

• Please refer to the changelog for v15.0.1

See the changelog for more details.

v15.1.0a2

• #1778 Update generated code for private-preview
  • Add support for new resources shared_payment.IssuedToken and v2.data.reporting.QueryRun
  • Add support for create and retrieve methods on resource v2.data.reporting.QueryRun
  • Add support for pause and resume methods on resource v2.payments.OffSessionPayment
  • Add support for tenant_keys, tenant_operator, and tenant_values on billing.BillingMeterListMeterEventSummaryParams
  • Add support for money_services on ChargeCaptureParamsPaymentDetail, ChargeModifyParamsPaymentDetail, PaymentIntentCaptureParamsPaymentDetail, PaymentIntentConfirmParamsPaymentDetail, PaymentIntentCreateParamsPaymentDetail, and PaymentIntentModifyParamsPaymentDetail
  • Add support for payment_method_options on DelegatedCheckout.RequestedSession, delegated_checkout.RequestedSessionCreateParams, and delegated_checkout.RequestedSessionModifyParams
  • ⚠️ Remove support for payment_method_data on delegated_checkout.RequestedSessionConfirmParams, delegated_checkout.RequestedSessionCreateParams, and delegated_checkout.RequestedSessionModifyParams
  • Add support for card_brands and payment_method_types on DelegatedCheckout.RequestedSession.SellerDetail
  • ⚠️ Change type of DelegatedCheckout.RequestedSession.shared_payment_issued_token from string to expandable($SharedPayment.IssuedToken)
  • Add support for check_scan on Invoice.PaymentSetting.PaymentMethodOption, InvoiceCreateParamsPaymentSettingPaymentMethodOption, InvoiceModifyParamsPaymentSettingPaymentMethodOption, QuotePreviewInvoice.PaymentSetting.PaymentMethodOption, Subscription.PaymentSetting.PaymentMethodOption, SubscriptionCreateParamsPaymentSettingPaymentMethodOption, and SubscriptionModifyParamsPaymentSettingPaymentMethodOption
  • ⚠️ Add support for new value check_scan 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 processor_details on PaymentAttemptRecordReportFailedParams, PaymentAttemptRecordReportGuaranteedParams, PaymentRecordReportPaymentAttemptFailedParams, PaymentRecordReportPaymentAttemptGuaranteedParams, PaymentRecordReportPaymentAttemptParamsFailed, PaymentRecordReportPaymentAttemptParamsGuaranteed, PaymentRecordReportPaymentParamsFailed, and PaymentRecordReportPaymentParamsGuaranteed
  • Add support for payment_details on PaymentIntentConfirmParamsPaymentMethodOptionCardPresent, PaymentIntentConfirmParamsPaymentMethodOptionCard, PaymentIntentCreateParamsPaymentMethodOptionCardPresent, PaymentIntentCreateParamsPaymentMethodOptionCard, PaymentIntentModifyParamsPaymentMethodOptionCardPresent, and PaymentIntentModifyParamsPaymentMethodOptionCard
  • ⚠️ Remove support for bill_from on QuotePreviewSubscriptionSchedule.BillingSchedule, Subscription.BillingSchedule, and SubscriptionSchedule.BillingSchedule
  • Add support for agent_details, payment_method_details, and risk_details on SharedPayment.GrantedToken
  • Add support for paper_checks on V2.Account.Configuration.RecipientDatum.Feature, V2.Core.Account.Configuration.Recipient.Capability, V2.Core.Account.Configuration.Storer.Capability.OutboundPayment, v2.AccountCreateParamsConfigurationRecipientDatumFeature, v2.AccountModifyParamsConfigurationRecipientDatumFeature, v2.core.AccountCreateParamsConfigurationRecipientCapability, v2.core.AccountCreateParamsConfigurationStorerCapabilityOutboundPayment, v2.core.AccountModifyParamsConfigurationRecipientCapability, and v2.core.AccountModifyParamsConfigurationStorerCapabilityOutboundPayment
  • ⚠️ Add support for new value paper_checks on enum V2.Account.Configuration.SupportableFeature.recipient_data
  • ⚠️ Add support for new value paper_checks on enum V2.Account.Requirement.Impact.required_for_features
  • ⚠️ Change type of V2.Billing.Cadence.SettingsDatum.Collection.PaymentMethodOption.konbini, V2.Billing.CollectionSetting.PaymentMethodOption.konbini, V2.Billing.CollectionSettingVersion.PaymentMethodOption.konbini, v2.billing.CollectionSettingCreateParamsPaymentMethodOption.konbini, and v2.billing.CollectionSettingModifyParamsPaymentMethodOption.konbini from map(string: dynamic) to an object
  • ⚠️ Change type of V2.Billing.Cadence.SettingsDatum.Collection.PaymentMethodOption.sepa_debit, V2.Billing.CollectionSetting.PaymentMethodOption.sepa_debit, V2.Billing.CollectionSettingVersion.PaymentMethodOption.sepa_debit, v2.billing.CollectionSettingCreateParamsPaymentMethodOption.sepa_debit, and v2.billing.CollectionSettingModifyParamsPaymentMethodOption.sepa_debit from map(string: dynamic) to an object
  • Add support for id on V2.Billing.CadenceSpendModifier.MaxBillingPeriodSpend.Amount.CustomPricingUnit, V2.Billing.IntentAction.Apply.SpendModifierRule.MaxBillingPeriodSpend.Amount.CustomPricingUnit, and v2.billing.IntentCreateParamsActionApplySpendModifierRuleMaxBillingPeriodSpendAmountCustomPricingUnit
  • ⚠️ Add support for new values outbound_payments.paper_checks and paper_checks on enums V2.Core.Account.FutureRequirement.Entry.Impact.RestrictsCapability.capability and V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capability
  • ⚠️ Add support for new values bm_crn, bo_tin, bt_tpn, co_nit, ec_ruc, eg_tin, gh_tin, gy_tin, hn_rtn, jm_trn, jo_crn, ke_pin, ky_crn, lk_tin, mo_tin, mv_tin, ng_tin, pa_ruc, ph_tin, py_ruc, sl_tin, sv_nit, uy_ruc, vg_cn, and za_tin on enums V2.Core.Account.Identity.BusinessDetail.IdNumber.type, v2.core.AccountCreateParamsIdentityBusinessDetailIdNumber.type, v2.core.AccountModifyParamsIdentityBusinessDetailIdNumber.type, and v2.core.AccountTokenCreateParamsIdentityBusinessDetailIdNumber.type
  • ⚠️ Add support for new values bm_pp, bo_ci, bt_cid, eg_tin, gh_pin, gy_tin, hn_rtn, jm_trn, jo_pin, ky_pp, lk_nic, mo_bir, mt_nic, mv_tin, pa_ruc, ph_tin, py_ruc, si_pin, sv_nit, and vg_pp on enums V2.Core.Account.Identity.Individual.IdNumber.type, V2.Core.AccountPerson.IdNumber.type, v2.core.AccountCreateParamsIdentityIndividualIdNumber.type, v2.core.AccountModifyParamsIdentityIndividualIdNumber.type, v2.core.AccountPersonCreateParamsIdNumber.type, v2.core.AccountPersonModifyParamsIdNumber.type, v2.core.AccountPersonTokenCreateParamsIdNumber.type, and v2.core.AccountTokenCreateParamsIdentityIndividualIdNumber.type
  • ⚠️ Change type of V2.Core.Event.Reason.Request.Client.stripe_action from map(string: dynamic) to an object
  • ⚠️ Change type of V2.MoneyManagement.InboundTransfer.TransferHistory.bank_debit_processing from map(string: dynamic) to an object
  • ⚠️ Change type of V2.MoneyManagement.InboundTransfer.TransferHistory.bank_debit_queued from map(string: dynamic) to an object
  • ⚠️ Change type of V2.MoneyManagement.InboundTransfer.TransferHistory.bank_debit_succeeded from map(string: dynamic) to an object
  • ⚠️ Add support for new values paper_check_attachment_too_large, paper_check_expired, and paper_check_undeliverable on enum V2.MoneyManagement.OutboundPayment.StatusDetail.Failed.reason
  • ⚠️ Remove support for town on V2.MoneyManagement.OutboundPayment.TrackingDetail.PaperCheck.MailingAddress
  • Change V2.MoneyManagement.OutboundPayment.DeliveryOption.PaperCheck.memo to be required
  • ⚠️ Add support for new value payout_method_amount_limit_exceeded on enum V2.MoneyManagement.OutboundTransfer.StatusDetail.Failed.reason
  • Add support for application_fee_amount_requested on V2.Payments.OffSessionPayment
  • ⚠️ Remove support for compartment_id on V2.Payments.OffSessionPayment
  • ⚠️ Add support for new value exceeded_retry_window on enum V2.Payments.OffSessionPayment.failure_reason
  • Add support for retry_until on V2.Payments.OffSessionPayment.RetryDetail
  • ⚠️ Add support for new value paused on enum V2.Payments.OffSessionPayment.status
  • ⚠️ Change V2.Reporting.ReportRun.Result.file to be optional
  • Add support for application_fee_amount on v2.payments.OffSessionPaymentCaptureParams and v2.payments.OffSessionPaymentCreateParams
  • ⚠️ Add support for new value paper_checks on enum EventsV2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent.updated_capability
  • ⚠️ Add support for new value outbound_payments.paper_checks on enum EventsV2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent.updated_capability
  • Add support for alert_id on EventsV2CoreHealthApiErrorResolvedEvent, EventsV2CoreHealthApiLatencyResolvedEvent, EventsV2CoreHealthAuthorizationRateDropResolvedEvent, EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent, EventsV2CoreHealthPaymentMethodErrorResolvedEvent, EventsV2CoreHealthSepaDebitDelayedFiringEvent, EventsV2CoreHealthSepaDebitDelayedResolvedEvent, EventsV2CoreHealthTrafficVolumeDropResolvedEvent, and EventsV2CoreHealthWebhookLatencyResolvedEvent
  • Add support for api_key on EventsV2IamApiKeyCreatedEvent, EventsV2IamApiKeyDefaultSecretRevealedEvent, EventsV2IamApiKeyExpiredEvent, EventsV2IamApiKeyPermissionsUpdatedEvent, EventsV2IamApiKeyRotatedEvent, and EventsV2IamApiKeyUpdatedEvent
  • Add support for stripe_access_grant on EventsV2IamStripeAccessGrantApprovedEvent, `EventsV2IamStripeAccessGrantCanc...

v15.0.1

• #1786 Fix encoding two-dimensional array request params
• #1785 Improve types for metadata and other dict-like types
• #1780 Fix str / repr for StripeObjects with decimals & add support for plain dicts

See the changelog for more details.

v15.1.0b1

This release changes the pinned API version to 2026-03-25.preview. It is built on top of SDK version 15.0.0 which contains breaking changes. Please review the changelog for 15.0.0 if upgrading from older SDK versions.

• #1774 Update generated code for beta
• #1772 Update generated code for beta
  • Release specs are identical.
• #1742 Update generated code for beta
  • Add support for new resources product_catalog.TrialOffer, tax.Location, and v2.core.BatchJob
  • Add support for create method on resource product_catalog.TrialOffer
  • Add support for create, list, and retrieve methods on resource tax.Location
  • Add support for cancel, create, and retrieve methods on resource v2.core.BatchJob
  • Add support for performance_location on Tax.CalculationLineItem and tax.CalculationCreateParamsLineItem
  • ⚠️ Add support for new value performance on enums Tax.Calculation.ShippingCost.TaxBreakdown.sourcing, Tax.CalculationLineItem.TaxBreakdown.sourcing, and Tax.Transaction.ShippingCost.TaxBreakdown.sourcing
  • ⚠️ Add support for new values admissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on enums Tax.Calculation.ShippingCost.TaxBreakdown.TaxRateDetail.tax_type, Tax.Calculation.TaxBreakdown.TaxRateDetail.tax_type, Tax.CalculationLineItem.TaxBreakdown.TaxRateDetail.tax_type, and Tax.Transaction.ShippingCost.TaxBreakdown.TaxRateDetail.tax_type
  • Add support for trial_offer on InvoiceCreatePreviewParamsScheduleDetailAmendmentItemActionAdd, InvoiceCreatePreviewParamsScheduleDetailAmendmentItemActionSet, InvoiceCreatePreviewParamsScheduleDetailPhaseItem, QuoteCreateParamsLineActionAddItem, QuoteCreateParamsLineActionSetItem, QuoteLine.Action.AddItem, QuoteLine.Action.SetItem, QuoteModifyParamsLineActionAddItem, QuoteModifyParamsLineActionSetItem, QuotePreviewSubscriptionSchedule.Phase.Item, SubscriptionSchedule.Phase.Item, SubscriptionScheduleAmendParamsAmendmentItemActionAdd, SubscriptionScheduleAmendParamsAmendmentItemActionSet, SubscriptionScheduleCreateParamsPhaseItem, and SubscriptionScheduleModifyParamsPhaseItem
  • Add support for risk_reserved on Balance
  • ⚠️ Remove support for source_type on Charge.PaymentMethodDetail.StripeBalance, ConfirmationToken.PaymentMethodPreview.StripeBalance, ConfirmationTokenCreateParamsPaymentMethodDatumStripeBalance, PaymentAttemptRecord.PaymentMethodDetail.StripeBalance, PaymentIntentConfirmParamsPaymentMethodDatumStripeBalance, PaymentIntentCreateParamsPaymentMethodDatumStripeBalance, PaymentIntentModifyParamsPaymentMethodDatumStripeBalance, PaymentMethod.StripeBalance, PaymentMethodCreateParamsStripeBalance, PaymentRecord.PaymentMethodDetail.StripeBalance, SetupIntentConfirmParamsPaymentMethodDatumStripeBalance, SetupIntentCreateParamsPaymentMethodDatumStripeBalance, and SetupIntentModifyParamsPaymentMethodDatumStripeBalance
  • Add support for tax_details on InvoiceAddLinesParamsLinePriceDatumProductDatum, InvoiceLineItemModifyParamsPriceDatumProductDatum, InvoiceUpdateLinesParamsLinePriceDatumProductDatum, PaymentLinkCreateParamsLineItemPriceDatumProductDatum, PlanCreateParamsProduct, PriceCreateParamsProductDatum, ProductCreateParams, ProductModifyParams, checkout.SessionCreateParamsLineItemPriceDatumProductDatum, and checkout.SessionModifyParamsLineItemPriceDatumProductDatum
  • Add support for pending_invoice_item_interval on checkout.SessionModifyParamsSubscriptionDatum
  • Add support for hosted and ui_mode on FinancialConnections.Session and financial_connections.SessionCreateParams
  • Add support for url on FinancialConnections.Session
  • Add support for expires_after_seconds on Invoice.PaymentSetting.PaymentMethodOption.Pix, InvoiceCreateParamsPaymentSettingPaymentMethodOptionPix, InvoiceModifyParamsPaymentSettingPaymentMethodOptionPix, QuotePreviewInvoice.PaymentSetting.PaymentMethodOption.Pix, Subscription.PaymentSetting.PaymentMethodOption.Pix, SubscriptionCreateParamsPaymentSettingPaymentMethodOptionPix, and SubscriptionModifyParamsPaymentSettingPaymentMethodOptionPix
  • Add support for current_trial on InvoiceCreatePreviewParamsSubscriptionDetailItem, SubscriptionCreateParamsItem, SubscriptionItemCreateParams, SubscriptionItemModifyParams, SubscriptionItem, and SubscriptionModifyParamsItem
  • Add support for surcharge on PaymentIntent.AmountDetail, PaymentIntentCaptureParamsAmountDetail, PaymentIntentConfirmParamsAmountDetail, PaymentIntentCreateParamsAmountDetail, PaymentIntentIncrementAuthorizationParamsAmountDetail, and PaymentIntentModifyParamsAmountDetail
  • Add support for amount_details and payment_details on PaymentIntentDecrementAuthorizationParams
  • Add support for mandate_options on PaymentIntent.PaymentMethodOption.StripeBalance
  • Add support for managed_payments on PaymentLinkCreateParams and PaymentLink
  • Add support for stripe_balance on SetupIntent.PaymentMethodOption, SetupIntentConfirmParamsPaymentMethodOption, SetupIntentCreateParamsPaymentMethodOption, and SetupIntentModifyParamsPaymentMethodOption
  • Add support for billing_cycle_anchor on Subscription.TrialSetting.EndBehavior, SubscriptionCreateParamsTrialSettingEndBehavior, and SubscriptionModifyParamsTrialSettingEndBehavior
  • ⚠️ Add support for new values admissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on enums Tax.Registration.CountryOption.Me.type and tax.RegistrationCreateParamsCountryOptionMe.type
  • Add support for admissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on Tax.Registration.CountryOption.Me
  • Add support for requirements on TaxCode
  • ⚠️ Change type of V2.Billing.Cadence.SettingsDatum.Collection.PaymentMethodOption.Card.MandateOption.amount, V2.Billing.CollectionSetting.PaymentMethodOption.Card.MandateOption.amount, V2.Billing.CollectionSettingVersion.PaymentMethodOption.Card.MandateOption.amount, v2.billing.CollectionSettingCreateParamsPaymentMethodOptionCardMandateOption.amount, and v2.billing.CollectionSettingModifyParamsPaymentMethodOptionCardMandateOption.amount from longInteger to int64_string
  • ⚠️ Add support for new values ar_bank_account, co_bank_account, and eg_bank_account on enum V2.Core.Account.Configuration.Recipient.DefaultOutboundDestination.type
  • Add support for timezone on V2.Core.Account.Default, v2.core.AccountCreateParamsDefault, and v2.core.AccountModifyParamsDefault
  • Add support for azure_event_grid on V2.Core.EventDestination and v2.core.EventDestinationCreateParams
  • ⚠️ Add support for new value no_azure_partner_topic_exists on enum V2.Core.EventDestination.StatusDetail.Disabled.reason
  • ⚠️ Add support for new value azure_event_grid on enums V2.Core.EventDestination.type and v2.core.EventDestinationCreateParams.type
  • Add support for supported_currencies on V2.Core.Vault.GbBankAccount, V2.Core.Vault.UsBankAccount, and V2.MoneyManagement.PayoutMethod.Card
  • ⚠️ Change V2.Core.Vault.GbBankAccount.sort_code and v2.core.vault.GbBankAccountCreateParams.sort_code to be optional
  • Add support for restricted on V2.MoneyManagement.PayoutMethod
  • Add support for currencies on V2.MoneyManagement.PayoutMethodsBankAccountSpec.Country.Field
  • Add support for counterparty and description on V2.MoneyManagement.Transaction
  • ⚠️ Add support for currency on v2.core.vault.GbBankAccountCreateParams, v2.core.vault.UsBankAccountCreateParams, v2.money_management.OutboundSetupIntentCreateParamsPayoutMethodDatumBankAccount, v2.money_management.OutboundSetupIntentCreateParamsPayoutMethodDatumCard, v2.money_management.OutboundSetupIntentModifyParamsPayoutMethodDatumBankAccount, and v2.money_management.OutboundSetupIntentModifyParamsPayoutMethodDatumCard
  • Add support for iban on v2.core.vault.GbBankAccountCreateParams
  • Change v2.core.vault.GbBankAccountCreateParams.account_number to be optional
  • ⚠️ Add support for new value currency on enum InvalidPaymentMethodError.invalid_param
  • Add support for event notifications V2CoreBatchJobBatchFailedEvent, V2CoreBatchJobCanceledEvent, V2CoreBatchJobCompletedEvent, V2CoreBatchJobCreatedEvent, V2CoreBatchJobReadyForUploadEvent, V2CoreBatchJobTimeoutEvent, V2CoreBatchJobUpdatedEvent, V2CoreBatchJobUploadTimeoutEvent, V2CoreBatchJobValidatingEvent, and V2CoreBatchJobValidationFailedEvent with related object v2.core.BatchJob
  • Add support for error code service_period_coupon_with_metered_tiered_item_unsupported on QuotePreviewInvoice.LastFinalizationError
• #1765 Merge to beta
• #1753 Merge to beta
• #1745 Merge to beta
• #1713 Delete API_VERSION file as it is no longer needed

See the changelog for more details.

v15.1.0a1

This release changes the pinned API version to 2026-03-25.preview and contains additional breaking changes. See the GA changelog for more information.

• #1776 Update generated code for private-preview
  • Add support for new resource RiskSignals
  • Add support for financial_account_rewards and nesting_demo on AccountSession.Component
  • Add support for upi_payments on Account.Capability, AccountCreateParamsCapability, and AccountModifyParamsCapability
  • Add support for risk_signals on Account
  • Add support for fraud_intent on AccountSignals
  • ⚠️ Add support for new value related_accounts on enum AccountSignals.Delinquency.Indicator.indicator
  • Add support for risk_reserved on Balance
  • ⚠️ Remove support for billable_items on Billing.Alert.SpendThreshold.Filter
  • Add support for upi on Charge.PaymentMethodDetail, Checkout.Session.PaymentMethodOption, ConfirmationToken.PaymentMethodPreview, ConfirmationTokenCreateParamsPaymentMethodDatum, Mandate.PaymentMethodDetail, PaymentAttemptRecord.PaymentMethodDetail, PaymentIntent.PaymentMethodOption, PaymentIntentConfirmParamsPaymentMethodDatum, PaymentIntentConfirmParamsPaymentMethodOption, PaymentIntentCreateParamsPaymentMethodDatum, PaymentIntentCreateParamsPaymentMethodOption, PaymentIntentModifyParamsPaymentMethodDatum, PaymentIntentModifyParamsPaymentMethodOption, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationModifyParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.PaymentMethodDetail, SetupAttempt.PaymentMethodDetail, SetupIntent.PaymentMethodOption, SetupIntentConfirmParamsPaymentMethodDatum, SetupIntentConfirmParamsPaymentMethodOption, SetupIntentCreateParamsPaymentMethodDatum, SetupIntentCreateParamsPaymentMethodOption, SetupIntentModifyParamsPaymentMethodDatum, SetupIntentModifyParamsPaymentMethodOption, and checkout.SessionCreateParamsPaymentMethodOption
  • ⚠️ Add support for new value tempo on enums Charge.PaymentMethodDetail.Crypto.network, PaymentAttemptRecord.PaymentMethodDetail.Crypto.network, and PaymentRecord.PaymentMethodDetail.Crypto.network
  • ⚠️ Remove support for source_type on Charge.PaymentMethodDetail.StripeBalance, ConfirmationToken.PaymentMethodPreview.StripeBalance, ConfirmationTokenCreateParamsPaymentMethodDatumStripeBalance, PaymentAttemptRecord.PaymentMethodDetail.StripeBalance, PaymentIntentConfirmParamsPaymentMethodDatumStripeBalance, PaymentIntentCreateParamsPaymentMethodDatumStripeBalance, PaymentIntentModifyParamsPaymentMethodDatumStripeBalance, PaymentMethod.StripeBalance, PaymentMethodCreateParamsStripeBalance, PaymentRecord.PaymentMethodDetail.StripeBalance, SetupIntentConfirmParamsPaymentMethodDatumStripeBalance, SetupIntentCreateParamsPaymentMethodDatumStripeBalance, and SetupIntentModifyParamsPaymentMethodDatumStripeBalance
  • Add support for integration_identifier on Checkout.Session and checkout.SessionCreateParams
  • ⚠️ Add support for new value application on enums Checkout.Session.AutomaticTax.Liability.type, Checkout.Session.InvoiceCreation.InvoiceDatum.Issuer.type, Invoice.AutomaticTax.Liability.type, Invoice.Issuer.type, InvoiceCreateParamsAutomaticTaxLiability.type, InvoiceCreateParamsIssuer.type, InvoiceCreatePreviewParamsAutomaticTaxLiability.type, InvoiceCreatePreviewParamsIssuer.type, InvoiceCreatePreviewParamsScheduleDetailPhaseAutomaticTaxLiability.type, InvoiceCreatePreviewParamsScheduleDetailPhaseInvoiceSettingIssuer.type, InvoiceModifyParamsAutomaticTaxLiability.type, InvoiceModifyParamsIssuer.type, PaymentLink.AutomaticTax.Liability.type, PaymentLink.InvoiceCreation.InvoiceDatum.Issuer.type, PaymentLink.SubscriptionDatum.InvoiceSetting.Issuer.type, PaymentLinkCreateParamsAutomaticTaxLiability.type, PaymentLinkCreateParamsInvoiceCreationInvoiceDatumIssuer.type, PaymentLinkCreateParamsSubscriptionDatumInvoiceSettingIssuer.type, PaymentLinkModifyParamsAutomaticTaxLiability.type, PaymentLinkModifyParamsInvoiceCreationInvoiceDatumIssuer.type, PaymentLinkModifyParamsSubscriptionDatumInvoiceSettingIssuer.type, Quote.AutomaticTax.Liability.type, Quote.InvoiceSetting.Issuer.type, QuoteCreateParamsAutomaticTaxLiability.type, QuoteCreateParamsInvoiceSettingIssuer.type, QuoteModifyParamsAutomaticTaxLiability.type, QuoteModifyParamsInvoiceSettingIssuer.type, QuotePreviewInvoice.AutomaticTax.Liability.type, QuotePreviewInvoice.Issuer.type, QuotePreviewSubscriptionSchedule.DefaultSetting.AutomaticTax.Liability.type, QuotePreviewSubscriptionSchedule.DefaultSetting.InvoiceSetting.Issuer.type, QuotePreviewSubscriptionSchedule.Phase.AutomaticTax.Liability.type, QuotePreviewSubscriptionSchedule.Phase.InvoiceSetting.Issuer.type, Subscription.AutomaticTax.Liability.type, Subscription.InvoiceSetting.Issuer.type, SubscriptionCreateParamsAutomaticTaxLiability.type, SubscriptionCreateParamsInvoiceSettingIssuer.type, SubscriptionModifyParamsAutomaticTaxLiability.type, SubscriptionModifyParamsInvoiceSettingIssuer.type, SubscriptionSchedule.DefaultSetting.AutomaticTax.Liability.type, SubscriptionSchedule.DefaultSetting.InvoiceSetting.Issuer.type, SubscriptionSchedule.Phase.AutomaticTax.Liability.type, SubscriptionSchedule.Phase.InvoiceSetting.Issuer.type, SubscriptionScheduleCreateParamsDefaultSettingAutomaticTaxLiability.type, SubscriptionScheduleCreateParamsDefaultSettingInvoiceSettingIssuer.type, SubscriptionScheduleCreateParamsPhaseAutomaticTaxLiability.type, SubscriptionScheduleCreateParamsPhaseInvoiceSettingIssuer.type, SubscriptionScheduleModifyParamsDefaultSettingAutomaticTaxLiability.type, SubscriptionScheduleModifyParamsDefaultSettingInvoiceSettingIssuer.type, SubscriptionScheduleModifyParamsPhaseAutomaticTaxLiability.type, SubscriptionScheduleModifyParamsPhaseInvoiceSettingIssuer.type, checkout.SessionCreateParamsAutomaticTaxLiability.type, checkout.SessionCreateParamsInvoiceCreationInvoiceDatumIssuer.type, checkout.SessionCreateParamsSubscriptionDatumInvoiceSettingIssuer.type, checkout.SessionModifyParamsAutomaticTaxLiability.type, checkout.SessionModifyParamsInvoiceCreationInvoiceDatumIssuer.type, and checkout.SessionModifyParamsSubscriptionDatumInvoiceSettingIssuer.type
  • Add support for new value upi on enum checkout.SessionCreateParams.excluded_payment_method_types
  • Change type of InvoiceAddLinesParamsLinePriceDatumProductDatumTaxDetail.tax_code, InvoiceLineItemModifyParamsPriceDatumProductDatumTaxDetail.tax_code, InvoiceUpdateLinesParamsLinePriceDatumProductDatumTaxDetail.tax_code, PaymentLinkCreateParamsLineItemPriceDatumProductDatumTaxDetail.tax_code, PlanCreateParamsProductTaxDetail.tax_code, PriceCreateParamsProductDatumTaxDetail.tax_code, ProductCreateParamsTaxDetail.tax_code, ProductModifyParamsTaxDetail.tax_code, checkout.SessionCreateParamsLineItemPriceDatumProductDatumTaxDetail.tax_code, and checkout.SessionModifyParamsLineItemPriceDatumProductDatumTaxDetail.tax_code from string to emptyable(string)
  • Add support for crypto on checkout.SessionCreateParamsPaymentMethodOption
  • Add support for new value upi on enum checkout.SessionCreateParams.payment_method_types
  • Add support for pending_invoice_item_interval on checkout.SessionCreateParamsSubscriptionDatum and checkout.SessionModifyParamsSubscriptionDatum
  • ⚠️ Add support for new values elements, embedded_page, form, and hosted_page on enums Checkout.Session.ui_mode and checkout.SessionCreateParams.ui_mode
  • ⚠️ Remove support for values custom, embedded, and hosted from enums Checkout.Session.ui_mode and checkout.SessionCreateParams.ui_mode
  • Change InvoiceAddLinesParamsLinePriceDatumProductDatumTaxDetail.tax_code, InvoiceLineItemModifyParamsPriceDatumProductDatumTaxDetail.tax_code, InvoiceUpdateLinesParamsLinePriceDatumProductDatumTaxDetail.tax_code, PaymentLinkCreateParamsLineItemPriceDatumProductDatumTaxDetail.tax_code, PlanCreateParamsProductTaxDetail.tax_code, PriceCreateParamsProductDatumTaxDetail.tax_code, ProductCreateParamsTaxDetail.tax_code, ProductModifyParamsTaxDetail.tax_code, checkout.SessionCreateParamsLineItemPriceDatumProductDatumTaxDetail.tax_code, and checkout.SessionModifyParamsLineItemPriceDatumProductDatumTaxDetail.tax_code to be optional
  • Add support for au_becs_debit, bacs_debit, boleto, link, sepa_debit, and us_bank_account on Checkout.Session.CurrentAttempt.PaymentMethodDetail
  • ⚠️ Add support for new value marine_carbon_removal on enum Climate.Supplier.removal_pathway
  • Add support for new value upi on enums ConfirmationTokenCreateParamsPaymentMethodDatum.type, PaymentIntentConfirmParamsPaymentMethodDatum.type, PaymentIntentCreateParamsPaymentMethodDatum.type, PaymentIntentModifyParamsPaymentMethodDatum.type, SetupIntentConfirmParamsPaymentMethodDatum.type, SetupIntentCreateParamsPaymentMethodDatum.type, and SetupIntentModifyParamsPaymentMethodDatum.type
  • ⚠️ Add support for new value upi on enums ConfirmationToken.PaymentMethodPreview.type and PaymentMethod.type
  • Add support for metadata on CreditNoteCreateParamsLine, CreditNoteLineItem, CreditNotePreviewLinesParamsLine, and CreditNotePreviewParamsLine
  • Add support for new value upi on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for selected_fulfillment_option_overrides on DelegatedCheckout.RequestedSession.FulfillmentDetail
  • Add support for line_item_keys on DelegatedCheckout.RequestedSession.FulfillmentDetail.FulfillmentOption.Digital.DigitalOption and ...

v15.0.0

This release changes the pinned API version to 2026-03-25.dahlia and contains breaking changes (prefixed with ⚠️ below). There's also a detailed migration guide to simplify your upgrade process.

Please review details for the breaking changes and alternatives in the Stripe API changelog before upgrading.

• ⚠️ Breaking change: #1769 Add decimal_string coercion for v1 and v2 API fields

  • All decimal_string fields changed type from str to decimal.Decimal in both request params and response objects. Code that reads or writes these fields as str will need to use Decimal instead. Affected fields across v1 and v2 APIs:
    • checkout.Session: fx_rate
    • climate.Order: metric_tons; climate.Product: metric_tons_available
    • CreditNoteLineItem: unit_amount_decimal
    • InvoiceItem: quantity_decimal, unit_amount_decimal
    • InvoiceLineItem: quantity_decimal, unit_amount_decimal
    • issuing.Authorization / issuing.Transaction (and TestHelpers): quantity_decimal, unit_cost_decimal, gross_amount_decimal, local_amount_decimal, national_amount_decimal
    • Plan: amount_decimal, flat_amount_decimal, unit_amount_decimal
    • Price: unit_amount_decimal, flat_amount_decimal (including currency_options and tiers)
    • v2.core.Account / v2.core.AccountPerson: percent_ownership
    • Request params on Invoice, Product, Quote, Subscription, SubscriptionItem, SubscriptionSchedule, PaymentLink: unit_amount_decimal, flat_amount_decimal, quantity_decimal (where applicable)

• ⚠️ Breaking change:#1767 Throw an error when using the wrong webhook parsing method

• ⚠️ Breaking change: #1764 Drop support for Python 3.7 & 3.8

• ⚠️ Breaking change: #1762 StripeObject no longer inherits from dict

  • StripeObject no longer inherits from dict, so any dict methods will no longer exist, including .get(), .update(), and notably, .items().
  • or convenience, it's still possible to check presence with 'some_key' in some_obj and check for equality between stripe objects. But most key/value iteration needs an extra step
  • To access the underlying data as a dict, call some_obj.to_dict(), which recursively dumps all stripe-provided classes into native Python types. This is a read-only view; changes to the output of to_dict() won't affect the original object.
  • Write operations can still be done with dot notation (some_obj.val = 123) or bracket notation (some_obj["val"] = 123). Do that instead of trying to interact with the underlying data store, as the implementation is considered private and may change without warning in the future.

See the changelog for more details.

v14.5.0a4

• #1760 Update generated code for private-preview
  • Add support for simulate_crypto_deposit test helper method on resource PaymentIntent
  • Add support for deposit_options and mode on PaymentIntent.PaymentMethodOption.Crypto, PaymentIntentConfirmParamsPaymentMethodOptionCrypto, PaymentIntentCreateParamsPaymentMethodOptionCrypto, and PaymentIntentModifyParamsPaymentMethodOptionCrypto
  • Add support for crypto_display_details on PaymentIntent.NextAction
• #1755 Update generated code for private-preview
  • Add support for new resources orchestration.PaymentAttempt and radar.CustomerEvaluation
  • Add support for retrieve method on resource orchestration.PaymentAttempt
  • Add support for create and modify methods on resource radar.CustomerEvaluation
  • Add support for approve method on resource checkout.Session
  • Add support for report_authenticated, report_canceled, report_failed, report_guaranteed, report_informational, and report_refund methods on resource PaymentAttemptRecord
  • Add support for create_us_paper_check_on_application on AccountSessionCreateParamsComponentCheckScanningFeature
  • ⚠️ Change AccountSignals.delinquency to be optional
  • Add support for approval_method on Checkout.Session and checkout.SessionCreateParams
  • Add support for current_attempt on Checkout.Session
  • Add support for selected_fulfillment_option_overrides on delegated_checkout.RequestedSessionModifyParamsFulfillmentDetail
  • Add support for pricing_plan_subscription_details on InvoiceItem.Parent and InvoiceLineItem.Parent
  • ⚠️ Remove support for license_fee_subscription_details on InvoiceItem.Parent and InvoiceLineItem.Parent
  • ⚠️ Remove support for pricing_plan_subscription and pricing_plan_version on InvoiceItem.Parent.RateCardSubscriptionDetail and InvoiceLineItem.Parent.RateCardSubscriptionDetail
  • Add support for new value pricing_plan_subscription_details on enum InvoiceItem.Parent.type
  • ⚠️ Remove support for value license_fee_subscription_details from enum InvoiceItem.Parent.type
  • Add support for new value discounts on enum InvoiceItem.frozen_fields
  • Add support for new value pricing_plan_subscription_details on enum InvoiceLineItem.Parent.type
  • ⚠️ Remove support for value license_fee_subscription_details from enum InvoiceLineItem.Parent.type
  • Add support for token_details on Issuing.Authorization
  • Add support for failure_code on PaymentRecordReportPaymentAttemptFailedParams, PaymentRecordReportPaymentAttemptParamsFailed, and PaymentRecordReportPaymentParamsFailed
  • Change PaymentRecordReportPaymentAttemptCanceledParams.canceled_at to be optional
  • Change PaymentRecordReportPaymentAttemptFailedParams.failed_at to be optional
  • Change PaymentRecordReportPaymentAttemptGuaranteedParams.guaranteed_at to be optional
  • Change PaymentRecordReportRefundParams.refunded to be optional
  • ⚠️ Remove support for value now from enums QuoteCreateParamsSubscriptionDataOverrideBillingScheduleBillFrom.type, QuoteCreateParamsSubscriptionDatumBillingScheduleBillFrom.type, QuoteModifyParamsSubscriptionDataOverrideBillingScheduleBillFrom.type, and QuoteModifyParamsSubscriptionDatumBillingScheduleBillFrom.type
  • ⚠️ Change radar.IssuingAuthorizationEvaluationCreateParamsCardDetail.bin_country to be required
  • Add support for recurring_interval on shared_payment.GrantedTokenCreateParamsUsageLimit
  • Change shared_payment.GrantedTokenCreateParamsUsageLimit.expires_at to be optional
  • Add support for home_rule_tax on Tax.Registration.CountryOption.Me and tax.RegistrationCreateParamsCountryOptionMe
  • Add support for new value home_rule_tax on enums Tax.Registration.CountryOption.Me.type and tax.RegistrationCreateParamsCountryOptionMe.type

See the changelog for more details.

v14.5.0a3

• #1750 Update generated code for private-preview
  • Add support for new resource radar.IssuingAuthorizationEvaluation
  • Add support for create method on resource radar.IssuingAuthorizationEvaluation
  • Add support for new value fee_credits on enum BalanceTransaction.balance_type
  • ⚠️ Rename affiliate_attributions to affiliate_attribution on delegated_checkout.RequestedSessionConfirmParams and delegated_checkout.RequestedSessionCreateParams
  • Add support for amount_to_counter on Dispute
  • Add support for frozen_fields on InvoiceItem
  • Add support for new value next_billing_period_start on enums V2.Billing.IntentAction.Apply.EffectiveAt.type and v2.billing.IntentCreateParamsActionApplyEffectiveAt.type
  • Add support for consumer on V2.Core.Account.Configuration.CardCreator.Capability, V2.Core.Account.Identity.Attestation.TermsOfService.CardCreator, v2.core.AccountCreateParamsConfigurationCardCreatorCapability, v2.core.AccountCreateParamsIdentityAttestationTermsOfServiceCardCreator, v2.core.AccountModifyParamsConfigurationCardCreatorCapability, and v2.core.AccountModifyParamsIdentityAttestationTermsOfServiceCardCreator
  • Add support for fifth_third on V2.Core.Account.Configuration.CardCreator.Capability.Commercial, V2.Core.Account.Identity.Attestation.TermsOfService.CardCreator.Commercial, v2.core.AccountCreateParamsConfigurationCardCreatorCapabilityCommercial, v2.core.AccountCreateParamsIdentityAttestationTermsOfServiceCardCreatorCommercial, v2.core.AccountModifyParamsConfigurationCardCreatorCapabilityCommercial, and v2.core.AccountModifyParamsIdentityAttestationTermsOfServiceCardCreatorCommercial
  • Add support for prepaid_card on V2.Core.Account.Configuration.CardCreator.Capability.Commercial.CrossRiverBank, V2.Core.Account.Identity.Attestation.TermsOfService.CardCreator.Commercial.CrossRiverBank, v2.core.AccountCreateParamsConfigurationCardCreatorCapabilityCommercialCrossRiverBank, v2.core.AccountCreateParamsIdentityAttestationTermsOfServiceCardCreatorCommercialCrossRiverBank, v2.core.AccountModifyParamsConfigurationCardCreatorCapabilityCommercialCrossRiverBank, and v2.core.AccountModifyParamsIdentityAttestationTermsOfServiceCardCreatorCommercialCrossRiverBank
  • Add support for new values commercial.cross_river_bank.prepaid_card, commercial.fifth_third.charge_card, consumer.celtic.revolving_credit_card, consumer.cross_river_bank.prepaid_card, and consumer.lead.prepaid_card on enums V2.Core.Account.FutureRequirement.Entry.Impact.RestrictsCapability.capability and V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capability
  • Add support for payment_method_data on v2.payments.OffSessionPaymentCreateParams
  • Change v2.payments.OffSessionPaymentCreateParams.payment_method to be optional
  • Add support for new values commercial.cross_river_bank.prepaid_card, commercial.fifth_third.charge_card, consumer.celtic.revolving_credit_card, consumer.cross_river_bank.prepaid_card, and consumer.lead.prepaid_card on enum EventsV2CoreAccountIncludingConfigurationCardCreatorCapabilityStatusUpdatedEvent.updated_capability

See the changelog for more details.

v14.4.1

• #1748 Add Stripe-Request-Trigger header
• #1743 Add agent information to UserAgent

See the changelog for more details.