• #2627 Fix export for Stripe.Decimal in CJS and ESM. Resolves #2625

See the changelog for more details.

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

• #2621 Update generated code for beta
• #2622 Merge to beta
• #2587 Update generated code for beta
  • Add support for new resources ProductCatalog.TrialOffer, Tax.Location, and V2.Core.BatchJob
  • Add support for create method on resource ProductCatalog.TrialOffer
  • Add support for create, list, and retrieve methods on resource Tax.Location
  • Add support for cancel, create, and retrieve methods on resource V2.Core.BatchJob
  • Add support for performance_location on Tax.CalculationCreateParams.line_items[] and Tax.CalculationLineItem
  • ⚠️ Add support for new value performance on enums Tax.Calculation.shipping_cost.tax_breakdown[].sourcing, Tax.CalculationLineItem.tax_breakdown[].sourcing, and Tax.Transaction.shipping_cost.tax_breakdown[].sourcing
  • ⚠️ Add support for new values admissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on enums Tax.Calculation.shipping_cost.tax_breakdown[].tax_rate_details.tax_type, Tax.Calculation.tax_breakdown[].tax_rate_details.tax_type, Tax.CalculationLineItem.tax_breakdown[].tax_rate_details.tax_type, and Tax.Transaction.shipping_cost.tax_breakdown[].tax_rate_details.tax_type
  • Add support for trial_offer on InvoiceCreatePreviewParams.schedule_details.amendments[].item_actions[].add, InvoiceCreatePreviewParams.schedule_details.amendments[].item_actions[].set, InvoiceCreatePreviewParams.schedule_details.phases[].items[], QuoteCreateParams.lines[].actions[].add_item, QuoteCreateParams.lines[].actions[].set_items[], QuoteLine.actions[].add_item, QuoteLine.actions[].set_items[], QuotePreviewSubscriptionSchedule.phases[].items[], QuoteUpdateParams.lines[].actions[].add_item, QuoteUpdateParams.lines[].actions[].set_items[], SubscriptionSchedule.phases[].items[], SubscriptionScheduleAmendParams.amendments[].item_actions[].add, SubscriptionScheduleAmendParams.amendments[].item_actions[].set, SubscriptionScheduleCreateParams.phases[].items[], and SubscriptionScheduleUpdateParams.phases[].items[]
  • Add support for risk_reserved on Balance
  • ⚠️ Remove support for source_type on Charge.payment_method_details.stripe_balance, ConfirmationToken.payment_method_preview.stripe_balance, ConfirmationTokenCreateParams.testHelpers.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, and SetupIntentUpdateParams.payment_method_data.stripe_balance
  • Add support for tax_details on Checkout.SessionCreateParams.line_items[].price_data.product_data, Checkout.SessionUpdateParams.line_items[].price_data.product_data, InvoiceAddLinesParams.lines[].price_data.product_data, InvoiceLineItemUpdateParams.price_data.product_data, InvoiceUpdateLinesParams.lines[].price_data.product_data, PaymentLinkCreateParams.line_items[].price_data.product_data, PlanCreateParams.product[0], PriceCreateParams.product_data, ProductCreateParams, and ProductUpdateParams
  • Add support for pending_invoice_item_interval on Checkout.SessionUpdateParams.subscription_data
  • Add support for hosted and ui_mode on FinancialConnections.SessionCreateParams and FinancialConnections.Session
  • Add support for url on FinancialConnections.Session
  • Add support for expires_after_seconds on Invoice.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, and SubscriptionUpdateParams.payment_settings.payment_method_options.pix
  • Add support for current_trial on InvoiceCreatePreviewParams.subscription_details.items[], SubscriptionCreateParams.items[], SubscriptionItemCreateParams, SubscriptionItemUpdateParams, SubscriptionItem, and SubscriptionUpdateParams.items[]
  • Add support for surcharge on PaymentIntent.amount_details, PaymentIntentCaptureParams.amount_details, PaymentIntentConfirmParams.amount_details, PaymentIntentCreateParams.amount_details, PaymentIntentIncrementAuthorizationParams.amount_details, and PaymentIntentUpdateParams.amount_details
  • Add support for amount_details and payment_details on PaymentIntentDecrementAuthorizationParams
  • Add support for mandate_options on PaymentIntent.payment_method_options.stripe_balance
  • Add support for managed_payments on PaymentLinkCreateParams and PaymentLink
  • Add support for stripe_balance on SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_options, and SetupIntentUpdateParams.payment_method_options
  • Add support for billing_cycle_anchor on Subscription.trial_settings.end_behavior, SubscriptionCreateParams.trial_settings.end_behavior, and SubscriptionUpdateParams.trial_settings.end_behavior
  • ⚠️ Add support for new values admissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on enums Tax.Registration.country_options.us.type and Tax.RegistrationCreateParams.country_options.us.type
  • Add support for admissions_tax, attendance_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, resort_tax, and tourism_tax on Tax.Registration.country_options.us
  • Add support for requirements on TaxCode
  • ⚠️ Change type of V2.Billing.Cadence.settings_data.collection.payment_method_options.card.mandate_options.amount, V2.Billing.CollectionSetting.payment_method_options.card.mandate_options.amount, V2.Billing.CollectionSettingCreateParams.payment_method_options.card.mandate_options.amount, V2.Billing.CollectionSettingUpdateParams.payment_method_options.card.mandate_options.amount, and V2.Billing.CollectionSettingVersion.payment_method_options.card.mandate_options.amount from longInteger to int64_string
  • ⚠️ Add support for new values ar_bank_account, co_bank_account, and eg_bank_account on enum V2.Core.Account.configuration.recipient.default_outbound_destination.type
  • Add support for timezone on V2.Core.Account.defaults, V2.Core.AccountCreateParams.defaults, and V2.Core.AccountUpdateParams.defaults
  • Add support for azure_event_grid on V2.Core.EventDestinationCreateParams and V2.Core.EventDestination
  • ⚠️ Add support for new value no_azure_partner_topic_exists on enum V2.Core.EventDestination.status_details.disabled.reason
  • ⚠️ Add support for new value azure_event_grid on enums V2.Core.EventDestination.type and V2.Core.EventDestinationCreateParams.type
  • Add support for supported_currencies on V2.Core.Vault.GbBankAccount, V2.Core.Vault.UsBankAccount, and V2.MoneyManagement.PayoutMethod.card
  • ⚠️ Change V2.Core.Vault.GbBankAccount.sort_code and V2.Core.Vault.GbBankAccountCreateParams.sort_code to be optional
  • Add support for restricted on V2.MoneyManagement.PayoutMethod
  • Add support for currencies on V2.MoneyManagement.PayoutMethodsBankAccountSpec.countries.value.fields[]
  • Add support for counterparty and description on V2.MoneyManagement.Transaction
  • ⚠️ Add support for currency on V2.Core.Vault.GbBankAccountCreateParams, V2.Core.Vault.UsBankAccountCreateParams, V2.MoneyManagement.OutboundSetupIntentCreateParams.payout_method_data.bank_account, V2.MoneyManagement.OutboundSetupIntentCreateParams.payout_method_data.card, V2.MoneyManagement.OutboundSetupIntentUpdateParams.payout_method_data.bank_account, and V2.MoneyManagement.OutboundSetupIntentUpdateParams.payout_method_data.card
  • Add support for iban on V2.Core.Vault.GbBankAccountCreateParams
  • Change V2.Core.Vault.GbBankAccountCreateParams.account_number to be optional
  • ⚠️ Add support for new value currency on enum InvalidPaymentMethodError.invalid_param
  • Add support for event notifications V2CoreBatchJobBatchFailedEvent, V2CoreBatchJobCanceledEvent, V2CoreBatchJobCompletedEvent, V2CoreBatchJobCreatedEvent, V2CoreBatchJobReadyForUploadEvent, V2CoreBatchJobTimeoutEvent, V2CoreBatchJobUpdatedEvent, V2CoreBatchJobUploadTimeoutEvent, V2CoreBatchJobValidatingEvent, and V2CoreBatchJobValidationFailedEvent with related object V2.Core.BatchJob
  • Add support for error code service_period_coupon_with_metered_tiered_item_unsupported on QuotePreviewInvoice.last_finalization_error
• #2608 Merge to beta
• #2597 Merge to beta
• #2592 Merge to beta

See the changelog for more details.

• #2628 Fix export for Stripe.Decimal in CJS and ESM. Resolves #2625

See the changelog for more details.

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

• #2623 Update generated code for private-preview
  • Add support for new resource RiskSignals
  • Add support for upi_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
  • Add support for risk_signals on Account
  • Add support for financial_account_rewards and nesting_demo on AccountSession.components
  • Add support for fraud_intent on AccountSignals
  • ⚠️ Add support for new value related_accounts on enum AccountSignals.delinquency.indicators[].indicator
  • Add support for risk_reserved on Balance
  • ⚠️ Remove support for billable_items on Billing.Alert.spend_threshold.filters
  • Add support for upi on Charge.payment_method_details, Checkout.Session.payment_method_options, Checkout.SessionCreateParams.payment_method_options, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.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, and SetupIntentUpdateParams.payment_method_options
  • ⚠️ Add support for new value tempo on enums Charge.payment_method_details.crypto.network, PaymentAttemptRecord.payment_method_details.crypto.network, and PaymentRecord.payment_method_details.crypto.network
  • ⚠️ Remove support for source_type on Charge.payment_method_details.stripe_balance, ConfirmationToken.payment_method_preview.stripe_balance, ConfirmationTokenCreateParams.testHelpers.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, and SetupIntentUpdateParams.payment_method_data.stripe_balance
  • Add support for integration_identifier on Checkout.SessionCreateParams and Checkout.Session
  • ⚠️ Add support for new value application on enums Checkout.Session.automatic_tax.liability.type, Checkout.Session.invoice_creation.invoice_data.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, Checkout.SessionUpdateParams.subscription_data.invoice_settings.issuer.type, Invoice.automatic_tax.liability.type, Invoice.issuer.type, InvoiceCreateParams.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, PaymentLink.automatic_tax.liability.type, PaymentLink.invoice_creation.invoice_data.issuer.type, PaymentLink.subscription_data.invoice_settings.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, Quote.automatic_tax.liability.type, Quote.invoice_settings.issuer.type, QuoteCreateParams.automatic_tax.liability.type, QuoteCreateParams.invoice_settings.issuer.type, QuotePreviewInvoice.automatic_tax.liability.type, QuotePreviewInvoice.issuer.type, QuotePreviewSubscriptionSchedule.default_settings.automatic_tax.liability.type, QuotePreviewSubscriptionSchedule.default_settings.invoice_settings.issuer.type, QuotePreviewSubscriptionSchedule.phases[].automatic_tax.liability.type, QuotePreviewSubscriptionSchedule.phases[].invoice_settings.issuer.type, QuoteUpdateParams.automatic_tax.liability.type, QuoteUpdateParams.invoice_settings.issuer.type, Subscription.automatic_tax.liability.type, Subscription.invoice_settings.issuer.type, SubscriptionCreateParams.automatic_tax.liability.type, SubscriptionCreateParams.invoice_settings.issuer.type, SubscriptionSchedule.default_settings.automatic_tax.liability.type, SubscriptionSchedule.default_settings.invoice_settings.issuer.type, SubscriptionSchedule.phases[].automatic_tax.liability.type, SubscriptionSchedule.phases[].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, and SubscriptionUpdateParams.invoice_settings.issuer.type
  • Add support for new value upi on enum Checkout.SessionCreateParams.excluded_payment_method_types
  • Change type of Checkout.SessionCreateParams.line_items[].price_data.product_data.tax_details.tax_code, Checkout.SessionUpdateParams.line_items[].price_data.product_data.tax_details.tax_code, InvoiceAddLinesParams.lines[].price_data.product_data.tax_details.tax_code, InvoiceLineItemUpdateParams.price_data.product_data.tax_details.tax_code, InvoiceUpdateLinesParams.lines[].price_data.product_data.tax_details.tax_code, PaymentLinkCreateParams.line_items[].price_data.product_data.tax_details.tax_code, PlanCreateParams.product[0].tax_details.tax_code, PriceCreateParams.product_data.tax_details.tax_code, ProductCreateParams.tax_details.tax_code, and ProductUpdateParams.tax_details.tax_code from string to emptyable(string)
  • Add support for crypto on Checkout.SessionCreateParams.payment_method_options
  • Add support for new value upi on enum Checkout.SessionCreateParams.payment_method_types
  • Add support for pending_invoice_item_interval on Checkout.SessionCreateParams.subscription_data and Checkout.SessionUpdateParams.subscription_data
  • ⚠️ Add support for new values elements, embedded_page, form, and hosted_page on enums Checkout.Session.ui_mode and Checkout.SessionCreateParams.ui_mode
  • ⚠️ Remove support for values custom, embedded, and hosted from enums Checkout.Session.ui_mode and Checkout.SessionCreateParams.ui_mode
  • Change Checkout.SessionCreateParams.line_items[].price_data.product_data.tax_details.tax_code, Checkout.SessionUpdateParams.line_items[].price_data.product_data.tax_details.tax_code, InvoiceAddLinesParams.lines[].price_data.product_data.tax_details.tax_code, InvoiceLineItemUpdateParams.price_data.product_data.tax_details.tax_code, InvoiceUpdateLinesParams.lines[].price_data.product_data.tax_details.tax_code, PaymentLinkCreateParams.line_items[].price_data.product_data.tax_details.tax_code, PlanCreateParams.product[0].tax_details.tax_code, PriceCreateParams.product_data.tax_details.tax_code, ProductCreateParams.tax_details.tax_code, and ProductUpdateParams.tax_details.tax_code to be optional
  • Add support for au_becs_debit, bacs_debit, boleto, link, sepa_debit, and us_bank_account on Checkout.Session.current_attempt.payment_method_details
  • ⚠️ Add support for new value marine_carbon_removal on enum Climate.Supplier.removal_pathway
  • Add support for new value upi on enums ConfirmationTokenCreateParams.testHelpers.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, and SetupIntentUpdateParams.payment_method_data.type
  • ⚠️ Add support for new value upi on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Add support for `m...

• #2626 Fix export for Stripe.Decimal in CJS and ESM. Resolves #2625

See the changelog for more details.

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

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

Note: we're releasing another major version very soon that overhauls and improves the package's structure and typescript types. That will also use 2026-03-25.dahlia as an API version and will mostly be a drop-in replacement.

• ⚠️ Breaking change: #2617 Add decimal_string support with vendored Decimal type
  • All decimal_string fields changed type from string to Stripe.Decimal in both request params and response objects. Code that reads or writes these fields as string will need to use Stripe.Decimal instead (construct via Decimal.from("1.23"), serialize via .toString()). Affected fields across v1 and v2 APIs:
    • Checkout.Session: currency_conversion.fx_rate
    • Climate.Order: metric_tons; Climate.Product: metric_tons_available
    • CreditNoteLineItem: unit_amount_decimal
    • InvoiceItem: quantity_decimal, unit_amount_decimal
    • InvoiceLineItem: quantity_decimal, unit_amount_decimal
    • Issuing.Authorization / Issuing.Transaction (and TestHelpers): quantity_decimal, unit_cost_decimal, gross_amount_decimal, local_amount_decimal, national_amount_decimal
    • Plan: amount_decimal, flat_amount_decimal, unit_amount_decimal
    • Price: unit_amount_decimal, flat_amount_decimal (including currency_options and tiers)
    • V2.Core.Account / V2.Core.AccountPerson: percent_ownership
    • Request params on Invoice, Product, Quote, Subscription, SubscriptionItem, SubscriptionSchedule, PaymentLink: unit_amount_decimal, flat_amount_decimal, quantity_decimal (where applicable)
• ⚠️ Breaking change: #2618#2616 Throw an error when using the wrong webhook parsing method
• ⚠️ Breaking change: #2604 Add new OAuth Error classes
• ⚠️ Breaking change: #2609 Drop support for Node 16
• #2612 add manual amount type
• #2600 Add runtime support for V2 int64 string-encoded fields

See the changelog for more details.

• #2605 Update generated code for private-preview
  • Add support for simulate_crypto_deposit test helper method on resource PaymentIntent
  • Add support for deposit_options and mode on PaymentIntent.payment_method_options.crypto, PaymentIntentConfirmParams.payment_method_options.crypto, PaymentIntentCreateParams.payment_method_options.crypto, and PaymentIntentUpdateParams.payment_method_options.crypto
  • Add support for crypto_display_details on PaymentIntent.next_action
• #2599 Update generated code for private-preview
  • Add support for new resources Orchestration.PaymentAttempt and Radar.CustomerEvaluation
  • Add support for retrieve method on resource Orchestration.PaymentAttempt
  • Add support for create and update methods on resource Radar.CustomerEvaluation
  • Add support for approve method on resource Checkout.Session
  • Add support for report_authenticated, report_canceled, report_failed, report_guaranteed, report_informational, and report_refund methods on resource PaymentAttemptRecord
  • Add support for create_us_paper_check_on_application on AccountSessionCreateParams.components.check_scanning.features
  • ⚠️ Change AccountSignals.delinquency to be optional
  • Add support for approval_method on Checkout.SessionCreateParams and Checkout.Session
  • Add support for current_attempt on Checkout.Session
  • Add support for selected_fulfillment_option_overrides on DelegatedCheckout.RequestedSessionUpdateParams.fulfillment_details
  • Add support for pricing_plan_subscription_details on InvoiceItem.parent and InvoiceLineItem.parent
  • ⚠️ Remove support for license_fee_subscription_details on InvoiceItem.parent and InvoiceLineItem.parent
  • ⚠️ Remove support for pricing_plan_subscription and pricing_plan_version on InvoiceItem.parent.rate_card_subscription_details and InvoiceLineItem.parent.rate_card_subscription_details
  • Add support for new value pricing_plan_subscription_details on enum InvoiceItem.parent.type
  • ⚠️ Remove support for value license_fee_subscription_details from enum InvoiceItem.parent.type
  • Add support for new value discounts on enum InvoiceItem.frozen_fields
  • Add support for new value pricing_plan_subscription_details on enum InvoiceLineItem.parent.type
  • ⚠️ Remove support for value license_fee_subscription_details from enum InvoiceLineItem.parent.type
  • Add support for token_details on Issuing.Authorization
  • Add support for failure_code on PaymentRecordReportPaymentAttemptFailedParams, PaymentRecordReportPaymentAttemptParams.failed, and PaymentRecordReportPaymentParams.failed
  • Change PaymentRecordReportPaymentAttemptCanceledParams.canceled_at to be optional
  • Change PaymentRecordReportPaymentAttemptFailedParams.failed_at to be optional
  • Change PaymentRecordReportPaymentAttemptGuaranteedParams.guaranteed_at to be optional
  • Change PaymentRecordReportRefundParams.refunded to be optional
  • ⚠️ Remove support for value now from enums QuoteCreateParams.subscription_data.billing_schedules[].bill_from.type, QuoteCreateParams.subscription_data_overrides[].billing_schedules[].bill_from.type, QuoteUpdateParams.subscription_data.billing_schedules[].bill_from.type, and QuoteUpdateParams.subscription_data_overrides[].billing_schedules[].bill_from.type
  • ⚠️ Change Radar.IssuingAuthorizationEvaluationCreateParams.card_details.bin_country to be required
  • Add support for recurring_interval on SharedPayment.GrantedTokenCreateParams.testHelpers.usage_limits
  • Change SharedPayment.GrantedTokenCreateParams.testHelpers.usage_limits.expires_at to be optional
  • Add support for home_rule_tax on Tax.Registration.country_options.us and Tax.RegistrationCreateParams.country_options.us
  • Add support for new value home_rule_tax on enums Tax.Registration.country_options.us.type and Tax.RegistrationCreateParams.country_options.us.type

See the changelog for more details.

• #2594 Update generated code for private-preview
  • Add support for new resource Radar.IssuingAuthorizationEvaluation
  • Add support for create method on resource Radar.IssuingAuthorizationEvaluation
  • Add support for new value fee_credits on enum BalanceTransaction.balance_type
  • ⚠️ Rename affiliate_attributions to affiliate_attribution on DelegatedCheckout.RequestedSessionConfirmParams and DelegatedCheckout.RequestedSessionCreateParams
  • Add support for amount_to_counter on Dispute
  • Add support for frozen_fields on InvoiceItem
  • Add support for new value next_billing_period_start on enums V2.Billing.IntentAction.apply.effective_at.type and V2.Billing.IntentCreateParams.actions[].apply.effective_at.type
  • Add support for consumer on V2.Core.Account.configuration.card_creator.capabilities, V2.Core.Account.identity.attestations.terms_of_service.card_creator, V2.Core.AccountCreateParams.configuration.card_creator.capabilities, V2.Core.AccountCreateParams.identity.attestations.terms_of_service.card_creator, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities, and V2.Core.AccountUpdateParams.identity.attestations.terms_of_service.card_creator
  • Add support for fifth_third on V2.Core.Account.configuration.card_creator.capabilities.commercial, V2.Core.Account.identity.attestations.terms_of_service.card_creator.commercial, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.commercial, V2.Core.AccountCreateParams.identity.attestations.terms_of_service.card_creator.commercial, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.commercial, and V2.Core.AccountUpdateParams.identity.attestations.terms_of_service.card_creator.commercial
  • Add support for prepaid_card on V2.Core.Account.configuration.card_creator.capabilities.commercial.cross_river_bank, V2.Core.Account.identity.attestations.terms_of_service.card_creator.commercial.cross_river_bank, V2.Core.AccountCreateParams.configuration.card_creator.capabilities.commercial.cross_river_bank, V2.Core.AccountCreateParams.identity.attestations.terms_of_service.card_creator.commercial.cross_river_bank, V2.Core.AccountUpdateParams.configuration.card_creator.capabilities.commercial.cross_river_bank, and V2.Core.AccountUpdateParams.identity.attestations.terms_of_service.card_creator.commercial.cross_river_bank
  • Add support for new values commercial.cross_river_bank.prepaid_card, commercial.fifth_third.charge_card, consumer.celtic.revolving_credit_card, consumer.cross_river_bank.prepaid_card, and consumer.lead.prepaid_card on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability
  • Add support for payment_method_data on V2.Payments.OffSessionPaymentCreateParams
  • Change V2.Payments.OffSessionPaymentCreateParams.payment_method to be optional
  • Add support for new values commercial.cross_river_bank.prepaid_card, commercial.fifth_third.charge_card, consumer.celtic.revolving_credit_card, consumer.cross_river_bank.prepaid_card, and consumer.lead.prepaid_card on enum EventsV2CoreAccountIncludingConfigurationCardCreatorCapabilityStatusUpdatedEvent.updated_capability

See the changelog for more details.

• #2590 Add Stripe-Request-Trigger header
• #2588 Add agent information to UserAgent

See the changelog for more details.

This release changes the pinned API version to 2026-03-04.preview.

• #2586 Update generated code for private-preview
  • Add support for new resources Billing.AlertRecovered and Profile
  • Add support for reauthorize method on resource PaymentIntent
  • Add support for smart_disputes on Account.settings, AccountCreateParams.settings, AccountUpdateParams.settings, V2.Core.Account.configuration.merchant, V2.Core.AccountCreateParams.configuration.merchant, and V2.Core.AccountUpdateParams.configuration.merchant
  • Add support for email_customers_on_successful_payment on Account.settings.payments, AccountCreateParams.settings.payments, and AccountUpdateParams.settings.payments
  • Add support for settings on QuoteLine.actions[].add_discount, QuoteLine.actions[].add_item.discounts[], QuoteLine.actions[].set_discounts[], QuoteLine.actions[].set_items[].discounts[], QuotePreviewSubscriptionSchedule.phases[].discounts[], QuotePreviewSubscriptionSchedule.phases[].items[].discounts[], SubscriptionSchedule.phases[].discounts[], and SubscriptionSchedule.phases[].items[].discounts[]
  • Add support for balance_update_details on Billing.CreditBalanceSummary.balances[]
  • Add support for reauthorization and reauthorize_before on Charge.payment_method_details.card_present, Charge.payment_method_details.card, ConfirmationToken.payment_method_preview.card.generated_from.payment_method_details.card_present, PaymentAttemptRecord.payment_method_details.card_present, PaymentMethod.card.generated_from.payment_method_details.card_present, and PaymentRecord.payment_method_details.card_present
  • Add support for location and reader on Charge.payment_method_details.card_present, Charge.payment_method_details.interac_present, ConfirmationToken.payment_method_preview.card.generated_from.payment_method_details.card_present, PaymentAttemptRecord.payment_method_details.card_present, PaymentAttemptRecord.payment_method_details.interac_present, PaymentMethod.card.generated_from.payment_method_details.card_present, PaymentRecord.payment_method_details.card_present, and PaymentRecord.payment_method_details.interac_present
  • Add support for managed_payments on Checkout.SessionCreateParams, Checkout.Session, PaymentIntent, SetupIntent, and Subscription
  • Add support for new value lk_vat on enums Checkout.Session.collected_information.tax_ids[].type, Checkout.Session.customer_details.tax_ids[].type, Invoice.customer_tax_ids[].type, Order.tax_details.tax_ids[].type, QuotePreviewInvoice.customer_tax_ids[].type, Tax.Calculation.customer_details.tax_ids[].type, Tax.Transaction.customer_details.tax_ids[].type, and TaxId.type
  • Add support for new value lk_vat on enums CustomerCreateParams.tax_id_data[].type, CustomerCreateTaxIdParams.type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, OrderCreateParams.tax_details.tax_ids[].type, OrderUpdateParams.tax_details.tax_ids[].type, Tax.CalculationCreateParams.customer_details.tax_ids[].type, and TaxIdCreateParams.type
  • Add support for digital on DelegatedCheckout.RequestedSession.fulfillment_details.fulfillment_options[], DelegatedCheckout.RequestedSession.fulfillment_details.selected_fulfillment_option, and DelegatedCheckout.RequestedSessionUpdateParams.fulfillment_details.selected_fulfillment_option
  • Change DelegatedCheckout.RequestedSessionUpdateParams.fulfillment_details.selected_fulfillment_option.shipping to be optional
  • Add support for affiliate_attributions on DelegatedCheckout.RequestedSessionConfirmParams, DelegatedCheckout.RequestedSessionCreateParams, and DelegatedCheckout.RequestedSession
  • Add support for fulfillment_type on DelegatedCheckout.RequestedSession.line_item_details[]
  • Add support for marketplace_seller_details, network_profile, privacy_notice_url, return_policy_url, store_policy_url, and terms_of_service_url on DelegatedCheckout.RequestedSession.seller_details
  • Add support for amount_to_counter on DisputeUpdateParams
  • Add support for new values reserve.hold.created, reserve.hold.updated, reserve.plan.created, reserve.plan.disabled, reserve.plan.expired, reserve.plan.updated, and reserve.release.created on enum Event.type
  • Add support for new values terminal_wifi_certificate and terminal_wifi_private_key on enums File.purpose and FileListParams.purpose
  • Add support for new values terminal_wifi_certificate and terminal_wifi_private_key on enum FileCreateParams.purpose
  • Add support for new value pay_by_bank on enums Invoice.payment_settings.payment_method_types, InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, QuotePreviewInvoice.payment_settings.payment_method_types, Subscription.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_types
  • Add support for display_name and service_user_number on Mandate.payment_method_details.bacs_debit
  • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.boleto.tax_id and PaymentRecord.payment_method_details.boleto.tax_id from string to string | null
  • Change type of PaymentAttemptRecord.payment_method_details.us_bank_account.expected_debit_date and PaymentRecord.payment_method_details.us_bank_account.expected_debit_date from string | null to string
  • Add support for request_reauthorization on PaymentIntent.payment_method_options.card_present, PaymentIntent.payment_method_options.card, PaymentIntentConfirmParams.payment_method_options.card_present, PaymentIntentConfirmParams.payment_method_options.card, PaymentIntentCreateParams.payment_method_options.card_present, PaymentIntentCreateParams.payment_method_options.card, PaymentIntentUpdateParams.payment_method_options.card_present, and PaymentIntentUpdateParams.payment_method_options.card
  • Add support for transaction_purpose on PaymentIntent.payment_method_options.us_bank_account, PaymentIntentConfirmParams.payment_method_options.us_bank_account, PaymentIntentCreateParams.payment_method_options.us_bank_account, and PaymentIntentUpdateParams.payment_method_options.us_bank_account
  • Add support for new value requires_reauthorization on enum PaymentIntent.status
  • Add support for optional_items on PaymentLinkUpdateParams
  • Add support for new value billing_schedules_invalid on enum Quote.status_details.stale.last_reason.type
  • ⚠️ Remove support for card_issuer_decline on Radar.PaymentEvaluation.insights
  • Add support for payment_behavior on SubscriptionItemDeleteParams
  • Add support for billing_cycle_anchor on Subscription.trial_settings.end_behavior
  • Add support for lk on Tax.Registration.country_options and Tax.RegistrationCreateParams.country_options
  • Add support for cellular and stripe_s710 on Terminal.ConfigurationCreateParams, Terminal.ConfigurationUpdateParams, and Terminal.Configuration
  • Add support for new values simulated_stripe_s710 and stripe_s710 on enums Terminal.Reader.device_type and Terminal.ReaderListParams.device_type
  • Add support for new values reserve.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 WebhookEndpointUpdateParams.enabled_events
  • Add support for new value 2026-02-25.clover on enum WebhookEndpointCreateParams.api_version
  • Add support for new values ar_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.recipient_data.default_outbound_destination.type and V2.Core.Account.configuration.recipient.default_outbound_destination.type
  • Add support for recipient_onboarding and recipient_update on V2.Core.AccountLink.use_case and V2.Core.AccountLinkCreateParams.use_case
  • Add support for new values recipient_onboarding and recipient_update on enums V2.Core.AccountLink.use_case.type and V2.Core.AccountLinkCreateParams.use_case.type
  • Add support for consumer on V2.Core.Account.configuration.storer.capabilities, V2.Core.AccountCreateParams.configuration.storer.capabilities, and V2.Core.AccountUpdateParams.configuration.storer.capabilities
  • Add support for new value consumer.holds_currencies.usd on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability
  • Add support for funds_usage_type on V2.MoneyManagement.FinancialAccount.storage and V2.MoneyManagement.FinancialAccountCreateParams.storage
  • Add support for purpose on V2.MoneyManagement.OutboundPaymentCreateParams and V2.MoneyManagement.OutboundPayment
  • Add support for branch_number and swift_code on V2.MoneyManagement.PayoutMethod.bank_account
  • Add support for new values dispute, 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.transaction_details.category
  • ⚠️ Remove support for values charge_failure and charge from enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.transaction_details.category
  • ⚠️ Change `V2.MoneyManagement.Transaction.flow...