This release changes the pinned API version to 2026-03-25.preview and contains additional breaking changes. See the GA changelog for more information.
- #1776 Update generated code for private-preview
- Add support for new resource
RiskSignals - Add support for
financial_account_rewardsandnesting_demoonAccountSession.Component - Add support for
upi_paymentsonAccount.Capability,AccountCreateParamsCapability, andAccountModifyParamsCapability - Add support for
risk_signalsonAccount - Add support for
fraud_intentonAccountSignals - ⚠️ Add support for new value
related_accountson enumAccountSignals.Delinquency.Indicator.indicator - Add support for
risk_reservedonBalance - ⚠️ Remove support for
billable_itemsonBilling.Alert.SpendThreshold.Filter - Add support for
upionCharge.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, andcheckout.SessionCreateParamsPaymentMethodOption - ⚠️ Add support for new value
tempoon enumsCharge.PaymentMethodDetail.Crypto.network,PaymentAttemptRecord.PaymentMethodDetail.Crypto.network, andPaymentRecord.PaymentMethodDetail.Crypto.network - ⚠️ Remove support for
source_typeonCharge.PaymentMethodDetail.StripeBalance,ConfirmationToken.PaymentMethodPreview.StripeBalance,ConfirmationTokenCreateParamsPaymentMethodDatumStripeBalance,PaymentAttemptRecord.PaymentMethodDetail.StripeBalance,PaymentIntentConfirmParamsPaymentMethodDatumStripeBalance,PaymentIntentCreateParamsPaymentMethodDatumStripeBalance,PaymentIntentModifyParamsPaymentMethodDatumStripeBalance,PaymentMethod.StripeBalance,PaymentMethodCreateParamsStripeBalance,PaymentRecord.PaymentMethodDetail.StripeBalance,SetupIntentConfirmParamsPaymentMethodDatumStripeBalance,SetupIntentCreateParamsPaymentMethodDatumStripeBalance, andSetupIntentModifyParamsPaymentMethodDatumStripeBalance - Add support for
integration_identifieronCheckout.Sessionandcheckout.SessionCreateParams - ⚠️ Add support for new value
applicationon enumsCheckout.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, andcheckout.SessionModifyParamsSubscriptionDatumInvoiceSettingIssuer.type - Add support for new value
upion enumcheckout.SessionCreateParams.excluded_payment_method_types - Change type of
InvoiceAddLinesParamsLinePriceDatumProductDatumTaxDetail.tax_code,InvoiceLineItemModifyParamsPriceDatumProductDatumTaxDetail.tax_code,InvoiceUpdateLinesParamsLinePriceDatumProductDatumTaxDetail.tax_code,PaymentLinkCreateParamsLineItemPriceDatumProductDatumTaxDetail.tax_code,PlanCreateParamsProductTaxDetail.tax_code,PriceCreateParamsProductDatumTaxDetail.tax_code,ProductCreateParamsTaxDetail.tax_code,ProductModifyParamsTaxDetail.tax_code,checkout.SessionCreateParamsLineItemPriceDatumProductDatumTaxDetail.tax_code, andcheckout.SessionModifyParamsLineItemPriceDatumProductDatumTaxDetail.tax_codefromstringtoemptyable(string) - Add support for
cryptooncheckout.SessionCreateParamsPaymentMethodOption - Add support for new value
upion enumcheckout.SessionCreateParams.payment_method_types - Add support for
pending_invoice_item_intervaloncheckout.SessionCreateParamsSubscriptionDatumandcheckout.SessionModifyParamsSubscriptionDatum - ⚠️ Add support for new values
elements,embedded_page,form, andhosted_pageon enumsCheckout.Session.ui_modeandcheckout.SessionCreateParams.ui_mode - ⚠️ Remove support for values
custom,embedded, andhostedfrom enumsCheckout.Session.ui_modeandcheckout.SessionCreateParams.ui_mode - Change
InvoiceAddLinesParamsLinePriceDatumProductDatumTaxDetail.tax_code,InvoiceLineItemModifyParamsPriceDatumProductDatumTaxDetail.tax_code,InvoiceUpdateLinesParamsLinePriceDatumProductDatumTaxDetail.tax_code,PaymentLinkCreateParamsLineItemPriceDatumProductDatumTaxDetail.tax_code,PlanCreateParamsProductTaxDetail.tax_code,PriceCreateParamsProductDatumTaxDetail.tax_code,ProductCreateParamsTaxDetail.tax_code,ProductModifyParamsTaxDetail.tax_code,checkout.SessionCreateParamsLineItemPriceDatumProductDatumTaxDetail.tax_code, andcheckout.SessionModifyParamsLineItemPriceDatumProductDatumTaxDetail.tax_codeto be optional - Add support for
au_becs_debit,bacs_debit,boleto,link,sepa_debit, andus_bank_accountonCheckout.Session.CurrentAttempt.PaymentMethodDetail - ⚠️ Add support for new value
marine_carbon_removalon enumClimate.Supplier.removal_pathway - Add support for new value
upion enumsConfirmationTokenCreateParamsPaymentMethodDatum.type,PaymentIntentConfirmParamsPaymentMethodDatum.type,PaymentIntentCreateParamsPaymentMethodDatum.type,PaymentIntentModifyParamsPaymentMethodDatum.type,SetupIntentConfirmParamsPaymentMethodDatum.type,SetupIntentCreateParamsPaymentMethodDatum.type, andSetupIntentModifyParamsPaymentMethodDatum.type - ⚠️ Add support for new value
upion enumsConfirmationToken.PaymentMethodPreview.typeandPaymentMethod.type - Add support for
metadataonCreditNoteCreateParamsLine,CreditNoteLineItem,CreditNotePreviewLinesParamsLine, andCreditNotePreviewParamsLine - Add support for new value
upion enumsCustomerListPaymentMethodsParams.type,PaymentMethodCreateParams.type, andPaymentMethodListParams.type - Add support for
selected_fulfillment_option_overridesonDelegatedCheckout.RequestedSession.FulfillmentDetail - Add support for
line_item_keysonDelegatedCheckout.RequestedSession.FulfillmentDetail.FulfillmentOption.Digital.DigitalOptionandDelegatedCheckout.RequestedSession.FulfillmentDetail.FulfillmentOption.Shipping.ShippingOption - Add support for
quantity_decimalonInvoiceAddLinesParamsLine,InvoiceCreatePreviewParamsInvoiceItem,InvoiceItemCreateParams,InvoiceItemModifyParams,InvoiceItem,InvoiceLineItemModifyParams,InvoiceLineItem, andInvoiceUpdateLinesParamsLine - Add support for
expires_after_secondsonInvoice.PaymentSetting.PaymentMethodOption.Pix,InvoiceCreateParamsPaymentSettingPaymentMethodOptionPix,InvoiceModifyParamsPaymentSettingPaymentMethodOptionPix,QuotePreviewInvoice.PaymentSetting.PaymentMethodOption.Pix,Subscription.PaymentSetting.PaymentMethodOption.Pix,SubscriptionCreateParamsPaymentSettingPaymentMethodOptionPix, andSubscriptionModifyParamsPaymentSettingPaymentMethodOptionPix - ⚠️ Add support for
levelonissuing.AuthorizationCreateParamsRiskAssessmentCardTestingRiskandissuing.AuthorizationCreateParamsRiskAssessmentMerchantDisputeRisk - ⚠️ Remove support for
risk_levelonissuing.AuthorizationCreateParamsRiskAssessmentCardTestingRiskandissuing.AuthorizationCreateParamsRiskAssessmentMerchantDisputeRisk - ⚠️ Add support for new values
da,pl, andsvon enumsIssuing.Cardholder.preferred_locales,issuing.CardholderCreateParams.preferred_locales, andissuing.CardholderModifyParams.preferred_locales - Add support for
lifecycle_controlsonIssuing.Cardandissuing.CardCreateParams - ⚠️ Change type of
Issuing.Token.NetworkDatum.Visa.card_reference_idfromstringtonullable(string) - ⚠️ Change type of
PaymentAttemptRecord.PaymentMethodDetail.Card.brandandPaymentRecord.PaymentMethodDetail.Card.brandfromenumtonullable(enum) - ⚠️ Change type of
PaymentAttemptRecord.PaymentMethodDetail.Card.exp_monthandPaymentRecord.PaymentMethodDetail.Card.exp_monthfromlongIntegertonullable(longInteger) - ⚠️ Change type of
PaymentAttemptRecord.PaymentMethodDetail.Card.exp_yearandPaymentRecord.PaymentMethodDetail.Card.exp_yearfromlongIntegertonullable(longInteger) - ⚠️ Change type of
PaymentAttemptRecord.PaymentMethodDetail.Card.fundingandPaymentRecord.PaymentMethodDetail.Card.fundingfromenum('credit'|'debit'|'prepaid'|'unknown')tonullable(enum('credit'|'debit'|'prepaid'|'unknown')) - ⚠️ Change type of
PaymentAttemptRecord.PaymentMethodDetail.Card.last4andPaymentRecord.PaymentMethodDetail.Card.last4fromstringtonullable(string) - ⚠️ Change type of
PaymentAttemptRecord.PaymentMethodDetail.Card.motoandPaymentRecord.PaymentMethodDetail.Card.motofrombooleantonullable(boolean) - Add support for
cryptogram,electronic_commerce_indicator,exemption_indicator_applied, andexemption_indicatoronPaymentAttemptRecord.PaymentMethodDetail.Card.ThreeDSecureandPaymentRecord.PaymentMethodDetail.Card.ThreeDSecure - Add support for
surchargeonPaymentIntent.AmountDetail,PaymentIntentCaptureParamsAmountDetail,PaymentIntentConfirmParamsAmountDetail,PaymentIntentCreateParamsAmountDetail,PaymentIntentIncrementAuthorizationParamsAmountDetail, andPaymentIntentModifyParamsAmountDetail - ⚠️ Add support for new value
upion enumsPaymentIntent.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, andSetupIntentModifyParams.excluded_payment_method_types - Add support for
mandate_optionsonPaymentIntent.PaymentMethodOption.StripeBalance,PaymentIntentConfirmParamsPaymentMethodOptionStripeBalance,PaymentIntentCreateParamsPaymentMethodOptionStripeBalance, andPaymentIntentModifyParamsPaymentMethodOptionStripeBalance - Add support for
amount_detailsandpayment_detailsonPaymentIntentDecrementAuthorizationParams - Add support for
upi_handle_redirect_or_display_qr_codeonPaymentIntent.NextActionandSetupIntent.NextAction - Add support for
managed_paymentsonPaymentLinkCreateParamsandPaymentLink - ⚠️ Add support for new value
upion enumsPaymentLink.payment_method_types,PaymentLinkCreateParams.payment_method_types, andPaymentLinkModifyParams.payment_method_types - Add support for
recommended_actionandsignalsonRadar.PaymentEvaluation - ⚠️ Remove support for
insightsonRadar.PaymentEvaluation - ⚠️ Add support for new value
crypto_fingerprinton enumsRadar.ValueList.item_typeandradar.ValueListCreateParams.item_type - Add support for
stripe_balanceonSetupIntent.PaymentMethodOption,SetupIntentConfirmParamsPaymentMethodOption,SetupIntentCreateParamsPaymentMethodOption, andSetupIntentModifyParamsPaymentMethodOption - ⚠️ Add support for new value
resolvedon enumSharedPayment.GrantedToken.deactivated_reason - Add support for
recurring_intervalonSharedPayment.GrantedToken.UsageLimit - ⚠️ Change type of
SharedPayment.GrantedToken.UsageLimit.expires_atfromDateTimetonullable(DateTime) - Add support for
presentment_detailsonSubscription - ⚠️ Add support for new value
canceled_by_retention_policyon enumSubscription.CancellationDetail.reason - Add support for new value
2026-03-25.dahliaon enumWebhookEndpointCreateParams.api_version - ⚠️ Remove support for
invoice_resourcesonV2.Billing.Intent - ⚠️ Remove support for
amount_dueandcustomer_balance_appliedonV2.Billing.Intent.AmountDetail - Add support for
recurring_credit_grantonV2.Billing.IntentAction.Modify.PricingPlanSubscriptionDetail.Override.PartialPeriodBehavior,V2.Billing.IntentAction.Subscribe.PricingPlanSubscriptionDetail.Override.PartialPeriodBehavior,v2.billing.IntentCreateParamsActionModifyPricingPlanSubscriptionDetailOverridePartialPeriodBehavior, andv2.billing.IntentCreateParamsActionSubscribePricingPlanSubscriptionDetailOverridePartialPeriodBehavior - Add support for
consumer_privacy_disclosuresandconsumer_storeronV2.Core.Account.Identity.Attestation.TermsOfService,v2.core.AccountCreateParamsIdentityAttestationTermsOfService, andv2.core.AccountModifyParamsIdentityAttestationTermsOfService - ⚠️ Remove support for
includeonv2.billing.IntentCreateParamsandv2.billing.IntentReserveParams - Add support for error code
service_period_coupon_with_metered_tiered_item_unsupportedonInvoice.LastFinalizationError,PaymentIntent.LastPaymentError,QuotePreviewInvoice.LastFinalizationError,SetupAttempt.SetupError,SetupIntent.LastSetupError, andStripeError
- Add support for new resource
- #1763 Update generated code for private-preview
- Add support for new resource
v2.core.AccountEvaluation - ⚠️ Remove support for resources
v2.billing.LicenseFeeSubscriptionandv2.billing.PricingPlanSubscriptionComponents - Add support for
createmethod on resourcev2.core.AccountEvaluation - ⚠️ Remove support for
retrievemethod on resourcesv2.billing.LicenseFeeSubscriptionandv2.billing.PricingPlanSubscriptionComponents - Add support for
modify_ratesmethod on resourcev2.billing.RateCard - Add support for
remove_discountsmethod on resourcev2.billing.PricingPlanSubscription - ⚠️ Add support for new value
eg_bank_accounton enumV2.Account.Configuration.RecipientDatum.DefaultOutboundDestination.type - Add support for
invoice_resourcesonV2.Billing.Intent - Add support for
amount_dueandcustomer_balance_appliedonV2.Billing.Intent.AmountDetail - Add support for
expires_atonV2.Billing.Intent.StatusTransition - Add support for
discountonV2.Billing.IntentAction.Applyandv2.billing.IntentCreateParamsActionApply - Add support for
timestamponV2.Billing.IntentAction.Apply.EffectiveAtandv2.billing.IntentCreateParamsActionApplyEffectiveAt - ⚠️ Add support for new values
current_billing_period_startandtimestampon enumsV2.Billing.IntentAction.Apply.EffectiveAt.typeandv2.billing.IntentCreateParamsActionApplyEffectiveAt.type - ⚠️ Add support for new value
discounton enumsV2.Billing.IntentAction.Apply.typeandv2.billing.IntentCreateParamsActionApply.type - ⚠️ Change type of
V2.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, andv2.billing.IntentCreateParamsActionSubscribePricingPlanSubscriptionDetailOverridePartialPeriodBehavior.typefromliteral('license_fee')toenum('license_fee'|'recurring_credit_grant') - Add support for
service_cycleonV2.Billing.LicenseFeeandV2.Billing.RateCard - ⚠️ Remove support for
latest_versiononV2.Billing.LicenseFee,V2.Billing.PricingPlan, andV2.Billing.RateCard - ⚠️ Remove support for
service_interval_countandservice_intervalonV2.Billing.LicenseFeeandV2.Billing.RateCard - ⚠️ Change type of
V2.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, andv2.billing.RateCardRateCreateParamsTransformQuantity.divide_byfromlongIntegertoint64_string - Add support for
discount_detailsandpricing_plan_component_detailsonV2.Billing.PricingPlanSubscription - ⚠️ Add support for new value
crypto_walletson enumsV2.Core.Account.FutureRequirement.Entry.Impact.RestrictsCapability.capabilityandV2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capability - ⚠️ Remove support for value
cryptofrom enumsV2.Core.Account.FutureRequirement.Entry.Impact.RestrictsCapability.capabilityandV2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capability - Add support for
balance_by_funds_typeonV2.MoneyManagement.FinancialAccount.Payment - ⚠️ Add support for new value
next_day_payout_feeon enumV2.MoneyManagement.OutboundPaymentQuote.EstimatedFee.type - Add support for
treasury_transaction_entryonV2.MoneyManagement.TransactionEntry - Add support for
treasury_credit_reversal,treasury_debit_reversal,treasury_inbound_transfer,treasury_issuing_authorization,treasury_outbound_payment,treasury_outbound_transfer,treasury_received_credit, andtreasury_received_debitonV2.MoneyManagement.Transaction.FlowandV2.MoneyManagement.TransactionEntry.TransactionDetail.Flow - ⚠️ Add support for new values
treasury_credit_reversal,treasury_debit_reversal,treasury_inbound_transfer,treasury_issuing_authorization,treasury_other,treasury_outbound_payment,treasury_outbound_transfer,treasury_received_credit, andtreasury_received_debiton enumsV2.MoneyManagement.Transaction.Flow.typeandV2.MoneyManagement.TransactionEntry.TransactionDetail.Flow.type - Add support for
treasury_transactiononV2.MoneyManagement.Transaction - ⚠️ Add support for new value
no_valid_payment_methodon enumV2.Payments.OffSessionPayment.failure_reason - Add support for
metadataonV2.Payments.SettlementAllocationIntentSplit - ⚠️ Change type of
V2.Reporting.ReportRun.Result.File.sizefromlongIntegertoint64_string - Add support for
statement_descriptoronv2.money_management.OutboundPaymentCreateParamsandv2.money_management.OutboundTransferCreateParams - Add support for
includeonv2.billing.IntentCreateParams,v2.billing.IntentReserveParams,v2.billing.PricingPlanSubscriptionListParams,v2.billing.PricingPlanSubscriptionRetrieveParams,v2.money_management.FinancialAccountListParams, andv2.money_management.FinancialAccountRetrieveParams - Add support for event notifications
V1AccountSignalsIncludingDelinquencyCreatedEvent,V2CoreAccountSignalsFraudulentWebsiteReadyEvent, andV2SignalsAccountSignalFraudulentMerchantReadyEvent
- Add support for new resource
- #1766 Merge to private-preview