latest_version on V2.Billing.LicenseFee, V2.Billing.PricingPlan, and V2.Billing.RateCardservice_interval_count and service_interval on V2.Billing.LicenseFee and V2.Billing.RateCardv2.core.WorkflowRun and v2.core.Workflowreport_authorized method on resource PaymentAttemptRecordlist and retrieve methods on resource v2.core.WorkflowRuninvoke, list, and retrieve methods on resource v2.core.Workflownext_action and status on SharedPayment.IssuedTokennetwork_id on SharedPayment.IssuedToken.SellerDetailbills on AccountSession.Componentsettlement_currencies on BalanceSettings.Payment and BalanceSettingsModifyParamsPaymentdefault_settlement_currency on BalanceSettings.Paymentaccount_funding on Charge.PaymentMethodDetail.Cardautomatic_surcharge on Checkout.Session, PaymentLinkCreateParams, PaymentLink, and checkout.SessionCreateParamsbizum on Checkout.Session.PaymentMethodOption and checkout.SessionCreateParamsPaymentMethodOptionsurcharge_cost on Checkout.Sessionamount_surcharge on Checkout.Session.TotalDetailshared_payment_granted_token on ConfirmationTokenCreateParamsPaymentMethodDatum, PaymentIntentConfirmParamsPaymentMethodDatum, PaymentIntentCreateParamsPaymentMethodDatum, PaymentIntentModifyParamsPaymentMethodDatum, SetupIntentConfirmParamsPaymentMethodDatum, SetupIntentCreateParamsPaymentMethodDatum, and SetupIntentModifyParamsPaymentMethodDatumemail on enums identity.VerificationReportListParams.type, identity.VerificationSessionCreateParams.type, and identity.VerificationSessionModifyParams.typedetails on Identity.VerificationReport.Emailemail on enums Identity.VerificationReport.type and Identity.VerificationSession.typeconfirm on identity.VerificationSessionCreateParams and identity.VerificationSessionModifyParamssubscription on InvoiceItem.Parent.ScheduleDetailshared_payment_granted_token on PaymentIntentConfirmParams and PaymentIntentCreateParamsmoney_services on PaymentIntent.PaymentDetailexternal_reference on PlanSharedPayment.GrantedToken.PaymentMethodDetail.billing_details to be requiredpayment_record on ApplicationFee.FeeSourcefleet_data on ChargeCaptureParamsPaymentDetail, ChargeModifyParamsPaymentDetail, PaymentIntent.PaymentDetail, PaymentIntentAmountDetailsLineItem.PaymentMethodOption.Card, PaymentIntentCaptureParamsAmountDetailLineItemPaymentMethodOptionCard, PaymentIntentCaptureParamsPaymentDetail, PaymentIntentConfirmParamsAmountDetailLineItemPaymentMethodOptionCard, PaymentIntentConfirmParamsPaymentDetail, PaymentIntentCreateParamsAmountDetailLineItemPaymentMethodOptionCard, PaymentIntentCreateParamsPaymentDetail, PaymentIntentDecrementAuthorizationParamsAmountDetailLineItemPaymentMethodOptionCard, PaymentIntentIncrementAuthorizationParamsAmountDetailLineItemPaymentMethodOptionCard, PaymentIntentModifyParamsAmountDetailLineItemPaymentMethodOptionCard, and PaymentIntentModifyParamsPaymentDetailbeneficiary_account, beneficiary_details, sender_account, and sender_details on ChargeCaptureParamsPaymentDetailMoneyServiceAccountFunding, ChargeModifyParamsPaymentDetailMoneyServiceAccountFunding, PaymentIntentCaptureParamsPaymentDetailMoneyServiceAccountFunding, PaymentIntentConfirmParamsPaymentDetailMoneyServiceAccountFunding, PaymentIntentCreateParamsPaymentDetailMoneyServiceAccountFunding, and PaymentIntentModifyParamsPaymentDetailMoneyServiceAccountFundingChargeCaptureParamsPaymentDetailMoneyService.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'))requires_action on enum DelegatedCheckout.RequestedSession.statusbizum on Invoice.PaymentSetting.PaymentMethodOption, InvoiceCreateParamsPaymentSettingPaymentMethodOption, InvoiceModifyParamsPaymentSettingPaymentMethodOption, QuotePreviewInvoice.PaymentSetting.PaymentMethodOption, Subscription.PaymentSetting.PaymentMethodOption, SubscriptionCreateParamsPaymentSettingPaymentMethodOption, and SubscriptionModifyParamsPaymentSettingPaymentMethodOptionbizum 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_typesquantity_precision on PaymentIntentAmountDetailsLineItem, PaymentIntentCaptureParamsAmountDetailLineItem, PaymentIntentConfirmParamsAmountDetailLineItem, PaymentIntentCreateParamsAmountDetailLineItem, PaymentIntentDecrementAuthorizationParamsAmountDetailLineItem, PaymentIntentIncrementAuthorizationParamsAmountDetailLineItem, and PaymentIntentModifyParamsAmountDetailLineItemliquid_asset and wallet on PaymentIntentConfirmParamsPaymentMethodOptionCardPaymentDetailMoneyServiceAccountFunding, PaymentIntentConfirmParamsPaymentMethodOptionCardPresentPaymentDetailMoneyServiceAccountFunding, PaymentIntentCreateParamsPaymentMethodOptionCardPaymentDetailMoneyServiceAccountFunding, PaymentIntentCreateParamsPaymentMethodOptionCardPresentPaymentDetailMoneyServiceAccountFunding, PaymentIntentModifyParamsPaymentMethodOptionCardPaymentDetailMoneyServiceAccountFunding, and PaymentIntentModifyParamsPaymentMethodOptionCardPresentPaymentDetailMoneyServiceAccountFundingshared_payment_granted_token on PaymentMethodRadar.CustomerEvaluation.event_type from string to enum('login'|'registration')Radar.CustomerEvaluation.Signal.AccountSharing.risk_level and Radar.CustomerEvaluation.Signal.MultiAccounting.risk_level from string to enumdata on Radar.PaymentEvaluation.ClientDeviceMetadataDetail and radar.PaymentEvaluationCreateParamsClientDeviceMetadataDetailsunbit on SharedPayment.GrantedToken.PaymentMethodDetailsunbit on enum SharedPayment.GrantedToken.PaymentMethodDetail.typebm_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.typebm_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.typeCannotProceedErrorshared_payment.IssuedToken and v2.data.reporting.QueryRuncreate and retrieve methods on resource v2.data.reporting.QueryRunpause and resume methods on resource v2.payments.OffSessionPaymenttenant_keys, tenant_operator, and tenant_values on billing.BillingMeterListMeterEventSummaryParamsmoney_services on ChargeCaptureParamsPaymentDetail, ChargeModifyParamsPaymentDetail, PaymentIntentCaptureParamsPaymentDetail, PaymentIntentConfirmParamsPaymentDetail, PaymentIntentCreateParamsPaymentDetail, and PaymentIntentModifyParamsPaymentDetailpayment_method_options on DelegatedCheckout.RequestedSession, delegated_checkout.RequestedSessionCreateParams, and delegated_checkout.RequestedSessionModifyParamspayment_method_data on delegated_checkout.RequestedSessionConfirmParams, delegated_checkout.RequestedSessionCreateParams, and delegated_checkout.RequestedSessionModifyParamscard_brands and payment_method_types on DelegatedCheckout.RequestedSession.SellerDetailDelegatedCheckout.RequestedSession.shared_payment_issued_token from string to expandable($SharedPayment.IssuedToken)check_scan on Invoice.PaymentSetting.PaymentMethodOption, InvoiceCreateParamsPaymentSettingPaymentMethodOption, InvoiceModifyParamsPaymentSettingPaymentMethodOption, QuotePreviewInvoice.PaymentSetting.PaymentMethodOption, Subscription.PaymentSetting.PaymentMethodOption, SubscriptionCreateParamsPaymentSettingPaymentMethodOption, and SubscriptionModifyParamsPaymentSettingPaymentMethodOptioncheck_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_typesprocessor_details on PaymentAttemptRecordReportFailedParams, PaymentAttemptRecordReportGuaranteedParams, PaymentRecordReportPaymentAttemptFailedParams, PaymentRecordReportPaymentAttemptGuaranteedParams, PaymentRecordReportPaymentAttemptParamsFailed, PaymentRecordReportPaymentAttemptParamsGuaranteed, PaymentRecordReportPaymentParamsFailed, and PaymentRecordReportPaymentParamsGuaranteedpayment_details on PaymentIntentConfirmParamsPaymentMethodOptionCardPresent, PaymentIntentConfirmParamsPaymentMethodOptionCard, PaymentIntentCreateParamsPaymentMethodOptionCardPresent, PaymentIntentCreateParamsPaymentMethodOptionCard, PaymentIntentModifyParamsPaymentMethodOptionCardPresent, and PaymentIntentModifyParamsPaymentMethodOptionCardbill_from on QuotePreviewSubscriptionSchedule.BillingSchedule, Subscription.BillingSchedule, and SubscriptionSchedule.BillingScheduleagent_details, payment_method_details, and risk_details on SharedPayment.GrantedTokenpaper_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.AccountModifyParamsConfigurationStorerCapabilityOutboundPaymentpaper_checks on enum V2.Account.Configuration.SupportableFeature.recipient_datapaper_checks on enum V2.Account.Requirement.Impact.required_for_featuresV2.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 objectV2.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 objectid on V2.Billing.CadenceSpendModifier.MaxBillingPeriodSpend.Amount.CustomPricingUnit, V2.Billing.IntentAction.Apply.SpendModifierRule.MaxBillingPeriodSpend.Amount.CustomPricingUnit, and v2.billing.IntentCreateParamsActionApplySpendModifierRuleMaxBillingPeriodSpendAmountCustomPricingUnitoutbound_payments.paper_checks and paper_checks on enums V2.Core.Account.FutureRequirement.Entry.Impact.RestrictsCapability.capability and V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capabilitybm_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.typebm_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.typeV2.Core.Event.Reason.Request.Client.stripe_action from map(string: dynamic) to an objectV2.MoneyManagement.InboundTransfer.TransferHistory.bank_debit_processing from map(string: dynamic) to an objectV2.MoneyManagement.InboundTransfer.TransferHistory.bank_debit_queued from map(string: dynamic) to an objectV2.MoneyManagement.InboundTransfer.TransferHistory.bank_debit_succeeded from map(string: dynamic) to an objectpaper_check_attachment_too_large, paper_check_expired, and paper_check_undeliverable on enum V2.MoneyManagement.OutboundPayment.StatusDetail.Failed.reasontown on V2.MoneyManagement.OutboundPayment.TrackingDetail.PaperCheck.MailingAddressV2.MoneyManagement.OutboundPayment.DeliveryOption.PaperCheck.memo to be requiredpayout_method_amount_limit_exceeded on enum V2.MoneyManagement.OutboundTransfer.StatusDetail.Failed.reasonapplication_fee_amount_requested on V2.Payments.OffSessionPaymentcompartment_id on V2.Payments.OffSessionPaymentexceeded_retry_window on enum V2.Payments.OffSessionPayment.failure_reasonretry_until on V2.Payments.OffSessionPayment.RetryDetailpaused on enum V2.Payments.OffSessionPayment.statusV2.Reporting.ReportRun.Result.file to be optionalapplication_fee_amount on v2.payments.OffSessionPaymentCaptureParams and v2.payments.OffSessionPaymentCreateParamspaper_checks on enum EventsV2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent.updated_capabilityoutbound_payments.paper_checks on enum EventsV2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent.updated_capabilityalert_id on EventsV2CoreHealthApiErrorResolvedEvent, EventsV2CoreHealthApiLatencyResolvedEvent, EventsV2CoreHealthAuthorizationRateDropResolvedEvent, EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent, EventsV2CoreHealthPaymentMethodErrorResolvedEvent, EventsV2CoreHealthSepaDebitDelayedFiringEvent, EventsV2CoreHealthSepaDebitDelayedResolvedEvent, EventsV2CoreHealthTrafficVolumeDropResolvedEvent, and EventsV2CoreHealthWebhookLatencyResolvedEventapi_key on EventsV2IamApiKeyCreatedEvent, EventsV2IamApiKeyDefaultSecretRevealedEvent, EventsV2IamApiKeyExpiredEvent, EventsV2IamApiKeyPermissionsUpdatedEvent, EventsV2IamApiKeyRotatedEvent, and EventsV2IamApiKeyUpdatedEventstripe_access_grant on EventsV2IamStripeAccessGrantApprovedEvent, EventsV2IamStripeAccessGrantCanceledEvent, EventsV2IamStripeAccessGrantDeniedEvent, EventsV2IamStripeAccessGrantRemovedEvent, EventsV2IamStripeAccessGrantRequestedEvent, and EventsV2IamStripeAccessGrantUpdatedEventV2DataReportingQueryRunCreatedEvent, V2DataReportingQueryRunFailedEvent, V2DataReportingQueryRunSucceededEvent, and V2DataReportingQueryRunUpdatedEvent with related object v2.data.reporting.QueryRunV2PaymentsOffSessionPaymentPausedEvent and V2PaymentsOffSessionPaymentResumedEvent with related object v2.payments.OffSessionPaymentThis release changes the pinned API version to 2026-03-25.preview and contains additional breaking changes. See the GA changelog for more information.
RiskSignalsfinancial_account_rewards and nesting_demo on AccountSession.Componentupi_payments on Account.Capability, AccountCreateParamsCapability, and AccountModifyParamsCapabilityrisk_signals on Accountfraud_intent on AccountSignalsrelated_accounts on enum AccountSignals.Delinquency.Indicator.indicatorrisk_reserved on Balancebillable_items on Billing.Alert.SpendThreshold.Filterupi 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.SessionCreateParamsPaymentMethodOptiontempo on enums Charge.PaymentMethodDetail.Crypto.network, PaymentAttemptRecord.PaymentMethodDetail.Crypto.network, and PaymentRecord.PaymentMethodDetail.Crypto.networksource_type on Charge.PaymentMethodDetail.StripeBalance, ConfirmationToken.PaymentMethodPreview.StripeBalance, ConfirmationTokenCreateParamsPaymentMethodDatumStripeBalance, PaymentAttemptRecord.PaymentMethodDetail.StripeBalance, PaymentIntentConfirmParamsPaymentMethodDatumStripeBalance, PaymentIntentCreateParamsPaymentMethodDatumStripeBalance, PaymentIntentModifyParamsPaymentMethodDatumStripeBalance, PaymentMethod.StripeBalance, PaymentMethodCreateParamsStripeBalance, PaymentRecord.PaymentMethodDetail.StripeBalance, SetupIntentConfirmParamsPaymentMethodDatumStripeBalance, SetupIntentCreateParamsPaymentMethodDatumStripeBalance, and SetupIntentModifyParamsPaymentMethodDatumStripeBalanceintegration_identifier on Checkout.Session and checkout.SessionCreateParamsapplication 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.typeupi on enum checkout.SessionCreateParams.excluded_payment_method_typesInvoiceAddLinesParamsLinePriceDatumProductDatumTaxDetail.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)crypto on checkout.SessionCreateParamsPaymentMethodOptionupi on enum checkout.SessionCreateParams.payment_method_typespending_invoice_item_interval on checkout.SessionCreateParamsSubscriptionDatum and checkout.SessionModifyParamsSubscriptionDatumelements, embedded_page, form, and hosted_page on enums Checkout.Session.ui_mode and checkout.SessionCreateParams.ui_modecustom, embedded, and hosted from enums Checkout.Session.ui_mode and checkout.SessionCreateParams.ui_modeInvoiceAddLinesParamsLinePriceDatumProductDatumTaxDetail.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 optionalau_becs_debit, bacs_debit, boleto, link, sepa_debit, and us_bank_account on Checkout.Session.CurrentAttempt.PaymentMethodDetailmarine_carbon_removal on enum Climate.Supplier.removal_pathwayupi on enums ConfirmationTokenCreateParamsPaymentMethodDatum.type, PaymentIntentConfirmParamsPaymentMethodDatum.type, PaymentIntentCreateParamsPaymentMethodDatum.type, PaymentIntentModifyParamsPaymentMethodDatum.type, SetupIntentConfirmParamsPaymentMethodDatum.type, SetupIntentCreateParamsPaymentMethodDatum.type, and SetupIntentModifyParamsPaymentMethodDatum.typeupi on enums ConfirmationToken.PaymentMethodPreview.type and PaymentMethod.typemetadata on CreditNoteCreateParamsLine, CreditNoteLineItem, CreditNotePreviewLinesParamsLine, and CreditNotePreviewParamsLineupi on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typeselected_fulfillment_option_overrides on DelegatedCheckout.RequestedSession.FulfillmentDetailline_item_keys on DelegatedCheckout.RequestedSession.FulfillmentDetail.FulfillmentOption.Digital.DigitalOption and DelegatedCheckout.RequestedSession.FulfillmentDetail.FulfillmentOption.Shipping.ShippingOptionquantity_decimal on InvoiceAddLinesParamsLine, InvoiceCreatePreviewParamsInvoiceItem, InvoiceItemCreateParams, InvoiceItemModifyParams, InvoiceItem, InvoiceLineItemModifyParams, InvoiceLineItem, and InvoiceUpdateLinesParamsLineexpires_after_seconds on Invoice.PaymentSetting.PaymentMethodOption.Pix, InvoiceCreateParamsPaymentSettingPaymentMethodOptionPix, InvoiceModifyParamsPaymentSettingPaymentMethodOptionPix, QuotePreviewInvoice.PaymentSetting.PaymentMethodOption.Pix, Subscription.PaymentSetting.PaymentMethodOption.Pix, SubscriptionCreateParamsPaymentSettingPaymentMethodOptionPix, and SubscriptionModifyParamsPaymentSettingPaymentMethodOptionPixlevel on issuing.AuthorizationCreateParamsRiskAssessmentCardTestingRisk and issuing.AuthorizationCreateParamsRiskAssessmentMerchantDisputeRiskrisk_level on issuing.AuthorizationCreateParamsRiskAssessmentCardTestingRisk and issuing.AuthorizationCreateParamsRiskAssessmentMerchantDisputeRiskda, pl, and sv on enums Issuing.Cardholder.preferred_locales, issuing.CardholderCreateParams.preferred_locales, and issuing.CardholderModifyParams.preferred_localeslifecycle_controls on Issuing.Card and issuing.CardCreateParamsIssuing.Token.NetworkDatum.Visa.card_reference_id from string to nullable(string)PaymentAttemptRecord.PaymentMethodDetail.Card.brand and PaymentRecord.PaymentMethodDetail.Card.brand from enum to nullable(enum)PaymentAttemptRecord.PaymentMethodDetail.Card.exp_month and PaymentRecord.PaymentMethodDetail.Card.exp_month from longInteger to nullable(longInteger)PaymentAttemptRecord.PaymentMethodDetail.Card.exp_year and PaymentRecord.PaymentMethodDetail.Card.exp_year from longInteger to nullable(longInteger)PaymentAttemptRecord.PaymentMethodDetail.Card.funding and PaymentRecord.PaymentMethodDetail.Card.funding from enum('credit'|'debit'|'prepaid'|'unknown') to nullable(enum('credit'|'debit'|'prepaid'|'unknown'))PaymentAttemptRecord.PaymentMethodDetail.Card.last4 and PaymentRecord.PaymentMethodDetail.Card.last4 from string to nullable(string)PaymentAttemptRecord.PaymentMethodDetail.Card.moto and PaymentRecord.PaymentMethodDetail.Card.moto from boolean to nullable(boolean)cryptogram, electronic_commerce_indicator, exemption_indicator_applied, and exemption_indicator on PaymentAttemptRecord.PaymentMethodDetail.Card.ThreeDSecure and PaymentRecord.PaymentMethodDetail.Card.ThreeDSecuresurcharge on PaymentIntent.AmountDetail, PaymentIntentCaptureParamsAmountDetail, PaymentIntentConfirmParamsAmountDetail, PaymentIntentCreateParamsAmountDetail, PaymentIntentIncrementAuthorizationParamsAmountDetail, and PaymentIntentModifyParamsAmountDetailupi 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_typesmandate_options on PaymentIntent.PaymentMethodOption.StripeBalance, PaymentIntentConfirmParamsPaymentMethodOptionStripeBalance, PaymentIntentCreateParamsPaymentMethodOptionStripeBalance, and PaymentIntentModifyParamsPaymentMethodOptionStripeBalanceamount_details and payment_details on PaymentIntentDecrementAuthorizationParamsupi_handle_redirect_or_display_qr_code on PaymentIntent.NextAction and SetupIntent.NextActionmanaged_payments on PaymentLinkCreateParams and PaymentLinkupi on enums PaymentLink.payment_method_types, PaymentLinkCreateParams.payment_method_types, and PaymentLinkModifyParams.payment_method_typesrecommended_action and signals on Radar.PaymentEvaluationinsights on Radar.PaymentEvaluationcrypto_fingerprint on enums Radar.ValueList.item_type and radar.ValueListCreateParams.item_typestripe_balance on SetupIntent.PaymentMethodOption, SetupIntentConfirmParamsPaymentMethodOption, SetupIntentCreateParamsPaymentMethodOption, and SetupIntentModifyParamsPaymentMethodOptionresolved on enum SharedPayment.GrantedToken.deactivated_reasonrecurring_interval on SharedPayment.GrantedToken.UsageLimitSharedPayment.GrantedToken.UsageLimit.expires_at from DateTime to nullable(DateTime)presentment_details on Subscriptioncanceled_by_retention_policy on enum Subscription.CancellationDetail.reason2026-03-25.dahlia on enum WebhookEndpointCreateParams.api_versioninvoice_resources on V2.Billing.Intentamount_due and customer_balance_applied on V2.Billing.Intent.AmountDetailrecurring_credit_grant on V2.Billing.IntentAction.Modify.PricingPlanSubscriptionDetail.Override.PartialPeriodBehavior, V2.Billing.IntentAction.Subscribe.PricingPlanSubscriptionDetail.Override.PartialPeriodBehavior, v2.billing.IntentCreateParamsActionModifyPricingPlanSubscriptionDetailOverridePartialPeriodBehavior, and v2.billing.IntentCreateParamsActionSubscribePricingPlanSubscriptionDetailOverridePartialPeriodBehaviorconsumer_privacy_disclosures and consumer_storer on V2.Core.Account.Identity.Attestation.TermsOfService, v2.core.AccountCreateParamsIdentityAttestationTermsOfService, and v2.core.AccountModifyParamsIdentityAttestationTermsOfServiceinclude on v2.billing.IntentCreateParams and v2.billing.IntentReserveParamsservice_period_coupon_with_metered_tiered_item_unsupported on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, QuotePreviewInvoice.LastFinalizationError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeErrorv2.core.AccountEvaluationv2.billing.LicenseFeeSubscription and v2.billing.PricingPlanSubscriptionComponentscreate method on resource v2.core.AccountEvaluationretrieve method on resources v2.billing.LicenseFeeSubscription and v2.billing.PricingPlanSubscriptionComponentsmodify_rates method on resource v2.billing.RateCardremove_discounts method on resource v2.billing.PricingPlanSubscriptioneg_bank_account on enum V2.Account.Configuration.RecipientDatum.DefaultOutboundDestination.typeinvoice_resources on V2.Billing.Intentamount_due and customer_balance_applied on V2.Billing.Intent.AmountDetailexpires_at on V2.Billing.Intent.StatusTransitiondiscount on V2.Billing.IntentAction.Apply and v2.billing.IntentCreateParamsActionApplytimestamp on V2.Billing.IntentAction.Apply.EffectiveAt and v2.billing.IntentCreateParamsActionApplyEffectiveAtcurrent_billing_period_start and timestamp on enums V2.Billing.IntentAction.Apply.EffectiveAt.type and v2.billing.IntentCreateParamsActionApplyEffectiveAt.typediscount on enums V2.Billing.IntentAction.Apply.type and v2.billing.IntentCreateParamsActionApply.typeV2.Billing.IntentAction.Deactivate.PricingPlanSubscriptionDetail.Override.PartialPeriodBehavior.type, V2.Billing.IntentAction.Modify.PricingPlanSubscriptionDetail.Override.PartialPeriodBehavior.type, V2.Billing.IntentAction.Subscribe.PricingPlanSubscriptionDetail.Override.PartialPeriodBehavior.type, v2.billing.IntentCreateParamsActionDeactivatePricingPlanSubscriptionDetailOverridePartialPeriodBehavior.type, v2.billing.IntentCreateParamsActionModifyPricingPlanSubscriptionDetailOverridePartialPeriodBehavior.type, and v2.billing.IntentCreateParamsActionSubscribePricingPlanSubscriptionDetailOverridePartialPeriodBehavior.type from literal('license_fee') to enum('license_fee'|'recurring_credit_grant')service_cycle on V2.Billing.LicenseFee and V2.Billing.RateCardlatest_version on V2.Billing.LicenseFee, V2.Billing.PricingPlan, and V2.Billing.RateCardservice_interval_count and service_interval on V2.Billing.LicenseFee and V2.Billing.RateCardV2.Billing.LicenseFee.TransformQuantity.divide_by, V2.Billing.LicenseFeeVersion.TransformQuantity.divide_by, V2.Billing.RateCardRate.TransformQuantity.divide_by, v2.billing.LicenseFeeCreateParamsTransformQuantity.divide_by, v2.billing.LicenseFeeModifyParamsTransformQuantity.divide_by, and v2.billing.RateCardRateCreateParamsTransformQuantity.divide_by from longInteger to int64_stringdiscount_details and pricing_plan_component_details on V2.Billing.PricingPlanSubscriptioncrypto_wallets on enums V2.Core.Account.FutureRequirement.Entry.Impact.RestrictsCapability.capability and V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capabilitycrypto from enums V2.Core.Account.FutureRequirement.Entry.Impact.RestrictsCapability.capability and V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capabilitybalance_by_funds_type on V2.MoneyManagement.FinancialAccount.Paymentnext_day_payout_fee on enum V2.MoneyManagement.OutboundPaymentQuote.EstimatedFee.typetreasury_transaction_entry on V2.MoneyManagement.TransactionEntrytreasury_credit_reversal, treasury_debit_reversal, treasury_inbound_transfer, treasury_issuing_authorization, treasury_outbound_payment, treasury_outbound_transfer, treasury_received_credit, and treasury_received_debit on V2.MoneyManagement.Transaction.Flow and V2.MoneyManagement.TransactionEntry.TransactionDetail.Flowtreasury_credit_reversal, treasury_debit_reversal, treasury_inbound_transfer, treasury_issuing_authorization, treasury_other, treasury_outbound_payment, treasury_outbound_transfer, treasury_received_credit, and treasury_received_debit on enums V2.MoneyManagement.Transaction.Flow.type and V2.MoneyManagement.TransactionEntry.TransactionDetail.Flow.typetreasury_transaction on V2.MoneyManagement.Transactionno_valid_payment_method on enum V2.Payments.OffSessionPayment.failure_reasonmetadata on V2.Payments.SettlementAllocationIntentSplitV2.Reporting.ReportRun.Result.File.size from longInteger to int64_stringstatement_descriptor on v2.money_management.OutboundPaymentCreateParams and v2.money_management.OutboundTransferCreateParamsinclude on v2.billing.IntentCreateParams, v2.billing.IntentReserveParams, v2.billing.PricingPlanSubscriptionListParams, v2.billing.PricingPlanSubscriptionRetrieveParams, v2.money_management.FinancialAccountListParams, and v2.money_management.FinancialAccountRetrieveParamsV1AccountSignalsIncludingDelinquencyCreatedEvent, V2CoreAccountSignalsFraudulentWebsiteReadyEvent, and V2SignalsAccountSignalFraudulentMerchantReadyEventThis 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.
product_catalog.TrialOffer, tax.Location, and v2.core.BatchJobcreate method on resource product_catalog.TrialOffercreate, list, and retrieve methods on resource tax.Locationcancel, create, and retrieve methods on resource v2.core.BatchJobperformance_location on Tax.CalculationLineItem and tax.CalculationCreateParamsLineItemperformance on enums Tax.Calculation.ShippingCost.TaxBreakdown.sourcing, Tax.CalculationLineItem.TaxBreakdown.sourcing, and Tax.Transaction.ShippingCost.TaxBreakdown.sourcingadmissions_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_typetrial_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 SubscriptionScheduleModifyParamsPhaseItemrisk_reserved on Balancesource_type on Charge.PaymentMethodDetail.StripeBalance, ConfirmationToken.PaymentMethodPreview.StripeBalance, ConfirmationTokenCreateParamsPaymentMethodDatumStripeBalance, PaymentAttemptRecord.PaymentMethodDetail.StripeBalance, PaymentIntentConfirmParamsPaymentMethodDatumStripeBalance, PaymentIntentCreateParamsPaymentMethodDatumStripeBalance, PaymentIntentModifyParamsPaymentMethodDatumStripeBalance, PaymentMethod.StripeBalance, PaymentMethodCreateParamsStripeBalance, PaymentRecord.PaymentMethodDetail.StripeBalance, SetupIntentConfirmParamsPaymentMethodDatumStripeBalance, SetupIntentCreateParamsPaymentMethodDatumStripeBalance, and SetupIntentModifyParamsPaymentMethodDatumStripeBalancetax_details on InvoiceAddLinesParamsLinePriceDatumProductDatum, InvoiceLineItemModifyParamsPriceDatumProductDatum, InvoiceUpdateLinesParamsLinePriceDatumProductDatum, PaymentLinkCreateParamsLineItemPriceDatumProductDatum, PlanCreateParamsProduct, PriceCreateParamsProductDatum, ProductCreateParams, ProductModifyParams, checkout.SessionCreateParamsLineItemPriceDatumProductDatum, and checkout.SessionModifyParamsLineItemPriceDatumProductDatumpending_invoice_item_interval on checkout.SessionModifyParamsSubscriptionDatumhosted and ui_mode on FinancialConnections.Session and financial_connections.SessionCreateParamsurl on FinancialConnections.Sessionexpires_after_seconds on Invoice.PaymentSetting.PaymentMethodOption.Pix, InvoiceCreateParamsPaymentSettingPaymentMethodOptionPix, InvoiceModifyParamsPaymentSettingPaymentMethodOptionPix, QuotePreviewInvoice.PaymentSetting.PaymentMethodOption.Pix, Subscription.PaymentSetting.PaymentMethodOption.Pix, SubscriptionCreateParamsPaymentSettingPaymentMethodOptionPix, and SubscriptionModifyParamsPaymentSettingPaymentMethodOptionPixcurrent_trial on InvoiceCreatePreviewParamsSubscriptionDetailItem, SubscriptionCreateParamsItem, SubscriptionItemCreateParams, SubscriptionItemModifyParams, SubscriptionItem, and SubscriptionModifyParamsItemsurcharge on PaymentIntent.AmountDetail, PaymentIntentCaptureParamsAmountDetail, PaymentIntentConfirmParamsAmountDetail, PaymentIntentCreateParamsAmountDetail, PaymentIntentIncrementAuthorizationParamsAmountDetail, and PaymentIntentModifyParamsAmountDetailamount_details and payment_details on PaymentIntentDecrementAuthorizationParamsmandate_options on PaymentIntent.PaymentMethodOption.StripeBalancemanaged_payments on PaymentLinkCreateParams and PaymentLinkstripe_balance on SetupIntent.PaymentMethodOption, SetupIntentConfirmParamsPaymentMethodOption, SetupIntentCreateParamsPaymentMethodOption, and SetupIntentModifyParamsPaymentMethodOptionbilling_cycle_anchor on Subscription.TrialSetting.EndBehavior, SubscriptionCreateParamsTrialSettingEndBehavior, and SubscriptionModifyParamsTrialSettingEndBehavioradmissions_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.typeadmissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on Tax.Registration.CountryOption.Merequirements on TaxCodeV2.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_stringar_bank_account, co_bank_account, and eg_bank_account on enum V2.Core.Account.Configuration.Recipient.DefaultOutboundDestination.typetimezone on V2.Core.Account.Default, v2.core.AccountCreateParamsDefault, and v2.core.AccountModifyParamsDefaultazure_event_grid on V2.Core.EventDestination and v2.core.EventDestinationCreateParamsno_azure_partner_topic_exists on enum V2.Core.EventDestination.StatusDetail.Disabled.reasonazure_event_grid on enums V2.Core.EventDestination.type and v2.core.EventDestinationCreateParams.typesupported_currencies on V2.Core.Vault.GbBankAccount, V2.Core.Vault.UsBankAccount, and V2.MoneyManagement.PayoutMethod.CardV2.Core.Vault.GbBankAccount.sort_code and v2.core.vault.GbBankAccountCreateParams.sort_code to be optionalrestricted on V2.MoneyManagement.PayoutMethodcurrencies on V2.MoneyManagement.PayoutMethodsBankAccountSpec.Country.Fieldcounterparty and description on V2.MoneyManagement.Transactioncurrency 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.OutboundSetupIntentModifyParamsPayoutMethodDatumCardiban on v2.core.vault.GbBankAccountCreateParamsv2.core.vault.GbBankAccountCreateParams.account_number to be optionalcurrency on enum InvalidPaymentMethodError.invalid_paramV2CoreBatchJobBatchFailedEvent, V2CoreBatchJobCanceledEvent, V2CoreBatchJobCompletedEvent, V2CoreBatchJobCreatedEvent, V2CoreBatchJobReadyForUploadEvent, V2CoreBatchJobTimeoutEvent, V2CoreBatchJobUpdatedEvent, V2CoreBatchJobUploadTimeoutEvent, V2CoreBatchJobValidatingEvent, and V2CoreBatchJobValidationFailedEvent with related object v2.core.BatchJobservice_period_coupon_with_metered_tiered_item_unsupported on QuotePreviewInvoice.LastFinalizationErrorThis 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
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:
fx_ratemetric_tons; climate.Product: metric_tons_availableunit_amount_decimalquantity_decimal, unit_amount_decimalquantity_decimal, unit_amount_decimalquantity_decimal, unit_cost_decimal, gross_amount_decimal, local_amount_decimal, national_amount_decimalamount_decimal, flat_amount_decimal, unit_amount_decimalunit_amount_decimal, flat_amount_decimal (including currency_options and tiers)percent_ownershipunit_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().'some_key' in some_obj and check for equality between stripe objects. But most key/value iteration needs an extra stepdict, 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.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.simulate_crypto_deposit test helper method on resource PaymentIntentdeposit_options and mode on PaymentIntent.PaymentMethodOption.Crypto, PaymentIntentConfirmParamsPaymentMethodOptionCrypto, PaymentIntentCreateParamsPaymentMethodOptionCrypto, and PaymentIntentModifyParamsPaymentMethodOptionCryptocrypto_display_details on PaymentIntent.NextActionorchestration.PaymentAttempt and radar.CustomerEvaluationretrieve method on resource orchestration.PaymentAttemptcreate and modify methods on resource radar.CustomerEvaluationapprove method on resource checkout.Sessionreport_authenticated, report_canceled, report_failed, report_guaranteed, report_informational, and report_refund methods on resource PaymentAttemptRecordcreate_us_paper_check_on_application on AccountSessionCreateParamsComponentCheckScanningFeatureAccountSignals.delinquency to be optionalapproval_method on Checkout.Session and checkout.SessionCreateParamscurrent_attempt on Checkout.Sessionselected_fulfillment_option_overrides on delegated_checkout.RequestedSessionModifyParamsFulfillmentDetailpricing_plan_subscription_details on InvoiceItem.Parent and InvoiceLineItem.Parentlicense_fee_subscription_details on InvoiceItem.Parent and InvoiceLineItem.Parentpricing_plan_subscription and pricing_plan_version on InvoiceItem.Parent.RateCardSubscriptionDetail and InvoiceLineItem.Parent.RateCardSubscriptionDetailpricing_plan_subscription_details on enum InvoiceItem.Parent.typelicense_fee_subscription_details from enum InvoiceItem.Parent.typediscounts on enum InvoiceItem.frozen_fieldspricing_plan_subscription_details on enum InvoiceLineItem.Parent.typelicense_fee_subscription_details from enum InvoiceLineItem.Parent.typetoken_details on Issuing.Authorizationfailure_code on PaymentRecordReportPaymentAttemptFailedParams, PaymentRecordReportPaymentAttemptParamsFailed, and PaymentRecordReportPaymentParamsFailedPaymentRecordReportPaymentAttemptCanceledParams.canceled_at to be optionalPaymentRecordReportPaymentAttemptFailedParams.failed_at to be optionalPaymentRecordReportPaymentAttemptGuaranteedParams.guaranteed_at to be optionalPaymentRecordReportRefundParams.refunded to be optionalnow from enums QuoteCreateParamsSubscriptionDataOverrideBillingScheduleBillFrom.type, QuoteCreateParamsSubscriptionDatumBillingScheduleBillFrom.type, QuoteModifyParamsSubscriptionDataOverrideBillingScheduleBillFrom.type, and QuoteModifyParamsSubscriptionDatumBillingScheduleBillFrom.typeradar.IssuingAuthorizationEvaluationCreateParamsCardDetail.bin_country to be requiredrecurring_interval on shared_payment.GrantedTokenCreateParamsUsageLimitshared_payment.GrantedTokenCreateParamsUsageLimit.expires_at to be optionalhome_rule_tax on Tax.Registration.CountryOption.Me and tax.RegistrationCreateParamsCountryOptionMehome_rule_tax on enums Tax.Registration.CountryOption.Me.type and tax.RegistrationCreateParamsCountryOptionMe.typeradar.IssuingAuthorizationEvaluationcreate method on resource radar.IssuingAuthorizationEvaluationfee_credits on enum BalanceTransaction.balance_typeaffiliate_attributions to affiliate_attribution on delegated_checkout.RequestedSessionConfirmParams and delegated_checkout.RequestedSessionCreateParamsamount_to_counter on Disputefrozen_fields on InvoiceItemnext_billing_period_start on enums V2.Billing.IntentAction.Apply.EffectiveAt.type and v2.billing.IntentCreateParamsActionApplyEffectiveAt.typeconsumer 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.AccountModifyParamsIdentityAttestationTermsOfServiceCardCreatorfifth_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.AccountModifyParamsIdentityAttestationTermsOfServiceCardCreatorCommercialprepaid_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.AccountModifyParamsIdentityAttestationTermsOfServiceCardCreatorCommercialCrossRiverBankcommercial.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.capabilitypayment_method_data on v2.payments.OffSessionPaymentCreateParamsv2.payments.OffSessionPaymentCreateParams.payment_method to be optionalcommercial.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_capabilityThis release changes the pinned API version to 2026-03-04.preview.
Profile and billing.AlertRecoveredreauthorize method on resource PaymentIntentsettings on QuoteLine.Action.AddDiscount, QuoteLine.Action.AddItem.Discount, QuoteLine.Action.SetDiscount, QuoteLine.Action.SetItem.Discount, QuotePreviewSubscriptionSchedule.Phase.Discount, QuotePreviewSubscriptionSchedule.Phase.Item.Discount, SubscriptionSchedule.Phase.Discount, and SubscriptionSchedule.Phase.Item.Discountsmart_disputes on Account.Setting, AccountCreateParamsSetting, AccountModifyParamsSetting, V2.Core.Account.Configuration.Merchant, v2.core.AccountCreateParamsConfigurationMerchant, and v2.core.AccountModifyParamsConfigurationMerchantemail_customers_on_successful_payment on Account.Setting.Payment, AccountCreateParamsSettingPayment, and AccountModifyParamsSettingPaymentbalance_update_details on Billing.CreditBalanceSummary.Balancereauthorization and reauthorize_before on Charge.PaymentMethodDetail.CardPresent, Charge.PaymentMethodDetail.Card, ConfirmationToken.PaymentMethodPreview.Card.GeneratedFrom.PaymentMethodDetail.CardPresent, PaymentAttemptRecord.PaymentMethodDetail.CardPresent, PaymentMethod.Card.GeneratedFrom.PaymentMethodDetail.CardPresent, and PaymentRecord.PaymentMethodDetail.CardPresentlocation and reader on Charge.PaymentMethodDetail.CardPresent, Charge.PaymentMethodDetail.InteracPresent, ConfirmationToken.PaymentMethodPreview.Card.GeneratedFrom.PaymentMethodDetail.CardPresent, PaymentAttemptRecord.PaymentMethodDetail.CardPresent, PaymentAttemptRecord.PaymentMethodDetail.InteracPresent, PaymentMethod.Card.GeneratedFrom.PaymentMethodDetail.CardPresent, PaymentRecord.PaymentMethodDetail.CardPresent, and PaymentRecord.PaymentMethodDetail.InteracPresentmanaged_payments on Checkout.Session, PaymentIntent, SetupIntent, Subscription, and checkout.SessionCreateParamslk_vat on enums Checkout.Session.CollectedInformation.TaxId.type, Checkout.Session.CustomerDetail.TaxId.type, Invoice.CustomerTaxId.type, Order.TaxDetail.TaxId.type, QuotePreviewInvoice.CustomerTaxId.type, Tax.Calculation.CustomerDetail.TaxId.type, Tax.Transaction.CustomerDetail.TaxId.type, and TaxId.typelk_vat on enums CustomerCreateParamsTaxIdDatum.type, CustomerCreateTaxIdParams.type, InvoiceCreatePreviewParamsCustomerDetailTaxId.type, OrderCreateParamsTaxDetailTaxId.type, OrderModifyParamsTaxDetailTaxId.type, TaxIdCreateParams.type, and tax.CalculationCreateParamsCustomerDetailTaxId.typedigital on DelegatedCheckout.RequestedSession.FulfillmentDetail.FulfillmentOption, DelegatedCheckout.RequestedSession.FulfillmentDetail.SelectedFulfillmentOption, and delegated_checkout.RequestedSessionModifyParamsFulfillmentDetailSelectedFulfillmentOptiondelegated_checkout.RequestedSessionModifyParamsFulfillmentDetailSelectedFulfillmentOption.shipping to be optionalaffiliate_attributions on DelegatedCheckout.RequestedSession, delegated_checkout.RequestedSessionConfirmParams, and delegated_checkout.RequestedSessionCreateParamsfulfillment_type on DelegatedCheckout.RequestedSession.LineItemDetailmarketplace_seller_details, network_profile, privacy_notice_url, return_policy_url, store_policy_url, and terms_of_service_url on DelegatedCheckout.RequestedSession.SellerDetailamount_to_counter on DisputeModifyParamsreserve.hold.created, reserve.hold.updated, reserve.plan.created, reserve.plan.disabled, reserve.plan.expired, reserve.plan.updated, and reserve.release.created on enum Event.typeterminal_wifi_certificate and terminal_wifi_private_key on enums File.purpose and FileListParams.purposeterminal_wifi_certificate and terminal_wifi_private_key on enum FileCreateParams.purposepay_by_bank 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_typesdisplay_name and service_user_number on Mandate.PaymentMethodDetail.BacsDebitPaymentAttemptRecord.PaymentMethodDetail.Boleto.tax_id and PaymentRecord.PaymentMethodDetail.Boleto.tax_id from string to nullable(string)PaymentAttemptRecord.PaymentMethodDetail.UsBankAccount.expected_debit_date and PaymentRecord.PaymentMethodDetail.UsBankAccount.expected_debit_date from nullable(string) to stringrequest_reauthorization on PaymentIntent.PaymentMethodOption.CardPresent, PaymentIntent.PaymentMethodOption.Card, PaymentIntentConfirmParamsPaymentMethodOptionCardPresent, PaymentIntentConfirmParamsPaymentMethodOptionCard, PaymentIntentCreateParamsPaymentMethodOptionCardPresent, PaymentIntentCreateParamsPaymentMethodOptionCard, PaymentIntentModifyParamsPaymentMethodOptionCardPresent, and PaymentIntentModifyParamsPaymentMethodOptionCardtransaction_purpose on PaymentIntent.PaymentMethodOption.UsBankAccount, PaymentIntentConfirmParamsPaymentMethodOptionUsBankAccount, PaymentIntentCreateParamsPaymentMethodOptionUsBankAccount, and PaymentIntentModifyParamsPaymentMethodOptionUsBankAccountrequires_reauthorization on enum PaymentIntent.statusoptional_items on PaymentLinkModifyParamsbilling_schedules_invalid on enum Quote.StatusDetail.Stale.LastReason.typecard_issuer_decline on Radar.PaymentEvaluation.Insightpayment_behavior on SubscriptionItemDeleteParamsbilling_cycle_anchor on Subscription.TrialSetting.EndBehaviorlk on Tax.Registration.CountryOption and tax.RegistrationCreateParamsCountryOptioncellular and stripe_s710 on Terminal.Configuration, terminal.ConfigurationCreateParams, and terminal.ConfigurationModifyParamssimulated_stripe_s710 and stripe_s710 on enums Terminal.Reader.device_type and terminal.ReaderListParams.device_typereserve.hold.created, reserve.hold.updated, reserve.plan.created, reserve.plan.disabled, reserve.plan.expired, reserve.plan.updated, and reserve.release.created on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointModifyParams.enabled_events2026-02-25.clover on enum WebhookEndpointCreateParams.api_versionar_bank_account, bt_bank_account, co_bank_account, cr_bank_account, do_bank_account, gt_bank_account, md_bank_account, mk_bank_account, mo_bank_account, mz_bank_account, pe_bank_account, pk_bank_account, tw_bank_account, and uz_bank_account on enums V2.Account.Configuration.RecipientDatum.DefaultOutboundDestination.type and V2.Core.Account.Configuration.Recipient.DefaultOutboundDestination.typerecipient_onboarding and recipient_update on V2.Core.AccountLink.UseCase and v2.core.AccountLinkCreateParamsUseCaserecipient_onboarding and recipient_update on enums V2.Core.AccountLink.UseCase.type and v2.core.AccountLinkCreateParamsUseCase.typeconsumer on V2.Core.Account.Configuration.Storer.Capability, v2.core.AccountCreateParamsConfigurationStorerCapability, and v2.core.AccountModifyParamsConfigurationStorerCapabilityconsumer.holds_currencies.usd on enums V2.Core.Account.FutureRequirement.Entry.Impact.RestrictsCapability.capability and V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capabilityfunds_usage_type on V2.MoneyManagement.FinancialAccount.Storage and v2.money_management.FinancialAccountCreateParamsStoragepurpose on V2.MoneyManagement.OutboundPayment and v2.money_management.OutboundPaymentCreateParamsbranch_number and swift_code on V2.MoneyManagement.PayoutMethod.BankAccountdispute, inbound_payment_failure, inbound_payment, india_mdr_processing_fee, payment_method_passthrough_fee, refund, and tax_withholding on enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.TransactionDetail.categorycharge_failure and charge from enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.TransactionDetail.categoryV2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.TransactionDetail.flow to be optionalconsumer.holds_currencies.usd on enum EventsV2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent.updated_capabilitybilling.alert.recovered with resource billing.AlertRecoveredreserve.hold.created and reserve.hold.updated with resource reserve.Holdreserve.plan.created, reserve.plan.disabled, reserve.plan.expired, and reserve.plan.updated with resource reserve.Planreserve.release.created with resource reserve.ReleaseV2BillingRateCardCustomPricingUnitOverageRateCreatedEvent with related object v2.billing.RateCardCustomPricingUnitOverageRateV2IamStripeAccessGrantApprovedEvent, V2IamStripeAccessGrantCanceledEvent, V2IamStripeAccessGrantDeniedEvent, V2IamStripeAccessGrantRemovedEvent, V2IamStripeAccessGrantRequestedEvent, and V2IamStripeAccessGrantUpdatedEventstorer_capability_missing and storer_capability_not_active on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, QuotePreviewInvoice.LastFinalizationError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeErrorThis release changes the pinned API version to 2026-02-25.preview.
AccountSignalsretrieve method on resource AccountSignalsaggregation_period, group_by, and triggered_at on Billing.AlertTriggeredexternal_account_collection on AccountLinkCreateParamsCollectionOptionfunding_source on ApplicationFeedelegated_checkout.RequestedSessionConfirmParamsPaymentMethodDatumBillingDetailAddress.line1, delegated_checkout.RequestedSessionCreateParamsFulfillmentDetailAddress.line1, delegated_checkout.RequestedSessionCreateParamsPaymentMethodDatumBillingDetailAddress.line1, delegated_checkout.RequestedSessionModifyParamsFulfillmentDetailAddress.line1, and delegated_checkout.RequestedSessionModifyParamsPaymentMethodDatumBillingDetailAddress.line1 to be optionalhosted and ui_mode on FinancialConnections.Session and financial_connections.SessionCreateParamsurl on FinancialConnections.Sessionbilling_cycle_anchor on SubscriptionCreateParamsTrialSettingEndBehavior and SubscriptionModifyParamsTrialSettingEndBehaviorThis release changes the pinned API version to 2026-02-25.preview.
smart_disputes on Account.Setting, AccountCreateParamsSetting, AccountModifyParamsSetting, V2.Core.Account.Configuration.Merchant, v2.core.AccountCreateParamsConfigurationMerchant, and v2.core.AccountModifyParamsConfigurationMerchantemail_customers_on_successful_payment on Account.Setting.Payment, AccountCreateParamsSettingPayment, and AccountModifyParamsSettingPaymentmanaged_payments on Checkout.Session, PaymentIntent, SetupIntent, Subscription, and checkout.SessionCreateParamslk_vat on enums Checkout.Session.CollectedInformation.TaxId.type, Order.TaxDetail.TaxId.type, and QuotePreviewInvoice.CustomerTaxId.typelk_vat on enums OrderCreateParamsTaxDetailTaxId.type and OrderModifyParamsTaxDetailTaxId.typepay_by_bank on enum QuotePreviewInvoice.PaymentSetting.payment_method_typesbt_bank_account, cr_bank_account, do_bank_account, gt_bank_account, md_bank_account, mk_bank_account, mo_bank_account, mz_bank_account, pe_bank_account, pk_bank_account, tw_bank_account, and uz_bank_account on enum V2.Core.Account.Configuration.Recipient.DefaultOutboundDestination.typepurpose on V2.MoneyManagement.OutboundPayment and v2.money_management.OutboundPaymentCreateParamsbranch_number and swift_code on V2.MoneyManagement.PayoutMethod.BankAccountV2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.TransactionDetail.flow to be optionalstorer_capability_missing and storer_capability_not_active on QuotePreviewInvoice.LastFinalizationErrorThis release changes the pinned API version to 2026-02-25.clover.
reserve.Hold, reserve.Plan, and reserve.Releaselocation and reader on Charge.PaymentMethodDetail.CardPresent, Charge.PaymentMethodDetail.InteracPresent, ConfirmationToken.PaymentMethodPreview.Card.GeneratedFrom.PaymentMethodDetail.CardPresent, PaymentAttemptRecord.PaymentMethodDetail.CardPresent, PaymentAttemptRecord.PaymentMethodDetail.InteracPresent, PaymentMethod.Card.GeneratedFrom.PaymentMethodDetail.CardPresent, PaymentRecord.PaymentMethodDetail.CardPresent, and PaymentRecord.PaymentMethodDetail.InteracPresentlk_vat on enums Checkout.Session.CustomerDetail.TaxId.type, Invoice.CustomerTaxId.type, Tax.Calculation.CustomerDetail.TaxId.type, Tax.Transaction.CustomerDetail.TaxId.type, and TaxId.typelk_vat on enums CustomerCreateParamsTaxIdDatum.type, CustomerCreateTaxIdParams.type, InvoiceCreatePreviewParamsCustomerDetailTaxId.type, TaxIdCreateParams.type, and tax.CalculationCreateParamsCustomerDetailTaxId.typereserve.hold.created, reserve.hold.updated, reserve.plan.created, reserve.plan.disabled, reserve.plan.expired, reserve.plan.updated, and reserve.release.created on enum Event.typeterminal_wifi_certificate and terminal_wifi_private_key on enums File.purpose and FileListParams.purposeterminal_wifi_certificate and terminal_wifi_private_key on enum FileCreateParams.purposepay_by_bank 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_typesdisplay_name and service_user_number on Mandate.PaymentMethodDetail.BacsDebitPaymentAttemptRecord.PaymentMethodDetail.Boleto.tax_id and PaymentRecord.PaymentMethodDetail.Boleto.tax_id from string to nullable(string)PaymentAttemptRecord.PaymentMethodDetail.UsBankAccount.expected_debit_date and PaymentRecord.PaymentMethodDetail.UsBankAccount.expected_debit_date from nullable(string) to stringtransaction_purpose on PaymentIntent.PaymentMethodOption.UsBankAccount, PaymentIntentConfirmParamsPaymentMethodOptionUsBankAccount, PaymentIntentCreateParamsPaymentMethodOptionUsBankAccount, and PaymentIntentModifyParamsPaymentMethodOptionUsBankAccountoptional_items on PaymentLinkModifyParamscard_issuer_decline on Radar.PaymentEvaluation.Insightpayment_behavior on SubscriptionItemDeleteParamslk on Tax.Registration.CountryOption and tax.RegistrationCreateParamsCountryOptioncellular and stripe_s710 on Terminal.Configuration, terminal.ConfigurationCreateParams, and terminal.ConfigurationModifyParamssimulated_stripe_s710 and stripe_s710 on enums Terminal.Reader.device_type and terminal.ReaderListParams.device_typereserve.hold.created, reserve.hold.updated, reserve.plan.created, reserve.plan.disabled, reserve.plan.expired, reserve.plan.updated, and reserve.release.created on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointModifyParams.enabled_events2026-02-25.clover on enum WebhookEndpointCreateParams.api_versionreserve.hold.created and reserve.hold.updated with resource reserve.Holdreserve.plan.created, reserve.plan.disabled, reserve.plan.expired, and reserve.plan.updated with resource reserve.Planreserve.release.created with resource reserve.Releasestorer_capability_missing and storer_capability_not_active on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeErrorspend_threshold on enums Billing.Alert.alert_type, billing.AlertCreateParams.alert_type, and billing.AlertListParams.alert_typespend_threshold on Billing.Alert and billing.AlertCreateParamsinvoice_item, proration_details, proration, and subscription on InvoiceLineItem.Parent.ScheduleDetailcustom on PaymentMethodModifyParamspayment_method_reference and usage on PaymentMethod.Customoutstanding_usage_through and unused_time_from on SubscriptionPauseParamsBillForoutstanding_usage and unused_time on SubscriptionPauseParamsBillForpayment_behavior on SubscriptionResumeParamsv2.billing.CadenceSpendModifier, v2.billing.OneTimeItem, and v2.billing.RateCardCustomPricingUnitOverageRatecreate, delete, list, and retrieve methods on resource v2.billing.RateCardCustomPricingUnitOverageRatecreate, list, modify, and retrieve methods on resource v2.billing.OneTimeItemretrieve method on resource v2.billing.CadenceSpendModifierEventsV2CoreHealthFraudRateIncreasedEvent.Impact.RealizedFraudAmount.value, EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent.Impact.ApprovedAmount.value, EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent.Impact.DeclinedAmount.value, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent.Impact.ApprovedAmount.value, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent.Impact.DeclinedAmount.value, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent.Impact.ApprovedAmount.value, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent.Impact.DeclinedAmount.value, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent.Impact.ApprovedAmount.value, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent.Impact.DeclinedAmount.value, V2.Billing.ServiceAction.CreditGrant.Amount.Monetary.value, V2.Billing.ServiceAction.CreditGrantPerTenant.Amount.Monetary.value, V2.Core.Account.Identity.BusinessDetail.AnnualRevenue.Amount.value, V2.Core.Account.Identity.BusinessDetail.MonthlyEstimatedRevenue.Amount.value, V2.FinancialAddressGeneratedMicrodeposits.Amount.value, V2.MoneyManagement.Adjustment.Amount.value, V2.MoneyManagement.CurrencyConversion.From.Amount.value, V2.MoneyManagement.CurrencyConversion.To.Amount.value, V2.MoneyManagement.FinancialAccount.Balance.Available.value, V2.MoneyManagement.FinancialAccount.Balance.InboundPending.value, V2.MoneyManagement.FinancialAccount.Balance.OutboundPending.value, V2.MoneyManagement.FinancialAccount.Payment.StartingBalance.Available.value, V2.MoneyManagement.InboundTransfer.Amount.value, V2.MoneyManagement.InboundTransfer.From.Debited.value, V2.MoneyManagement.InboundTransfer.To.Credited.value, V2.MoneyManagement.OutboundPayment.Amount.value, V2.MoneyManagement.OutboundPayment.From.Debited.value, V2.MoneyManagement.OutboundPayment.To.Credited.value, V2.MoneyManagement.OutboundPaymentQuote.Amount.value, V2.MoneyManagement.OutboundPaymentQuote.EstimatedFee.Amount.value, V2.MoneyManagement.OutboundPaymentQuote.From.Debited.value, V2.MoneyManagement.OutboundPaymentQuote.To.Credited.value, V2.MoneyManagement.OutboundTransfer.Amount.value, V2.MoneyManagement.OutboundTransfer.From.Debited.value, V2.MoneyManagement.OutboundTransfer.To.Credited.value, V2.MoneyManagement.ReceivedCredit.Amount.value, V2.MoneyManagement.ReceivedCredit.ExternalAmount.value, V2.MoneyManagement.ReceivedDebit.Amount.value, V2.MoneyManagement.ReceivedDebit.CardSpend.Authorization.Amount.value, V2.MoneyManagement.ReceivedDebit.CardSpend.CardTransaction.Amount.value, V2.MoneyManagement.ReceivedDebit.ExternalAmount.value, V2.MoneyManagement.Transaction.Amount.value, V2.MoneyManagement.Transaction.BalanceImpact.Available.value, V2.MoneyManagement.Transaction.BalanceImpact.InboundPending.value, V2.MoneyManagement.Transaction.BalanceImpact.OutboundPending.value, V2.MoneyManagement.TransactionEntry.BalanceImpact.Available.value, V2.MoneyManagement.TransactionEntry.BalanceImpact.InboundPending.value, V2.MoneyManagement.TransactionEntry.BalanceImpact.OutboundPending.value, V2.Payments.OffSessionPayment.AmountCapturable.value, V2.Payments.OffSessionPayment.AmountRequested.value, V2.Payments.SettlementAllocationIntent.Amount.value, V2.Payments.SettlementAllocationIntentSplit.Amount.value, v2.FinancialAddressCreditSimulationCreditParamsAmount.value, v2.billing.ServiceActionCreateParamsCreditGrantAmountMonetary.value, v2.billing.ServiceActionCreateParamsCreditGrantPerTenantAmountMonetary.value, v2.core.AccountCreateParamsIdentityBusinessDetailAnnualRevenueAmount.value, v2.core.AccountCreateParamsIdentityBusinessDetailMonthlyEstimatedRevenueAmount.value, v2.core.AccountModifyParamsIdentityBusinessDetailAnnualRevenueAmount.value, v2.core.AccountModifyParamsIdentityBusinessDetailMonthlyEstimatedRevenueAmount.value, v2.core.AccountTokenCreateParamsIdentityBusinessDetailAnnualRevenueAmount.value, v2.core.AccountTokenCreateParamsIdentityBusinessDetailMonthlyEstimatedRevenueAmount.value, v2.money_management.CurrencyConversionCreateParamsFromAmount.value, v2.money_management.CurrencyConversionCreateParamsToAmount.value, v2.money_management.InboundTransferCreateParamsAmount.value, v2.money_management.OutboundPaymentCreateParamsAmount.value, v2.money_management.OutboundPaymentQuoteCreateParamsAmount.value, v2.money_management.OutboundTransferCreateParamsAmount.value, v2.payments.OffSessionPaymentCreateParamsAmount.value, v2.payments.SettlementAllocationIntentCreateParamsAmount.value, v2.payments.SettlementAllocationIntentModifyParamsAmount.value, and v2.payments.SettlementAllocationIntentSplitCreateParamsAmount.value to be requiredEventsV2CoreHealthFraudRateIncreasedEvent.Impact.RealizedFraudAmount.currency, EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent.Impact.ApprovedAmount.currency, EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent.Impact.DeclinedAmount.currency, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent.Impact.ApprovedAmount.currency, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent.Impact.DeclinedAmount.currency, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent.Impact.ApprovedAmount.currency, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent.Impact.DeclinedAmount.currency, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent.Impact.ApprovedAmount.currency, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent.Impact.DeclinedAmount.currency, V2.Billing.ServiceAction.CreditGrant.Amount.Monetary.currency, V2.Billing.ServiceAction.CreditGrantPerTenant.Amount.Monetary.currency, V2.Core.Account.Identity.BusinessDetail.AnnualRevenue.Amount.currency, V2.Core.Account.Identity.BusinessDetail.MonthlyEstimatedRevenue.Amount.currency, V2.FinancialAddressGeneratedMicrodeposits.Amount.currency, V2.MoneyManagement.Adjustment.Amount.currency, V2.MoneyManagement.CurrencyConversion.From.Amount.currency, V2.MoneyManagement.CurrencyConversion.To.Amount.currency, V2.MoneyManagement.FinancialAccount.Balance.Available.currency, V2.MoneyManagement.FinancialAccount.Balance.InboundPending.currency, V2.MoneyManagement.FinancialAccount.Balance.OutboundPending.currency, V2.MoneyManagement.FinancialAccount.Payment.StartingBalance.Available.currency, V2.MoneyManagement.InboundTransfer.Amount.currency, V2.MoneyManagement.InboundTransfer.From.Debited.currency, V2.MoneyManagement.InboundTransfer.To.Credited.currency, V2.MoneyManagement.OutboundPayment.Amount.currency, V2.MoneyManagement.OutboundPayment.From.Debited.currency, V2.MoneyManagement.OutboundPayment.To.Credited.currency, V2.MoneyManagement.OutboundPaymentQuote.Amount.currency, V2.MoneyManagement.OutboundPaymentQuote.EstimatedFee.Amount.currency, V2.MoneyManagement.OutboundPaymentQuote.From.Debited.currency, V2.MoneyManagement.OutboundPaymentQuote.To.Credited.currency, V2.MoneyManagement.OutboundTransfer.Amount.currency, V2.MoneyManagement.OutboundTransfer.From.Debited.currency, V2.MoneyManagement.OutboundTransfer.To.Credited.currency, V2.MoneyManagement.ReceivedCredit.Amount.currency, V2.MoneyManagement.ReceivedCredit.ExternalAmount.currency, V2.MoneyManagement.ReceivedDebit.Amount.currency, V2.MoneyManagement.ReceivedDebit.CardSpend.Authorization.Amount.currency, V2.MoneyManagement.ReceivedDebit.CardSpend.CardTransaction.Amount.currency, V2.MoneyManagement.ReceivedDebit.ExternalAmount.currency, V2.MoneyManagement.Transaction.Amount.currency, V2.MoneyManagement.Transaction.BalanceImpact.Available.currency, V2.MoneyManagement.Transaction.BalanceImpact.InboundPending.currency, V2.MoneyManagement.Transaction.BalanceImpact.OutboundPending.currency, V2.MoneyManagement.TransactionEntry.BalanceImpact.Available.currency, V2.MoneyManagement.TransactionEntry.BalanceImpact.InboundPending.currency, V2.MoneyManagement.TransactionEntry.BalanceImpact.OutboundPending.currency, V2.Payments.OffSessionPayment.AmountCapturable.currency, V2.Payments.OffSessionPayment.AmountRequested.currency, V2.Payments.SettlementAllocationIntent.Amount.currency, V2.Payments.SettlementAllocationIntentSplit.Amount.currency, v2.FinancialAddressCreditSimulationCreditParamsAmount.currency, v2.billing.ServiceActionCreateParamsCreditGrantAmountMonetary.currency, v2.billing.ServiceActionCreateParamsCreditGrantPerTenantAmountMonetary.currency, v2.core.AccountCreateParamsIdentityBusinessDetailAnnualRevenueAmount.currency, v2.core.AccountCreateParamsIdentityBusinessDetailMonthlyEstimatedRevenueAmount.currency, v2.core.AccountModifyParamsIdentityBusinessDetailAnnualRevenueAmount.currency, v2.core.AccountModifyParamsIdentityBusinessDetailMonthlyEstimatedRevenueAmount.currency, v2.core.AccountTokenCreateParamsIdentityBusinessDetailAnnualRevenueAmount.currency, v2.core.AccountTokenCreateParamsIdentityBusinessDetailMonthlyEstimatedRevenueAmount.currency, v2.money_management.CurrencyConversionCreateParamsFromAmount.currency, v2.money_management.CurrencyConversionCreateParamsToAmount.currency, v2.money_management.InboundTransferCreateParamsAmount.currency, v2.money_management.OutboundPaymentCreateParamsAmount.currency, v2.money_management.OutboundPaymentQuoteCreateParamsAmount.currency, v2.money_management.OutboundTransferCreateParamsAmount.currency, v2.payments.OffSessionPaymentCreateParamsAmount.currency, v2.payments.SettlementAllocationIntentCreateParamsAmount.currency, v2.payments.SettlementAllocationIntentModifyParamsAmount.currency, and v2.payments.SettlementAllocationIntentSplitCreateParamsAmount.currency to be requiredsettlement_type on ApplicationFeerate_card_custom_pricing_unit_overage_rate_details on InvoiceItem.Pricing and InvoiceLineItem.Pricingrate_card_custom_pricing_unit_overage_rate_details on enums InvoiceItem.Pricing.type and InvoiceLineItem.Pricing.typedefault_settings on InvoiceCreatePreviewParamsScheduleDetailQuoteModifyParamsSubscriptionDataOverride.billing_schedules from emptyable(array(billing_schedules_update_specs)) to array(billing_schedules_update_specs)payment_behavior on SubscriptionResumeParamseffective_at and spend_modifier_rule on V2.Billing.IntentAction.Apply, V2.Billing.IntentAction.Remove, v2.billing.IntentCreateParamsActionApply, and v2.billing.IntentCreateParamsActionRemoveV2.Billing.IntentAction.Apply.type, V2.Billing.IntentAction.Remove.type, v2.billing.IntentCreateParamsActionApply.type, and v2.billing.IntentCreateParamsActionRemove.type from literal('invoice_discount_rule') to enum('invoice_discount_rule'|'spend_modifier_rule')v2.core.ConnectionSessioncreate and retrieve methods on resource v2.core.ConnectionSessionlist method on resources v2.payments.SettlementAllocationIntentSplit and v2.payments.SettlementAllocationIntentagentic_commerce_settings on AccountSessionCreateParamsComponentterminal_hardware_orders and terminal_hardware_shop on AccountSession.Component and AccountSessionCreateParamsComponentnetwork_cost_passthrough_report on AccountSession.Componentae_bank_account, ag_bank_account, bh_bank_account, gm_bank_account, hk_bank_account, kh_bank_account, lc_bank_account, mc_bank_account, mg_bank_account, my_bank_account, qa_bank_account, rw_bank_account, th_bank_account, tt_bank_account, and vn_bank_account on enums V2.Account.Configuration.RecipientDatum.DefaultOutboundDestination.type and V2.Core.Account.Configuration.Recipient.DefaultOutboundDestination.typecadence_data on V2.Billing.Intent and v2.billing.IntentCreateParamscancellation_details on V2.Billing.IntentAction.Deactivate, V2.Billing.PricingPlanSubscription, and v2.billing.IntentCreateParamsActionDeactivatecontact_phone on V2.Core.Account, v2.core.AccountCreateParams, v2.core.AccountModifyParams, and v2.core.AccountTokenCreateParamsregistration_date on V2.Core.Account.Identity.BusinessDetail, v2.core.AccountCreateParamsIdentityBusinessDetail, v2.core.AccountModifyParamsIdentityBusinessDetail, and v2.core.AccountTokenCreateParamsIdentityBusinessDetailgb_vat on enums V2.Core.Account.Identity.BusinessDetail.IdNumber.type, v2.core.AccountCreateParamsIdentityBusinessDetailIdNumber.type, v2.core.AccountModifyParamsIdentityBusinessDetailIdNumber.type, and v2.core.AccountTokenCreateParamsIdentityBusinessDetailIdNumber.typereference on V2.MoneyManagement.Adjustmentaccrued_fees on V2.MoneyManagement.FinancialAccountstarting_balance on V2.MoneyManagement.FinancialAccount.Paymentaccrued_fees on enum V2.MoneyManagement.FinancialAccount.typeaccount_holder_address and account_holder_name on V2.MoneyManagement.FinancialAddress.Credential.UsBankAccountfingerprint on V2.MoneyManagement.PayoutMethod.Cardcard_spend on V2.MoneyManagement.ReceivedCredit and V2.MoneyManagement.ReceivedDebitcard_spend on enum V2.MoneyManagement.ReceivedCredit.typecard_spend on enum V2.MoneyManagement.ReceivedDebit.typeadvance, anticipation_repayment, balance_transfer, charge_failure, charge, climate_order_purchase, climate_order_refund, connect_collection_transfer, connect_reserved_funds, contribution, dispute_reversal, financing_paydown_reversal, financing_paydown, inbound_transfer_reversal, issuing_dispute_fraud_liability_debit, issuing_dispute_provisional_credit_reversal, issuing_dispute_provisional_credit, issuing_dispute, minimum_balance_hold, network_cost, obligation, outbound_payment_reversal, outbound_transfer_reversal, partial_capture_reversal, payment_network_reserved_funds, platform_earning_refund, platform_earning, platform_fee, received_credit_reversal, received_debit_reversal, refund_failure, risk_reserved_funds, stripe_balance_payment_debit_reversal, stripe_balance_payment_debit, stripe_fee_tax, transfer_reversal, and unreconciled_customer_funds on enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.TransactionDetail.categoryapplication_fee_refund, application_fee, charge, dispute, payout, refund, reserve_hold, reserve_release, topup, transfer_reversal, and transfer on V2.MoneyManagement.Transaction.Flow and V2.MoneyManagement.TransactionEntry.TransactionDetail.Flowapplication_fee_refund, application_fee, charge, dispute, payout, refund, reserve_hold, reserve_release, topup, transfer_reversal, and transfer on enums V2.MoneyManagement.Transaction.Flow.type and V2.MoneyManagement.TransactionEntry.TransactionDetail.Flow.typeV2.Payments.SettlementAllocationIntentSplit.flow to be optionalaccrued_fees on enum v2.money_management.FinancialAccountListParams.typesv2.billing.RateCardRateCreateParams.metered_item to be requiredblocked_payout_method and unsupported_payout_method on BlockedByStripeErrorinvalid_payout_method_data on InvalidPayoutMethodErrorlimit_payout_method on QuotaExceededErrorThis release changes the pinned API version to 2026-01-28.preview.
FrMealVouchersOnboarding, reserve.Hold, reserve.Plan, and reserve.Releasecreate, list, modify, and retrieve methods on resource FrMealVouchersOnboardinglist and retrieve methods on resources reserve.Hold and reserve.Releaseretrieve method on resource reserve.Planpause method on resource Subscriptionservice_period_details on Discountagentic_commerce_settings on AccountSession.Componentrisk_reserved on enum BalanceTransaction.balance_typeservice_period on enums Coupon.duration, CouponCreateParams.duration, checkout.SessionCreateParamsDiscountCouponDatum.duration, and checkout.SessionModifyParamsDiscountCouponDatum.durationservice_period on CouponCreateParams and CouponInvoiceItem.Pricing.PriceDetail.price and InvoiceLineItem.Pricing.PriceDetail.price from string to expandable($Price)settings on InvoiceCreatePreviewParamsDiscount, InvoiceCreatePreviewParamsScheduleDetailAmendmentDiscountActionAdd, InvoiceCreatePreviewParamsScheduleDetailAmendmentDiscountActionSet, InvoiceCreatePreviewParamsScheduleDetailAmendmentItemActionAddDiscount, InvoiceCreatePreviewParamsScheduleDetailAmendmentItemActionSetDiscount, InvoiceCreatePreviewParamsScheduleDetailPhaseDiscount, InvoiceCreatePreviewParamsScheduleDetailPhaseItemDiscount, InvoiceCreatePreviewParamsSubscriptionDetailItemDiscount, QuoteCreateParamsLineActionAddDiscount, QuoteCreateParamsLineActionAddItemDiscount, QuoteCreateParamsLineActionSetDiscount, QuoteCreateParamsLineActionSetItemDiscount, QuoteModifyParamsLineActionAddDiscount, QuoteModifyParamsLineActionAddItemDiscount, QuoteModifyParamsLineActionSetDiscount, QuoteModifyParamsLineActionSetItemDiscount, SubscriptionCreateParamsDiscount, SubscriptionCreateParamsItemDiscount, SubscriptionItemCreateParamsDiscount, SubscriptionItemModifyParamsDiscount, SubscriptionModifyParamsDiscount, SubscriptionModifyParamsItemDiscount, SubscriptionScheduleAmendParamsAmendmentDiscountActionAdd, SubscriptionScheduleAmendParamsAmendmentDiscountActionSet, SubscriptionScheduleAmendParamsAmendmentItemActionAddDiscount, SubscriptionScheduleAmendParamsAmendmentItemActionSetDiscount, SubscriptionScheduleCreateParamsPhaseDiscount, SubscriptionScheduleCreateParamsPhaseItemDiscount, SubscriptionScheduleModifyParamsPhaseDiscount, and SubscriptionScheduleModifyParamsPhaseItemDiscountsubtotal on InvoiceLineItembilling_cadence on SubscriptionListParamsThis release changes the pinned API version to 2026-01-28.preview.
financial_connections.Authorizationretrieve method on resource financial_connections.Authorizationdetach_payment method on resource Invoicecancel, list_line_items, and reopen methods on resource Orderattach_cadence method on resource Subscriptionadditional_files and site on Account.Setting.PaypayPayment, AccountCreateParamsSettingPaypayPayment, and AccountModifyParamsSettingPaypayPaymentcapital on Account.SettingCharge.PaymentMethodDetail.StripeBalance.source_type, ConfirmationToken.PaymentMethodPreview.StripeBalance.source_type, PaymentAttemptRecord.PaymentMethodDetail.StripeBalance.source_type, PaymentMethod.StripeBalance.source_type, and PaymentRecord.PaymentMethodDetail.StripeBalance.source_type from enum('bank_account'|'card'|'fpx') to nullable(enum('bank_account'|'card'|'fpx'))pl_nip on enums Checkout.Session.CollectedInformation.TaxId.type, Order.TaxDetail.TaxId.type, and QuotePreviewInvoice.CustomerTaxId.typecapital.financing_summary.line_of_credit_update on enum Event.typeauthorization and status_details on FinancialConnections.Accountrelink_options on FinancialConnections.Session and financial_connections.SessionCreateParamsfinancial_connections.SessionCreateParams.account_holder to be optionalrelink_result on FinancialConnections.Sessionbilling_cadence on InvoiceCreatePreviewParams, SubscriptionCreateParams, SubscriptionModifyParams, and Subscriptionbilling_cadence_details on Invoice.Parent and QuotePreviewInvoice.Parentbilling_cadence_details from enums Invoice.Parent.type and QuotePreviewInvoice.Parent.typepl_nip on enums OrderCreateParamsTaxDetailTaxId.type and OrderModifyParamsTaxDetailTaxId.typecar_rental_data, flight_data, and lodging_data on PaymentIntent.PaymentDetailQuotePreviewInvoice.PaymentSetting.PaymentMethodOption.payto to be requiredcapital.financing_summary.line_of_credit_update on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointModifyParams.enabled_eventsae_bank_account, ag_bank_account, bh_bank_account, gm_bank_account, hk_bank_account, kh_bank_account, lc_bank_account, mc_bank_account, mg_bank_account, my_bank_account, qa_bank_account, rw_bank_account, th_bank_account, tt_bank_account, and vn_bank_account on enum V2.Core.Account.Configuration.Recipient.DefaultOutboundDestination.typealternative_reference on V2.Core.Vault.GbBankAccount, V2.Core.Vault.UsBankAccount, and V2.MoneyManagement.PayoutMethodaccount_holder_address and account_holder_name on V2.MoneyManagement.FinancialAddress.Credential.UsBankAccountfingerprint on V2.MoneyManagement.PayoutMethod.Cardinvoice_payment.detached with resource InvoicePaymentrequest_blocked on QuotePreviewInvoice.LastFinalizationErrorblocked_payout_method and unsupported_payout_method on BlockedByStripeErrorinvalid_payout_method_data on InvalidPayoutMethodErrorlimit_payout_method on QuotaExceededError