This 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 V2SignalsAccountSignalFraudulentMerchantReadyEventFetched March 26, 2026