This release changes the pinned API version to 2026-03-25.preview and contains additional breaking changes. See the GA changelog for more information.
- #2196 Update generated code for private-preview
- Add support for new resource
RiskSignals - Add support for
financialAccountRewardsandnestingDemoonAccountSession.components - Add support for
upiPaymentsonAccount.capabilities,AccountCreateParams.capabilities, andAccountUpdateParams.capabilities - Add support for
riskSignalsonAccount - Add support for
fraudIntentonAccountSignals - Add support for
riskReservedonBalance - ⚠️ Remove support for
billableItemsonbilling.Alert.spend_threshold.filters - Add support for
upionCharge.payment_method_details,ConfirmationToken.payment_method_preview,ConfirmationTokenCreateParams.payment_method_data,Mandate.payment_method_details,PaymentAttemptRecord.payment_method_details,PaymentIntent.payment_method_options,PaymentIntentConfirmParams.payment_method_data,PaymentIntentConfirmParams.payment_method_options,PaymentIntentCreateParams.payment_method_data,PaymentIntentCreateParams.payment_method_options,PaymentIntentUpdateParams.payment_method_data,PaymentIntentUpdateParams.payment_method_options,PaymentMethodConfigurationCreateParams,PaymentMethodConfigurationUpdateParams,PaymentMethodConfiguration,PaymentMethodCreateParams,PaymentMethod,PaymentRecord.payment_method_details,SetupAttempt.payment_method_details,SetupIntent.payment_method_options,SetupIntentConfirmParams.payment_method_data,SetupIntentConfirmParams.payment_method_options,SetupIntentCreateParams.payment_method_data,SetupIntentCreateParams.payment_method_options,SetupIntentUpdateParams.payment_method_data,SetupIntentUpdateParams.payment_method_options,checkout.Session.payment_method_options, andcheckout.SessionCreateParams.payment_method_options - ⚠️ Remove support for
sourceTypeonCharge.payment_method_details.stripe_balance,ConfirmationToken.payment_method_preview.stripe_balance,ConfirmationTokenCreateParams.payment_method_data.stripe_balance,PaymentAttemptRecord.payment_method_details.stripe_balance,PaymentIntentConfirmParams.payment_method_data.stripe_balance,PaymentIntentCreateParams.payment_method_data.stripe_balance,PaymentIntentUpdateParams.payment_method_data.stripe_balance,PaymentMethod.stripe_balance,PaymentMethodCreateParams.stripe_balance,PaymentRecord.payment_method_details.stripe_balance,SetupIntentConfirmParams.payment_method_data.stripe_balance,SetupIntentCreateParams.payment_method_data.stripe_balance, andSetupIntentUpdateParams.payment_method_data.stripe_balance - Add support for
integrationIdentifieroncheckout.SessionCreateParamsandcheckout.Session - Add support for new value
applicationon enumsInvoiceCreateParams.automatic_tax.liability.type,InvoiceCreateParams.issuer.type,InvoiceCreatePreviewParams.automatic_tax.liability.type,InvoiceCreatePreviewParams.issuer.type,InvoiceCreatePreviewParams.schedule_details.phases[].automatic_tax.liability.type,InvoiceCreatePreviewParams.schedule_details.phases[].invoice_settings.issuer.type,InvoiceUpdateParams.automatic_tax.liability.type,InvoiceUpdateParams.issuer.type,PaymentLinkCreateParams.automatic_tax.liability.type,PaymentLinkCreateParams.invoice_creation.invoice_data.issuer.type,PaymentLinkCreateParams.subscription_data.invoice_settings.issuer.type,PaymentLinkUpdateParams.automatic_tax.liability.type,PaymentLinkUpdateParams.invoice_creation.invoice_data.issuer.type,PaymentLinkUpdateParams.subscription_data.invoice_settings.issuer.type,QuoteCreateParams.automatic_tax.liability.type,QuoteCreateParams.invoice_settings.issuer.type,QuoteUpdateParams.automatic_tax.liability.type,QuoteUpdateParams.invoice_settings.issuer.type,SubscriptionCreateParams.automatic_tax.liability.type,SubscriptionCreateParams.invoice_settings.issuer.type,SubscriptionScheduleCreateParams.default_settings.automatic_tax.liability.type,SubscriptionScheduleCreateParams.default_settings.invoice_settings.issuer.type,SubscriptionScheduleCreateParams.phases[].automatic_tax.liability.type,SubscriptionScheduleCreateParams.phases[].invoice_settings.issuer.type,SubscriptionScheduleUpdateParams.default_settings.automatic_tax.liability.type,SubscriptionScheduleUpdateParams.default_settings.invoice_settings.issuer.type,SubscriptionScheduleUpdateParams.phases[].automatic_tax.liability.type,SubscriptionScheduleUpdateParams.phases[].invoice_settings.issuer.type,SubscriptionUpdateParams.automatic_tax.liability.type,SubscriptionUpdateParams.invoice_settings.issuer.type,checkout.SessionCreateParams.automatic_tax.liability.type,checkout.SessionCreateParams.invoice_creation.invoice_data.issuer.type,checkout.SessionCreateParams.subscription_data.invoice_settings.issuer.type,checkout.SessionUpdateParams.automatic_tax.liability.type,checkout.SessionUpdateParams.invoice_creation.invoice_data.issuer.type, andcheckout.SessionUpdateParams.subscription_data.invoice_settings.issuer.type - Add support for new value
upion enumcheckout.SessionCreateParams.excludedPaymentMethodTypes - Change type of
InvoiceAddLinesParams.lines[].price_data.product_data.tax_details.taxCode,InvoiceLineItemUpdateParams.price_data.product_data.tax_details.taxCode,InvoiceUpdateLinesParams.lines[].price_data.product_data.tax_details.taxCode,PaymentLinkCreateParams.line_items[].price_data.product_data.tax_details.taxCode,PlanCreateParams.product[0].tax_details.taxCode,PriceCreateParams.product_data.tax_details.taxCode,ProductCreateParams.tax_details.taxCode,ProductUpdateParams.tax_details.taxCode,checkout.SessionCreateParams.line_items[].price_data.product_data.tax_details.taxCode, andcheckout.SessionUpdateParams.line_items[].price_data.product_data.tax_details.taxCodefromstringtoemptyable(string) - Add support for
cryptooncheckout.SessionCreateParams.payment_method_options - Add support for new value
upion enumcheckout.SessionCreateParams.paymentMethodTypes - Add support for
pendingInvoiceItemIntervaloncheckout.SessionCreateParams.subscription_dataandcheckout.SessionUpdateParams.subscription_data - Add support for new values
elements,embedded_page,form, andhosted_pageon enumcheckout.SessionCreateParams.uiMode - ⚠️ Remove support for values
custom,embedded, andhostedfrom enumcheckout.SessionCreateParams.uiMode - Change
InvoiceAddLinesParams.lines[].price_data.product_data.tax_details.taxCode,InvoiceLineItemUpdateParams.price_data.product_data.tax_details.taxCode,InvoiceUpdateLinesParams.lines[].price_data.product_data.tax_details.taxCode,PaymentLinkCreateParams.line_items[].price_data.product_data.tax_details.taxCode,PlanCreateParams.product[0].tax_details.taxCode,PriceCreateParams.product_data.tax_details.taxCode,ProductCreateParams.tax_details.taxCode,ProductUpdateParams.tax_details.taxCode,checkout.SessionCreateParams.line_items[].price_data.product_data.tax_details.taxCode, andcheckout.SessionUpdateParams.line_items[].price_data.product_data.tax_details.taxCodeto be optional - Add support for
auBecsDebit,bacsDebit,boleto,link,sepaDebit, andusBankAccountoncheckout.Session.current_attempt.payment_method_details - Add support for new value
upion enumsConfirmationTokenCreateParams.payment_method_data.type,PaymentIntentConfirmParams.payment_method_data.type,PaymentIntentCreateParams.payment_method_data.type,PaymentIntentUpdateParams.payment_method_data.type,SetupIntentConfirmParams.payment_method_data.type,SetupIntentCreateParams.payment_method_data.type, andSetupIntentUpdateParams.payment_method_data.type - Add support for
metadataonCreditNoteCreateParams.lines[],CreditNoteLineItem,CreditNotePreviewLinesParams.lines[], andCreditNotePreviewParams.lines[] - Add support for new value
upion enumsCustomerListPaymentMethodsParams.type,PaymentMethodCreateParams.type, andPaymentMethodListParams.type - Add support for
selectedFulfillmentOptionOverridesondelegatedcheckout.RequestedSession.fulfillment_details - Add support for
lineItemKeysondelegatedcheckout.RequestedSession.fulfillment_details.fulfillment_options[].digital.digital_options[]anddelegatedcheckout.RequestedSession.fulfillment_details.fulfillment_options[].shipping.shipping_options[] - Add support for
quantityDecimalonInvoiceAddLinesParams.lines[],InvoiceCreatePreviewParams.invoice_items[],InvoiceItemCreateParams,InvoiceItemUpdateParams,InvoiceItem,InvoiceLineItemUpdateParams,InvoiceLineItem, andInvoiceUpdateLinesParams.lines[] - Add support for
expiresAfterSecondsonInvoice.payment_settings.payment_method_options.pix,InvoiceCreateParams.payment_settings.payment_method_options.pix,InvoiceUpdateParams.payment_settings.payment_method_options.pix,QuotePreviewInvoice.payment_settings.payment_method_options.pix,Subscription.payment_settings.payment_method_options.pix,SubscriptionCreateParams.payment_settings.payment_method_options.pix, andSubscriptionUpdateParams.payment_settings.payment_method_options.pix - ⚠️ Add support for
levelonissuing.AuthorizationCreateParams.risk_assessment.card_testing_riskandissuing.AuthorizationCreateParams.risk_assessment.merchant_dispute_risk - ⚠️ Remove support for
riskLevelonissuing.AuthorizationCreateParams.risk_assessment.card_testing_riskandissuing.AuthorizationCreateParams.risk_assessment.merchant_dispute_risk - Add support for new values
da,pl, andsvon enumsissuing.CardholderCreateParams.preferredLocalesandissuing.CardholderUpdateParams.preferredLocales - Add support for
lifecycleControlsonissuing.CardCreateParamsandissuing.Card - Add support for
cryptogram,electronicCommerceIndicator,exemptionIndicatorApplied, andexemptionIndicatoronPaymentAttemptRecord.payment_method_details.card.three_d_secureandPaymentRecord.payment_method_details.card.three_d_secure - Add support for
surchargeonPaymentIntent.amount_details,PaymentIntentCaptureParams.amount_details,PaymentIntentConfirmParams.amount_details,PaymentIntentCreateParams.amount_details,PaymentIntentIncrementAuthorizationParams.amount_details, andPaymentIntentUpdateParams.amount_details - Add support for new value
upion enumsPaymentIntentConfirmParams.excludedPaymentMethodTypes,PaymentIntentCreateParams.excludedPaymentMethodTypes,PaymentIntentUpdateParams.excludedPaymentMethodTypes,SetupIntentCreateParams.excludedPaymentMethodTypes, andSetupIntentUpdateParams.excludedPaymentMethodTypes - Add support for
mandateOptionsonPaymentIntent.payment_method_options.stripe_balance,PaymentIntentConfirmParams.payment_method_options.stripe_balance,PaymentIntentCreateParams.payment_method_options.stripe_balance, andPaymentIntentUpdateParams.payment_method_options.stripe_balance - Add support for
amountDetailsandpaymentDetailsonPaymentIntentDecrementAuthorizationParams - Add support for
upiHandleRedirectOrDisplayQrCodeonPaymentIntent.next_actionandSetupIntent.next_action - Add support for
managedPaymentsonPaymentLinkCreateParamsandPaymentLink - Add support for new value
upion enumsPaymentLinkCreateParams.paymentMethodTypesandPaymentLinkUpdateParams.paymentMethodTypes - Add support for
recommendedActionandsignalsonradar.PaymentEvaluation - ⚠️ Remove support for
insightsonradar.PaymentEvaluation - Add support for new value
crypto_fingerprinton enumradar.ValueListCreateParams.itemType - Add support for
stripeBalanceonSetupIntent.payment_method_options,SetupIntentConfirmParams.payment_method_options,SetupIntentCreateParams.payment_method_options, andSetupIntentUpdateParams.payment_method_options - Add support for
recurringIntervalonsharedpayment.GrantedToken.usage_limits - Add support for
presentmentDetailsonSubscription - Add support for new value
2026-03-25.dahliaon enumWebhookEndpointCreateParams.apiVersion - ⚠️ Remove support for
invoiceResourcesonv2.billing.Intent - ⚠️ Remove support for
amountDueandcustomerBalanceAppliedonv2.billing.Intent.amount_details - Add support for
recurringCreditGrantonv2.billing.IntentAction.modify.pricing_plan_subscription_details.overrides.partial_period_behaviors[],v2.billing.IntentAction.subscribe.pricing_plan_subscription_details.overrides.partial_period_behaviors[],v2.billing.IntentCreateParams.actions[].modify.pricing_plan_subscription_details.overrides.partial_period_behaviors[], andv2.billing.IntentCreateParams.actions[].subscribe.pricing_plan_subscription_details.overrides.partial_period_behaviors[] - Add support for
consumerPrivacyDisclosuresandconsumerStoreronv2.core.Account.identity.attestations.terms_of_service,v2.core.AccountCreateParams.identity.attestations.terms_of_service, andv2.core.AccountUpdateParams.identity.attestations.terms_of_service - ⚠️ Remove support for
includeonv2.billing.IntentCreateParamsandv2.billing.IntentReserveParams
- Add support for new resource
- #2195 Update generated code for private-preview
- Release specs are identical.
- #2185 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
invoiceResourcesonv2.billing.Intent - Add support for
amountDueandcustomerBalanceAppliedonv2.billing.Intent.amount_details - Add support for
expiresAtonv2.billing.Intent.status_transitions - Add support for
discountonv2.billing.IntentAction.applyandv2.billing.IntentCreateParams.actions[].apply - Add support for
timestamponv2.billing.IntentAction.apply.effective_atandv2.billing.IntentCreateParams.actions[].apply.effective_at - ⚠️ Change type of
v2.billing.IntentAction.deactivate.pricing_plan_subscription_details.overrides.partial_period_behaviors[].type,v2.billing.IntentAction.modify.pricing_plan_subscription_details.overrides.partial_period_behaviors[].type,v2.billing.IntentAction.subscribe.pricing_plan_subscription_details.overrides.partial_period_behaviors[].type,v2.billing.IntentCreateParams.actions[].deactivate.pricing_plan_subscription_details.overrides.partial_period_behaviors[].type,v2.billing.IntentCreateParams.actions[].modify.pricing_plan_subscription_details.overrides.partial_period_behaviors[].type, andv2.billing.IntentCreateParams.actions[].subscribe.pricing_plan_subscription_details.overrides.partial_period_behaviors[].typefromliteral('license_fee')toenum('license_fee'|'recurring_credit_grant') - Add support for
serviceCycleonv2.billing.LicenseFeeandv2.billing.RateCard - ⚠️ Remove support for
latestVersiononv2.billing.LicenseFee,v2.billing.PricingPlan, andv2.billing.RateCard - ⚠️ Remove support for
serviceIntervalCountandserviceIntervalonv2.billing.LicenseFeeandv2.billing.RateCard - ⚠️ Change type of
v2.billing.LicenseFee.transform_quantity.divideBy,v2.billing.LicenseFeeCreateParams.transform_quantity.divideBy,v2.billing.LicenseFeeUpdateParams.transform_quantity.divideBy,v2.billing.LicenseFeeVersion.transform_quantity.divideBy,v2.billing.RateCardRate.transform_quantity.divideBy, andv2.billing.RateCardRateCreateParams.transform_quantity.divideByfromlongIntegertoint64_string - Add support for
discountDetailsandpricingPlanComponentDetailsonv2.billing.PricingPlanSubscription - Add support for
balanceByFundsTypeonv2.moneymanagement.FinancialAccount.payments - Add support for
treasuryTransactionEntryonv2.moneymanagement.TransactionEntry - Add support for
treasuryCreditReversal,treasuryDebitReversal,treasuryInboundTransfer,treasuryIssuingAuthorization,treasuryOutboundPayment,treasuryOutboundTransfer,treasuryReceivedCredit, andtreasuryReceivedDebitonv2.moneymanagement.Transaction.flowandv2.moneymanagement.TransactionEntry.transaction_details.flow - Add support for
treasuryTransactiononv2.moneymanagement.Transaction - Add support for
metadataonv2.payments.SettlementAllocationIntentSplit - ⚠️ Change type of
v2.reporting.ReportRun.result.file.sizefromlongIntegertoint64_string - Add support for
statementDescriptoronv2.moneymanagement.OutboundPaymentCreateParamsandv2.moneymanagement.OutboundTransferCreateParams - Add support for
includeonv2.billing.IntentCreateParams,v2.billing.IntentReserveParams,v2.billing.PricingPlanSubscriptionListParams,v2.billing.PricingPlanSubscriptionRetrieveParams,v2.moneymanagement.FinancialAccountListParams, andv2.moneymanagement.FinancialAccountRetrieveParams - Add support for new values
current_billing_period_startandtimestampon enumv2.billing.IntentCreateParams.actions[].apply.effective_at.type - Add support for new value
discounton enumv2.billing.IntentCreateParams.actions[].apply.type - Add support for event notifications
V1AccountSignalsIncludingDelinquencyCreatedEvent,V2CoreAccountSignalsFraudulentWebsiteReadyEvent, andV2SignalsAccountSignalFraudulentMerchantReadyEvent
- Add support for new resource
- #2188 Merge to private-preview