releases.shpreview
Stripe/stripe-node

stripe-node

$npx -y @buildinternet/releases show stripe-node
Mon
Wed
Fri
AprMayJunJulAugSepOctNovDecJanFebMarApr
Less
More
Releases36Avg11/moVersionsv20.2.0-alpha.3 → v22.1.0-beta.3
Feb 25, 2026

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

  • #2566 Update generated code for beta
    • 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 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, Order.tax_details.tax_ids[].type, and QuotePreviewInvoice.customer_tax_ids[].type
    • Add support for new value lk_vat on enums OrderCreateParams.tax_details.tax_ids[].type and OrderUpdateParams.tax_details.tax_ids[].type
    • Add support for new value pay_by_bank on enum QuotePreviewInvoice.payment_settings.payment_method_types
    • Add support for new values bt_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 enum V2.Core.Account.configuration.recipient.default_outbound_destination.type
    • 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
    • Change V2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.transaction_details.flow to be optional
    • Add support for error codes storer_capability_missing and storer_capability_not_active on QuotePreviewInvoice.last_finalization_error

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.

Feb 19, 2026
  • #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.

Feb 11, 2026
  • #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.

Feb 5, 2026
  • #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.

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

Feb 4, 2026
  • #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.

Jan 28, 2026

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.

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.

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
  • #2562 Document usage of undocumented API parameters

See the changelog for more details.

Jan 21, 2026
  • #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.

Jan 16, 2026
  • #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.

Jan 14, 2026
  • #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.

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

  • #2550 Remove npm whoami command from github workflow

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.

Jan 8, 2026

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.

Jan 7, 2026
  • #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.

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

Jan 6, 2026
  • #2535 Update qs dependency to latest version

See the changelog for more details.

Latest
v22.1.0-beta.3
Tracking Since
Oct 17, 2023
Last checked Apr 21, 2026