chore(deps): update dependency stripe to v22 - autoclosed

v22.3.2

Compare Source

• #​2784 Replace source hash with Telemetry UUID
• #​2783 Make Error fields generated

v22.3.1

Compare Source

• #​2781 Remove unused Retry-After header support
• #​2779 Export HttpClient types as interfaces instead of classes
  • Stripe.HttpClient and Stripe.HttpClientResponse types now reflect the minimal interface contract rather than the concrete class, making custom HTTP client implementations easier to type correctly.
• #​2778 Restore missing public type exports from v21 Stripe namespace
  • Restores Stripe.StripeConfig, Stripe.CryptoProvider, Stripe.HttpClient, Stripe.HttpClientResponse, Stripe.Webhooks, Stripe.Signature, Stripe.WebhookTestHeaderOptions, Stripe.StripeResource, Stripe.LatestApiVersion, Stripe.HttpAgent, Stripe.HttpProtocol, and Stripe.RawErrorType type exports that were inadvertently dropped in the v22 type system migration.

v22.3.0

Compare Source

This release changes the pinned API version to 2026-06-24.dahlia.

• #​2748 Update generated code

  • Add support for release_details on Reserve.Hold
  • ⚠️ Add support for new value tax_fund on enum BalanceTransaction.type
  • Change Billing.CreditGrant.priority to be required
  • Add support for buyer_id on Charge.payment_method_details.bizum, ConfirmationToken.payment_method_preview.bizum, ConfirmationToken.payment_method_preview.blik, PaymentAttemptRecord.payment_method_details.bizum, PaymentMethod.bizum, PaymentMethod.blik, and PaymentRecord.payment_method_details.bizum
  • Add support for transaction_link_id on Charge.payment_method_details.card
  • ⚠️ Add support for new value sui on enums Charge.payment_method_details.crypto.network, PaymentAttemptRecord.payment_method_details.crypto.network, and PaymentRecord.payment_method_details.crypto.network
  • ⚠️ Add support for new value usdsui on enums Charge.payment_method_details.crypto.token_currency, PaymentAttemptRecord.payment_method_details.crypto.token_currency, and PaymentRecord.payment_method_details.crypto.token_currency
  • Add support for fingerprint on Charge.payment_method_details.pix, ConfirmationToken.payment_method_preview.pix, PaymentMethod.pix, and SetupAttempt.payment_method_details.pix
  • Add support for sunbit on Checkout.Session.payment_method_options, Checkout.SessionCreateParams.payment_method_options, PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_options, and PaymentIntentUpdateParams.payment_method_options
  • Add support for billing_cycle_anchor_config on Checkout.SessionCreateParams.subscription_data
  • Add support for wechat_pay on Checkout.Session.payment_method_options
  • Add support for mastercard_compliance on Dispute.evidence.enhanced_evidence, Dispute.evidence_details.enhanced_eligibility, and DisputeUpdateParams.evidence.enhanced_evidence
  • ⚠️ Add support for new value mastercard_compliance on enum Dispute.enhanced_eligibility_types
  • Add support for status_details on FinancialConnections.Account
  • ⚠️ Add support for new value validated on enum Identity.VerificationSession.redaction.status
  • Add support for new value satispay on enums InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_types
  • ⚠️ Add support for new value satispay on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
  • ⚠️ Remove support for stored_credential_usage on PaymentAttemptRecord.payment_method_details.card and PaymentRecord.payment_method_details.card
  • ⚠️ Change PaymentAttemptRecord.payment_method_details.card.description and PaymentRecord.payment_method_details.card.description to be optional
  • ⚠️ Change PaymentAttemptRecord.payment_method_details.card.iin and PaymentRecord.payment_method_details.card.iin to be optional
  • ⚠️ Change PaymentAttemptRecord.payment_method_details.card.issuer and PaymentRecord.payment_method_details.card.issuer to be optional
  • Add support for setup_future_usage on PaymentIntent.payment_method_options.satispay, PaymentIntentConfirmParams.payment_method_options.satispay, PaymentIntentCreateParams.payment_method_options.satispay, and PaymentIntentUpdateParams.payment_method_options.satispay
  • Change PaymentRecordReportRefundParams.refunded to be optional
  • Add support for satispay on SetupAttempt.payment_method_details
  • Add support for custom_fields, description, and footer on Subscription.invoice_settings, SubscriptionCreateParams.invoice_settings, and SubscriptionUpdateParams.invoice_settings
  • Add support for payment_method_options and payment_method on TopupCreateParams
  • Add support for new value 2026-06-24.dahlia on enum WebhookEndpointCreateParams.api_version
  • Add support for mode on V2.Commerce.ProductCatalogImport
  • ⚠️ Add support for new value promotion on enum V2.Commerce.ProductCatalogImport.feed_type
  • Add support for sunbit_payments on V2.Core.Account.configuration.merchant.capabilities, V2.Core.AccountCreateParams.configuration.merchant.capabilities, and V2.Core.AccountUpdateParams.configuration.merchant.capabilities
  • Add support for crypto_money_manager and money_manager on V2.Core.AccountUpdateParams.identity.attestations.terms_of_service
  • ⚠️ Remove support for crypto_storer and storer on V2.Core.AccountUpdateParams.identity.attestations.terms_of_service
  • Add support for new value promotion on enum V2.Commerce.ProductCatalogImportCreateParams.feed_type
  • ⚠️ Add support for new value sunbit_payments on enum EventsV2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent.updated_capability
  • Add support for error codes anomalous_money_movement_request, failed_tax_calculation, financial_account_balance_does_not_support_currency, financial_account_capability_not_enabled, and financial_account_capability_restricted on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, StripeError, and Terminal.Reader.action.api_error

• #​2765 fix: CJS companion namespace access for resource types at all depths

  • Fixes TypeScript type access for nested namespaces in CJS mode (e.g. Stripe.Price.Recurring, Stripe.Subscription.BillingMode)
  • Fixes TypeScript type access for nested resource types e.g. Stripe.Billing.Alert.Status, Stripe.Terminal.Configuration.Tipping in both ESM and CJS modes.

v22.2.3

Compare Source

• #​2761 Encode URI path params in accounts.retrieve

v22.2.2

Compare Source

• #​2725 Fixes CJS type exports for stripe package (reported in #​2683)
• #​2758 Fix Stripe.ErrorType.StripeError incorrectly being usable as a runtime class (reported in #​2661)
• #​2753 handle shadowed namespaces (reported in #​2691)

v22.2.1

Compare Source

• #​2750 URI Encode path params
• #​2747 Fix V2ListIterator: concurrency guard and empty page handling
• #​2740 Add "source" field to user-agent header
• #​2734 Fix parseHttpHeaderAsNumber to return undefined instead of NaN

v22.2.0

Compare Source

This release changes the pinned API version to 2026-05-27.dahlia.

• #​2710 Update generated code
  • Add support for new resource V2.Commerce.ProductCatalogImport
  • Add support for create and retrieve methods on resource V2.Commerce.ProductCatalogImport
  • Add support for bizum_payments and scalapay_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
  • Add support for automatic_transfer_rules_by_currency on BalanceSettingUpdateParams.payments.payouts and BalanceSettings.payments.payouts
  • Add support for start_of_day on BalanceSettingUpdateParams.payments.settlement_timing and BalanceSettings.payments.settlement_timing
  • Add support for description on ChargeCreateParams.transfer_data, PaymentIntent.transfer_data, PaymentIntentCreateParams.transfer_data, and PaymentIntentUpdateParams.transfer_data
  • Add support for bizum on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, 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, 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 scalapay on Charge.payment_method_details, Checkout.Session.payment_method_options, Checkout.SessionCreateParams.payment_method_options, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, 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, Refund.destination_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data
  • Add support for mandate on Charge.payment_method_details.twint, PaymentAttemptRecord.payment_method_details.twint, and PaymentRecord.payment_method_details.twint
  • Add support for new values bizum and scalapay on enums Checkout.SessionCreateParams.excluded_payment_method_types, PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentUpdateParams.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, and SetupIntentUpdateParams.excluded_payment_method_types
  • Change type of Checkout.SessionCreateParams.payment_method_options.twint.setup_future_usage, PaymentIntentConfirmParams.payment_method_options.twint.setup_future_usage, PaymentIntentCreateParams.payment_method_options.twint.setup_future_usage, and PaymentIntentUpdateParams.payment_method_options.twint.setup_future_usage from literal('none') to enum('none'|'off_session')
  • Add support for new values bizum and scalapay on enum Checkout.SessionCreateParams.payment_method_types
  • ⚠️ Change type of Checkout.Session.payment_method_options.twint.setup_future_usage and PaymentIntent.payment_method_options.twint.setup_future_usage from literal('none') to enum('none'|'off_session')
  • Add support for new values bizum and scalapay 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 values bizum and scalapay on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Add support for new values bizum and scalapay on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for credited_items on InvoiceItem.proration_details
  • Add support for new value twint on enums InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_types
  • Add support for discountable on InvoiceCreatePreviewParams.schedule_details.phases[].add_invoice_items[], SubscriptionCreateParams.add_invoice_items[], SubscriptionSchedule.phases[].add_invoice_items[], SubscriptionScheduleCreateParams.phases[].add_invoice_items[], SubscriptionScheduleUpdateParams.phases[].add_invoice_items[], and SubscriptionUpdateParams.add_invoice_items[]
  • Add support for billing_schedules on InvoiceCreatePreviewParams.subscription_details, SubscriptionCreateParams, SubscriptionUpdateParams, and Subscription
  • Add support for new value max_billed_until on enums InvoiceCreatePreviewParams.subscription_details.cancel_at, SubscriptionCreateParams.cancel_at, and SubscriptionUpdateParams.cancel_at
  • Add support for amount_paid_off_stripe on Invoice
  • ⚠️ Add support for new value twint on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
  • Add support for twint on Mandate.payment_method_details and SetupAttempt.payment_method_details
  • Add support for metadata on PaymentIntent.transfer_data, PaymentIntentCreateParams.transfer_data, PaymentIntentUpdateParams.transfer_data, and Subscription.pending_update
  • Add support for payment_data on PaymentIntent.transfer_data, PaymentIntentCreateParams.transfer_data, and PaymentIntentUpdateParams.transfer_data
  • ⚠️ Add support for new values bizum and scalapay on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_types
  • Add support for blik_authorize on PaymentIntent.next_action and SetupIntent.next_action
  • Add support for payment_method_options on PaymentLinkCreateParams, PaymentLinkUpdateParams, and PaymentLink
  • Add support for new value bizum on enums PaymentLinkCreateParams.payment_method_types and PaymentLinkUpdateParams.payment_method_types
  • ⚠️ Add support for new value bizum on enum PaymentLink.payment_method_types
  • Add support for active on PaymentMethodConfigurationListParams
  • Add support for billed_until on SubscriptionItem
  • Add support for discount and discounts on Subscription.pending_update
  • Add support for verifone_m425, verifone_p630, verifone_ux700, and verifone_v660p on Terminal.ConfigurationCreateParams, Terminal.ConfigurationUpdateParams, and Terminal.Configuration
  • Add support for new values simulated_verifone_m425, simulated_verifone_p630, simulated_verifone_ux700, simulated_verifone_v660p, verifone_m425, verifone_p630, verifone_ux700, and verifone_v660p on enum Terminal.ReaderListParams.device_type
  • Add support for api_error and print_content on Terminal.Reader.action
  • ⚠️ Add support for new value print_content on enum Terminal.Reader.action.type
  • ⚠️ Add support for new values simulated_verifone_m425, simulated_verifone_p630, simulated_verifone_ux700, simulated_verifone_v660p, verifone_m425, verifone_p630, verifone_ux700, and verifone_v660p on enum Terminal.Reader.device_type
  • Add support for customer on TestHelpers.TestClockCreateParams
  • Add support for new value 2026-05-27.dahlia on enum WebhookEndpointCreateParams.api_version
  • Add support for signer on V2.Core.Account.identity.business_details.documents.proof_of_registration, V2.Core.Account.identity.business_details.documents.proof_of_ultimate_beneficial_ownership, V2.Core.AccountCreateParams.identity.business_details.documents.proof_of_registration, V2.Core.AccountCreateParams.identity.business_details.documents.proof_of_ultimate_beneficial_ownership, V2.Core.AccountTokenCreateParams.identity.business_details.documents.proof_of_registration, V2.Core.AccountTokenCreateParams.identity.business_details.documents.proof_of_ultimate_beneficial_ownership, V2.Core.AccountUpdateParams.identity.business_details.documents.proof_of_registration, and V2.Core.AccountUpdateParams.identity.business_details.documents.proof_of_ultimate_beneficial_ownership
  • 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 enum V2.Core.EventDestination.type
  • Add support for new value azure_event_grid on enum V2.Core.EventDestinationCreateParams.type
  • ⚠️ Add support for new value meter_event_value_too_many_digits on enums EventsV1BillingMeterErrorReportTriggeredEvent.reason.error_types[].code and EventsV1BillingMeterNoMeterFoundEvent.reason.error_types[].code
  • Add support for event notifications V2CommerceProductCatalogImportsFailedEvent, V2CommerceProductCatalogImportsProcessingEvent, V2CommerceProductCatalogImportsSucceededEvent, and V2CommerceProductCatalogImportsSucceededWithErrorsEvent with related object V2.Commerce.ProductCatalogImport
  • Add support for error codes payment_method_microdeposit_processing_error and siret_invalid on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError
• #​2723 Emit warning when stripe-notify header is present in response
• #​2717 Add V2List and V2ListPromise types for v2 list endpoints
  • Adds V2List and V2ListPromise types to represent API v2 list responses. These types include deprecated fields from the previously returned list shapes. These fields will be removed in the next major release.
• #​2715 Add WinterTC compatibility ESLint rule
• #​2711 Export manually maintained types for OAuthToken and OAuth param classes

  // ❌ Before (v22.0.0-v22.1.1)
  const oAuthToken: Stripe.OAuthToken = {};
  
  // ✅ After (works on v22.1.2+)
  const oAuthToken: Stripe.OAuthToken = {};

• #​2712 Exported types for nested param classes
  • Types inside nested param class namespaces(e.g. Stripe.V2.Core.AccountCreateParams.Configuration, Stripe.V2.Core.AccountCreateParams.Dashboard) are now accessible.

v22.1.1

Compare Source

• #​2703 Export Decimal type from Stripe namespace

  • Added Stripe.Decimal as a usable type in the Stripe namespace, enabling type annotations like function takesDecimal(d: Stripe.Decimal).

• #​2704 Fix file upload regression: restore multipart request data processor

  • Fixed file uploads failing with StripeInvalidRequestError on the /v1/files endpoint since v22.

v22.1.0

Compare Source

This release changes the pinned API version to 2026-04-22.dahlia.

• #​2639 Update generated code
  • Add support for app_distribution and sunbit_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
  • Add support for balance_report and payout_reconciliation_report on AccountSession.components and AccountSessionCreateParams.components
  • ⚠️ Add support for new values fee_credit_funding, inbound_transfer_reversal, and inbound_transfer on enum BalanceTransaction.type
  • Add support for sunbit on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentAttemptRecord.payment_method_details, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.payment_method_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data
  • ⚠️ Add support for new values phantom_cash and usdt on enums Charge.payment_method_details.crypto.token_currency, PaymentAttemptRecord.payment_method_details.crypto.token_currency, and PaymentRecord.payment_method_details.crypto.token_currency
  • Add support for location and reader on Charge.payment_method_details.klarna, PaymentAttemptRecord.payment_method_details.klarna, and PaymentRecord.payment_method_details.klarna
  • Add support for mandate on Charge.payment_method_details.pix, PaymentAttemptRecord.payment_method_details.pix, and PaymentRecord.payment_method_details.pix
  • Add support for managed_payments on Checkout.SessionCreateParams, Checkout.Session, PaymentIntent, PaymentLinkCreateParams, PaymentLink, SetupIntent, and Subscription
  • Add support for new value sunbit on enums Checkout.SessionCreateParams.excluded_payment_method_types, PaymentIntentConfirmParams.excluded_payment_method_types, PaymentIntentCreateParams.excluded_payment_method_types, PaymentIntentUpdateParams.excluded_payment_method_types, SetupIntentCreateParams.excluded_payment_method_types, and SetupIntentUpdateParams.excluded_payment_method_types
  • Add support for mandate_options on Checkout.Session.payment_method_options.pix, Checkout.SessionCreateParams.payment_method_options.pix, PaymentIntent.payment_method_options.pix, PaymentIntentConfirmParams.payment_method_options.pix, PaymentIntentCreateParams.payment_method_options.pix, and PaymentIntentUpdateParams.payment_method_options.pix
  • Change type of Checkout.SessionCreateParams.payment_method_options.pix.setup_future_usage, PaymentIntentConfirmParams.payment_method_options.pix.setup_future_usage, PaymentIntentCreateParams.payment_method_options.pix.setup_future_usage, and PaymentIntentUpdateParams.payment_method_options.pix.setup_future_usage from literal('none') to enum('none'|'off_session')
  • Add support for new value sunbit on enum Checkout.SessionCreateParams.payment_method_types
  • ⚠️ Add support for new values fo_vat, gi_tin, it_cf, and py_ruc 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
  • ⚠️ Change type of Checkout.Session.payment_method_options.pix.setup_future_usage and PaymentIntent.payment_method_options.pix.setup_future_usage from literal('none') to enum('none'|'off_session')
  • Add support for new value sunbit 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 sunbit on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Add support for new values fo_vat, gi_tin, it_cf, and py_ruc 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 value sunbit on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for pix on Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, Mandate.payment_method_details, SetupAttempt.payment_method_details, SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_options, 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 upi on Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.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 values pix and upi on enums InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_types
  • ⚠️ Add support for new values pix and upi on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
  • Add support for card_presence on Issuing.Authorization
  • Add support for allowed_card_presences and blocked_card_presences on Issuing.Card.spending_controls, Issuing.CardCreateParams.spending_controls, Issuing.CardUpdateParams.spending_controls, Issuing.Cardholder.spending_controls, Issuing.CardholderCreateParams.spending_controls, and Issuing.CardholderUpdateParams.spending_controls
  • ⚠️ Add support for new value fulfillment_error on enum Issuing.Card.cancellation_reason
  • ⚠️ Add support for new value fulfillment_error on enum Issuing.Card.replacement_reason
  • Add support for amount and currency on Mandate.multi_use
  • Add support for amount_to_confirm on PaymentIntentConfirmParams
  • ⚠️ Add support for new value sunbit on enums PaymentIntent.excluded_payment_method_types and SetupIntent.excluded_payment_method_types
  • Add support for klarna_display_qr_code on PaymentIntent.next_action
  • Add support for new value sunbit on enums PaymentLinkCreateParams.payment_method_types and PaymentLinkUpdateParams.payment_method_types
  • ⚠️ Add support for new value sunbit on enum PaymentLink.payment_method_types
  • ⚠️ Add support for new values low, not_assessed, and unknown on enum Radar.PaymentEvaluation.signals.fraudulent_payment.risk_level
  • Add support for new value account on enum Radar.ValueListCreateParams.item_type
  • ⚠️ Add support for new value account on enum Radar.ValueList.item_type
  • Add support for moto on SetupAttempt.payment_method_details.card
  • Add support for pix_display_qr_code on SetupIntent.next_action
  • Add support for new value 2026-04-22.dahlia on enum WebhookEndpointCreateParams.api_version
  • Add support for error codes action_blocked and approval_required on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError
• #​2688 Preserve stack traces for async operations

v22.0.2

Compare Source

• #​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';

v22.0.1

Compare Source

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

v22.0.0

Compare Source

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
  })

  If those look familiar, head over to the migration guide to update your code.

• #​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',
  });

• #​2619 Improved TypeScript support in the Node SDK

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

• #​2635 Updated stripe.spec.ts test and constructEvent.tolerance type