stripe

Please review the changelog for 22.0.2 for more information about changes in this release.

See the changelog for more details.

Please review the changelog for 22.0.1 for more information about changes in this release.

See the changelog for more details.

Please review the changelog for 22.0.0 for more information about changes in this release.

See the changelog for more details.

• #2686 Update generated code for private-preview
  • Add support for latest_version on V2.Billing.LicenseFee, V2.Billing.PricingPlan, and V2.Billing.RateCard
  • Add support for service_interval_count and service_interval on V2.Billing.LicenseFee and V2.Billing.RateCard
• #2682 Update generated code for private-preview
  • Add support for new resources V2.Core.WorkflowRun and V2.Core.Workflow
  • Add support for report_authorized method on resource PaymentAttemptRecord
  • Add support for list and retrieve methods on resource V2.Core.WorkflowRun
  • Add support for invoke, list, and retrieve methods on resource V2.Core.Workflow
  • Add support for next_action and status on SharedPayment.IssuedToken
  • ⚠️ Remove support for network_id on SharedPayment.IssuedToken.seller_details
  • Add support for bills on AccountSession.components
  • Add support for settlement_currencies on BalanceSettingUpdateParams.payments and BalanceSettings.payments
  • Add support for default_settlement_currency on BalanceSettings.payments
  • Add support for account_funding on Charge.payment_method_details.card
  • Add support for automatic_surcharge on Checkout.SessionCreateParams, Checkout.Session, PaymentLinkCreateParams, and PaymentLink
  • Add support for bizum on Checkout.Session.payment_method_options and Checkout.SessionCreateParams.payment_method_options
  • Add support for surcharge_cost on Checkout.Session
  • Add support for amount_surcharge on Checkout.Session.total_details
  • Add support for shared_payment_granted_token on ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data
  • Add support for new value email on enums Identity.VerificationReportListParams.type, Identity.VerificationSessionCreateParams.type, and Identity.VerificationSessionUpdateParams.type
  • Add support for details on Identity.VerificationReport.email
  • ⚠️ Add support for new value email on enums Identity.VerificationReport.type and Identity.VerificationSession.type
  • Add support for confirm on Identity.VerificationSessionCreateParams and Identity.VerificationSessionUpdateParams
  • Add support for subscription on InvoiceItem.parent.schedule_details
  • ⚠️ Remove support for shared_payment_granted_token on PaymentIntentConfirmParams and PaymentIntentCreateParams
  • Add support for money_services on PaymentIntent.payment_details
  • ⚠️ Remove support for external_reference on Plan
  • Change SharedPayment.GrantedToken.payment_method_details.billing_details to be required

See the changelog for more details.

• #2657 Update generated code for private-preview
  • Add support for payment_record on ApplicationFee.fee_source
  • Add support for beneficiary_account, beneficiary_details, sender_account, and sender_details on ChargeCaptureParams.payment_details.money_services.account_funding, ChargeUpdateParams.payment_details.money_services.account_funding, PaymentIntentCaptureParams.payment_details.money_services.account_funding, PaymentIntentConfirmParams.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_details.money_services.account_funding, and PaymentIntentUpdateParams.payment_details.money_services.account_funding
  • Change type of ChargeCaptureParams.payment_details.money_services.transaction_type, ChargeUpdateParams.payment_details.money_services.transaction_type, PaymentIntentCaptureParams.payment_details.money_services.transaction_type, PaymentIntentConfirmParams.payment_details.money_services.transaction_type, PaymentIntentCreateParams.payment_details.money_services.transaction_type, and PaymentIntentUpdateParams.payment_details.money_services.transaction_type from literal('account_funding') to emptyable(literal('account_funding'))
  • Add support for bizum on Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, QuotePreviewInvoice.payment_settings.payment_method_options, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_options
  • ⚠️ Add support for new value bizum 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 quantity_precision on PaymentIntentAmountDetailsLineItem, PaymentIntentCaptureParams.amount_details.line_items[], PaymentIntentConfirmParams.amount_details.line_items[], PaymentIntentCreateParams.amount_details.line_items[], PaymentIntentDecrementAuthorizationParams.amount_details.line_items[], PaymentIntentIncrementAuthorizationParams.amount_details.line_items[], and PaymentIntentUpdateParams.amount_details.line_items[]
  • Add support for liquid_asset and wallet on PaymentIntentConfirmParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentConfirmParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentUpdateParams.payment_method_options.card.payment_details.money_services.account_funding, and PaymentIntentUpdateParams.payment_method_options.card_present.payment_details.money_services.account_funding
  • Add support for shared_payment_granted_token on PaymentMethod
  • ⚠️ Change type of Radar.CustomerEvaluation.event_type from string to enum('login'|'registration')
  • ⚠️ Change type of Radar.CustomerEvaluation.signals.account_sharing.risk_level and Radar.CustomerEvaluation.signals.multi_accounting.risk_level from string to enum
  • Add support for data on Radar.PaymentEvaluation.client_device_metadata_details and Radar.PaymentEvaluationCreateParams.client_device_metadata_details
  • Add support for sunbit on SharedPayment.GrantedToken.payment_method_details
  • ⚠️ Add support for new value sunbit on enum SharedPayment.GrantedToken.payment_method_details.type
  • ⚠️ Remove support for values bm_crn, bo_tin, bt_tpn, co_nit, ec_ruc, eg_tin, gh_tin, gy_tin, hn_rtn, jm_trn, jo_crn, ke_pin, ky_crn, lk_tin, mo_tin, mv_tin, ng_tin, pa_ruc, ph_tin, py_ruc, sl_tin, sv_nit, uy_ruc, vg_cn, and za_tin from enums V2.Core.Account.identity.business_details.id_numbers[].type, V2.Core.AccountCreateParams.identity.business_details.id_numbers[].type, V2.Core.AccountTokenCreateParams.identity.business_details.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.business_details.id_numbers[].type
  • ⚠️ Remove support for values bm_pp, bo_ci, bt_cid, eg_tin, gh_pin, gy_tin, hn_rtn, jm_trn, jo_pin, ky_pp, lk_nic, mo_bir, mt_nic, mv_tin, pa_ruc, ph_tin, py_ruc, si_pin, sv_nit, and vg_pp from enums V2.Core.Account.identity.individual.id_numbers[].type, V2.Core.AccountCreateParams.identity.individual.id_numbers[].type, V2.Core.AccountPerson.id_numbers[].type, V2.Core.AccountPersonCreateParams.id_numbers[].type, V2.Core.AccountPersonTokenCreateParams.id_numbers[].type, V2.Core.AccountPersonUpdateParams.id_numbers[].type, V2.Core.AccountTokenCreateParams.identity.individual.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.individual.id_numbers[].type
  • Add support for error type CannotProceedError

See the changelog for more details.

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

• #2629 Update generated code for private-preview
  • Add support for new resources SharedPayment.IssuedToken and V2.Data.Reporting.QueryRun
  • Add support for create and retrieve methods on resource V2.Data.Reporting.QueryRun
  • Add support for pause and resume methods on resource V2.Payments.OffSessionPayment
  • Add support for tenant_keys, tenant_operator, and tenant_values on Billing.MeterListMeterEventSummariesParams
  • Add support for fleet_data on ChargeCaptureParams.payment_details, ChargeUpdateParams.payment_details, PaymentIntent.payment_details, PaymentIntentAmountDetailsLineItem.payment_method_options.card, PaymentIntentCaptureParams.amount_details.line_items[].payment_method_options.card, PaymentIntentCaptureParams.payment_details, PaymentIntentConfirmParams.amount_details.line_items[].payment_method_options.card, PaymentIntentConfirmParams.payment_details, PaymentIntentCreateParams.amount_details.line_items[].payment_method_options.card, PaymentIntentCreateParams.payment_details, PaymentIntentDecrementAuthorizationParams.amount_details.line_items[].payment_method_options.card, PaymentIntentIncrementAuthorizationParams.amount_details.line_items[].payment_method_options.card, PaymentIntentUpdateParams.amount_details.line_items[].payment_method_options.card, and PaymentIntentUpdateParams.payment_details
  • Add support for money_services on ChargeCaptureParams.payment_details, ChargeUpdateParams.payment_details, PaymentIntentCaptureParams.payment_details, PaymentIntentConfirmParams.payment_details, PaymentIntentCreateParams.payment_details, and PaymentIntentUpdateParams.payment_details
  • Add support for payment_method_options on DelegatedCheckout.RequestedSessionCreateParams, DelegatedCheckout.RequestedSessionUpdateParams, and DelegatedCheckout.RequestedSession
  • ⚠️ Remove support for payment_method_data on DelegatedCheckout.RequestedSessionConfirmParams, DelegatedCheckout.RequestedSessionCreateParams, and DelegatedCheckout.RequestedSessionUpdateParams
  • Add support for card_brands and payment_method_types on DelegatedCheckout.RequestedSession.seller_details
  • ⚠️ Change type of DelegatedCheckout.RequestedSession.shared_payment_issued_token from string to expandable(SharedPayment.IssuedToken)
  • ⚠️ Add support for new value requires_action on enum DelegatedCheckout.RequestedSession.status
  • Add support for check_scan on Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, QuotePreviewInvoice.payment_settings.payment_method_options, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_options
  • ⚠️ Add support for new value check_scan 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 processor_details on PaymentAttemptRecordReportFailedParams, PaymentAttemptRecordReportGuaranteedParams, PaymentRecordReportPaymentAttemptFailedParams, PaymentRecordReportPaymentAttemptGuaranteedParams, PaymentRecordReportPaymentAttemptParams.failed, PaymentRecordReportPaymentAttemptParams.guaranteed, PaymentRecordReportPaymentParams.failed, and PaymentRecordReportPaymentParams.guaranteed
  • Add support for payment_details on 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
  • ⚠️ Remove support for bill_from on QuotePreviewSubscriptionSchedule.billing_schedules[], Subscription.billing_schedules[], and SubscriptionSchedule.billing_schedules[]
  • Add support for agent_details, payment_method_details, and risk_details on SharedPayment.GrantedToken
  • Add support for paper_checks on V2.Account.configuration.recipient_data.features, V2.AccountCreateParams.configuration.recipient_data.features, V2.AccountUpdateParams.configuration.recipient_data.features, V2.Core.Account.configuration.recipient.capabilities, V2.Core.Account.configuration.storer.capabilities.outbound_payments, V2.Core.AccountCreateParams.configuration.recipient.capabilities, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_payments, V2.Core.AccountUpdateParams.configuration.recipient.capabilities, and V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_payments
  • ⚠️ Add support for new value paper_checks on enum V2.Account.configuration.supportable_features.recipient_data
  • ⚠️ Add support for new value paper_checks on enum V2.Account.requirements[].impact.required_for_features
  • ⚠️ Change type of V2.Billing.Cadence.settings_data.collection.payment_method_options.konbini, V2.Billing.CollectionSetting.payment_method_options.konbini, V2.Billing.CollectionSettingCreateParams.payment_method_options.konbini, V2.Billing.CollectionSettingUpdateParams.payment_method_options.konbini, and V2.Billing.CollectionSettingVersion.payment_method_options.konbini from map(string: dynamic) to an object
  • ⚠️ Change type of V2.Billing.Cadence.settings_data.collection.payment_method_options.sepa_debit, V2.Billing.CollectionSetting.payment_method_options.sepa_debit, V2.Billing.CollectionSettingCreateParams.payment_method_options.sepa_debit, V2.Billing.CollectionSettingUpdateParams.payment_method_options.sepa_debit, and V2.Billing.CollectionSettingVersion.payment_method_options.sepa_debit from map(string: dynamic) to an object
  • Add support for id on V2.Billing.CadenceSpendModifier.max_billing_period_spend.amount.custom_pricing_unit, V2.Billing.IntentAction.apply.spend_modifier_rule.max_billing_period_spend.amount.custom_pricing_unit, and V2.Billing.IntentCreateParams.actions[].apply.spend_modifier_rule.max_billing_period_spend.amount.custom_pricing_unit
  • ⚠️ Add support for new values outbound_payments.paper_checks and paper_checks 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 new values bm_crn, bo_tin, bt_tpn, co_nit, ec_ruc, eg_tin, gh_tin, gy_tin, hn_rtn, jm_trn, jo_crn, ke_pin, ky_crn, lk_tin, mo_tin, mv_tin, ng_tin, pa_ruc, ph_tin, py_ruc, sl_tin, sv_nit, uy_ruc, vg_cn, and za_tin on enums V2.Core.Account.identity.business_details.id_numbers[].type, V2.Core.AccountCreateParams.identity.business_details.id_numbers[].type, V2.Core.AccountTokenCreateParams.identity.business_details.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.business_details.id_numbers[].type
  • ⚠️ Add support for new values bm_pp, bo_ci, bt_cid, eg_tin, gh_pin, gy_tin, hn_rtn, jm_trn, jo_pin, ky_pp, lk_nic, mo_bir, mt_nic, mv_tin, pa_ruc, ph_tin, py_ruc, si_pin, sv_nit, and vg_pp on enums V2.Core.Account.identity.individual.id_numbers[].type, V2.Core.AccountCreateParams.identity.individual.id_numbers[].type, V2.Core.AccountPerson.id_numbers[].type, V2.Core.AccountPersonCreateParams.id_numbers[].type, V2.Core.AccountPersonTokenCreateParams.id_numbers[].type, V2.Core.AccountPersonUpdateParams.id_numbers[].type, V2.Core.AccountTokenCreateParams.identity.individual.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.individual.id_numbers[].type
  • ⚠️ Change type of V2.Core.Event.reason.request.client.stripe_action from map(string: dynamic) to an object
  • ⚠️ Change type of V2.MoneyManagement.InboundTransfer.transfer_history[].bank_debit_processing from map(string: dynamic) to an object
  • ⚠️ Change type of V2.MoneyManagement.InboundTransfer.transfer_history[].bank_debit_queued from map(string: dynamic) to an object
  • ⚠️ Change type of V2.MoneyManagement.InboundTransfer.transfer_history[].bank_debit_succeeded from map(string: dynamic) to an object
  • ⚠️ Add support for new values paper_check_attachment_too_large, paper_check_expired, and paper_check_undeliverable on enum V2.MoneyManagement.OutboundPayment.status_details.failed.reason
  • ⚠️ Remove support for town on V2.MoneyManagement.OutboundPayment.tracking_details.paper_check.mailing_address
  • Change V2.MoneyManagement.OutboundPayment.delivery_options.paper_check.memo to be required
  • ⚠️ Add support for new value payout_method_amount_limit_exceeded on enum V2.MoneyManagement.OutboundTransfer.status_details.failed.reason
  • Add support for application_fee_amount_requested on V2.Payments.OffSessionPayment
  • ⚠️ Remove support for compartment_id on V2.Payments.OffSessionPayment
  • ⚠️ Add support for new value exceeded_retry_window on enum V2.Payments.OffSessionPayment.failure_reason
  • Add support for retry_until on V2.Payments.OffSessionPayment.retry_details
  • ⚠️ Add support for new value paused on enum V2.Payments.OffSessionPayment.status
  • ⚠️ Change V2.Reporting.ReportRun.result.file to be optional
  • Add support for application_fee_amount on V2.Payments.OffSessionPaymentCaptureParams and V2.Payments.OffSessionPaymentCreateParams
  • ⚠️ Add support for new value paper_checks on enum EventsV2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent.updated_capability
  • ⚠️ Add support for new value outbound_payments.paper_checks on enum EventsV2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent.updated_capability
  • Add support for alert_id on EventsV2CoreHealthApiErrorResolvedEvent, EventsV2CoreHealthApiLatencyResolvedEvent, EventsV2CoreHealthAuthorizationRateDropResolvedEvent, EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent, EventsV2CoreHealthPaymentMethodErrorResolvedEvent, EventsV2CoreHealthSepaDebitDelayedFiringEvent, EventsV2CoreHealthSepaDebitDelayedResolvedEvent, EventsV2CoreHealthTrafficVolumeDropResolvedEvent, and EventsV2CoreHealthWebhookLatencyResolvedEvent
  • Add support for api_key on EventsV2IamApiKeyCreatedEvent, EventsV2IamApiKeyDefaultSecretRevealedEvent, EventsV2IamApiKeyExpiredEvent, EventsV2IamApiKeyPermissionsUpdatedEvent, EventsV2IamApiKeyRotatedEvent, and EventsV2IamApiKeyUpdatedEvent
  • Add support for stripe_access_grant on EventsV2IamStripeAccessGrantApprovedEvent, EventsV2IamStripeAccessGrantCanceledEvent, EventsV2IamStripeAccessGrantDeniedEvent, EventsV2IamStripeAccessGrantRemovedEvent, EventsV2IamStripeAccessGrantRequestedEvent, and EventsV2IamStripeAccessGrantUpdatedEvent
  • Add support for event notifications V2DataReportingQueryRunCreatedEvent, V2DataReportingQueryRunFailedEvent, V2DataReportingQueryRunSucceededEvent, and V2DataReportingQueryRunUpdatedEvent with related object V2.Data.Reporting.QueryRun
  • Add support for event notifications V2PaymentsOffSessionPaymentPausedEvent and V2PaymentsOffSessionPaymentResumedEvent with related object V2.Payments.OffSessionPayment
• #2647 Merge to private-preview
• #2641 Merge to private-preview
• #2636 Prathmesh/merge node private preview

See the changelog for more details.

• #2685 Adds parseEventNotificationAsync to match existing sync function
• #2681 Add emitEventBodies config to include bodies in request/response events
  • Added emitEventBodies config option to include request and response bodies in request/response events.
  • Changed httpClient config type from HttpClient class to HttpClientInterface interface.
• #2670 tolerance, receivedAt, timestamp are now optional in Webhook.ts
• #2677 Fixed named export for Bun

  // ✅ Fixed
  import { Stripe } from 'stripe';
  

See the changelog for more details.

• #2669 Add constructor based initialization for CJS based TypeScript imports
  • Initialization of Stripe class with new keyword is now possible for CJS based TypeScript project. Resolves: 2660

  import Stripe = require('stripe');
  // ✅ Both statements work
  const stripeNew: Stripe.Stripe = new Stripe('sk_test_...');
  const stripeCalled: Stripe.Stripe = Stripe('sk_test_...');
  

• #2664 Fixed nested service param exports in the Stripe namespace
  • Resolves: 2658, 2662
• #2667 Add type safety to Stripe constructor config (no runtime change)
  • Fixed some compile-time checks (no runtime changes)
    • Fixed Stripe constructor config parameter to use StripeConfig type instead of Record<string, unknown>, restoring compile-time type safety.
    • Added missing authenticator property to StripeConfig.
    • Fixed Stripe.API_VERSION to retain the literal API version type.
    • Fixed StripeConfig.stripeContext to accept StripeContext objects in addition to strings.
• #2663 Throw a more descriptive error when calling rawRequest with absolute urls
• #2652 Added string[] to WebhookHeader type for compatibility with express
  • Added string[] to the type of signature param in stripe.webhooks.construct_event method.

See the changelog for more details.

This release uses the same pinned API version to 2026-03-25.dahlia as the last major release. The breaking changes in this release are prefixed with ⚠️ below. There's also a detailed migration guide to simplify your upgrade process.

• #2619 Improved TypeScript support in the Node SDK
  • Moved the types from the partially manually maintained and partially generated types folder to be inline with the implementation in TypeScript files.
  • Removed top-level “stripe” ambient module. This allows import aliasing for the stripe package.
  • ⚠️ Stripe.StripeContext is no longer exported as a type. Use Stripe.StripeContextType instead.
  • ⚠️ Stripe.errors.StripeError is no longer a type. Use typeof Stripe.errors.StripeError or Stripe.ErrorType instead.
  • ⚠️ CJS entry point no longer exports .default or .Stripe as separate properties.
  • ⚠️ Stripe import is now a true ES6 class. Use new Stripe() to create a StripeClient instead of calling it:

// Before
const stripeClient = Stripe("sk_test_...");

// After
const stripeClient = new Stripe("sk_test_...");

• #2645 ⚠️ Remove stripeMethod and standardize how function args are handled (including removing callback support)

  • ⚠️ Refactor how incoming method arguments are parsed. Type signatures for API methods should be much more accurate and reliable now
    • ⚠️ Remove support for providing callbacks to API methods. Use async / await instead
    • ⚠️ Remove support for passing a plain API key as a function arg. If supplied on a per-request basis, it should be in the RequestOptions under the apiKey property
    • ⚠️ Keys from params and options objects are no longer mixed. If present on a method, RequestParams must always come first and RequestOptions must always come second. To supply options without params, pass undefined as the first argument explicitly
    • ⚠️ Removed methods from StripeResource: createFullPath, createResourcePathWithSymbols, extend, method and _joinUrlParts. These were mostly intended for internal use and we no longer need them

  As a result, the following call patterns are no longer supported:

  stripe.customers.retrieve('cus_123', 'sk_test_123')
  stripe.customers.create({name: 'david', host: 'example.com'}, 'sk_test_123')
  stripe.customers.create({apiKey: 'sk_test_123'})
  stripe.customers.list(customers => {
    // do something with customers
  })
  

• #2643 ⚠️ Removed per-request host override. To use a custom host, set it in the client configuration. All requests from that client will use that host.

  Before:

  import Stripe from 'stripe';
  const stripe = new Stripe('sk_test_...');
  
  const customer = await stripe.customers.create({
    email: 'customer@example.com',
  }, {host: 'example.com'});
  

  After:

  import Stripe from 'stripe';
  const stripe = new Stripe('sk_test_...', {host: 'example.com'});
  
  // goes to example.com
  const customer = await stripe.customers.create({
    email: 'customer@example.com',
  });
  

• #2638 Converted V2/Amount.ts to V2/V2Amount.ts

See the changelog for more details.

• #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 metadata on CreditNoteCreateParams.lines[], CreditNoteLineItem, CreditNotePreviewLinesParams.lines[], and CreditNotePreviewParams.lines[]
  • Add support for new value upi on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for selected_fulfillment_option_overrides on DelegatedCheckout.RequestedSession.fulfillment_details
  • Add support for line_item_keys on DelegatedCheckout.RequestedSession.fulfillment_details.fulfillment_options[].digital.digital_options[] and DelegatedCheckout.RequestedSession.fulfillment_details.fulfillment_options[].shipping.shipping_options[]
  • Add support for quantity_decimal on InvoiceAddLinesParams.lines[], InvoiceCreatePreviewParams.invoice_items[], InvoiceItemCreateParams, InvoiceItemUpdateParams, InvoiceItem, InvoiceLineItemUpdateParams, InvoiceLineItem, and InvoiceUpdateLinesParams.lines[]
  • 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 level on Issuing.AuthorizationCreateParams.testHelpers.risk_assessment.card_testing_risk and Issuing.AuthorizationCreateParams.testHelpers.risk_assessment.merchant_dispute_risk
  • ⚠️ Remove support for risk_level on Issuing.AuthorizationCreateParams.testHelpers.risk_assessment.card_testing_risk and Issuing.AuthorizationCreateParams.testHelpers.risk_assessment.merchant_dispute_risk
  • ⚠️ Add support for new values da, pl, and sv on enums Issuing.Cardholder.preferred_locales, Issuing.CardholderCreateParams.preferred_locales, and Issuing.CardholderUpdateParams.preferred_locales
  • Add support for lifecycle_controls on Issuing.CardCreateParams and Issuing.Card
  • ⚠️ Change type of Issuing.Token.network_data.visa.card_reference_id from string to string | null
  • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.brand and PaymentRecord.payment_method_details.card.brand from enum to enum | null
  • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.exp_month and PaymentRecord.payment_method_details.card.exp_month from longInteger to longInteger | null
  • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.exp_year and PaymentRecord.payment_method_details.card.exp_year from longInteger to longInteger | null
  • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.funding and PaymentRecord.payment_method_details.card.funding from enum('credit'|'debit'|'prepaid'|'unknown') to enum('credit'|'debit'|'prepaid'|'unknown') | null
  • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.last4 and PaymentRecord.payment_method_details.card.last4 from string to string | null
  • ⚠️ Change type of PaymentAttemptRecord.payment_method_details.card.moto and PaymentRecord.payment_method_details.card.moto from boolean to boolean | null
  • Add support for cryptogram, electronic_commerce_indicator, exemption_indicator_applied, and exemption_indicator on PaymentAttemptRecord.payment_method_details.card.three_d_secure and PaymentRecord.payment_method_details.card.three_d_secure
  • 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 new value upi on enums PaymentIntent.excluded_payment_method_types, PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentUpdateParams.excluded_payment_method_types, SetupIntent.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, and SetupIntentUpdateParams.excluded_payment_method_types
  • Add support for mandate_options on PaymentIntent.payment_method_options.stripe_balance, PaymentIntentConfirmParams.payment_method_options.stripe_balance, PaymentIntentCreateParams.payment_method_options.stripe_balance, and PaymentIntentUpdateParams.payment_method_options.stripe_balance
  • Add support for amount_details and payment_details on PaymentIntentDecrementAuthorizationParams
  • Add support for upi_handle_redirect_or_display_qr_code on PaymentIntent.next_action and SetupIntent.next_action
  • Add support for managed_payments on PaymentLinkCreateParams and PaymentLink
  • ⚠️ Add support for new value upi on enums PaymentLink.payment_method_types, PaymentLinkCreateParams.payment_method_types, and PaymentLinkUpdateParams.payment_method_types
  • Add support for recommended_action and signals on Radar.PaymentEvaluation
  • ⚠️ Remove support for insights on Radar.PaymentEvaluation
  • ⚠️ Add support for new value crypto_fingerprint on enums Radar.ValueList.item_type and Radar.ValueListCreateParams.item_type
  • 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 new value resolved on enum SharedPayment.GrantedToken.deactivated_reason
  • Add support for recurring_interval on SharedPayment.GrantedToken.usage_limits
  • ⚠️ Change type of SharedPayment.GrantedToken.usage_limits.expires_at from DateTime to DateTime | null
  • Add support for presentment_details on Subscription
  • ⚠️ Add support for new value canceled_by_retention_policy on enum Subscription.cancellation_details.reason
  • Add support for new value 2026-03-25.dahlia on enum WebhookEndpointCreateParams.api_version
  • ⚠️ Remove support for invoice_resources on V2.Billing.Intent
  • ⚠️ Remove support for amount_due and customer_balance_applied on V2.Billing.Intent.amount_details
  • Add support for recurring_credit_grant on V2.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[], and V2.Billing.IntentCreateParams.actions[].subscribe.pricing_plan_subscription_details.overrides.partial_period_behaviors[]
  • Add support for consumer_privacy_disclosures and consumer_storer on V2.Core.Account.identity.attestations.terms_of_service, V2.Core.AccountCreateParams.identity.attestations.terms_of_service, and V2.Core.AccountUpdateParams.identity.attestations.terms_of_service
  • ⚠️ Remove support for include on V2.Billing.IntentCreateParams and V2.Billing.IntentReserveParams
  • Add support for error code service_period_coupon_with_metered_tiered_item_unsupported on Invoice.last_finalization_error, PaymentIntent.last_payment_error, QuotePreviewInvoice.last_finalization_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError
• #2607 Update generated code for private-preview
  • Add support for new resource V2.Core.AccountEvaluation
  • ⚠️ Remove support for resources V2.Billing.LicenseFeeSubscription and V2.Billing.PricingPlanSubscriptionComponents
  • Add support for create method on resource V2.Core.AccountEvaluation
  • ⚠️ Remove support for retrieve method on resources V2.Billing.LicenseFeeSubscription and V2.Billing.PricingPlanSubscriptionComponents
  • Add support for modify_rates method on resource V2.Billing.RateCard
  • Add support for remove_discounts method on resource V2.Billing.PricingPlanSubscription
  • ⚠️ Add support for new value eg_bank_account on enum V2.Account.configuration.recipient_data.default_outbound_destination.type
  • Add support for invoice_resources on V2.Billing.Intent
  • Add support for amount_due and customer_balance_applied on V2.Billing.Intent.amount_details
  • Add support for expires_at on V2.Billing.Intent.status_transitions
  • Add support for discount on V2.Billing.IntentAction.apply and V2.Billing.IntentCreateParams.actions[].apply
  • Add support for timestamp on V2.Billing.IntentAction.apply.effective_at and V2.Billing.IntentCreateParams.actions[].apply.effective_at
  • ⚠️ Add support for new values current_billing_period_start and timestamp on enums V2.Billing.IntentAction.apply.effective_at.type and V2.Billing.IntentCreateParams.actions[].apply.effective_at.type
  • ⚠️ Add support for new value discount on enums V2.Billing.IntentAction.apply.type and V2.Billing.IntentCreateParams.actions[].apply.type
  • ⚠️ 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, and V2.Billing.IntentCreateParams.actions[].subscribe.pricing_plan_subscription_details.overrides.partial_period_behaviors[].type from literal('license_fee') to enum('license_fee'|'recurring_credit_grant')
  • Add support for service_cycle on V2.Billing.LicenseFee and V2.Billing.RateCard
  • ⚠️ Remove support for latest_version on V2.Billing.LicenseFee, V2.Billing.PricingPlan, and V2.Billing.RateCard
  • ⚠️ Remove support for service_interval_count and service_interval on V2.Billing.LicenseFee and V2.Billing.RateCard
  • ⚠️ Change type of V2.Billing.LicenseFee.transform_quantity.divide_by, V2.Billing.LicenseFeeCreateParams.transform_quantity.divide_by, V2.Billing.LicenseFeeUpdateParams.transform_quantity.divide_by, V2.Billing.LicenseFeeVersion.transform_quantity.divide_by, V2.Billing.RateCardRate.transform_quantity.divide_by, and V2.Billing.RateCardRateCreateParams.transform_quantity.divide_by from longInteger to int64_string
  • Add support for discount_details and pricing_plan_component_details on V2.Billing.PricingPlanSubscription
  • ⚠️ Add support for new value crypto_wallets on enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability
  • ⚠️ Remove support for value crypto from enums V2.Core.Account.future_requirements.entries[].impact.restricts_capabilities[].capability and V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability
  • Add support for balance_by_funds_type on V2.MoneyManagement.FinancialAccount.payments
  • ⚠️ Add support for new value next_day_payout_fee on enum V2.MoneyManagement.OutboundPaymentQuote.estimated_fees[].type
  • Add support for treasury_transaction_entry on V2.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, and treasury_received_debit on V2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.transaction_details.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, and treasury_received_debit on enums V2.MoneyManagement.Transaction.flow.type and V2.MoneyManagement.TransactionEntry.transaction_details.flow.type
  • Add support for treasury_transaction on V2.MoneyManagement.Transaction
  • ⚠️ Add support for new value no_valid_payment_method on enum V2.Payments.OffSessionPayment.failure_reason
  • Add support for metadata on V2.Payments.SettlementAllocationIntentSplit
  • ⚠️ Change type of V2.Reporting.ReportRun.result.file.size from longInteger to int64_string
  • Add support for statement_descriptor on V2.MoneyManagement.OutboundPaymentCreateParams and V2.MoneyManagement.OutboundTransferCreateParams
  • Add support for include on V2.Billing.IntentCreateParams, V2.Billing.IntentReserveParams, V2.Billing.PricingPlanSubscriptionListParams, V2.Billing.PricingPlanSubscriptionRetrieveParams, V2.MoneyManagement.FinancialAccountListParams, and V2.MoneyManagement.FinancialAccountRetrieveParams
  • Add support for event notifications V1AccountSignalsIncludingDelinquencyCreatedEvent, V2CoreAccountSignalsFraudulentWebsiteReadyEvent, and V2SignalsAccountSignalFraudulentMerchantReadyEvent
• #2613 Merge to private-preview

See the changelog for more details.

• #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.

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 and V2.MoneyManagement.TransactionEntry.transaction_details.flow to be optional
  • Add support for new value consumer.holds_currencies.usd on enum EventsV2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent.updated_capability
  • Add support for snapshot event BillingAlertRecoveredEvent with resource Billing.AlertRecovered
  • Add support for snapshot events ReserveHoldCreatedEvent and ReserveHoldUpdatedEvent with resource Reserve.Hold
  • Add support for snapshot events ReservePlanCreatedEvent, ReservePlanDisabledEvent, ReservePlanExpiredEvent, and ReservePlanUpdatedEvent with resource Reserve.Plan
  • Add support for snapshot event ReserveReleaseCreatedEvent with resource Reserve.Release
  • Add support for event notification V2BillingRateCardCustomPricingUnitOverageRateCreatedEvent with related object V2.Billing.RateCardCustomPricingUnitOverageRate
  • Add support for event notifications V2IamStripeAccessGrantApprovedEvent, V2IamStripeAccessGrantCanceledEvent, V2IamStripeAccessGrantDeniedEvent, V2IamStripeAccessGrantRemovedEvent, V2IamStripeAccessGrantRequestedEvent, and V2IamStripeAccessGrantUpdatedEvent
  • Add support for error codes storer_capability_missing and storer_capability_not_active on Invoice.last_finalization_error, PaymentIntent.last_payment_error, QuotePreviewInvoice.last_finalization_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError

See the changelog for more details.

This release changes the pinned API version to 2026-02-25.preview.

• #2578 Update generated code for private-preview
  • Add support for new resource AccountSignals
  • Add support for retrieve method on resource AccountSignals
  • Add support for aggregation_period, group_by, and triggered_at on Billing.AlertTriggered
  • Add support for external_account_collection on AccountLinkCreateParams.collection_options
  • Add support for funding_source on ApplicationFee
  • Change DelegatedCheckout.RequestedSessionConfirmParams.payment_method_data.billing_details.address.line1, DelegatedCheckout.RequestedSessionCreateParams.fulfillment_details.address.line1, DelegatedCheckout.RequestedSessionCreateParams.payment_method_data.billing_details.address.line1, DelegatedCheckout.RequestedSessionUpdateParams.fulfillment_details.address.line1, and DelegatedCheckout.RequestedSessionUpdateParams.payment_method_data.billing_details.address.line1 to be optional
  • Add support for hosted and ui_mode on FinancialConnections.SessionCreateParams and FinancialConnections.Session
  • Add support for url on FinancialConnections.Session
  • Add support for billing_cycle_anchor on SubscriptionCreateParams.trial_settings.end_behavior and SubscriptionUpdateParams.trial_settings.end_behavior

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-02-25.clover.

• #2581 Update generated code
  • Add support for new resources Reserve.Hold, Reserve.Plan, and Reserve.Release
  • 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 new value lk_vat on enums Checkout.Session.customer_details.tax_ids[].type, Invoice.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, Tax.CalculationCreateParams.customer_details.tax_ids[].type, and TaxIdCreateParams.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 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, 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 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 optional_items on PaymentLinkUpdateParams
  • Remove support for unused card_issuer_decline on Radar.PaymentEvaluation.insights
  • Add support for payment_behavior on SubscriptionItemDeleteParams
  • 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 snapshot events ReserveHoldCreatedEvent and ReserveHoldUpdatedEvent with resource Reserve.Hold
  • Add support for snapshot events ReservePlanCreatedEvent, ReservePlanDisabledEvent, ReservePlanExpiredEvent, and ReservePlanUpdatedEvent with resource Reserve.Plan
  • Add support for snapshot event ReserveReleaseCreatedEvent with resource Reserve.Release
  • Add support for error codes storer_capability_missing and storer_capability_not_active on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError

See the changelog for more details.

• #2571 Fix UnhandledPromiseRejection error on failed V2 List operations
  • Fixes a bug where any error returned from the Stripe API on a V2 List call (e.g. a 4xx or 5xx) would crash Node due to an UnhandledPromiseRejection

See the changelog for more details.

This release changes the pinned API version to 2026-01-28.preview.

• #2552 Update generated code for beta
  • Add support for new resource FinancialConnections.Authorization
  • Add support for retrieve method on resource FinancialConnections.Authorization
  • Add support for detach_payment method on resource Invoice
  • Remove support for cancel, list_line_items, and reopen methods on resource Order
  • Remove support for attach_cadence method on resource Subscription
  • Add support for additional_files and site on Account.settings.paypay_payments, AccountCreateParams.settings.paypay_payments, and AccountUpdateParams.settings.paypay_payments
  • Remove support for capital on Account.settings
  • Change type of Charge.payment_method_details.stripe_balance.source_type, ConfirmationToken.payment_method_preview.stripe_balance.source_type, PaymentAttemptRecord.payment_method_details.stripe_balance.source_type, PaymentMethod.stripe_balance.source_type, and PaymentRecord.payment_method_details.stripe_balance.source_type from enum('bank_account'|'card'|'fpx') to enum('bank_account'|'card'|'fpx') | null
  • Add support for new value pl_nip on enums Checkout.Session.collected_information.tax_ids[].type, Order.tax_details.tax_ids[].type, and QuotePreviewInvoice.customer_tax_ids[].type
  • Add support for new value capital.financing_summary.line_of_credit_update on enum Event.type
  • Add support for authorization and status_details on FinancialConnections.Account
  • Add support for relink_options on FinancialConnections.SessionCreateParams and FinancialConnections.Session
  • Change FinancialConnections.SessionCreateParams.account_holder to be optional
  • Add support for relink_result on FinancialConnections.Session
  • Remove support for billing_cadence on InvoiceCreatePreviewParams, SubscriptionCreateParams, SubscriptionUpdateParams, and Subscription
  • Remove support for billing_cadence_details on Invoice.parent and QuotePreviewInvoice.parent
  • Remove support for value billing_cadence_details from enums Invoice.parent.type and QuotePreviewInvoice.parent.type
  • Add support for new value pl_nip on enums OrderCreateParams.tax_details.tax_ids[].type and OrderUpdateParams.tax_details.tax_ids[].type
  • Add support for car_rental_data, flight_data, and lodging_data on PaymentIntent.payment_details
  • Change QuotePreviewInvoice.payment_settings.payment_method_options.payto to be required
  • Add support for new value capital.financing_summary.line_of_credit_update on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_events
  • Add support for new values ae_bank_account, ag_bank_account, bh_bank_account, gm_bank_account, hk_bank_account, kh_bank_account, lc_bank_account, mc_bank_account, mg_bank_account, my_bank_account, qa_bank_account, rw_bank_account, th_bank_account, tt_bank_account, and vn_bank_account on enum V2.Core.Account.configuration.recipient.default_outbound_destination.type
  • Add support for alternative_reference on V2.Core.Vault.GbBankAccount, V2.Core.Vault.UsBankAccount, and V2.MoneyManagement.PayoutMethod
  • Add support for account_holder_address and account_holder_name on V2.MoneyManagement.FinancialAddress.credentials.us_bank_account
  • Add support for fingerprint on V2.MoneyManagement.PayoutMethod.card
  • Add support for snapshot event InvoicePaymentDetachedEvent with resource InvoicePayment
  • Add support for error code request_blocked on QuotePreviewInvoice.last_finalization_error
  • Add support for error codes blocked_payout_method and unsupported_payout_method on BlockedByStripeError
  • Add support for error code invalid_payout_method_data on InvalidPayoutMethodError
  • Add support for error code limit_payout_method on QuotaExceededError

See the changelog for more details.

• #2574 Update generated code for private-preview
  • ⚠️ Add support for new value spend_threshold on enums Billing.Alert.alert_type, Billing.AlertCreateParams.alert_type, and Billing.AlertListParams.alert_type
  • Add support for spend_threshold on Billing.AlertCreateParams and Billing.Alert
  • Add support for invoice_item, proration_details, proration, and subscription on InvoiceLineItem.parent.schedule_details
  • Add support for custom on PaymentMethodUpdateParams
  • Add support for payment_method_reference and usage on PaymentMethod.custom
  • Add support for outstanding_usage_through and unused_time_from on SubscriptionPauseParams.bill_for
  • ⚠️ Remove support for outstanding_usage and unused_time on SubscriptionPauseParams.bill_for
  • ⚠️ Remove support for payment_behavior on SubscriptionResumeParams

See the changelog for more details.

• #2572 Update generated code for private-preview
  • Add support for new resources V2.Billing.CadenceSpendModifier, V2.Billing.OneTimeItem, and V2.Billing.RateCardCustomPricingUnitOverageRate
  • Add support for create, del, list, and retrieve methods on resource V2.Billing.RateCardCustomPricingUnitOverageRate
  • Add support for create, list, retrieve, and update methods on resource V2.Billing.OneTimeItem
  • Add support for retrieve method on resource V2.Billing.CadenceSpendModifier
  • Change EventsV2CoreHealthFraudRateIncreasedEvent.impact.realized_fraud_amount.value, EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent.impact.approved_amount.value, EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent.impact.declined_amount.value, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent.impact.approved_amount.value, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent.impact.declined_amount.value, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent.impact.approved_amount.value, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent.impact.declined_amount.value, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent.impact.approved_amount.value, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent.impact.declined_amount.value, V2.Billing.ServiceAction.credit_grant.amount.monetary.value, V2.Billing.ServiceAction.credit_grant_per_tenant.amount.monetary.value, V2.Billing.ServiceActionCreateParams.credit_grant.amount.monetary.value, V2.Billing.ServiceActionCreateParams.credit_grant_per_tenant.amount.monetary.value, V2.Core.Account.identity.business_details.annual_revenue.amount.value, V2.Core.Account.identity.business_details.monthly_estimated_revenue.amount.value, V2.Core.AccountCreateParams.identity.business_details.annual_revenue.amount.value, V2.Core.AccountCreateParams.identity.business_details.monthly_estimated_revenue.amount.value, V2.Core.AccountTokenCreateParams.identity.business_details.annual_revenue.amount.value, V2.Core.AccountTokenCreateParams.identity.business_details.monthly_estimated_revenue.amount.value, V2.Core.AccountUpdateParams.identity.business_details.annual_revenue.amount.value, V2.Core.AccountUpdateParams.identity.business_details.monthly_estimated_revenue.amount.value, V2.FinancialAddressCreditSimulationCreditParams.amount.value, V2.FinancialAddressGeneratedMicrodeposits.amounts[].value, V2.MoneyManagement.Adjustment.amount.value, V2.MoneyManagement.CurrencyConversion.from.amount.value, V2.MoneyManagement.CurrencyConversion.to.amount.value, V2.MoneyManagement.CurrencyConversionCreateParams.from.amount.value, V2.MoneyManagement.CurrencyConversionCreateParams.to.amount.value, V2.MoneyManagement.FinancialAccount.balance.available.value.value, V2.MoneyManagement.FinancialAccount.balance.inbound_pending.value.value, V2.MoneyManagement.FinancialAccount.balance.outbound_pending.value.value, V2.MoneyManagement.FinancialAccount.payments.starting_balance.available.value.value, V2.MoneyManagement.InboundTransfer.amount.value, V2.MoneyManagement.InboundTransfer.from.debited.value, V2.MoneyManagement.InboundTransfer.to.credited.value, V2.MoneyManagement.InboundTransferCreateParams.amount.value, V2.MoneyManagement.OutboundPayment.amount.value, V2.MoneyManagement.OutboundPayment.from.debited.value, V2.MoneyManagement.OutboundPayment.to.credited.value, V2.MoneyManagement.OutboundPaymentCreateParams.amount.value, V2.MoneyManagement.OutboundPaymentQuote.amount.value, V2.MoneyManagement.OutboundPaymentQuote.estimated_fees[].amount.value, V2.MoneyManagement.OutboundPaymentQuote.from.debited.value, V2.MoneyManagement.OutboundPaymentQuote.to.credited.value, V2.MoneyManagement.OutboundPaymentQuoteCreateParams.amount.value, V2.MoneyManagement.OutboundTransfer.amount.value, V2.MoneyManagement.OutboundTransfer.from.debited.value, V2.MoneyManagement.OutboundTransfer.to.credited.value, V2.MoneyManagement.OutboundTransferCreateParams.amount.value, V2.MoneyManagement.ReceivedCredit.amount.value, V2.MoneyManagement.ReceivedCredit.external_amount.value, V2.MoneyManagement.ReceivedDebit.amount.value, V2.MoneyManagement.ReceivedDebit.card_spend.authorization.amount.value, V2.MoneyManagement.ReceivedDebit.card_spend.card_transactions[].amount.value, V2.MoneyManagement.ReceivedDebit.external_amount.value, V2.MoneyManagement.Transaction.amount.value, V2.MoneyManagement.Transaction.balance_impact.available.value, V2.MoneyManagement.Transaction.balance_impact.inbound_pending.value, V2.MoneyManagement.Transaction.balance_impact.outbound_pending.value, V2.MoneyManagement.TransactionEntry.balance_impact.available.value, V2.MoneyManagement.TransactionEntry.balance_impact.inbound_pending.value, V2.MoneyManagement.TransactionEntry.balance_impact.outbound_pending.value, V2.Payments.OffSessionPayment.amount_capturable.value, V2.Payments.OffSessionPayment.amount_requested.value, V2.Payments.OffSessionPaymentCreateParams.amount.value, V2.Payments.SettlementAllocationIntent.amount.value, V2.Payments.SettlementAllocationIntentCreateParams.amount.value, V2.Payments.SettlementAllocationIntentSplit.amount.value, V2.Payments.SettlementAllocationIntentSplitCreateParams.amount.value, and V2.Payments.SettlementAllocationIntentUpdateParams.amount.value to be required
  • Change EventsV2CoreHealthFraudRateIncreasedEvent.impact.realized_fraud_amount.currency, EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent.impact.approved_amount.currency, EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent.impact.declined_amount.currency, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent.impact.approved_amount.currency, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent.impact.declined_amount.currency, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent.impact.approved_amount.currency, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent.impact.declined_amount.currency, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent.impact.approved_amount.currency, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent.impact.declined_amount.currency, V2.Billing.ServiceAction.credit_grant.amount.monetary.currency, V2.Billing.ServiceAction.credit_grant_per_tenant.amount.monetary.currency, V2.Billing.ServiceActionCreateParams.credit_grant.amount.monetary.currency, V2.Billing.ServiceActionCreateParams.credit_grant_per_tenant.amount.monetary.currency, V2.Core.Account.identity.business_details.annual_revenue.amount.currency, V2.Core.Account.identity.business_details.monthly_estimated_revenue.amount.currency, V2.Core.AccountCreateParams.identity.business_details.annual_revenue.amount.currency, V2.Core.AccountCreateParams.identity.business_details.monthly_estimated_revenue.amount.currency, V2.Core.AccountTokenCreateParams.identity.business_details.annual_revenue.amount.currency, V2.Core.AccountTokenCreateParams.identity.business_details.monthly_estimated_revenue.amount.currency, V2.Core.AccountUpdateParams.identity.business_details.annual_revenue.amount.currency, V2.Core.AccountUpdateParams.identity.business_details.monthly_estimated_revenue.amount.currency, V2.FinancialAddressCreditSimulationCreditParams.amount.currency, V2.FinancialAddressGeneratedMicrodeposits.amounts[].currency, V2.MoneyManagement.Adjustment.amount.currency, V2.MoneyManagement.CurrencyConversion.from.amount.currency, V2.MoneyManagement.CurrencyConversion.to.amount.currency, V2.MoneyManagement.CurrencyConversionCreateParams.from.amount.currency, V2.MoneyManagement.CurrencyConversionCreateParams.to.amount.currency, V2.MoneyManagement.FinancialAccount.balance.available.value.currency, V2.MoneyManagement.FinancialAccount.balance.inbound_pending.value.currency, V2.MoneyManagement.FinancialAccount.balance.outbound_pending.value.currency, V2.MoneyManagement.FinancialAccount.payments.starting_balance.available.value.currency, V2.MoneyManagement.InboundTransfer.amount.currency, V2.MoneyManagement.InboundTransfer.from.debited.currency, V2.MoneyManagement.InboundTransfer.to.credited.currency, V2.MoneyManagement.InboundTransferCreateParams.amount.currency, V2.MoneyManagement.OutboundPayment.amount.currency, V2.MoneyManagement.OutboundPayment.from.debited.currency, V2.MoneyManagement.OutboundPayment.to.credited.currency, V2.MoneyManagement.OutboundPaymentCreateParams.amount.currency, V2.MoneyManagement.OutboundPaymentQuote.amount.currency, V2.MoneyManagement.OutboundPaymentQuote.estimated_fees[].amount.currency, V2.MoneyManagement.OutboundPaymentQuote.from.debited.currency, V2.MoneyManagement.OutboundPaymentQuote.to.credited.currency, V2.MoneyManagement.OutboundPaymentQuoteCreateParams.amount.currency, V2.MoneyManagement.OutboundTransfer.amount.currency, V2.MoneyManagement.OutboundTransfer.from.debited.currency, V2.MoneyManagement.OutboundTransfer.to.credited.currency, V2.MoneyManagement.OutboundTransferCreateParams.amount.currency, V2.MoneyManagement.ReceivedCredit.amount.currency, V2.MoneyManagement.ReceivedCredit.external_amount.currency, V2.MoneyManagement.ReceivedDebit.amount.currency, V2.MoneyManagement.ReceivedDebit.card_spend.authorization.amount.currency, V2.MoneyManagement.ReceivedDebit.card_spend.card_transactions[].amount.currency, V2.MoneyManagement.ReceivedDebit.external_amount.currency, V2.MoneyManagement.Transaction.amount.currency, V2.MoneyManagement.Transaction.balance_impact.available.currency, V2.MoneyManagement.Transaction.balance_impact.inbound_pending.currency, V2.MoneyManagement.Transaction.balance_impact.outbound_pending.currency, V2.MoneyManagement.TransactionEntry.balance_impact.available.currency, V2.MoneyManagement.TransactionEntry.balance_impact.inbound_pending.currency, V2.MoneyManagement.TransactionEntry.balance_impact.outbound_pending.currency, V2.Payments.OffSessionPayment.amount_capturable.currency, V2.Payments.OffSessionPayment.amount_requested.currency, V2.Payments.OffSessionPaymentCreateParams.amount.currency, V2.Payments.SettlementAllocationIntent.amount.currency, V2.Payments.SettlementAllocationIntentCreateParams.amount.currency, V2.Payments.SettlementAllocationIntentSplit.amount.currency, V2.Payments.SettlementAllocationIntentSplitCreateParams.amount.currency, and V2.Payments.SettlementAllocationIntentUpdateParams.amount.currency to be required
  • Add support for settlement_type on ApplicationFee
  • Add support for rate_card_custom_pricing_unit_overage_rate_details on InvoiceItem.pricing and InvoiceLineItem.pricing
  • Add support for new value rate_card_custom_pricing_unit_overage_rate_details on enums InvoiceItem.pricing.type and InvoiceLineItem.pricing.type
  • Add support for default_settings on InvoiceCreatePreviewParams.schedule_details
  • Change type of QuoteUpdateParams.subscription_data_overrides[].billing_schedules from emptyable(array(billing_schedules_update_specs)) to array(billing_schedules_update_specs)
  • Add support for payment_behavior on SubscriptionResumeParams
  • Add support for effective_at and spend_modifier_rule on V2.Billing.IntentAction.apply, V2.Billing.IntentAction.remove, V2.Billing.IntentCreateParams.actions[].apply, and V2.Billing.IntentCreateParams.actions[].remove
  • Change type of V2.Billing.IntentAction.apply.type, V2.Billing.IntentAction.remove.type, V2.Billing.IntentCreateParams.actions[].apply.type, and V2.Billing.IntentCreateParams.actions[].remove.type from literal('invoice_discount_rule') to enum('invoice_discount_rule'|'spend_modifier_rule')

See the changelog for more details.

• #2567 Update generated code for private-preview
  • Add support for new resource V2.Core.ConnectionSession
  • Add support for create and retrieve methods on resource V2.Core.ConnectionSession
  • Add support for list method on resources V2.Payments.SettlementAllocationIntentSplit and V2.Payments.SettlementAllocationIntent
  • Add support for agentic_commerce_settings on AccountSessionCreateParams.components
  • Add support for terminal_hardware_orders and terminal_hardware_shop on AccountSession.components and AccountSessionCreateParams.components
  • Add support for network_cost_passthrough_report on AccountSession.components
  • Add support for new values ae_bank_account, ag_bank_account, bh_bank_account, gm_bank_account, hk_bank_account, kh_bank_account, lc_bank_account, mc_bank_account, mg_bank_account, my_bank_account, qa_bank_account, rw_bank_account, th_bank_account, tt_bank_account, and vn_bank_account on enums V2.Account.configuration.recipient_data.default_outbound_destination.type and V2.Core.Account.configuration.recipient.default_outbound_destination.type
  • Add support for cadence_data on V2.Billing.IntentCreateParams and V2.Billing.Intent
  • Add support for cancellation_details on V2.Billing.IntentAction.deactivate, V2.Billing.IntentCreateParams.actions[].deactivate, and V2.Billing.PricingPlanSubscription
  • Add support for contact_phone on V2.Core.AccountCreateParams, V2.Core.AccountTokenCreateParams, V2.Core.AccountUpdateParams, and V2.Core.Account
  • Add support for registration_date on V2.Core.Account.identity.business_details, V2.Core.AccountCreateParams.identity.business_details, V2.Core.AccountTokenCreateParams.identity.business_details, and V2.Core.AccountUpdateParams.identity.business_details
  • Add support for new value gb_vat on enums V2.Core.Account.identity.business_details.id_numbers[].type, V2.Core.AccountCreateParams.identity.business_details.id_numbers[].type, V2.Core.AccountTokenCreateParams.identity.business_details.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.business_details.id_numbers[].type
  • Add support for reference on V2.MoneyManagement.Adjustment
  • Add support for accrued_fees on V2.MoneyManagement.FinancialAccount
  • Add support for starting_balance on V2.MoneyManagement.FinancialAccount.payments
  • Add support for new value accrued_fees on enum V2.MoneyManagement.FinancialAccount.type
  • Add support for account_holder_address and account_holder_name on V2.MoneyManagement.FinancialAddress.credentials.us_bank_account
  • Add support for fingerprint on V2.MoneyManagement.PayoutMethod.card
  • Add support for card_spend on V2.MoneyManagement.ReceivedCredit and V2.MoneyManagement.ReceivedDebit
  • Add support for new value card_spend on enum V2.MoneyManagement.ReceivedCredit.type
  • Add support for new value card_spend on enum V2.MoneyManagement.ReceivedDebit.type
  • Add support for new values advance, anticipation_repayment, balance_transfer, charge_failure, charge, climate_order_purchase, climate_order_refund, connect_collection_transfer, connect_reserved_funds, contribution, dispute_reversal, financing_paydown_reversal, financing_paydown, inbound_transfer_reversal, issuing_dispute_fraud_liability_debit, issuing_dispute_provisional_credit_reversal, issuing_dispute_provisional_credit, issuing_dispute, minimum_balance_hold, network_cost, obligation, outbound_payment_reversal, outbound_transfer_reversal, partial_capture_reversal, payment_network_reserved_funds, platform_earning_refund, platform_earning, platform_fee, received_credit_reversal, received_debit_reversal, refund_failure, risk_reserved_funds, stripe_balance_payment_debit_reversal, stripe_balance_payment_debit, stripe_fee_tax, transfer_reversal, and unreconciled_customer_funds on enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.transaction_details.category
  • Add support for application_fee_refund, application_fee, charge, dispute, payout, refund, reserve_hold, reserve_release, topup, transfer_reversal, and transfer on V2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.transaction_details.flow
  • Add support for new values application_fee_refund, application_fee, charge, dispute, payout, refund, reserve_hold, reserve_release, topup, transfer_reversal, and transfer on enums V2.MoneyManagement.Transaction.flow.type and V2.MoneyManagement.TransactionEntry.transaction_details.flow.type
  • Change V2.Payments.SettlementAllocationIntentSplit.flow to be optional
  • Add support for new value accrued_fees on enum V2.MoneyManagement.FinancialAccountListParams.types
  • Change V2.Billing.RateCardRateCreateParams.metered_item to be required
  • Add support for error codes blocked_payout_method and unsupported_payout_method on BlockedByStripeError
  • Add support for error code invalid_payout_method_data on InvalidPayoutMethodError
  • Add support for error code limit_payout_method on QuotaExceededError

See the changelog for more details.

This release changes the pinned API version to 2026-01-28.preview.

• #2565 Update generated code for private-preview
  • Add support for new resources FrMealVouchersOnboarding, Reserve.Hold, Reserve.Plan, and Reserve.Release
  • Add support for create, list, retrieve, and update methods on resource FrMealVouchersOnboarding
  • Add support for list and retrieve methods on resources Reserve.Hold and Reserve.Release
  • Add support for retrieve method on resource Reserve.Plan
  • Add support for pause method on resource Subscription
  • Add support for service_period_details on Discount
  • Add support for agentic_commerce_settings on AccountSession.components
  • Add support for new value risk_reserved on enum BalanceTransaction.balance_type
  • Add support for new value service_period on enums Checkout.SessionCreateParams.discounts[].coupon_data.duration, Checkout.SessionUpdateParams.discounts[].coupon_data.duration, Coupon.duration, and CouponCreateParams.duration
  • Add support for service_period on CouponCreateParams and Coupon
  • Change type of InvoiceItem.pricing.price_details.price and InvoiceLineItem.pricing.price_details.price from string to expandable(Price)
  • Add support for settings on InvoiceCreatePreviewParams.discounts[], InvoiceCreatePreviewParams.schedule_details.amendments[].discount_actions[].add, InvoiceCreatePreviewParams.schedule_details.amendments[].discount_actions[].set, InvoiceCreatePreviewParams.schedule_details.amendments[].item_actions[].add.discounts[], InvoiceCreatePreviewParams.schedule_details.amendments[].item_actions[].set.discounts[], InvoiceCreatePreviewParams.schedule_details.phases[].discounts[], InvoiceCreatePreviewParams.schedule_details.phases[].items[].discounts[], InvoiceCreatePreviewParams.subscription_details.items[].discounts[], QuoteCreateParams.lines[].actions[].add_discount, QuoteCreateParams.lines[].actions[].add_item.discounts[], QuoteCreateParams.lines[].actions[].set_discounts[], QuoteCreateParams.lines[].actions[].set_items[].discounts[], QuoteUpdateParams.lines[].actions[].add_discount, QuoteUpdateParams.lines[].actions[].add_item.discounts[], QuoteUpdateParams.lines[].actions[].set_discounts[], QuoteUpdateParams.lines[].actions[].set_items[].discounts[], SubscriptionCreateParams.discounts[], SubscriptionCreateParams.items[].discounts[], SubscriptionItemCreateParams.discounts[], SubscriptionItemUpdateParams.discounts[], SubscriptionScheduleAmendParams.amendments[].discount_actions[].add, SubscriptionScheduleAmendParams.amendments[].discount_actions[].set, SubscriptionScheduleAmendParams.amendments[].item_actions[].add.discounts[], SubscriptionScheduleAmendParams.amendments[].item_actions[].set.discounts[], SubscriptionScheduleCreateParams.phases[].discounts[], SubscriptionScheduleCreateParams.phases[].items[].discounts[], SubscriptionScheduleUpdateParams.phases[].discounts[], SubscriptionScheduleUpdateParams.phases[].items[].discounts[], SubscriptionUpdateParams.discounts[], and SubscriptionUpdateParams.items[].discounts[]
  • Add support for subtotal on InvoiceLineItem
  • Add support for billing_cadence on SubscriptionListParams

See the changelog for more details.

• #2571 Fix UnhandledPromiseRejection error on failed V2 List operations
  • Fixes a bug where any error returned from the Stripe API on a V2 List call (e.g. a 4xx or 5xx) would crash Node due to an UnhandledPromiseRejection

See the changelog for more details.

This release changes the pinned API version to 2026-01-28.clover.

• #2564 Update generated code
  • Add support for new resource Radar.PaymentEvaluation
  • Add support for create method on resource Radar.PaymentEvaluation
  • Add support for adjustable_quantity on LineItem
  • Add support for new value risk_reserved on enum BalanceTransaction.balance_type
  • Add support for new values reserve_hold and reserve_release on enum BalanceTransaction.type
  • Add support for new values 2.3.0 and 2.3.1 on enums Charge.payment_method_details.card.three_d_secure.version, PaymentIntentConfirmParams.payment_method_options.card.three_d_secure.version, PaymentIntentCreateParams.payment_method_options.card.three_d_secure.version, PaymentIntentUpdateParams.payment_method_options.card.three_d_secure.version, SetupAttempt.payment_method_details.card.three_d_secure.version, SetupIntentConfirmParams.payment_method_options.card.three_d_secure.version, SetupIntentCreateParams.payment_method_options.card.three_d_secure.version, and SetupIntentUpdateParams.payment_method_options.card.three_d_secure.version
  • Add support for new value adyen on enums Charge.payment_method_details.ideal.bank, ConfirmationToken.payment_method_preview.ideal.bank, ConfirmationTokenCreateParams.testHelpers.payment_method_data.ideal.bank, PaymentAttemptRecord.payment_method_details.ideal.bank, PaymentIntentConfirmParams.payment_method_data.ideal.bank, PaymentIntentCreateParams.payment_method_data.ideal.bank, PaymentIntentUpdateParams.payment_method_data.ideal.bank, PaymentMethod.ideal.bank, PaymentMethodCreateParams.ideal.bank, PaymentRecord.payment_method_details.ideal.bank, SetupAttempt.payment_method_details.ideal.bank, SetupIntentConfirmParams.payment_method_data.ideal.bank, SetupIntentCreateParams.payment_method_data.ideal.bank, and SetupIntentUpdateParams.payment_method_data.ideal.bank
  • Add support for new value ADYBNL2A on enums Charge.payment_method_details.ideal.bic, ConfirmationToken.payment_method_preview.ideal.bic, PaymentAttemptRecord.payment_method_details.ideal.bic, PaymentMethod.ideal.bic, PaymentRecord.payment_method_details.ideal.bic, and SetupAttempt.payment_method_details.ideal.bic
  • Add support for new value pl_nip on enums Checkout.Session.customer_details.tax_ids[].type, Invoice.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 pl_nip on enums CustomerCreateParams.tax_id_data[].type, CustomerCreateTaxIdParams.type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, Tax.CalculationCreateParams.customer_details.tax_ids[].type, and TaxIdCreateParams.type
  • Change Invoice.payment_settings.payment_method_options.payto and Subscription.payment_settings.payment_method_options.payto to be required
  • Add support for enforce_arithmetic_validation on PaymentIntentCaptureParams.amount_details, PaymentIntentConfirmParams.amount_details, PaymentIntentCreateParams.amount_details, PaymentIntentIncrementAuthorizationParams.amount_details, and PaymentIntentUpdateParams.amount_details
  • Add support for error on PaymentIntent.amount_details
  • Remove support for bgn on Terminal.Configuration.tipping, Terminal.ConfigurationCreateParams.tipping, and Terminal.ConfigurationUpdateParams.tipping
  • Add support for topup on Treasury.ReceivedDebit.linked_flows
  • Add support for contact_phone on V2.Core.AccountCreateParams, V2.Core.AccountTokenCreateParams, V2.Core.AccountUpdateParams, and V2.Core.Account
  • Add support for registration_date on V2.Core.Account.identity.business_details, V2.Core.AccountCreateParams.identity.business_details, V2.Core.AccountTokenCreateParams.identity.business_details, and V2.Core.AccountUpdateParams.identity.business_details
  • Add support for new value gb_vat on enums V2.Core.Account.identity.business_details.id_numbers[].type, V2.Core.AccountCreateParams.identity.business_details.id_numbers[].type, V2.Core.AccountTokenCreateParams.identity.business_details.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.business_details.id_numbers[].type
  • Add support for error code request_blocked on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError
• #2558 Remove qs dependency
  • Remove the qs dependency, addressing Issue #2117.
• #2562 Document usage of undocumented API parameters

See the changelog for more details.

• #2559 Update generated code for private-preview
  • Remove support for pause method on resource Subscription
  • Change type of Quote.subscription_data.phase_effective_at and Quote.subscription_data_overrides[].phase_effective_at from enum('billing_period_start'|'phase_start') to enum('billing_period_start'|'phase_start') | null

See the changelog for more details.

• #2551 Update generated code
  • Add support for event notifications V2CoreAccountClosedEvent, V2CoreAccountCreatedEvent, V2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent, V2CoreAccountIncludingConfigurationCustomerUpdatedEvent, V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent, V2CoreAccountIncludingConfigurationMerchantUpdatedEvent, V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent, V2CoreAccountIncludingConfigurationRecipientUpdatedEvent, V2CoreAccountIncludingDefaultsUpdatedEvent, V2CoreAccountIncludingFutureRequirementsUpdatedEvent, V2CoreAccountIncludingIdentityUpdatedEvent, V2CoreAccountIncludingRequirementsUpdatedEvent, and V2CoreAccountUpdatedEvent with related object V2.Core.Account
  • Add support for event notification V2CoreAccountLinkReturnedEvent
  • Add support for event notifications V2CoreAccountPersonCreatedEvent, V2CoreAccountPersonDeletedEvent, and V2CoreAccountPersonUpdatedEvent with related object V2.Core.AccountPerson

See the changelog for more details.

This release is purely for pulling in fixes from the releases 20.1.1 and 20.1.2 into the public preview release.

See the changelog for more details.

This release changes the pinned API version to 2025-12-15.preview.

• #2498 Add EventNotificationHandler
• #2509 Update generated code for beta
  • Add support for new resources Reserve.Hold, Reserve.Plan, and Reserve.Release
  • Add support for list and retrieve methods on resources Reserve.Hold and Reserve.Release
  • Add support for retrieve method on resource Reserve.Plan
  • Change Billing.CreditBalanceSummary.customer_account, Billing.CreditGrant.customer_account, BillingPortal.Session.customer_account, CashBalance.customer_account, Checkout.Session.customer_account, ConfirmationToken.payment_method_preview.customer_account, CreditNote.customer_account, CustomerBalanceTransaction.customer_account, CustomerCashBalanceTransaction.customer_account, CustomerSession.customer_account, Discount.customer_account, Invoice.customer_account, InvoiceItem.customer_account, PaymentIntent.customer_account, PaymentMethod.customer_account, PromotionCode.customer_account, Quote.customer_account, QuotePreviewInvoice.customer_account, QuotePreviewSubscriptionSchedule.customer_account, SetupAttempt.customer_account, Subscription.customer_account, SubscriptionSchedule.customer_account, TaxId.customer_account, and TaxId.owner.customer_account to be required
  • Change type of V2.FinancialAddressGeneratedMicrodeposits.amounts from amount to an object
  • Change type of Checkout.SessionCreateParams.payment_method_options.payto.mandate_options.amount, PaymentIntentConfirmParams.payment_method_options.payto.mandate_options.amount, PaymentIntentCreateParams.payment_method_options.payto.mandate_options.amount, PaymentIntentUpdateParams.payment_method_options.payto.mandate_options.amount, SetupIntentConfirmParams.payment_method_options.payto.mandate_options.amount, SetupIntentCreateParams.payment_method_options.payto.mandate_options.amount, and SetupIntentUpdateParams.payment_method_options.payto.mandate_options.amount from longInteger to emptyable(longInteger)
  • Change type of Checkout.SessionCreateParams.payment_method_options.payto.mandate_options.amount_type, PaymentIntentConfirmParams.payment_method_options.payto.mandate_options.amount_type, PaymentIntentCreateParams.payment_method_options.payto.mandate_options.amount_type, PaymentIntentUpdateParams.payment_method_options.payto.mandate_options.amount_type, SetupIntentConfirmParams.payment_method_options.payto.mandate_options.amount_type, SetupIntentCreateParams.payment_method_options.payto.mandate_options.amount_type, and SetupIntentUpdateParams.payment_method_options.payto.mandate_options.amount_type from enum('fixed'|'maximum') to emptyable(enum('fixed'|'maximum'))
  • Change type of Checkout.SessionCreateParams.payment_method_options.payto.mandate_options.end_date, PaymentIntentConfirmParams.payment_method_options.payto.mandate_options.end_date, PaymentIntentCreateParams.payment_method_options.payto.mandate_options.end_date, PaymentIntentUpdateParams.payment_method_options.payto.mandate_options.end_date, SetupIntentConfirmParams.payment_method_options.payto.mandate_options.end_date, SetupIntentCreateParams.payment_method_options.payto.mandate_options.end_date, and SetupIntentUpdateParams.payment_method_options.payto.mandate_options.end_date from string to emptyable(string)
  • Change type of Checkout.SessionCreateParams.payment_method_options.payto.mandate_options.payment_schedule, PaymentIntentConfirmParams.payment_method_options.payto.mandate_options.payment_schedule, PaymentIntentCreateParams.payment_method_options.payto.mandate_options.payment_schedule, PaymentIntentUpdateParams.payment_method_options.payto.mandate_options.payment_schedule, SetupIntentConfirmParams.payment_method_options.payto.mandate_options.payment_schedule, SetupIntentCreateParams.payment_method_options.payto.mandate_options.payment_schedule, and SetupIntentUpdateParams.payment_method_options.payto.mandate_options.payment_schedule from enum to emptyable(enum)
  • Change type of Checkout.SessionCreateParams.payment_method_options.payto.mandate_options.payments_per_period, PaymentIntentConfirmParams.payment_method_options.payto.mandate_options.payments_per_period, PaymentIntentCreateParams.payment_method_options.payto.mandate_options.payments_per_period, PaymentIntentUpdateParams.payment_method_options.payto.mandate_options.payments_per_period, SetupIntentConfirmParams.payment_method_options.payto.mandate_options.payments_per_period, SetupIntentCreateParams.payment_method_options.payto.mandate_options.payments_per_period, and SetupIntentUpdateParams.payment_method_options.payto.mandate_options.payments_per_period from longInteger to emptyable(longInteger)
  • Change type of Checkout.SessionCreateParams.payment_method_options.payto.mandate_options.purpose, PaymentIntentConfirmParams.payment_method_options.payto.mandate_options.purpose, PaymentIntentCreateParams.payment_method_options.payto.mandate_options.purpose, PaymentIntentUpdateParams.payment_method_options.payto.mandate_options.purpose, SetupIntentConfirmParams.payment_method_options.payto.mandate_options.purpose, SetupIntentCreateParams.payment_method_options.payto.mandate_options.purpose, and SetupIntentUpdateParams.payment_method_options.payto.mandate_options.purpose from enum to emptyable(enum)
  • Change type of Checkout.SessionCreateParams.payment_method_options.payto.mandate_options.start_date, SetupIntentConfirmParams.payment_method_options.payto.mandate_options.start_date, SetupIntentCreateParams.payment_method_options.payto.mandate_options.start_date, and SetupIntentUpdateParams.payment_method_options.payto.mandate_options.start_date from string to emptyable(string)
  • Change Identity.VerificationSession.related_customer_account to be required
  • Add support for async_workflows on PaymentIntent
  • Add support for payto on QuotePreviewInvoice.payment_settings.payment_method_options
  • Add support for new value payto on enum QuotePreviewInvoice.payment_settings.payment_method_types
  • Remove support for requested on V2.Core.Account.configuration.customer.capabilities.automatic_indirect_tax, V2.Core.Account.configuration.merchant.capabilities.ach_debit_payments, V2.Core.Account.configuration.merchant.capabilities.acss_debit_payments, V2.Core.Account.configuration.merchant.capabilities.affirm_payments, V2.Core.Account.configuration.merchant.capabilities.afterpay_clearpay_payments, V2.Core.Account.configuration.merchant.capabilities.alma_payments, V2.Core.Account.configuration.merchant.capabilities.amazon_pay_payments, V2.Core.Account.configuration.merchant.capabilities.au_becs_debit_payments, V2.Core.Account.configuration.merchant.capabilities.bacs_debit_payments, V2.Core.Account.configuration.merchant.capabilities.bancontact_payments, V2.Core.Account.configuration.merchant.capabilities.blik_payments, V2.Core.Account.configuration.merchant.capabilities.boleto_payments, V2.Core.Account.configuration.merchant.capabilities.card_payments, V2.Core.Account.configuration.merchant.capabilities.cartes_bancaires_payments, V2.Core.Account.configuration.merchant.capabilities.cashapp_payments, V2.Core.Account.configuration.merchant.capabilities.eps_payments, V2.Core.Account.configuration.merchant.capabilities.fpx_payments, V2.Core.Account.configuration.merchant.capabilities.gb_bank_transfer_payments, V2.Core.Account.configuration.merchant.capabilities.grabpay_payments, V2.Core.Account.configuration.merchant.capabilities.ideal_payments, V2.Core.Account.configuration.merchant.capabilities.jcb_payments, V2.Core.Account.configuration.merchant.capabilities.jp_bank_transfer_payments, V2.Core.Account.configuration.merchant.capabilities.kakao_pay_payments, V2.Core.Account.configuration.merchant.capabilities.klarna_payments, V2.Core.Account.configuration.merchant.capabilities.konbini_payments, V2.Core.Account.configuration.merchant.capabilities.kr_card_payments, V2.Core.Account.configuration.merchant.capabilities.link_payments, V2.Core.Account.configuration.merchant.capabilities.mobilepay_payments, V2.Core.Account.configuration.merchant.capabilities.multibanco_payments, V2.Core.Account.configuration.merchant.capabilities.mx_bank_transfer_payments, V2.Core.Account.configuration.merchant.capabilities.naver_pay_payments, V2.Core.Account.configuration.merchant.capabilities.oxxo_payments, V2.Core.Account.configuration.merchant.capabilities.p24_payments, V2.Core.Account.configuration.merchant.capabilities.pay_by_bank_payments, V2.Core.Account.configuration.merchant.capabilities.payco_payments, V2.Core.Account.configuration.merchant.capabilities.paynow_payments, V2.Core.Account.configuration.merchant.capabilities.promptpay_payments, V2.Core.Account.configuration.merchant.capabilities.revolut_pay_payments, V2.Core.Account.configuration.merchant.capabilities.samsung_pay_payments, V2.Core.Account.configuration.merchant.capabilities.sepa_bank_transfer_payments, V2.Core.Account.configuration.merchant.capabilities.sepa_debit_payments, V2.Core.Account.configuration.merchant.capabilities.stripe_balance.payouts, V2.Core.Account.configuration.merchant.capabilities.swish_payments, V2.Core.Account.configuration.merchant.capabilities.twint_payments, V2.Core.Account.configuration.merchant.capabilities.us_bank_transfer_payments, V2.Core.Account.configuration.merchant.capabilities.zip_payments, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.local, V2.Core.Account.configuration.recipient.capabilities.bank_accounts.wire, V2.Core.Account.configuration.recipient.capabilities.cards, V2.Core.Account.configuration.recipient.capabilities.stripe_balance.payouts, V2.Core.Account.configuration.recipient.capabilities.stripe_balance.stripe_transfers, V2.Core.Account.configuration.storer.capabilities.financial_addresses.bank_accounts, V2.Core.Account.configuration.storer.capabilities.holds_currencies.eur, V2.Core.Account.configuration.storer.capabilities.holds_currencies.gbp, V2.Core.Account.configuration.storer.capabilities.holds_currencies.usd, V2.Core.Account.configuration.storer.capabilities.inbound_transfers.bank_accounts, V2.Core.Account.configuration.storer.capabilities.outbound_payments.bank_accounts, V2.Core.Account.configuration.storer.capabilities.outbound_payments.cards, V2.Core.Account.configuration.storer.capabilities.outbound_payments.financial_accounts, V2.Core.Account.configuration.storer.capabilities.outbound_transfers.bank_accounts, and V2.Core.Account.configuration.storer.capabilities.outbound_transfers.financial_accounts
  • Add support for new values al_bank_account, am_bank_account, bn_bank_account, bw_bank_account, dz_bank_account, gy_bank_account, jm_bank_account, jo_bank_account, kw_bank_account, lk_bank_account, ma_bank_account, om_bank_account, and tz_bank_account on enum V2.Core.Account.configuration.recipient.default_outbound_destination.type
  • Change type of V2.Core.Account.identity.business_details.annual_revenue.amount, V2.Core.Account.identity.business_details.monthly_estimated_revenue.amount, V2.Core.AccountCreateParams.identity.business_details.annual_revenue.amount, V2.Core.AccountCreateParams.identity.business_details.monthly_estimated_revenue.amount, V2.Core.AccountTokenCreateParams.identity.business_details.annual_revenue.amount, V2.Core.AccountTokenCreateParams.identity.business_details.monthly_estimated_revenue.amount, V2.Core.AccountUpdateParams.identity.business_details.annual_revenue.amount, V2.Core.AccountUpdateParams.identity.business_details.monthly_estimated_revenue.amount, V2.FinancialAddressCreditSimulationCreditParams.amount, V2.MoneyManagement.Adjustment.amount, V2.MoneyManagement.InboundTransfer.amount, V2.MoneyManagement.InboundTransferCreateParams.amount, V2.MoneyManagement.OutboundPayment.amount, V2.MoneyManagement.OutboundPaymentCreateParams.amount, V2.MoneyManagement.OutboundPaymentQuote.amount, V2.MoneyManagement.OutboundPaymentQuote.estimated_fees[].amount, V2.MoneyManagement.OutboundPaymentQuoteCreateParams.amount, V2.MoneyManagement.OutboundTransfer.amount, V2.MoneyManagement.OutboundTransferCreateParams.amount, V2.MoneyManagement.ReceivedCredit.amount, V2.MoneyManagement.ReceivedDebit.amount, and V2.MoneyManagement.Transaction.amount from amount to an object
  • Add support for new values at_stn, at_vat, be_vat, bg_vat, ca_gst_hst, cy_he, cy_vat, cz_vat, de_stn, dk_vat, ee_vat, es_vat, fi_vat, fr_rna, gr_afm, gr_vat, hr_mbs, hr_oib, hr_vat, hu_tin, hu_vat, ie_trn, ie_vat, lt_vat, lu_nif, lu_vat, lv_vat, mt_tin, mt_vat, my_itn, nl_rsin, nl_vat, nz_ird, pl_nip, pl_vat, ro_orc, ro_vat, se_vat, si_tin, si_vat, sk_dic, and sk_vat on enums V2.Core.Account.identity.business_details.id_numbers[].type, V2.Core.AccountCreateParams.identity.business_details.id_numbers[].type, V2.Core.AccountTokenCreateParams.identity.business_details.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.business_details.id_numbers[].type
  • Remove support for value hk_mbs from enums V2.Core.Account.identity.business_details.id_numbers[].type, V2.Core.AccountCreateParams.identity.business_details.id_numbers[].type, V2.Core.AccountTokenCreateParams.identity.business_details.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.business_details.id_numbers[].type
  • Add support for new values ar_cuil, at_stn, be_nrn, bg_ucn, bn_nric, ca_sin, ch_oasi, cl_rut, cn_pp, co_nuip, cr_ci, cy_tic, cz_rc, dk_cpr, do_cie, ec_ci, ee_ik, es_nif, fi_hetu, fr_nir, gb_nino, gr_afm, hr_oib, hu_ad, id_nik, ie_ppsn, is_kt, it_cf, jp_inc, ke_pin, li_peid, lt_ak, lu_nif, lv_pk, ng_nin, no_nin, nz_ird, pl_pesel, pt_nif, ro_cnp, se_pin, sk_dic, tr_tin, uy_dni, and za_id on enums V2.Core.Account.identity.individual.id_numbers[].type, V2.Core.AccountCreateParams.identity.individual.id_numbers[].type, V2.Core.AccountPerson.id_numbers[].type, V2.Core.AccountPersonCreateParams.id_numbers[].type, V2.Core.AccountPersonTokenCreateParams.id_numbers[].type, V2.Core.AccountPersonUpdateParams.id_numbers[].type, V2.Core.AccountTokenCreateParams.identity.individual.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.individual.id_numbers[].type
  • Change V2.Core.Account.defaults.responsibilities to be required
  • Change V2.Core.Account.defaults.responsibilities.fees_collector to be optional
  • Change V2.Core.Account.defaults.responsibilities.losses_collector to be optional
  • Add support for financial_connections_account on V2.Core.Vault.UsBankAccount and V2.MoneyManagement.PayoutMethod.bank_account
  • Change type of V2.MoneyManagement.FinancialAccount.balance.available, V2.MoneyManagement.Transaction.balance_impact.available, and V2.MoneyManagement.TransactionEntry.balance_impact.available from amount to an object
  • Change type of V2.MoneyManagement.FinancialAccount.balance.inbound_pending, V2.MoneyManagement.Transaction.balance_impact.inbound_pending, and V2.MoneyManagement.TransactionEntry.balance_impact.inbound_pending from amount to an object
  • Change type of V2.MoneyManagement.FinancialAccount.balance.outbound_pending, V2.MoneyManagement.Transaction.balance_impact.outbound_pending, and V2.MoneyManagement.TransactionEntry.balance_impact.outbound_pending from amount to an object
  • Change type of V2.MoneyManagement.InboundTransfer.from.debited, V2.MoneyManagement.OutboundPayment.from.debited, V2.MoneyManagement.OutboundPaymentQuote.from.debited, and V2.MoneyManagement.OutboundTransfer.from.debited from amount to an object
  • Change type of V2.MoneyManagement.InboundTransfer.to.credited, V2.MoneyManagement.OutboundPayment.to.credited, V2.MoneyManagement.OutboundPaymentQuote.to.credited, and V2.MoneyManagement.OutboundTransfer.to.credited from amount to an object
  • Add support for transfer on V2.MoneyManagement.ReceivedCredit.balance_transfer
  • Add support for new value transfer on enum V2.MoneyManagement.ReceivedCredit.balance_transfer.type
  • Change V2.Core.AccountTokenCreateParams.identity to be optional
  • Change type of V2.Core.AccountListParams.applied_configurations from string to enum('customer'|'merchant'|'recipient'|'storer')
  • Add support for event notification V2MoneyManagementPayoutMethodCreatedEvent with related object V2.MoneyManagement.PayoutMethod
  • Add support for error type ControlledByAlternateResourceError
  • Remove support for error type RateLimitError
  • Add support for error code account_token_required_for_v2_account on QuotePreviewInvoice.last_finalization_error

See the changelog for more details.

• #2544 Update generated code for private-preview
  • Add support for risk_details on DelegatedCheckout.RequestedSession
  • Remove support for description, images, and name on DelegatedCheckout.RequestedSession.line_item_details[]
  • Add support for name on ProductCatalog.TrialOfferCreateParams and ProductCatalog.TrialOffer
  • Add support for login_failed and registration_failed on Radar.AccountEvaluation.events[] and Radar.AccountEvaluationUpdateParams
  • Change type of Radar.AccountEvaluationUpdateParams.type from literal('registration_succeeded') to enum('login_failed'|'login_succeeded'|'registration_failed'|'registration_succeeded')

See the changelog for more details.

• #2537 Update generated code for private-preview
  • Add support for tracking_details on V2.MoneyManagement.OutboundPayment
  • Add support for paper_check on V2.MoneyManagement.OutboundPayment.delivery_options and V2.MoneyManagement.OutboundPaymentCreateParams.delivery_options
  • Add support for event notification V2CoreAccountIncludingFutureRequirementsUpdatedEvent with related object V2.Core.Account
  • Add support for error code account_rate_limit_exceeded on RateLimitError
• #2524 Update generated code for private-preview
  • Add support for new resource Tax.Location
  • Add support for create, list, and retrieve methods on resource Tax.Location
  • Add support for pause method on resource Subscription
  • Add support for performance_location on Checkout.SessionCreateParams.line_items[].price_data.product_data.tax_details, Checkout.SessionUpdateParams.line_items[].price_data.product_data.tax_details, InvoiceAddLinesParams.lines[].price_data.product_data.tax_details, InvoiceLineItemUpdateParams.price_data.product_data.tax_details, InvoiceUpdateLinesParams.lines[].price_data.product_data.tax_details, PaymentLinkCreateParams.line_items[].price_data.product_data.tax_details, ProductCreateParams.tax_details, ProductUpdateParams.tax_details, 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
  • Change type of DelegatedCheckout.RequestedSessionUpdateParams.metadata from map(string: string) to emptyable(map(string: string))
  • Change type of DelegatedCheckout.RequestedSessionUpdateParams.payment_method_data from payment_method_data to emptyable(payment_method_data)
  • Change type of DelegatedCheckout.RequestedSessionUpdateParams.shared_metadata from map(string: string) to emptyable(map(string: string))
  • Add support for subscription on Invoice.parent.schedule_details and QuotePreviewInvoice.parent.schedule_details
  • Change type of PaymentIntentConfirmParams.payment_details.benefit.fr_meal_voucher, PaymentIntentCreateParams.payment_details.benefit.fr_meal_voucher, PaymentIntentUpdateParams.payment_details.benefit.fr_meal_voucher, SetupIntentConfirmParams.setup_details.benefit.fr_meal_voucher, SetupIntentCreateParams.setup_details.benefit.fr_meal_voucher, and SetupIntentUpdateParams.setup_details.benefit.fr_meal_voucher from payment_details_benefit_fr_meal_voucher to emptyable(payment_details_benefit_fr_meal_voucher)
  • Add support for tax_details on PlanCreateParams.product[0] and PriceCreateParams.product_data
  • Add support for external_reference on Plan and Price
  • Add support for new value phase_start on enums Quote.subscription_data.phase_effective_at, Quote.subscription_data_overrides[].phase_effective_at, QuoteCreateParams.subscription_data.phase_effective_at, QuoteCreateParams.subscription_data_overrides[].phase_effective_at, QuoteUpdateParams.subscription_data.phase_effective_at, and QuoteUpdateParams.subscription_data_overrides[].phase_effective_at
  • Remove support for value line_start from enums Quote.subscription_data.phase_effective_at, Quote.subscription_data_overrides[].phase_effective_at, QuoteCreateParams.subscription_data.phase_effective_at, QuoteCreateParams.subscription_data_overrides[].phase_effective_at, QuoteUpdateParams.subscription_data.phase_effective_at, and QuoteUpdateParams.subscription_data_overrides[].phase_effective_at
  • 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

See the changelog for more details.

• #2520 Update generated code for private-preview
  • Add support for new resources SharedPayment.GrantedToken, V2.Iam.ApiKey, V2.Payments.SettlementAllocationIntentSplit, V2.Payments.SettlementAllocationIntent, and V2.Tax.ManualRule
  • Add support for retrieve method on resource SharedPayment.GrantedToken
  • Add support for create and update test helper methods on resource SharedPayment.GrantedToken
  • Add support for create, deactivate, list, retrieve, and update methods on resource V2.Tax.ManualRule
  • Add support for cancel, create, retrieve, submit, and update methods on resource V2.Payments.SettlementAllocationIntent
  • Add support for cancel, create, and retrieve methods on resource V2.Payments.SettlementAllocationIntentSplit
  • Add support for create, expire, list, retrieve, rotate, and update methods on resource V2.Iam.ApiKey
  • Add support for check_scanning on AccountSessionCreateParams.components
  • 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, ProductCreateParams, and ProductUpdateParams
  • Add support for payment_method_data on DelegatedCheckout.RequestedSessionConfirmParams
  • Add support for product_details on DelegatedCheckout.RequestedSession.line_item_details[]
  • Add support for wallets on Issuing.CardListParams
  • Add support for primary_account_identifier on Issuing.Card.wallets.apple_pay and Issuing.Card.wallets.google_pay
  • Add support for shared_payment_granted_token on PaymentIntentConfirmParams, PaymentIntentCreateParams, and PaymentIntent
  • Change ProductCatalog.TrialOffer.duration.relative to be optional
  • Add support for new values al_bank_account, am_bank_account, bn_bank_account, bw_bank_account, dz_bank_account, gy_bank_account, jm_bank_account, jo_bank_account, kw_bank_account, lk_bank_account, ma_bank_account, om_bank_account, and tz_bank_account on enum V2.Account.configuration.recipient_data.default_outbound_destination.type
  • Add support for instant on V2.Account.configuration.recipient_data.features.bank_accounts, V2.AccountCreateParams.configuration.recipient_data.features.bank_accounts, V2.AccountUpdateParams.configuration.recipient_data.features.bank_accounts, V2.Core.Account.configuration.recipient.capabilities.bank_accounts, V2.Core.AccountCreateParams.configuration.recipient.capabilities.bank_accounts, and V2.Core.AccountUpdateParams.configuration.recipient.capabilities.bank_accounts
  • Add support for new value bank_accounts.instant on enum V2.Account.requirements[].impact.required_for_features
  • Add support for collect_at on V2.Billing.IntentAction.deactivate, V2.Billing.IntentAction.modify, V2.Billing.IntentAction.subscribe, V2.Billing.IntentCreateParams.actions[].deactivate, V2.Billing.IntentCreateParams.actions[].modify, and V2.Billing.IntentCreateParams.actions[].subscribe
  • Remove support for billing_details on V2.Billing.IntentAction.deactivate, V2.Billing.IntentAction.modify, V2.Billing.IntentAction.subscribe, V2.Billing.IntentCreateParams.actions[].deactivate, V2.Billing.IntentCreateParams.actions[].modify, and V2.Billing.IntentCreateParams.actions[].subscribe
  • Add support for overrides on V2.Billing.IntentAction.deactivate.pricing_plan_subscription_details, V2.Billing.IntentAction.modify.pricing_plan_subscription_details, V2.Billing.IntentAction.subscribe.pricing_plan_subscription_details, V2.Billing.IntentCreateParams.actions[].deactivate.pricing_plan_subscription_details, V2.Billing.IntentCreateParams.actions[].modify.pricing_plan_subscription_details, and V2.Billing.IntentCreateParams.actions[].subscribe.pricing_plan_subscription_details
  • Remove support for requested on V2.Core.Account.configuration.card_creator.capabilities.commercial.celtic.charge_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.celtic.spend_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.cross_river_bank.charge_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.cross_river_bank.spend_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.lead.prepaid_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.stripe.charge_card, V2.Core.Account.configuration.card_creator.capabilities.commercial.stripe.prepaid_card, V2.Core.Account.configuration.recipient.capabilities.crypto_wallets, V2.Core.Account.configuration.storer.capabilities.financial_addresses.crypto_wallets, V2.Core.Account.configuration.storer.capabilities.holds_currencies.usdc, V2.Core.Account.configuration.storer.capabilities.outbound_payments.crypto_wallets, and V2.Core.Account.configuration.storer.capabilities.outbound_transfers.crypto_wallets
  • Add support for new value bank_accounts.instant 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 alternative_reference on V2.Core.Vault.GbBankAccount, V2.Core.Vault.UsBankAccount, and V2.MoneyManagement.PayoutMethod
  • Add support for managed_by and payments on V2.MoneyManagement.FinancialAccount
  • Add support for new value payments on enum V2.MoneyManagement.FinancialAccount.type
  • Add support for speed on V2.MoneyManagement.OutboundPayment.delivery_options, V2.MoneyManagement.OutboundPaymentCreateParams.delivery_options, V2.MoneyManagement.OutboundPaymentQuote.delivery_options, and V2.MoneyManagement.OutboundPaymentQuoteCreateParams.delivery_options
  • Add support for new value real_time_payout_fee on enum V2.MoneyManagement.OutboundPaymentQuote.estimated_fees[].type
  • Add support for types on V2.MoneyManagement.FinancialAccountListParams
  • Change type of V2.Core.AccountListParams.applied_configurations from string to enum
  • Add support for new value bank_accounts.instant on enum EventsV2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent.updated_capability
  • Add support for top_impacted_accounts on EventsV2CoreHealthApiErrorFiringEvent.impact, EventsV2CoreHealthApiErrorResolvedEvent.impact, EventsV2CoreHealthApiLatencyFiringEvent.impact, EventsV2CoreHealthApiLatencyResolvedEvent.impact, EventsV2CoreHealthPaymentMethodErrorFiringEvent.impact, and EventsV2CoreHealthPaymentMethodErrorResolvedEvent.impact
  • Add support for event notifications V2CoreHealthSepaDebitDelayedFiringEvent, V2CoreHealthSepaDebitDelayedResolvedEvent, and V2PaymentsSettlementAllocationIntentNotFoundEvent
  • Add support for event notifications V2PaymentsSettlementAllocationIntentCanceledEvent, V2PaymentsSettlementAllocationIntentCreatedEvent, V2PaymentsSettlementAllocationIntentErroredEvent, V2PaymentsSettlementAllocationIntentFundsNotReceivedEvent, V2PaymentsSettlementAllocationIntentMatchedEvent, V2PaymentsSettlementAllocationIntentSettledEvent, and V2PaymentsSettlementAllocationIntentSubmittedEvent with related object V2.Payments.SettlementAllocationIntent
  • Add support for event notifications V2PaymentsSettlementAllocationIntentSplitCanceledEvent, V2PaymentsSettlementAllocationIntentSplitCreatedEvent, and V2PaymentsSettlementAllocationIntentSplitSettledEvent with related object V2.Payments.SettlementAllocationIntentSplit
  • Remove support for error code account_rate_limit_exceeded on RateLimitError

See the changelog for more details.

• #2542 Fix content length calculations for multipart file uploads. This fixes the bug reported in 2538 around file uploads.
• #2539 Delete API_VERSION file as it is no longer needed

See the changelog for more details.

• #2535 Update qs dependency to latest version

See the changelog for more details.

This release changes the pinned API version to 2025-12-15.clover.

• #2522 Update generated code
  • Add support for new resources V2.Core.AccountLink, V2.Core.AccountPersonToken, V2.Core.AccountPerson, V2.Core.AccountToken, and V2.Core.Account
  • Add support for create and retrieve methods on resources V2.Core.AccountPersonToken and V2.Core.AccountToken
  • Add support for create method on resource V2.Core.AccountLink
  • Add support for close, create, list, retrieve, and update methods on resource V2.Core.Account
  • Add support for create, del, list, retrieve, and update methods on resource V2.Core.AccountPerson
  • Add support for payto_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
  • Add support for signer on AccountCreateParams.documents.proof_of_registration, AccountCreateParams.documents.proof_of_ultimate_beneficial_ownership, AccountUpdateParams.documents.proof_of_registration, and AccountUpdateParams.documents.proof_of_ultimate_beneficial_ownership
  • Add support for customer_account on Billing.CreditBalanceSummaryRetrieveParams, Billing.CreditBalanceSummary, Billing.CreditBalanceTransactionListParams, Billing.CreditGrantCreateParams, Billing.CreditGrantListParams, Billing.CreditGrant, BillingPortal.SessionCreateParams, BillingPortal.Session, CashBalance, Checkout.SessionCreateParams, Checkout.SessionListParams, Checkout.Session, ConfirmationToken.payment_method_preview, CreditNoteListParams, CreditNote, CustomerBalanceTransaction, CustomerCashBalanceTransaction, CustomerSessionCreateParams, CustomerSession, Customer, Discount, FinancialConnections.Account.account_holder, FinancialConnections.AccountListParams.account_holder, FinancialConnections.Session.account_holder, FinancialConnections.SessionCreateParams.account_holder, InvoiceCreateParams, InvoiceCreatePreviewParams, InvoiceItemCreateParams, InvoiceItemListParams, InvoiceItem, InvoiceListParams, Invoice, PaymentIntentCreateParams, PaymentIntentListParams, PaymentIntentUpdateParams, PaymentIntent, PaymentMethodAttachParams, PaymentMethodListParams, PaymentMethod, PromotionCodeCreateParams, PromotionCodeListParams, PromotionCode, QuoteCreateParams, QuoteListParams, QuoteUpdateParams, Quote, SetupAttempt, SetupIntentCreateParams, SetupIntentListParams, SetupIntentUpdateParams, SetupIntent, SubscriptionCreateParams, SubscriptionListParams, SubscriptionScheduleCreateParams, SubscriptionScheduleListParams, SubscriptionSchedule, Subscription, TaxId.owner, TaxIdCreateParams.owner, TaxIdListParams.owner, and TaxId
  • Add support for metadata on Checkout.SessionCreateParams.line_items[] and LineItem
  • Change Billing.CreditBalanceSummaryRetrieveParams.customer, Billing.CreditBalanceTransactionListParams.customer, Billing.CreditGrantCreateParams.customer, BillingPortal.SessionCreateParams.customer, CustomerSessionCreateParams.customer, InvoiceItemCreateParams.customer, PaymentMethodAttachParams.customer, and SubscriptionCreateParams.customer to be optional
  • Add support for billing_cycle_anchor on BillingPortal.Configuration.features.subscription_update, BillingPortal.ConfigurationCreateParams.features.subscription_update, and BillingPortal.ConfigurationUpdateParams.features.subscription_update
  • Add support for payto on Charge.payment_method_details, Checkout.Session.payment_method_options, Checkout.SessionCreateParams.payment_method_options, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, 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, PaymentMethodUpdateParams, 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, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_options
  • Add support for expected_debit_date on Charge.payment_method_details.acss_debit, Charge.payment_method_details.au_becs_debit, Charge.payment_method_details.bacs_debit, Charge.payment_method_details.nz_bank_account, Charge.payment_method_details.sepa_debit, Charge.payment_method_details.us_bank_account, PaymentAttemptRecord.payment_method_details.acss_debit, PaymentAttemptRecord.payment_method_details.au_becs_debit, PaymentAttemptRecord.payment_method_details.bacs_debit, PaymentAttemptRecord.payment_method_details.nz_bank_account, PaymentAttemptRecord.payment_method_details.sepa_debit, PaymentAttemptRecord.payment_method_details.us_bank_account, PaymentRecord.payment_method_details.acss_debit, PaymentRecord.payment_method_details.au_becs_debit, PaymentRecord.payment_method_details.bacs_debit, PaymentRecord.payment_method_details.nz_bank_account, PaymentRecord.payment_method_details.sepa_debit, and PaymentRecord.payment_method_details.us_bank_account
  • Add support for new value mollie on enums Charge.payment_method_details.ideal.bank, ConfirmationToken.payment_method_preview.ideal.bank, ConfirmationTokenCreateParams.testHelpers.payment_method_data.ideal.bank, PaymentAttemptRecord.payment_method_details.ideal.bank, PaymentIntentConfirmParams.payment_method_data.ideal.bank, PaymentIntentCreateParams.payment_method_data.ideal.bank, PaymentIntentUpdateParams.payment_method_data.ideal.bank, PaymentMethod.ideal.bank, PaymentMethodCreateParams.ideal.bank, PaymentRecord.payment_method_details.ideal.bank, SetupAttempt.payment_method_details.ideal.bank, SetupIntentConfirmParams.payment_method_data.ideal.bank, SetupIntentCreateParams.payment_method_data.ideal.bank, and SetupIntentUpdateParams.payment_method_data.ideal.bank
  • Add support for new value MLLENL2A on enums Charge.payment_method_details.ideal.bic, ConfirmationToken.payment_method_preview.ideal.bic, PaymentAttemptRecord.payment_method_details.ideal.bic, PaymentMethod.ideal.bic, PaymentRecord.payment_method_details.ideal.bic, and SetupAttempt.payment_method_details.ideal.bic
  • Add support for new value payto on enums Checkout.SessionCreateParams.excluded_payment_method_types, PaymentIntent.excluded_payment_method_types, PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentUpdateParams.excluded_payment_method_types, SetupIntent.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, and SetupIntentUpdateParams.excluded_payment_method_types
  • Add support for new value payto on enum Checkout.SessionCreateParams.payment_method_types
  • Add support for line_items on Checkout.SessionUpdateParams
  • Add support for new value payto 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 payto on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Add support for new value payto on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for invoice on CustomerListCustomerBalanceTransactionsParams
  • Add support for related_customer_account on Identity.VerificationSessionCreateParams, Identity.VerificationSessionListParams, and Identity.VerificationSession
  • Change type of InvoiceItem.pricing.price_details.price and InvoiceLineItem.pricing.price_details.price from string to expandable(Price)
  • Add support for new value payto on enums Invoice.payment_settings.payment_method_types, InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.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 subtotal on InvoiceLineItem
  • Add support for authorization_code, description, iin, installments, issuer, network_advice_code, network_decline_code, and stored_credential_usage on PaymentAttemptRecord.payment_method_details.card and PaymentRecord.payment_method_details.card
  • Change PaymentIntent.transfer_data to be optional
  • Add support for new value payto on enums PaymentLink.payment_method_types, PaymentLinkCreateParams.payment_method_types, and PaymentLinkUpdateParams.payment_method_types
  • Add support for allow_redisplay on PaymentMethodListParams
  • Add support for reported_by on PaymentRecord
  • Change Product.tax_code to be optional
  • Add support for new values 2025-12-15.clover and 2026-01-28.clover on enum WebhookEndpointCreateParams.api_version
  • Add support for changes on V2.Core.Event
  • Add support for error code account_token_required_for_v2_account on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError

See the changelog for more details.

This release changes the pinned API version to 2025-11-17.preview.

• #2487 Update generated code for beta
  • Add support for new resources V2.Core.AccountPersonToken and V2.Core.AccountToken
  • Remove support for resource V2.Payments.OffSessionPayment
  • Add support for create and retrieve methods on resources V2.Core.AccountPersonToken and V2.Core.AccountToken
  • Remove support for cancel, capture, create, list, and retrieve methods on resource V2.Payments.OffSessionPayment
  • Add support for specified_commercial_transactions_act_url on Account.business_profile, AccountCreateParams.business_profile, and AccountUpdateParams.business_profile
  • Add support for paypay_payments on Account.settings, AccountCreateParams.settings, and AccountUpdateParams.settings
  • Change Tax.Association.tax_transaction_attempts to be required
  • Change type of Billing.Analytics.MeterUsageRetrieveParams.meters[].dimension_filters from string to array(string)
  • Change type of Billing.Analytics.MeterUsageRetrieveParams.meters[].tenant_filters from string to array(string)
  • Add support for car_rental_data, flight_data, and lodging_data on ChargeCaptureParams.payment_details, ChargeUpdateParams.payment_details, PaymentIntentCaptureParams.payment_details, PaymentIntentConfirmParams.payment_details, PaymentIntentCreateParams.payment_details, and PaymentIntentUpdateParams.payment_details
  • Add support for supplementary_purchase_data on OrderCreateParams.payment.settings.payment_method_options.klarna, OrderUpdateParams.payment.settings.payment_method_options.klarna, PaymentIntentConfirmParams.payment_method_options.klarna, PaymentIntentCreateParams.payment_method_options.klarna, and PaymentIntentUpdateParams.payment_method_options.klarna
  • Add support for allow_redisplay and customer_account on PaymentMethodListParams
  • Add support for future_requirements on V2.Core.Account
  • Add support for konbini_payments and script_statement_descriptor on V2.Core.Account.configuration.merchant, V2.Core.AccountCreateParams.configuration.merchant, and V2.Core.AccountUpdateParams.configuration.merchant
  • Add support for eur on V2.Core.Account.configuration.storer.capabilities.holds_currencies, V2.Core.AccountCreateParams.configuration.storer.capabilities.holds_currencies, and V2.Core.AccountUpdateParams.configuration.storer.capabilities.holds_currencies
  • Add support for requirements_collector on V2.Core.Account.defaults.responsibilities
  • Add support for new value ar_cuit on enums V2.Core.Account.identity.business_details.id_numbers[].type, V2.Core.AccountCreateParams.identity.business_details.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.business_details.id_numbers[].type
  • Add support for new value ar_dni on enums V2.Core.Account.identity.individual.id_numbers[].type, V2.Core.AccountCreateParams.identity.individual.id_numbers[].type, V2.Core.AccountPerson.id_numbers[].type, V2.Core.AccountPersonCreateParams.id_numbers[].type, V2.Core.AccountPersonUpdateParams.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.individual.id_numbers[].type
  • Remove support for collector on V2.Core.Account.requirements
  • Add support for new value holds_currencies.eur on enum V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability
  • Add support for new values payment_method and person on enum V2.Core.Account.requirements.entries[].reference.type
  • Remove support for value resource from enum V2.Core.Account.requirements.entries[].reference.type
  • Remove support for value future_requirements from enum V2.Core.Account.requirements.entries[].requested_reasons[].code
  • Add support for changes on V2.Core.Event
  • Remove support for value sepa_bank_account from enums V2.MoneyManagement.FinancialAddress.credentials.type and V2.MoneyManagement.FinancialAddressCreateParams.type
  • Add support for account_token on V2.Core.AccountCreateParams and V2.Core.AccountUpdateParams
  • Add support for new value future_requirements on enums V2.Core.AccountCreateParams.include, V2.Core.AccountRetrieveParams.include, and V2.Core.AccountUpdateParams.include
  • Add support for person_token on V2.Core.AccountPersonCreateParams and V2.Core.AccountPersonUpdateParams
  • Add support for thin event V2CoreHealthEventGenerationFailureResolvedEvent
  • Remove support for thin events V2PaymentsOffSessionPaymentAuthorizationAttemptFailedEvent, V2PaymentsOffSessionPaymentAuthorizationAttemptStartedEvent, V2PaymentsOffSessionPaymentCanceledEvent, V2PaymentsOffSessionPaymentCreatedEvent, V2PaymentsOffSessionPaymentFailedEvent, V2PaymentsOffSessionPaymentRequiresCaptureEvent, and V2PaymentsOffSessionPaymentSucceededEvent with related object V2.Payments.OffSessionPayment

See the changelog for more details.

• #2519 Update generated code for private-preview
  • Add support for event notifications V2IamApiKeyCreatedEvent, V2IamApiKeyDefaultSecretRevealedEvent, V2IamApiKeyExpiredEvent, V2IamApiKeyPermissionsUpdatedEvent, V2IamApiKeyRotatedEvent, and V2IamApiKeyUpdatedEvent
• #2517 Update generated code for private-preview
  • Add support for check_scanning on AccountSession.components
  • Add support for client on V2.Core.Event.reason.request
  • Add support for stripe_balance_payment on V2.MoneyManagement.ReceivedCredit and V2.MoneyManagement.ReceivedDebit
  • Add support for new value stripe_balance_payment on enum V2.MoneyManagement.ReceivedCredit.type
  • Add support for balance_transfer on V2.MoneyManagement.ReceivedDebit
  • Add support for new values balance_transfer and stripe_balance_payment on enum V2.MoneyManagement.ReceivedDebit.type
  • Add support for include on V2.Core.EventListParams and V2.Core.EventRetrieveParams

See the changelog for more details.

• #2512 Update generated code for private-preview
  • Add support for new resource ProductCatalog.TrialOffer
  • Add support for create method on resource ProductCatalog.TrialOffer
  • Remove support for amount_subtotal_after_discount on DelegatedCheckout.RequestedSession.line_item_details[] and DelegatedCheckout.RequestedSession.total_details
  • Remove support for amount_total, unit_amount_after_discount, and unit_discount on DelegatedCheckout.RequestedSession.line_item_details[]
  • Add support for amount_cart_discount and amount_items_discount on DelegatedCheckout.RequestedSession.total_details
  • Remove support for amount_discount on DelegatedCheckout.RequestedSession.total_details
  • Add support for payments_orchestration on PaymentIntentCreateParams and PaymentIntent

See the changelog for more details.

This release changes the pinned API version to 2025-11-17.preview.

• #2510 Update generated code for private-preview
  • Add support for new resources V2.Core.AccountPersonToken, V2.Core.AccountToken, and V2.MoneyManagement.CurrencyConversion
  • Add support for create, list, and retrieve methods on resource V2.MoneyManagement.CurrencyConversion
  • Add support for create and retrieve methods on resources V2.Core.AccountPersonToken and V2.Core.AccountToken
  • Add support for effective_at on InvoiceCreatePreviewParams.schedule_details.amendments[], InvoiceCreatePreviewParams.schedule_details.phases[], QuoteCreateParams.lines[], QuoteLine, QuotePreviewSubscriptionSchedule.phases[], QuoteUpdateParams.lines[], SubscriptionSchedule.phases[], SubscriptionScheduleAmendParams.amendments[], SubscriptionScheduleCreateParams.phases[], and SubscriptionScheduleUpdateParams.phases[]
  • 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[]
  • Change type of DelegatedCheckout.RequestedSession.amount_subtotal from longInteger to longInteger | null
  • Change type of DelegatedCheckout.RequestedSession.amount_total from longInteger to longInteger | null
  • Add support for amount_discount, amount_subtotal, amount_total, unit_amount_after_discount, and unit_discount on DelegatedCheckout.RequestedSession.line_item_details[]
  • Add support for amount_subtotal_after_discount on DelegatedCheckout.RequestedSession.line_item_details[] and DelegatedCheckout.RequestedSession.total_details
  • Change type of InvoiceCreatePreviewParams.schedule_details.billing_schedules from array(billing_schedules_update_params) to emptyable(array(billing_schedules_update_params))
  • Remove support for values amendment_end, line_ends_at, schedule_end, and upcoming_invoice from enums InvoiceCreatePreviewParams.subscription_details.billing_schedules[].bill_until.type, Subscription.billing_schedules[].bill_until.type, SubscriptionCreateParams.billing_schedules[].bill_until.type, SubscriptionScheduleCreateParams.billing_schedules[].bill_until.type, SubscriptionScheduleUpdateParams.billing_schedules[].bill_until.type, and SubscriptionUpdateParams.billing_schedules[].bill_until.type
  • Add support for current_trial on InvoiceCreatePreviewParams.subscription_details.items[], SubscriptionCreateParams.items[], SubscriptionItemCreateParams, SubscriptionItemUpdateParams, SubscriptionItem, and SubscriptionUpdateParams.items[]
  • Change type of QuoteCreateParams.subscription_data.billing_schedules and QuoteCreateParams.subscription_data_overrides[].billing_schedules from emptyable(array(billing_schedules_create_specs)) to array(billing_schedules_create_specs)
  • Add support for new value line_start on enums QuoteCreateParams.subscription_data.phase_effective_at, QuoteCreateParams.subscription_data_overrides[].phase_effective_at, QuoteUpdateParams.subscription_data.phase_effective_at, and QuoteUpdateParams.subscription_data_overrides[].phase_effective_at
  • Remove support for value phase_start from enums QuoteCreateParams.subscription_data.phase_effective_at, QuoteCreateParams.subscription_data_overrides[].phase_effective_at, QuoteUpdateParams.subscription_data.phase_effective_at, and QuoteUpdateParams.subscription_data_overrides[].phase_effective_at
  • Change type of Quote.subscription_data.billing_schedules and Quote.subscription_data_overrides[].billing_schedules from array(SubscriptionsResourceBillingSchedules) | null to array(QuotesResourceSubscriptionDataBillingSchedules)
  • Change type of Quote.subscription_data.phase_effective_at and Quote.subscription_data_overrides[].phase_effective_at from enum('billing_period_start'|'phase_start') | null to enum('billing_period_start'|'line_start')
  • Change type of QuotePreviewSubscriptionSchedule.default_settings.phase_effective_at and SubscriptionSchedule.default_settings.phase_effective_at from enum('billing_period_start'|'phase_start') | null to enum('billing_period_start'|'phase_start')
  • Change type of QuotePreviewSubscriptionSchedule.billing_schedules and SubscriptionSchedule.billing_schedules from array(SubscriptionsResourceBillingSchedules) | null to array(SubscriptionsResourceBillingSchedules)
  • Remove support for amendment_start, line_starts_at, and relative on Subscription.billing_schedules[].bill_from
  • Change type of Subscription.billing_schedules[].bill_from.computed_timestamp from DateTime | null to DateTime
  • Change type of Subscription.billing_schedules[].bill_from.type from enum to literal('timestamp')
  • Remove support for amendment_end and line_ends_at on Subscription.billing_schedules[].bill_until
  • Change type of V2.Billing.ServiceAction.credit_grant.amount.monetary, V2.Billing.ServiceAction.credit_grant_per_tenant.amount.monetary, V2.Billing.ServiceActionCreateParams.credit_grant.amount.monetary, and V2.Billing.ServiceActionCreateParams.credit_grant_per_tenant.amount.monetary from amount to an object
  • Add support for future_requirements on V2.Core.Account
  • Add support for konbini_payments and script_statement_descriptor on V2.Core.Account.configuration.merchant, V2.Core.AccountCreateParams.configuration.merchant, and V2.Core.AccountUpdateParams.configuration.merchant
  • Add support for eur on V2.Core.Account.configuration.storer.capabilities.holds_currencies, V2.Core.AccountCreateParams.configuration.storer.capabilities.holds_currencies, and V2.Core.AccountUpdateParams.configuration.storer.capabilities.holds_currencies
  • Add support for requirements_collector on V2.Core.Account.defaults.responsibilities
  • Add support for new value ar_cuit on enums V2.Core.Account.identity.business_details.id_numbers[].type, V2.Core.AccountCreateParams.identity.business_details.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.business_details.id_numbers[].type
  • Add support for new value ar_dni on enums V2.Core.Account.identity.individual.id_numbers[].type, V2.Core.AccountCreateParams.identity.individual.id_numbers[].type, V2.Core.AccountPerson.id_numbers[].type, V2.Core.AccountPersonCreateParams.id_numbers[].type, V2.Core.AccountPersonUpdateParams.id_numbers[].type, and V2.Core.AccountUpdateParams.identity.individual.id_numbers[].type
  • Remove support for collector on V2.Core.Account.requirements
  • Add support for new value holds_currencies.eur on enum V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability
  • Add support for new values payment_method and person on enum V2.Core.Account.requirements.entries[].reference.type
  • Remove support for value resource from enum V2.Core.Account.requirements.entries[].reference.type
  • Remove support for value future_requirements from enum V2.Core.Account.requirements.entries[].requested_reasons[].code
  • Remove support for v1_event_id on V2.Core.Event
  • Remove support for amount_details and capture_method on V2.Payments.OffSessionPaymentCreateParams and V2.Payments.OffSessionPayment
  • Change type of V2.Payments.OffSessionPayment.amount_capturable from amount to an object
  • Change type of V2.Payments.OffSessionPayment.amount_requested from amount to an object
  • Change type of V2.Payments.OffSessionPaymentCreateParams.amount from amount to an object
  • Add support for new value best_available on enum V2.Payments.OffSessionPaymentCreateParams.retry_details.retry_strategy
  • Remove support for values heuristic, scheduled, and smart from enum V2.Payments.OffSessionPaymentCreateParams.retry_details.retry_strategy
  • Change V2.Payments.OffSessionPaymentCreateParams.retry_details.retry_strategy to be optional
  • Remove support for destination on V2.Payments.OffSessionPaymentCaptureParams.transfer_data
  • Change V2.Payments.OffSessionPaymentCaptureParams.amount_to_capture to be optional
  • Add support for created on V2.Core.EventListParams
  • Remove support for gt, gte, lt, and lte on V2.Core.EventListParams
  • Add support for account_token on V2.Core.AccountCreateParams and V2.Core.AccountUpdateParams
  • Add support for new value future_requirements on enums V2.Core.AccountCreateParams.include, V2.Core.AccountRetrieveParams.include, and V2.Core.AccountUpdateParams.include
  • Add support for person_token on V2.Core.AccountPersonCreateParams and V2.Core.AccountPersonUpdateParams
  • Add support for impacted_requests_percentage on EventsV2CoreHealthApiErrorFiringEvent.impact, EventsV2CoreHealthApiErrorResolvedEvent.impact, EventsV2CoreHealthApiLatencyFiringEvent.impact, EventsV2CoreHealthApiLatencyResolvedEvent.impact, EventsV2CoreHealthPaymentMethodErrorFiringEvent.impact, and EventsV2CoreHealthPaymentMethodErrorResolvedEvent.impact
  • Add support for context and related_object on EventsV2CoreHealthEventGenerationFailureResolvedEvent.impact
  • Remove support for account, livemode, missing_delivery_attempts, and related_object_id on EventsV2CoreHealthEventGenerationFailureResolvedEvent.impact
  • Change type of EventsV2CoreHealthFraudRateIncreasedEvent.impact.realized_fraud_amount from amount to an object
  • Change type of EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent.impact.approved_amount, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent.impact.approved_amount, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent.impact.approved_amount, and EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent.impact.approved_amount from amount to an object
  • Change type of EventsV2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent.impact.declined_amount, EventsV2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent.impact.declined_amount, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent.impact.declined_amount, and EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent.impact.declined_amount from amount to an object
  • Add support for thin events V2PaymentsOffSessionPaymentAttemptFailedEvent and V2PaymentsOffSessionPaymentAttemptStartedEvent with related object V2.Payments.OffSessionPayment
  • Remove support for thin event V1AccountUpdatedEvent with related object Account
  • Remove support for thin events V1ApplicationFeeCreatedEvent and V1ApplicationFeeRefundedEvent with related object ApplicationFee
  • Remove support for thin events V1BillingPortalConfigurationCreatedEvent and V1BillingPortalConfigurationUpdatedEvent with related object BillingPortal.Configuration
  • Remove support for thin event V1CapabilityUpdatedEvent with related object Capability
  • Remove support for thin events V1ChargeCapturedEvent, V1ChargeExpiredEvent, V1ChargeFailedEvent, V1ChargePendingEvent, V1ChargeRefundedEvent, V1ChargeSucceededEvent, and V1ChargeUpdatedEvent with related object Charge
  • Remove support for thin events V1ChargeDisputeClosedEvent, V1ChargeDisputeCreatedEvent, V1ChargeDisputeFundsReinstatedEvent, V1ChargeDisputeFundsWithdrawnEvent, and V1ChargeDisputeUpdatedEvent with related object Dispute
  • Remove support for thin events V1ChargeRefundUpdatedEvent, V1RefundCreatedEvent, V1RefundFailedEvent, and V1RefundUpdatedEvent with related object Refund
  • Remove support for thin events V1CheckoutSessionAsyncPaymentFailedEvent, V1CheckoutSessionAsyncPaymentSucceededEvent, V1CheckoutSessionCompletedEvent, and V1CheckoutSessionExpiredEvent with related object Checkout.Session
  • Remove support for thin events V1ClimateOrderCanceledEvent, V1ClimateOrderCreatedEvent, V1ClimateOrderDelayedEvent, V1ClimateOrderDeliveredEvent, and V1ClimateOrderProductSubstitutedEvent with related object Climate.Order
  • Remove support for thin events V1ClimateProductCreatedEvent and V1ClimateProductPricingUpdatedEvent with related object Climate.Product
  • Remove support for thin events V1CouponCreatedEvent, V1CouponDeletedEvent, and V1CouponUpdatedEvent with related object Coupon
  • Remove support for thin events V1CreditNoteCreatedEvent, V1CreditNoteUpdatedEvent, and V1CreditNoteVoidedEvent with related object CreditNote
  • Remove support for thin events V1CustomerCreatedEvent, V1CustomerDeletedEvent, and V1CustomerUpdatedEvent with related object Customer
  • Remove support for thin events V1CustomerSubscriptionCreatedEvent, V1CustomerSubscriptionDeletedEvent, V1CustomerSubscriptionPausedEvent, V1CustomerSubscriptionPendingUpdateAppliedEvent, V1CustomerSubscriptionPendingUpdateExpiredEvent, V1CustomerSubscriptionResumedEvent, V1CustomerSubscriptionTrialWillEndEvent, and V1CustomerSubscriptionUpdatedEvent with related object Subscription
  • Remove support for thin events V1CustomerTaxIdCreatedEvent, V1CustomerTaxIdDeletedEvent, and V1CustomerTaxIdUpdatedEvent with related object TaxId
  • Remove support for thin event V1FileCreatedEvent with related object File
  • Remove support for thin events V1FinancialConnectionsAccountCreatedEvent, V1FinancialConnectionsAccountDeactivatedEvent, V1FinancialConnectionsAccountDisconnectedEvent, V1FinancialConnectionsAccountReactivatedEvent, V1FinancialConnectionsAccountRefreshedBalanceEvent, V1FinancialConnectionsAccountRefreshedOwnershipEvent, and V1FinancialConnectionsAccountRefreshedTransactionsEvent with related object FinancialConnections.Account
  • Remove support for thin events V1IdentityVerificationSessionCanceledEvent, V1IdentityVerificationSessionCreatedEvent, V1IdentityVerificationSessionProcessingEvent, V1IdentityVerificationSessionRedactedEvent, V1IdentityVerificationSessionRequiresInputEvent, and V1IdentityVerificationSessionVerifiedEvent with related object Identity.VerificationSession
  • Remove support for thin events V1InvoiceCreatedEvent, V1InvoiceDeletedEvent, V1InvoiceFinalizationFailedEvent, V1InvoiceFinalizedEvent, V1InvoiceMarkedUncollectibleEvent, V1InvoiceOverdueEvent, V1InvoiceOverpaidEvent, V1InvoicePaidEvent, V1InvoicePaymentActionRequiredEvent, V1InvoicePaymentFailedEvent, V1InvoicePaymentSucceededEvent, V1InvoiceSentEvent, V1InvoiceUpcomingEvent, V1InvoiceUpdatedEvent, V1InvoiceVoidedEvent, and V1InvoiceWillBeDueEvent with related object Invoice
  • Remove support for thin event V1InvoicePaymentPaidEvent with related object InvoicePayment
  • Remove support for thin events V1InvoiceitemCreatedEvent and V1InvoiceitemDeletedEvent with related object InvoiceItem
  • Remove support for thin events V1IssuingAuthorizationCreatedEvent, V1IssuingAuthorizationRequestEvent, and V1IssuingAuthorizationUpdatedEvent with related object Issuing.Authorization
  • Remove support for thin events V1IssuingCardCreatedEvent and V1IssuingCardUpdatedEvent with related object Issuing.Card
  • Remove support for thin events V1IssuingCardholderCreatedEvent and V1IssuingCardholderUpdatedEvent with related object Issuing.Cardholder
  • Remove support for thin events V1IssuingDisputeClosedEvent, V1IssuingDisputeCreatedEvent, V1IssuingDisputeFundsReinstatedEvent, V1IssuingDisputeFundsRescindedEvent, V1IssuingDisputeSubmittedEvent, and V1IssuingDisputeUpdatedEvent with related object Issuing.Dispute
  • Remove support for thin events V1IssuingPersonalizationDesignActivatedEvent, V1IssuingPersonalizationDesignDeactivatedEvent, V1IssuingPersonalizationDesignRejectedEvent, and V1IssuingPersonalizationDesignUpdatedEvent with related object Issuing.PersonalizationDesign
  • Remove support for thin events V1IssuingTokenCreatedEvent and V1IssuingTokenUpdatedEvent with related object Issuing.Token
  • Remove support for thin events V1IssuingTransactionCreatedEvent, V1IssuingTransactionPurchaseDetailsReceiptUpdatedEvent, and V1IssuingTransactionUpdatedEvent with related object Issuing.Transaction
  • Remove support for thin event V1MandateUpdatedEvent with related object Mandate
  • Remove support for thin events V1PaymentIntentAmountCapturableUpdatedEvent, V1PaymentIntentCanceledEvent, V1PaymentIntentCreatedEvent, V1PaymentIntentPartiallyFundedEvent, V1PaymentIntentPaymentFailedEvent, V1PaymentIntentProcessingEvent, V1PaymentIntentRequiresActionEvent, and V1PaymentIntentSucceededEvent with related object PaymentIntent
  • Remove support for thin events V1PaymentLinkCreatedEvent and V1PaymentLinkUpdatedEvent with related object PaymentLink
  • Remove support for thin events V1PaymentMethodAttachedEvent, V1PaymentMethodAutomaticallyUpdatedEvent, V1PaymentMethodDetachedEvent, and V1PaymentMethodUpdatedEvent with related object PaymentMethod
  • Remove support for thin events V1PayoutCanceledEvent, V1PayoutCreatedEvent, V1PayoutFailedEvent, V1PayoutPaidEvent, V1PayoutReconciliationCompletedEvent, and V1PayoutUpdatedEvent with related object Payout
  • Remove support for thin events V1PersonCreatedEvent, V1PersonDeletedEvent, and V1PersonUpdatedEvent with related object Person
  • Remove support for thin events V1PlanCreatedEvent, V1PlanDeletedEvent, and V1PlanUpdatedEvent with related object Plan
  • Remove support for thin events V1PriceCreatedEvent, V1PriceDeletedEvent, and V1PriceUpdatedEvent with related object Price
  • Remove support for thin events V1ProductCreatedEvent, V1ProductDeletedEvent, and V1ProductUpdatedEvent with related object Product
  • Remove support for thin events V1PromotionCodeCreatedEvent and V1PromotionCodeUpdatedEvent with related object PromotionCode
  • Remove support for thin events V1QuoteAcceptedEvent, V1QuoteCanceledEvent, V1QuoteCreatedEvent, and V1QuoteFinalizedEvent with related object Quote
  • Remove support for thin events V1RadarEarlyFraudWarningCreatedEvent and V1RadarEarlyFraudWarningUpdatedEvent with related object Radar.EarlyFraudWarning
  • Remove support for thin events V1ReviewClosedEvent and V1ReviewOpenedEvent with related object Review
  • Remove support for thin events V1SetupIntentCanceledEvent, V1SetupIntentCreatedEvent, V1SetupIntentRequiresActionEvent, V1SetupIntentSetupFailedEvent, and V1SetupIntentSucceededEvent with related object SetupIntent
  • Remove support for thin event V1SigmaScheduledQueryRunCreatedEvent with related object Sigma.ScheduledQueryRun
  • Remove support for thin events V1SourceCanceledEvent, V1SourceChargeableEvent, V1SourceFailedEvent, and V1SourceRefundAttributesRequiredEvent with related object Source
  • Remove support for thin events V1SubscriptionScheduleAbortedEvent, V1SubscriptionScheduleCanceledEvent, V1SubscriptionScheduleCompletedEvent, V1SubscriptionScheduleCreatedEvent, V1SubscriptionScheduleExpiringEvent, V1SubscriptionScheduleReleasedEvent, and V1SubscriptionScheduleUpdatedEvent with related object SubscriptionSchedule
  • Remove support for thin events V1TaxRateCreatedEvent and V1TaxRateUpdatedEvent with related object TaxRate
  • Remove support for thin events V1TerminalReaderActionFailedEvent, V1TerminalReaderActionSucceededEvent, and V1TerminalReaderActionUpdatedEvent with related object Terminal.Reader
  • Remove support for thin events V1TestHelpersTestClockAdvancingEvent, V1TestHelpersTestClockCreatedEvent, V1TestHelpersTestClockDeletedEvent, V1TestHelpersTestClockInternalFailureEvent, and V1TestHelpersTestClockReadyEvent with related object TestHelpers.TestClock
  • Remove support for thin events V1TopupCanceledEvent, V1TopupCreatedEvent, V1TopupFailedEvent, V1TopupReversedEvent, and V1TopupSucceededEvent with related object Topup
  • Remove support for thin events V1TransferCreatedEvent, V1TransferReversedEvent, and V1TransferUpdatedEvent with related object Transfer

See the changelog for more details.

• #2505 Update generated code for private-preview
  • Add support for billing_schedules_actions on InvoiceCreatePreviewParams.schedule_details.amendments[] and SubscriptionScheduleAmendParams.amendments[]
• #2504 Update generated code for private-preview
  • Add support for new resources BalanceTransfer and Radar.AccountEvaluation
  • Add support for create method on resource BalanceTransfer
  • Add support for create, retrieve, and update methods on resource Radar.AccountEvaluation
  • Add support for specified_commercial_transactions_act_url on Account.business_profile, AccountCreateParams.business_profile, and AccountUpdateParams.business_profile
  • Add support for paypay_payments on Account.settings, AccountCreateParams.settings, and AccountUpdateParams.settings
  • Change Tax.Association.tax_transaction_attempts to be required
  • Change type of Billing.Analytics.MeterUsageRetrieveParams.meters[].dimension_filters from string to array(string)
  • Change type of Billing.Analytics.MeterUsageRetrieveParams.meters[].tenant_filters from string to array(string)
  • Add support for payment_method_configuration on BillingPortal.Configuration.features.payment_method_update
  • Add support for car_rental_data, flight_data, and lodging_data on ChargeCaptureParams.payment_details, ChargeUpdateParams.payment_details, PaymentIntentCaptureParams.payment_details, PaymentIntentConfirmParams.payment_details, PaymentIntentCreateParams.payment_details, and PaymentIntentUpdateParams.payment_details
  • Add support for transaction_id on Charge.payment_method_details.ideal, PaymentAttemptRecord.payment_method_details.ideal, and PaymentRecord.payment_method_details.ideal
  • Add support for new value finom on enums Charge.payment_method_details.ideal.bank, ConfirmationToken.payment_method_preview.ideal.bank, ConfirmationTokenCreateParams.testHelpers.payment_method_data.ideal.bank, PaymentAttemptRecord.payment_method_details.ideal.bank, PaymentIntentConfirmParams.payment_method_data.ideal.bank, PaymentIntentCreateParams.payment_method_data.ideal.bank, PaymentIntentUpdateParams.payment_method_data.ideal.bank, PaymentMethod.ideal.bank, PaymentMethodCreateParams.ideal.bank, PaymentRecord.payment_method_details.ideal.bank, SetupAttempt.payment_method_details.ideal.bank, SetupIntentConfirmParams.payment_method_data.ideal.bank, SetupIntentCreateParams.payment_method_data.ideal.bank, and SetupIntentUpdateParams.payment_method_data.ideal.bank
  • Add support for new value FNOMNL22 on enums Charge.payment_method_details.ideal.bic, ConfirmationToken.payment_method_preview.ideal.bic, PaymentAttemptRecord.payment_method_details.ideal.bic, PaymentMethod.ideal.bic, PaymentRecord.payment_method_details.ideal.bic, and SetupAttempt.payment_method_details.ideal.bic
  • Add support for new value tokenized_account_number_deactivated on enums ConfirmationToken.payment_method_preview.us_bank_account.status_details.blocked.reason and PaymentMethod.us_bank_account.status_details.blocked.reason
  • Add support for created on CustomerListCustomerBalanceTransactionsParams and InvoicePaymentListParams
  • Add support for new values capital.financing_offer.accepted_other_offer, financial_connections.account.account_numbers_updated, and financial_connections.account.upcoming_account_number_expiry on enum Event.type
  • Add support for account_numbers on FinancialConnections.Account
  • Change type of FinancialConnections.Session.client_secret from string to string | null
  • Add support for fraud_risk on Issuing.AuthorizationCreateParams.testHelpers.risk_assessment
  • Add support for latest_fraud_warning on Issuing.Card
  • Add support for supplementary_purchase_data on OrderCreateParams.payment.settings.payment_method_options.klarna, OrderUpdateParams.payment.settings.payment_method_options.klarna, PaymentIntentConfirmParams.payment_method_options.klarna, PaymentIntentCreateParams.payment_method_options.klarna, and PaymentIntentUpdateParams.payment_method_options.klarna
  • Add support for capture_method on PaymentIntent.payment_method_options.card_present, PaymentIntentConfirmParams.payment_method_options.card_present, PaymentIntentCreateParams.payment_method_options.card_present, and PaymentIntentUpdateParams.payment_method_options.card_present
  • Add support for allow_redisplay and customer_account on PaymentMethodListParams
  • Add support for mb_way and twint on Refund.destination_details
  • Change type of SubscriptionScheduleUpdateParams.billing_schedules from array(billing_schedules_update_params) to emptyable(array(billing_schedules_update_params))
  • Add support for new values capital.financing_offer.accepted_other_offer, financial_connections.account.account_numbers_updated, and financial_connections.account.upcoming_account_number_expiry on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_events
  • Add support for new value 2025-11-17.clover on enum WebhookEndpointCreateParams.api_version
  • Add support for snapshot events FinancialConnectionsAccountAccountNumbersUpdatedEvent and FinancialConnectionsAccountUpcomingAccountNumberExpiryEvent with resource FinancialConnections.Account

See the changelog for more details.

This release changes the pinned API version to 2025-11-17.clover.

• #2502 Update generated code
  • ⚠️ Remove support for gt, gte, lt, and lte on V2.Core.EventListParams in favor of created.
• #2497 Update v2 array parameter serialization to use indexed format
  • Retrieve and List calls for /v2 endpoints now use indexed format (e.g., ?include[0]=foo&include[1]=bar) instead of repeated parameter format (e.g., ?include=foo&include=bar) when communicating with the Stripe API. This may break any unit tests that expect the latter behavior when setting up a mock server. Instead, they should now expect the former.
• #2495 Update generated code
  • Add support for new resources Tax.Association and Terminal.OnboardingLink
  • Add support for find method on resource Tax.Association
  • Add support for create method on resource Terminal.OnboardingLink
  • Add support for payment_method_configuration on BillingPortal.Configuration.features.payment_method_update
  • Add support for transaction_id on Charge.payment_method_details.ideal, PaymentAttemptRecord.payment_method_details.ideal, and PaymentRecord.payment_method_details.ideal
  • Add support for new value finom on enums Charge.payment_method_details.ideal.bank, ConfirmationToken.payment_method_preview.ideal.bank, ConfirmationTokenCreateParams.testHelpers.payment_method_data.ideal.bank, PaymentAttemptRecord.payment_method_details.ideal.bank, PaymentIntentConfirmParams.payment_method_data.ideal.bank, PaymentIntentCreateParams.payment_method_data.ideal.bank, PaymentIntentUpdateParams.payment_method_data.ideal.bank, PaymentMethod.ideal.bank, PaymentMethodCreateParams.ideal.bank, PaymentRecord.payment_method_details.ideal.bank, SetupAttempt.payment_method_details.ideal.bank, SetupIntentConfirmParams.payment_method_data.ideal.bank, SetupIntentCreateParams.payment_method_data.ideal.bank, and SetupIntentUpdateParams.payment_method_data.ideal.bank
  • Add support for new value FNOMNL22 on enums Charge.payment_method_details.ideal.bic, ConfirmationToken.payment_method_preview.ideal.bic, PaymentAttemptRecord.payment_method_details.ideal.bic, PaymentMethod.ideal.bic, PaymentRecord.payment_method_details.ideal.bic, and SetupAttempt.payment_method_details.ideal.bic
  • Add support for new value tokenized_account_number_deactivated on enums ConfirmationToken.payment_method_preview.us_bank_account.status_details.blocked.reason and PaymentMethod.us_bank_account.status_details.blocked.reason
  • Add support for created on CustomerListCustomerBalanceTransactionsParams and InvoicePaymentListParams
  • Add support for new values financial_connections.account.account_numbers_updated and financial_connections.account.upcoming_account_number_expiry on enum Event.type
  • Add support for account_numbers on FinancialConnections.Account
  • Change type of FinancialConnections.Session.client_secret from string to string | null
  • Add support for fraud_risk on Issuing.AuthorizationCreateParams.testHelpers.risk_assessment
  • Add support for latest_fraud_warning on Issuing.Card
  • Add support for hooks on PaymentIntentCaptureParams, PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentIncrementAuthorizationParams, PaymentIntentUpdateParams, and PaymentIntent
  • Add support for mb_way and twint on Refund.destination_details
  • Add support for new values financial_connections.account.account_numbers_updated and financial_connections.account.upcoming_account_number_expiry on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_events
  • Add support for snapshot events FinancialConnectionsAccountAccountNumbersUpdatedEvent and FinancialConnectionsAccountUpcomingAccountNumberExpiryEvent with resource FinancialConnections.Account

See the changelog for more details.

This release changes the pinned API version to 2025-10-29.preview.

• #2501 Update generated code for private-preview
  • Add support for new resource Issuing.Program
  • Add support for create, list, retrieve, and update methods on resource Issuing.Program
  • Add support for schedule on Discount
  • Add support for applicable_fees on DelegatedCheckout.RequestedSession.total_details
  • Add support for schedule_details on Invoice.parent, InvoiceItem.parent, InvoiceLineItem.parent, and QuotePreviewInvoice.parent
  • Add support for new value schedule_details on enum InvoiceItem.parent.type
  • Add support for billing_schedules on InvoiceCreatePreviewParams.schedule_details, QuotePreviewSubscriptionSchedule, SubscriptionScheduleCreateParams, SubscriptionScheduleUpdateParams, and SubscriptionSchedule
  • Add support for new value schedule_details on enums Invoice.parent.type and QuotePreviewInvoice.parent.type
  • Add support for new value schedule_details on enum InvoiceLineItem.parent.type
  • Add support for latest_invoice on QuotePreviewSubscriptionSchedule and SubscriptionSchedule
  • Add support for phase_effective_at on QuotePreviewSubscriptionSchedule.default_settings, SubscriptionSchedule.default_settings, SubscriptionScheduleCreateParams.default_settings, and SubscriptionScheduleUpdateParams.default_settings
• #2494 Update generated code for private-preview
  • Remove support for resource V2.Tax.AutomaticRule
  • Remove support for create, deactivate, find, retrieve, and update methods on resource V2.Tax.AutomaticRule
  • Add support for self_reported_income and self_reported_monthly_housing_payment on AccountCreateParams.individual, AccountCreatePersonParams, AccountUpdateParams.individual, AccountUpdatePersonParams, Person, TokenCreateParams.account.individual, and TokenCreateParams.person
  • Add support for new values amendment_end, line_ends_at, schedule_end, and upcoming_invoice on enums InvoiceCreatePreviewParams.subscription_details.billing_schedules[].bill_until.type, Subscription.billing_schedules[].bill_until.type, SubscriptionCreateParams.billing_schedules[].bill_until.type, and SubscriptionUpdateParams.billing_schedules[].bill_until.type
  • Add support for billing_schedules and phase_effective_at on Quote.subscription_data_overrides[], Quote.subscription_data, QuoteCreateParams.subscription_data_overrides[], QuoteCreateParams.subscription_data, QuoteUpdateParams.subscription_data_overrides[], and QuoteUpdateParams.subscription_data
  • Add support for bill_from on Subscription.billing_schedules[]
  • Add support for amendment_end and line_ends_at on Subscription.billing_schedules[].bill_until

See the changelog for more details.

• #2489 Update generated code for private-preview
  • Add support for new resources TransitBalance, V2.Reporting.ReportRun, V2.Reporting.Report
  • Add support for create and retrieve methods on resource V2.Reporting.ReportRun
  • Add support for retrieve method on resource V2.Reporting.Report
  • Add support for create and refill test helper methods on resource Capital.FinancingOffer
  • Add support for allocated_funds on Charge, PaymentIntentConfirmParams, PaymentIntentCreateParams, and PaymentIntentUpdateParams
  • Add support for thin events V2ReportingReportRunCreatedEvent, V2ReportingReportRunFailedEvent, V2ReportingReportRunSucceededEvent, and V2ReportingReportRunUpdatedEvent with related object V2.Reporting.ReportRun

See the changelog for more details.

• #2500 Use TextEncoder instead of Buffer to ensure support in other JS environments
  • Fixes issues like #2499 and #2493 where use of Buffer.byteLength was causing errors in some runtime environments.

See the changelog for more details.

• #2488 Update generated code
  • Add support for capture_method on PaymentIntent.payment_method_options.card_present, PaymentIntentConfirmParams.payment_method_options.card_present, PaymentIntentCreateParams.payment_method_options.card_present, and PaymentIntentUpdateParams.payment_method_options.card_present

See the changelog for more details.

This release changes the pinned API version to 2025-10-29.preview.

• #2475 Update generated code for beta
  • Add support for crypto_storer on V2.Core.AccountUpdateParams.identity.attestations.terms_of_service
• #2443 Update generated code for beta
  • Add support for update method on resource V2.MoneyManagement.FinancialAccount
  • Add support for confirm_microdeposits, list, and send_microdeposits methods on resource V2.Core.Vault.UsBankAccount
  • Add support for list method on resource V2.Core.Vault.GbBankAccount
  • Add support for new value verification_data_not_found on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, BankAccount.future_requirements.errors[].code, BankAccount.requirements.errors[].code, Capability.future_requirements.errors[].code, Capability.requirements.errors[].code, Person.future_requirements.errors[].code, and Person.requirements.errors[].code
  • Add support for payment_portal_url on Charge.payment_method_details.rechnung, PaymentAttemptRecord.payment_method_details.rechnung, and PaymentRecord.payment_method_details.rechnung
  • Add support for tax_id_element on CustomerSession.components and CustomerSessionCreateParams.components
  • Add support for starting_after on PaymentAttemptRecordListParams
  • Add support for new value solana on enums PaymentAttemptRecord.payment_method_details.crypto.network and PaymentRecord.payment_method_details.crypto.network
  • Add support for reference on PaymentIntentAmountDetailsLineItem.payment_method_options.klarna, PaymentIntentCaptureParams.amount_details.line_items[].payment_method_options.klarna, PaymentIntentConfirmParams.amount_details.line_items[].payment_method_options.klarna, PaymentIntentCreateParams.amount_details.line_items[].payment_method_options.klarna, PaymentIntentIncrementAuthorizationParams.amount_details.line_items[].payment_method_options.klarna, and PaymentIntentUpdateParams.amount_details.line_items[].payment_method_options.klarna
  • Change PaymentIntent.payment_details.customer_reference to be required
  • Change PaymentIntent.payment_details.order_reference to be required
  • Add support for subscription_reference on PaymentIntentAmountDetailsLineItem.payment_method_options.klarna
  • Add support for closed on V2.Core.AccountListParams and V2.Core.Account
  • Add support for new value payment_method on enums V2.Core.Account.configuration.customer.automatic_indirect_tax.location_source, V2.Core.AccountCreateParams.configuration.customer.automatic_indirect_tax.location_source, and V2.Core.AccountUpdateParams.configuration.customer.automatic_indirect_tax.location_source
  • Add support for usd on V2.Core.Account.configuration.storer.capabilities.holds_currencies, V2.Core.AccountCreateParams.configuration.storer.capabilities.holds_currencies, and V2.Core.AccountUpdateParams.configuration.storer.capabilities.holds_currencies
  • Add support for new values application_custom and application_express on enums V2.Core.Account.defaults.responsibilities.fees_collector, V2.Core.AccountCreateParams.defaults.responsibilities.fees_collector, and V2.Core.AccountUpdateParams.defaults.responsibilities.fees_collector
  • Add support for representative_declaration on V2.Core.Account.identity.attestations, V2.Core.AccountCreateParams.identity.attestations, and V2.Core.AccountUpdateParams.identity.attestations
  • Add support for new value holds_currencies.usd on enum V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability
  • Add support for verification on V2.Core.Vault.UsBankAccount
  • Add support for v1_id on EventsV2MoneyManagementTransactionCreatedEvent
  • Remove support for thin event V2BillingBillSettingUpdatedEvent with related object V2.Billing.BillSetting
  • Add support for error code payment_intent_rate_limit_exceeded on QuotePreviewInvoice.last_finalization_error
  • Add support for error codes blocked_payout_method_crypto_wallet and unsupported_payout_method_crypto_wallet on BlockedByStripeError
  • Add support for error code outbound_flow_from_closed_financial_account_unsupported on FeatureNotEnabledError
  • Add support for error code limit_payout_method_crypto_wallet on QuotaExceededError

See the changelog for more details.

• #2484 Update generated code for private-preview
  • Change DelegatedCheckout.RequestedSessionUpdateParams.line_item_details[].quantity to be required
  • Add support for payment_method_preview on DelegatedCheckout.RequestedSession
  • Add support for order_id on DelegatedCheckout.RequestedSession.order_details
  • Add support for lead 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 global_account_holder on V2.Core.Account.identity.attestations.terms_of_service.card_creator.commercial, V2.Core.AccountCreateParams.identity.attestations.terms_of_service.card_creator.commercial, and V2.Core.AccountUpdateParams.identity.attestations.terms_of_service.card_creator.commercial
  • Add support for new value commercial.lead.prepaid_card on enum V2.Core.Account.requirements.entries[].impact.restricts_capabilities[].capability
  • Add support for new value commercial.lead.prepaid_card on enum EventsV2CoreAccountIncludingConfigurationCardCreatorCapabilityStatusUpdatedEvent.updated_capability

See the changelog for more details.

• #2476 Update generated code for private-preview
  • Add support for report_refund method on resource PaymentRecord
  • Add support for representative_declaration on Account.company, AccountCreateParams.company, AccountUpdateParams.company, and TokenCreateParams.account.company
  • Add support for new value verification_data_not_found on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, BankAccount.future_requirements.errors[].code, BankAccount.requirements.errors[].code, Capability.future_requirements.errors[].code, Capability.requirements.errors[].code, Person.future_requirements.errors[].code, and Person.requirements.errors[].code
  • Add support for tenants on Billing.Analytics.MeterUsageRow
  • Add support for transfer on ApplicationFee.fee_source
  • Add support for new value transfer on enum ApplicationFee.fee_source.type
  • Add support for transit_balances_total on Balance
  • Add support for new value transit on enum BalanceTransaction.balance_type
  • Add support for tenant_group_by_keys on Billing.Analytics.MeterUsageRetrieveParams.meters[]
  • Change Billing.CreditGrantCreateParams.category to be optional
  • Add support for payment_method_configuration on BillingPortal.ConfigurationCreateParams.features.payment_method_update and BillingPortal.ConfigurationUpdateParams.features.payment_method_update
  • Add support for new value solana on enums Charge.payment_method_details.crypto.network, PaymentAttemptRecord.payment_method_details.crypto.network, and PaymentRecord.payment_method_details.crypto.network
  • Add support for payment_portal_url on Charge.payment_method_details.rechnung, PaymentAttemptRecord.payment_method_details.rechnung, and PaymentRecord.payment_method_details.rechnung
  • Add support for twint on Checkout.Session.payment_method_options and Checkout.SessionCreateParams.payment_method_options
  • Add support for new value custom on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Change CreditNote.refunds[].payment_record_refund to be required
  • Change CreditNote.refunds[].type to be required
  • Add support for customer_sheet, mobile_payment_element, and tax_id_element on CustomerSession.components and CustomerSessionCreateParams.components
  • Add support for new value custom on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for provider on Customer.tax
  • Remove support for risk_details on DelegatedCheckout.RequestedSessionCreateParams
  • Add support for risk_details on DelegatedCheckout.RequestedSessionConfirmParams
  • Add support for new value platform_terms_of_service on enums File.purpose and FileListParams.purpose
  • Add support for new value platform_terms_of_service on enum FileCreateParams.purpose
  • Add support for starting_after on PaymentAttemptRecordListParams
  • Add support for reference on PaymentIntentAmountDetailsLineItem.payment_method_options.klarna, PaymentIntentCaptureParams.amount_details.line_items[].payment_method_options.klarna, PaymentIntentConfirmParams.amount_details.line_items[].payment_method_options.klarna, PaymentIntentCreateParams.amount_details.line_items[].payment_method_options.klarna, PaymentIntentIncrementAuthorizationParams.amount_details.line_items[].payment_method_options.klarna, and PaymentIntentUpdateParams.amount_details.line_items[].payment_method_options.klarna
  • Add support for allocated_funds on PaymentIntent
  • Change PaymentIntent.payment_details.customer_reference to be required
  • Change PaymentIntent.payment_details.order_reference to be required
  • Add support for subscription_reference on PaymentIntentAmountDetailsLineItem.payment_method_options.klarna
  • Add support for name_collection on PaymentLinkCreateParams, PaymentLinkUpdateParams, and PaymentLink
  • Add support for crypto on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, and Refund.destination_details
  • Add support for mb_way on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfiguration
  • Add support for custom on PaymentMethodCreateParams and PaymentMethod
  • Add support for excluded_payment_method_types on SetupIntentCreateParams, SetupIntentUpdateParams, and SetupIntent
  • Change SetupIntent.flow_directions to be optional
  • Add support for tw on Tax.Registration.country_options and Tax.RegistrationCreateParams.country_options
  • Add support for gip on Terminal.Configuration.tipping, Terminal.ConfigurationCreateParams.tipping, and Terminal.ConfigurationUpdateParams.tipping
  • Add support for last_seen_at on Terminal.Reader
  • Add support for application_fee_amount on TransferCreateParams and Transfer
  • Add support for application_fee on Transfer
  • Add support for new value 2025-10-29.clover on enum WebhookEndpointCreateParams.api_version
  • Add support for high_risk_activities_description, high_risk_activities, money_services_description, operates_in_prohibited_countries, participates_in_regulated_activity, purpose_of_funds_description, purpose_of_funds, regulated_activity, source_of_funds_description, and source_of_funds on V2.Core.Account.configuration.storer, V2.Core.AccountCreateParams.configuration.storer, and V2.Core.AccountUpdateParams.configuration.storer
  • Add support for crypto_wallets on V2.Core.Account.configuration.storer.capabilities.financial_addresses, V2.Core.Account.configuration.storer.capabilities.outbound_payments, V2.Core.Account.configuration.storer.capabilities.outbound_transfers, V2.Core.AccountCreateParams.configuration.storer.capabilities.financial_addresses, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_payments, V2.Core.AccountCreateParams.configuration.storer.capabilities.outbound_transfers, V2.Core.AccountUpdateParams.configuration.storer.capabilities.financial_addresses, V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_payments, and V2.Core.AccountUpdateParams.configuration.storer.capabilities.outbound_transfers
  • Add support for usdc on V2.Core.Account.configuration.storer.capabilities.holds_currencies, V2.Core.AccountCreateParams.configuration.storer.capabilities.holds_currencies, and V2.Core.AccountUpdateParams.configuration.storer.capabilities.holds_currencies
  • Add support for crypto_storer on V2.Core.Account.identity.attestations.terms_of_service and V2.Core.AccountCreateParams.identity.attestations.terms_of_service
  • Add support for compliance_screening_description on V2.Core.Account.identity.business_details, V2.Core.AccountCreateParams.identity.business_details, and V2.Core.AccountUpdateParams.identity.business_details
  • Add support for external_amount on V2.MoneyManagement.ReceivedCredit and V2.MoneyManagement.ReceivedDebit
  • Add support for error code payment_intent_rate_limit_exceeded on Invoice.last_finalization_error, PaymentIntent.last_payment_error, QuotePreviewInvoice.last_finalization_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError

See the changelog for more details.

• #2492 Add support for value payment_record to enum InvoicePayment.payment.type
• #2485 correctly calculate content-length for JSON bodies that contain unicode

See the changelog for more details.

• #2477 Update generated code
  • Improve docs for PaymentIntent related endpoints
• #2469 Update generated code
  • Add support for new resources PaymentAttemptRecord, PaymentIntentAmountDetailsLineItem, and PaymentRecord
  • Add support for list and retrieve methods on resource PaymentAttemptRecord
  • Add support for report_payment_attempt_canceled, report_payment_attempt_failed, report_payment_attempt_guaranteed, report_payment_attempt_informational, report_payment_attempt, report_payment, report_refund, and retrieve methods on resource PaymentRecord
  • Add support for list method on resource PaymentIntentAmountDetailsLineItem
  • Add support for representative_declaration on Account.company, AccountCreateParams.company, AccountUpdateParams.company, and TokenCreateParams.account.company
  • Change Billing.CreditGrantCreateParams.category to be optional
  • Add support for payment_method_configuration on BillingPortal.ConfigurationCreateParams.features.payment_method_update and BillingPortal.ConfigurationUpdateParams.features.payment_method_update
  • Add support for new value solana on enum Charge.payment_method_details.crypto.network
  • Add support for new value mb_way on enum Checkout.SessionCreateParams.excluded_payment_method_types
  • Add support for twint on Checkout.Session.payment_method_options and Checkout.SessionCreateParams.payment_method_options
  • Add support for new value mb_way on enum Checkout.SessionCreateParams.payment_method_types
  • Add support for new value custom on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Add support for payment_record_refund and type on CreditNote.refunds[], CreditNoteCreateParams.refunds[], CreditNotePreviewLinesParams.refunds[], and CreditNotePreviewParams.refunds[]
  • Add support for customer_sheet and mobile_payment_element on CustomerSession.components and CustomerSessionCreateParams.components
  • Add support for new value custom on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for provider on Customer.tax
  • Add support for new values balance_settings.updated and invoice.payment_attempt_required on enum Event.type
  • Add support for new value platform_terms_of_service on enums File.purpose and FileListParams.purpose
  • Add support for new value platform_terms_of_service on enum FileCreateParams.purpose
  • Add support for payment_record on InvoiceAttachPaymentParams, InvoicePayment.payment, and InvoicePaymentListParams.payment
  • Change type of InvoicePaymentListParams.payment.type from literal('payment_intent') to enum('payment_intent'|'payment_record')
  • Add support for new value custom on enums Invoice.payment_settings.payment_method_types, InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.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 amount_details on PaymentIntentCaptureParams, PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentIncrementAuthorizationParams, and PaymentIntentUpdateParams
  • Add support for payment_details on PaymentIntentCaptureParams, PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentIncrementAuthorizationParams, PaymentIntentUpdateParams, and PaymentIntent
  • Add support for discount_amount, line_items, shipping, and tax on PaymentIntent.amount_details
  • Add support for name_collection on PaymentLinkCreateParams, PaymentLinkUpdateParams, and PaymentLink
  • Add support for new value mb_way on enums PaymentLink.payment_method_types, PaymentLinkCreateParams.payment_method_types, and PaymentLinkUpdateParams.payment_method_types
  • Add support for crypto on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, and Refund.destination_details
  • Add support for mb_way on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfiguration
  • Add support for custom on PaymentMethodCreateParams and PaymentMethod
  • Add support for excluded_payment_method_types on SetupIntentCreateParams, SetupIntentUpdateParams, and SetupIntent
  • Add support for tw on Tax.Registration.country_options and Tax.RegistrationCreateParams.country_options
  • Add support for gip on Terminal.Configuration.tipping, Terminal.ConfigurationCreateParams.tipping, and Terminal.ConfigurationUpdateParams.tipping
  • Add support for last_seen_at on Terminal.Reader
  • Add support for new values balance_settings.updated and invoice.payment_attempt_required on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_events
  • Add support for new value 2025-10-29.clover on enum WebhookEndpointCreateParams.api_version
  • Add support for gt, gte, lt, lte, and types on V2.Core.EventListParams
  • Change V2.Core.EventListParams.object_id to be optional
  • Add support for snapshot event BalanceSettingsUpdatedEvent with resource BalanceSettings
  • Add support for snapshot event InvoicePaymentAttemptRequiredEvent with resource Invoice
  • Add support for error code payment_intent_rate_limit_exceeded on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError

See the changelog for more details.