Packages

stripe

23.0.0MIT
  • 23.0.0 is the latest, published 1 October 2026.
  • No known security advisory.
  • 23.x: 1 release since 1 October 2026, 6 in the last 90 days.

Releases in the last 90 days

Feed of releases and advisories

Every stable release, newest first. Notes are quoted as the maintainers published them.

  1. 23.0.0

    1 October 2026
    This release changes the pinned API version to 2026-09-30.endive.

    This release changes the pinned API version to 2026-09-30.endive.

    • Support EventNotifications with singleton related objects

    • Allow suppressing Stripe notices

      Set the STRIPE_SUPPRESS_NOTICES environment variable to true to suppress Stripe notices in test and sandbox environments when not running under a detected AI agent. Notices remain enabled by default and continue to be shown to AI agents.

    • Fix account scoping for EventNotificationHandler callback clients

      • Fix callback clients to use the event's Stripe context and preserve client telemetry.

      • Fix 400 errors when using an EventNotificationHandler with a StripeClient configured with stripeAccount.

    • breaking

      ⚠️ #2856 Remove V1-only fields from V2 list response types

      Remove the V1-only object, has_more, and url fields from Stripe.V2List<T>. These fields were never populated and were added only to maintain type compatibility when correcting the V2 list response type in a minor release.

    • breaking

      ⚠️ #2862 Remove Stripe.constructEventWithoutVerification

      Removed the function Stripe.constructEventWithoutVerification() that was mistakenly added in version 22.5.0 of this package. The same functionality can be achieved via stripe.webhooks.constructEventWithoutVerification(payload);

    • breaking

      ⚠️ Generate operation-specific address parameters for V2 requests

      • Change V2 request address properties from shared V1 address parameter types to operation-specific V2 interfaces.

    • breaking

      ⚠️ #2865 Remove ErrorType export

      Remove the ErrorType interface from the top level client. Users can use .errors instead since it works as both a type and a value

    • breaking

      ⚠️ #2868 Classify incomplete response bodies as connection errors

      • Responses that stall or are severed before the body is complete now throw StripeConnectionError instead of StripeAPIError.

    • Fix NodeHttpClient compatibility with HTTP request interceptors

      • Fix NodeHttpClient requests hanging when using Nock 14 or MSW interceptors (#2211).

    • breaking

      ⚠️ Drop support for Node 18

      Drop support for Node.js 18. Node.js 20 is now the minimum supported version.

    • breaking

      ⚠️ #2876 Update verifyHeader and verifyHeaderAsync methods to use DEFAULT_TOLERANCE

      stripe.webhooks.signature.verifyHeader() and verifyHeaderAsync() previously skipped timestamp tolerance verification when the tolerance argument was omitted. They now default to Webhook.DEFAULT_TOLERANCE

      Passing 0 to stripe.webhooks.constructEvent now properly skips timestamp tolerance verification. Previously, passing 0 would perform verification with the default tolerance Webhook.DEFAULT_TOLERANCE.

    • Update generated code

      • Release specs are identical.

    • breaking

      ⚠️ #2832 Update generated code

      • Add support for new resources Apps.Install, ProductCatalog.TrialOffer, Tax.Location, and ThreeDSecure.Authentication

      • Add support for create, list, retrieve, uninstall, and update methods on resource Apps.Install

      • Add support for create, list, retrieve, and update methods on resource ProductCatalog.TrialOffer

      • Add support for create, list, and retrieve methods on resource Tax.Location

      • Add support for cancel, create, list, retrieve, and submit methods on resource ThreeDSecure.Authentication

      • Add support for pause method on resource Subscription

      • Add support for specified_commercial_transactions_act_url on Account.business_profile, AccountCreateParams.business_profile, and AccountUpdateParams.business_profile

      • Add support for blik_recurring_payments and sequra_payments on Account.capabilities, AccountCreateParams.capabilities, AccountUpdateParams.capabilities, V2.Core.Account.configuration.merchant.capabilities, V2.Core.AccountCreateParams.configuration.merchant.capabilities, and V2.Core.AccountUpdateParams.configuration.merchant.capabilities

      • Add support for paypay_payments on Account.capabilities, Account.settings, AccountCreateParams.capabilities, AccountCreateParams.settings, AccountUpdateParams.capabilities, and AccountUpdateParams.settings

      • Add support for sepa_debit_payments on AccountCreateParams.settings, V2.Core.AccountCreateParams.configuration.merchant, and V2.Core.AccountUpdateParams.configuration.merchant

      • ⚠️ Change type of AccountRejectParams.reason from string to enum

      • ⚠️ Add support for new values invalid_address_cmra_address and invalid_address_registered_agent_address 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 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, digital_excise_tax, entertainment_tax, gross_receipts_tax, hospitality_tax, luxury_tax, recycling_fee, resort_tax, tourism_tax, and utility_users_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 destination on Reserve.Hold, Reserve.Plan, and Reserve.Release

      • Add support for manual_release on Reserve.Plan

      • ⚠️ Add support for new value other on enum Reserve.Plan.status

      • ⚠️ Add support for new values manual_release and other on enum Reserve.Plan.type

      • ⚠️ Add support for new value hold_expired on enum Reserve.Release.reason

      • ⚠️ Remove support for value bulk_hold_expiry from enum Reserve.Release.reason

      • Add support for new values issuing_dispute_provisional_credit_reversal and issuing_dispute_provisional_credit on enum BalanceTransaction.type

      • Add support for paypay 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, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data

      • Add support for sequra 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, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data

      • Add support for electronic_commerce_indicator on Charge.payment_method_details.card

      • ⚠️ Change type of Charge.payment_method_details.card.mandate from string to expandable(Mandate)

      • Add support for allowed_payment_method_types on Checkout.SessionCreateParams and Checkout.Session

      • ⚠️ Remove support for payment_method_types on Checkout.SessionCreateParams, PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentUpdateParams, SetupIntentCreateParams, and SetupIntentUpdateParams

      • Add support for new values paypay and sequra 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 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, ProductUpdateParams, and Product

      • Add support for blik on Checkout.SessionCreateParams.payment_method_options, 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

      • Change type of Checkout.SessionCreateParams.payment_method_options.bancontact.setup_future_usage, PaymentIntentConfirmParams.payment_method_options.blik.setup_future_usage, PaymentIntentCreateParams.payment_method_options.blik.setup_future_usage, and PaymentIntentUpdateParams.payment_method_options.blik.setup_future_usage from literal('none') to enum('none'|'off_session')

      • ⚠️ Change type of Checkout.Session.payment_method_options.bancontact.setup_future_usage and PaymentIntent.payment_method_options.blik.setup_future_usage from literal('none') to enum('none'|'off_session')

      • Add support for new values paypay and sequra 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 paypay and sequra on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type

      • Add support for new values paypay and sequra on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type

      • Add support for new values apps.install.created, apps.install.deleted, and apps.install.updated on enum Event.type

      • Add support for new values expired and pending on enum FinancialConnections.Account.account_numbers.status

      • Add support for country on FinancialConnections.SessionCreateParams.filters

      • ⚠️ Remove support for countries on FinancialConnections.Session.filters and FinancialConnections.SessionCreateParams.filters

      • Add support for invoicing_rules on InvoiceItemUpdateParams and InvoiceItem

      • Add support for company_details on Invoice.payment_settings.payment_method_options.billie, InvoiceCreateParams.payment_settings.payment_method_options.billie, InvoiceUpdateParams.payment_settings.payment_method_options.billie, PaymentIntent.payment_method_options.billie, PaymentIntentConfirmParams.payment_method_options.billie, PaymentIntentCreateParams.payment_method_options.billie, PaymentIntentUpdateParams.payment_method_options.billie, Subscription.payment_settings.payment_method_options.billie, SubscriptionCreateParams.payment_settings.payment_method_options.billie, and SubscriptionUpdateParams.payment_settings.payment_method_options.billie

      • Add support for reference on Invoice.payment_settings.payment_method_options.billie, InvoiceCreateParams.payment_settings.payment_method_options.billie, InvoiceUpdateParams.payment_settings.payment_method_options.billie, PaymentIntent.payment_method_options.billie, PaymentIntentConfirmParams.payment_method_options.billie, PaymentIntentCreateParams.payment_method_options.billie, and PaymentIntentUpdateParams.payment_method_options.billie

      • Add support for new value blik 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 new values digital_excise_tax and utility_users_tax on enums InvoiceAddLinesParams.lines.tax_amounts.tax_rate_data.tax_type, InvoiceLineItemUpdateParams.tax_amounts.tax_rate_data.tax_type, InvoiceUpdateLinesParams.lines.tax_amounts.tax_rate_data.tax_type, TaxRate.tax_type, TaxRateCreateParams.tax_type, and TaxRateUpdateParams.tax_type

      • Add support for pause on InvoiceCreatePreviewParams.subscription_details

      • ⚠️ Change type of InvoiceCreatePreviewParams.subscription_details.billing_cycle_anchor from enum('now'|'unchanged') | DateTime to billing_cycle_anchor_param

      • Add support for current_trial on InvoiceCreatePreviewParams.subscription_details.items, SubscriptionCreateParams.items, SubscriptionItemCreateParams, SubscriptionItemUpdateParams, SubscriptionItem, and SubscriptionUpdateParams.items

      • Add support for status_details on Invoice and Subscription

      • Add support for india on Mandate.payment_method_details.card

      • Add support for momo on PaymentAttemptRecord.payment_method_details and PaymentRecord.payment_method_details

      • Add support for new values 2.3.0 and 2.3.1 on enums PaymentAttemptRecord.payment_method_details.card.three_d_secure.version and PaymentRecord.payment_method_details.card.three_d_secure.version

      • Add support for link on PaymentAttemptRecord.payment_method_details.card.wallet and PaymentRecord.payment_method_details.card.wallet

      • Add support for funding_source_group on PaymentAttemptRecord.payment_method_details.link and PaymentRecord.payment_method_details.link

      • Add support for new values card_present and interac_present on enums PaymentIntent.allowed_payment_method_types, PaymentIntentConfirmParams.allowed_payment_method_types, PaymentIntentCreateParams.allowed_payment_method_types, PaymentIntentUpdateParams.allowed_payment_method_types, SetupIntent.allowed_payment_method_types, SetupIntentConfirmParams.allowed_payment_method_types, SetupIntentCreateParams.allowed_payment_method_types, and SetupIntentUpdateParams.allowed_payment_method_types

      • Add support for mandate_options on PaymentIntent.payment_method_options.blik, PaymentIntentConfirmParams.payment_method_options.blik, PaymentIntentCreateParams.payment_method_options.blik, and PaymentIntentUpdateParams.payment_method_options.blik

      • Add support for payment_record on PaymentIntent

      • Add support for expires_at on PaymentIntent.next_action.swish_handle_redirect_or_display_qr_code.qr_code

      • Add support for new values paypay and sequra on enums PaymentLink.payment_method_types, PaymentLinkCreateParams.payment_method_types, and PaymentLinkUpdateParams.payment_method_types

      • ⚠️ Remove support for payto on PaymentMethodUpdateParams

      • Add support for canceled on PaymentRecordReportPaymentAttemptParams and PaymentRecordReportPaymentParams

      • Add support for new value canceled on enums PaymentRecordReportPaymentAttemptParams.outcome and PaymentRecordReportPaymentParams.outcome

      • Add support for new value rerouted on enum Radar.PaymentEvaluation.outcome.type

      • Add support for early_fraud_warning and fraudulent_dispute on Radar.PaymentEvaluation.signals

      • ⚠️ Change type of Radar.PaymentEvaluation.signals.fraudulent_payment.score from number to number | null

      • Add support for pause_schedules on SubscriptionScheduleCreateParams, SubscriptionScheduleUpdateParams, and SubscriptionSchedule

      • ⚠️ Change type of SubscriptionResumeParams.billing_cycle_anchor and SubscriptionUpdateParams.billing_cycle_anchor from enum('now'|'unchanged') to billing_cycle_anchor_param

      • Add support for billing_cycle_anchor on Subscription.trial_settings.end_behavior, SubscriptionCreateParams.trial_settings.end_behavior, and SubscriptionUpdateParams.trial_settings.end_behavior

      • Change SubscriptionCreateParams.trial_settings.end_behavior.missing_payment_method and SubscriptionUpdateParams.trial_settings.end_behavior.missing_payment_method to be optional

      • Add support for payment_behavior on SubscriptionResumeParams

      • Add support for cancel_at_period_end on Subscription.pending_update

      • ⚠️ Remove support for igic on Tax.Registration.country_options.at, Tax.Registration.country_options.be, Tax.Registration.country_options.bg, Tax.Registration.country_options.cy, Tax.Registration.country_options.cz, Tax.Registration.country_options.de, Tax.Registration.country_options.dk, Tax.Registration.country_options.ee, Tax.Registration.country_options.es, Tax.Registration.country_options.fi, Tax.Registration.country_options.fr, Tax.Registration.country_options.gr, Tax.Registration.country_options.hr, Tax.Registration.country_options.hu, Tax.Registration.country_options.ie, Tax.Registration.country_options.it, Tax.Registration.country_options.lt, Tax.Registration.country_options.lu, Tax.Registration.country_options.lv, Tax.Registration.country_options.mt, Tax.Registration.country_options.nl, Tax.Registration.country_options.pl, Tax.Registration.country_options.pt, Tax.Registration.country_options.ro, Tax.Registration.country_options.se, Tax.Registration.country_options.si, Tax.Registration.country_options.sk, Tax.RegistrationCreateParams.country_options.at, Tax.RegistrationCreateParams.country_options.be, Tax.RegistrationCreateParams.country_options.bg, Tax.RegistrationCreateParams.country_options.cy, Tax.RegistrationCreateParams.country_options.cz, Tax.RegistrationCreateParams.country_options.de, Tax.RegistrationCreateParams.country_options.dk, Tax.RegistrationCreateParams.country_options.ee, Tax.RegistrationCreateParams.country_options.es, Tax.RegistrationCreateParams.country_options.fi, Tax.RegistrationCreateParams.country_options.fr, Tax.RegistrationCreateParams.country_options.gr, Tax.RegistrationCreateParams.country_options.hr, Tax.RegistrationCreateParams.country_options.hu, Tax.RegistrationCreateParams.country_options.ie, Tax.RegistrationCreateParams.country_options.it, Tax.RegistrationCreateParams.country_options.lt, Tax.RegistrationCreateParams.country_options.lu, Tax.RegistrationCreateParams.country_options.lv, Tax.RegistrationCreateParams.country_options.mt, Tax.RegistrationCreateParams.country_options.nl, Tax.RegistrationCreateParams.country_options.pl, Tax.RegistrationCreateParams.country_options.pt, Tax.RegistrationCreateParams.country_options.ro, Tax.RegistrationCreateParams.country_options.se, Tax.RegistrationCreateParams.country_options.si, and Tax.RegistrationCreateParams.country_options.sk

      • 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 and Tax.RegistrationCreateParams.country_options.us

      • 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 requirements on TaxCode

      • Add support for new value rtp on enum Treasury.FinancialAccount.financial_addresses.supported_networks

      • Add support for new value rtp on enum Treasury.ReceivedCreditCreateParams.testHelpers.network

      • Add support for new value rtp on enum Treasury.ReceivedCredit.network

      • Add support for new values apps.install.created, apps.install.deleted, and apps.install.updated on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_events

      • Add support for new value 2026-09-30.endive on enum WebhookEndpointCreateParams.api_version

      • ⚠️ Remove support for configurations on V2.Core.AccountLink.use_case.account_onboarding, V2.Core.AccountLink.use_case.account_update, V2.Core.AccountLinkCreateParams.use_case.account_onboarding, and V2.Core.AccountLinkCreateParams.use_case.account_update

      • ⚠️ Add support for new value rejected on enums V2.Core.Account.configuration.customer.capabilities.automatic_indirect_tax.status, V2.Core.Account.configuration.merchant.capabilities.ach_debit_payments.status, V2.Core.Account.configuration.merchant.capabilities.acss_debit_payments.status, V2.Core.Account.configuration.merchant.capabilities.affirm_payments.status, V2.Core.Account.configuration.merchant.capabilities.afterpay_clearpay_payments.status, V2.Core.Account.configuration.merchant.capabilities.alma_payments.status, V2.Core.Account.configuration.merchant.capabilities.amazon_pay_payments.status, V2.Core.Account.configuration.merchant.capabilities.au_becs_debit_payments.status, V2.Core.Account.configuration.merchant.capabilities.bacs_debit_payments.status, V2.Core.Account.configuration.merchant.capabilities.bancontact_payments.status, V2.Core.Account.configuration.merchant.capabilities.blik_payments.status, V2.Core.Account.configuration.merchant.capabilities.boleto_payments.status, V2.Core.Account.configuration.merchant.capabilities.card_payments.status, V2.Core.Account.configuration.merchant.capabilities.cartes_bancaires_payments.status, V2.Core.Account.configuration.merchant.capabilities.cashapp_payments.status, V2.Core.Account.configuration.merchant.capabilities.eps_payments.status, V2.Core.Account.configuration.merchant.capabilities.fpx_payments.status, V2.Core.Account.configuration.merchant.capabilities.gb_bank_transfer_payments.status, V2.Core.Account.configuration.merchant.capabilities.grabpay_payments.status, V2.Core.Account.configuration.merchant.capabilities.ideal_payments.status, V2.Core.Account.configuration.merchant.capabilities.jcb_payments.status, V2.Core.Account.configuration.merchant.capabilities.jp_bank_transfer_payments.status, V2.Core.Account.configuration.merchant.capabilities.kakao_pay_payments.status, V2.Core.Account.configuration.merchant.capabilities.klarna_payments.status, V2.Core.Account.configuration.merchant.capabilities.konbini_payments.status, V2.Core.Account.configuration.merchant.capabilities.kr_card_payments.status, V2.Core.Account.configuration.merchant.capabilities.link_payments.status, V2.Core.Account.configuration.merchant.capabilities.mobilepay_payments.status, V2.Core.Account.configuration.merchant.capabilities.multibanco_payments.status, V2.Core.Account.configuration.merchant.capabilities.mx_bank_transfer_payments.status, V2.Core.Account.configuration.merchant.capabilities.naver_pay_payments.status, V2.Core.Account.configuration.merchant.capabilities.oxxo_payments.status, V2.Core.Account.configuration.merchant.capabilities.p24_payments.status, V2.Core.Account.configuration.merchant.capabilities.pay_by_bank_payments.status, V2.Core.Account.configuration.merchant.capabilities.payco_payments.status, V2.Core.Account.configuration.merchant.capabilities.paynow_payments.status, V2.Core.Account.configuration.merchant.capabilities.promptpay_payments.status, V2.Core.Account.configuration.merchant.capabilities.revolut_pay_payments.status, V2.Core.Account.configuration.merchant.capabilities.samsung_pay_payments.status, V2.Core.Account.configuration.merchant.capabilities.sepa_bank_transfer_payments.status, V2.Core.Account.configuration.merchant.capabilities.sepa_debit_payments.status, V2.Core.Account.configuration.merchant.capabilities.stripe_balance.payouts.status, V2.Core.Account.configuration.merchant.capabilities.sunbit_payments.status, V2.Core.Account.configuration.merchant.capabilities.swish_payments.status, V2.Core.Account.configuration.merchant.capabilities.twint_payments.status, V2.Core.Account.configuration.merchant.capabilities.us_bank_transfer_payments.status, V2.Core.Account.configuration.merchant.capabilities.zip_payments.status, V2.Core.Account.configuration.recipient.capabilities.stripe_balance.payouts.status, and V2.Core.Account.configuration.recipient.capabilities.stripe_balance.stripe_transfers.status

      • ⚠️ Add support for new values rejected_fraud, rejected_incomplete_verification, rejected_listed, rejected_other, rejected_platform_fraud, rejected_platform_other, rejected_platform_terms_of_service, and rejected_terms_of_service on enums V2.Core.Account.configuration.customer.capabilities.automatic_indirect_tax.status_details.code, V2.Core.Account.configuration.merchant.capabilities.ach_debit_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.acss_debit_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.affirm_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.afterpay_clearpay_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.alma_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.amazon_pay_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.au_becs_debit_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.bacs_debit_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.bancontact_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.blik_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.boleto_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.card_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.cartes_bancaires_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.cashapp_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.eps_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.fpx_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.gb_bank_transfer_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.grabpay_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.ideal_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.jcb_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.jp_bank_transfer_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.kakao_pay_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.klarna_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.konbini_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.kr_card_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.link_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.mobilepay_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.multibanco_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.mx_bank_transfer_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.naver_pay_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.oxxo_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.p24_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.pay_by_bank_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.payco_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.paynow_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.promptpay_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.revolut_pay_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.samsung_pay_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.sepa_bank_transfer_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.sepa_debit_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.stripe_balance.payouts.status_details.code, V2.Core.Account.configuration.merchant.capabilities.sunbit_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.swish_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.twint_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.us_bank_transfer_payments.status_details.code, V2.Core.Account.configuration.merchant.capabilities.zip_payments.status_details.code, V2.Core.Account.configuration.recipient.capabilities.stripe_balance.payouts.status_details.code, and V2.Core.Account.configuration.recipient.capabilities.stripe_balance.stripe_transfers.status_details.code

      • Add support for satispay_payments on V2.Core.Account.configuration.merchant.capabilities, V2.Core.AccountCreateParams.configuration.merchant.capabilities, and V2.Core.AccountUpdateParams.configuration.merchant.capabilities

      • Add support for new values invalid_address_cmra_address and invalid_address_registered_agent_address on enums V2.Core.Account.future_requirements.entries.errors.code and V2.Core.Account.requirements.entries.errors.code

      • Add support for new values blik_recurring_payments and satispay_payments 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 snapshot_event on V2.Core.Event

      • Add support for new values blik_recurring_payments, satispay_payments, and sequra_payments on enum EventsV2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent.updated_capability

      • Add support for snapshot events AppsInstallCreatedEvent, AppsInstallDeletedEvent, and AppsInstallUpdatedEvent with resource Apps.Install

      • Add support for event notifications V1AccountApplicationAuthorizedEvent, V1AccountApplicationDeauthorizedEvent, V1AccountExternalAccountCreatedEvent, V1AccountExternalAccountDeletedEvent, V1AccountExternalAccountUpdatedEvent, V1BillingPortalSessionCreatedEvent, and V1EntitlementsActiveEntitlementSummaryUpdatedEvent

      • Add support for event notification V1AccountUpdatedEvent with related object Account

      • Add support for event notifications V1ApplicationFeeCreatedEvent and V1ApplicationFeeRefundedEvent with related object ApplicationFee

      • Add support for event notification V1ApplicationFeeRefundUpdatedEvent with related object FeeRefund

      • Add support for event notification V1BalanceAvailableEvent with related object Balance

      • Add support for event notification V1BalanceSettingsUpdatedEvent with related object BalanceSettings

      • Add support for event notification V1BillingAlertTriggeredEvent with related object Billing.Alert

      • Add support for event notification V1BillingCreditBalanceTransactionCreatedEvent with related object Billing.CreditBalanceTransaction

      • Add support for event notifications V1BillingCreditGrantCreatedEvent and V1BillingCreditGrantUpdatedEvent with related object Billing.CreditGrant

      • Add support for event notifications V1BillingMeterCreatedEvent, V1BillingMeterDeactivatedEvent, V1BillingMeterReactivatedEvent, and V1BillingMeterUpdatedEvent with related object Billing.Meter

      • Add support for event notifications V1BillingPortalConfigurationCreatedEvent and V1BillingPortalConfigurationUpdatedEvent with related object BillingPortal.Configuration

      • Add support for event notification V1CapabilityUpdatedEvent with related object Capability

      • Add support for event notification V1CashBalanceFundsAvailableEvent with related object CashBalance

      • Add support for event notifications V1ChargeCapturedEvent, V1ChargeExpiredEvent, V1ChargeFailedEvent, V1ChargePendingEvent, V1ChargeRefundedEvent, V1ChargeSucceededEvent, and V1ChargeUpdatedEvent with related object Charge

      • Add support for event notifications V1ChargeDisputeClosedEvent, V1ChargeDisputeCreatedEvent, V1ChargeDisputeFundsReinstatedEvent, V1ChargeDisputeFundsWithdrawnEvent, and V1ChargeDisputeUpdatedEvent with related object Dispute

      • Add support for event notifications V1ChargeRefundUpdatedEvent, V1RefundCreatedEvent, V1RefundFailedEvent, and V1RefundUpdatedEvent with related object Refund

      • Add support for event notifications V1CheckoutSessionAsyncPaymentFailedEvent, V1CheckoutSessionAsyncPaymentSucceededEvent, V1CheckoutSessionCompletedEvent, and V1CheckoutSessionExpiredEvent with related object Checkout.Session

      • Add support for event notifications V1ClimateOrderCanceledEvent, V1ClimateOrderCreatedEvent, V1ClimateOrderDelayedEvent, V1ClimateOrderDeliveredEvent, and V1ClimateOrderProductSubstitutedEvent with related object Climate.Order

      • Add support for event notifications V1ClimateProductCreatedEvent and V1ClimateProductPricingUpdatedEvent with related object Climate.Product

      • Add support for event notifications V1CouponCreatedEvent, V1CouponDeletedEvent, and V1CouponUpdatedEvent with related object Coupon

      • Add support for event notifications V1CreditNoteCreatedEvent, V1CreditNoteUpdatedEvent, and V1CreditNoteVoidedEvent with related object CreditNote

      • Add support for event notifications V1CustomerCreatedEvent, V1CustomerDeletedEvent, and V1CustomerUpdatedEvent with related object Customer

      • Add support for event notifications V1CustomerDiscountCreatedEvent, V1CustomerDiscountDeletedEvent, and V1CustomerDiscountUpdatedEvent with related object Discount

      • Add support for event notifications V1CustomerSubscriptionCreatedEvent, V1CustomerSubscriptionDeletedEvent, V1CustomerSubscriptionPausedEvent, V1CustomerSubscriptionPendingUpdateAppliedEvent, V1CustomerSubscriptionPendingUpdateExpiredEvent, V1CustomerSubscriptionResumedEvent, V1CustomerSubscriptionTrialWillEndEvent, and V1CustomerSubscriptionUpdatedEvent with related object Subscription

      • Add support for event notifications V1CustomerTaxIdCreatedEvent, V1CustomerTaxIdDeletedEvent, and V1CustomerTaxIdUpdatedEvent with related object TaxId

      • Add support for event notification V1CustomerCashBalanceTransactionCreatedEvent with related object CustomerCashBalanceTransaction

      • Add support for event notification V1FileCreatedEvent with related object File

      • Add support for event notifications V1FinancialConnectionsAccountAccountNumbersUpdatedEvent, V1FinancialConnectionsAccountCreatedEvent, V1FinancialConnectionsAccountDeactivatedEvent, V1FinancialConnectionsAccountDisconnectedEvent, V1FinancialConnectionsAccountExpectedDeactivationDateUpdatedEvent, V1FinancialConnectionsAccountReactivatedEvent, V1FinancialConnectionsAccountRefreshedBalanceEvent, V1FinancialConnectionsAccountRefreshedOwnershipEvent, V1FinancialConnectionsAccountRefreshedTransactionsEvent, V1FinancialConnectionsAccountSupportedPaymentMethodTypesUpdatedEvent, V1FinancialConnectionsAccountUpcomingAccountNumberExpiryEvent, and V1FinancialConnectionsAccountUpcomingDeactivationEvent with related object FinancialConnections.Account

      • Add support for event notifications V1IdentityVerificationSessionCanceledEvent, V1IdentityVerificationSessionCreatedEvent, V1IdentityVerificationSessionProcessingEvent, V1IdentityVerificationSessionRedactedEvent, V1IdentityVerificationSessionRequiresInputEvent, and V1IdentityVerificationSessionVerifiedEvent with related object Identity.VerificationSession

      • Add support for event notifications V1InvoiceCreatedEvent, V1InvoiceDeletedEvent, V1InvoiceFinalizationFailedEvent, V1InvoiceFinalizedEvent, V1InvoiceMarkedUncollectibleEvent, V1InvoiceOverdueEvent, V1InvoiceOverpaidEvent, V1InvoicePaidEvent, V1InvoicePaymentActionRequiredEvent, V1InvoicePaymentAttemptRequiredEvent, V1InvoicePaymentFailedEvent, V1InvoicePaymentSucceededEvent, V1InvoiceSentEvent, V1InvoiceUpcomingEvent, V1InvoiceUpdatedEvent, V1InvoiceVoidedEvent, and V1InvoiceWillBeDueEvent with related object Invoice

      • Add support for event notification V1InvoicePaymentPaidEvent with related object InvoicePayment

      • Add support for event notifications V1InvoiceitemCreatedEvent and V1InvoiceitemDeletedEvent with related object InvoiceItem

      • Add support for event notifications V1IssuingAuthorizationCreatedEvent, V1IssuingAuthorizationRequestEvent, and V1IssuingAuthorizationUpdatedEvent with related object Issuing.Authorization

      • Add support for event notifications V1IssuingCardCreatedEvent and V1IssuingCardUpdatedEvent with related object Issuing.Card

      • Add support for event notifications V1IssuingCardholderCreatedEvent and V1IssuingCardholderUpdatedEvent with related object Issuing.Cardholder

      • Add support for event notifications V1IssuingDisputeClosedEvent, V1IssuingDisputeCreatedEvent, V1IssuingDisputeFundsReinstatedEvent, V1IssuingDisputeFundsRescindedEvent, V1IssuingDisputeSubmittedEvent, and V1IssuingDisputeUpdatedEvent with related object Issuing.Dispute

      • Add support for event notifications V1IssuingPersonalizationDesignActivatedEvent, V1IssuingPersonalizationDesignDeactivatedEvent, V1IssuingPersonalizationDesignRejectedEvent, and V1IssuingPersonalizationDesignUpdatedEvent with related object Issuing.PersonalizationDesign

      • Add support for event notifications V1IssuingTokenCreatedEvent and V1IssuingTokenUpdatedEvent with related object Issuing.Token

      • Add support for event notifications V1IssuingTransactionCreatedEvent, V1IssuingTransactionPurchaseDetailsReceiptUpdatedEvent, and V1IssuingTransactionUpdatedEvent with related object Issuing.Transaction

      • Add support for event notification V1MandateUpdatedEvent with related object Mandate

      • Add support for event notifications V1PaymentIntentAmountCapturableUpdatedEvent, V1PaymentIntentCanceledEvent, V1PaymentIntentCreatedEvent, V1PaymentIntentPartiallyFundedEvent, V1PaymentIntentPaymentFailedEvent, V1PaymentIntentProcessingEvent, V1PaymentIntentRequiresActionEvent, and V1PaymentIntentSucceededEvent with related object PaymentIntent

      • Add support for event notifications V1PaymentLinkCreatedEvent and V1PaymentLinkUpdatedEvent with related object PaymentLink

      • Add support for event notifications V1PaymentMethodAttachedEvent, V1PaymentMethodAutomaticallyUpdatedEvent, V1PaymentMethodDetachedEvent, and V1PaymentMethodUpdatedEvent with related object PaymentMethod

      • Add support for event notifications V1PayoutCanceledEvent, V1PayoutCreatedEvent, V1PayoutFailedEvent, V1PayoutPaidEvent, V1PayoutReconciliationCompletedEvent, and V1PayoutUpdatedEvent with related object Payout

      • Add support for event notifications V1PersonCreatedEvent, V1PersonDeletedEvent, and V1PersonUpdatedEvent with related object Person

      • Add support for event notifications V1PlanCreatedEvent, V1PlanDeletedEvent, and V1PlanUpdatedEvent with related object Plan

      • Add support for event notifications V1PriceCreatedEvent, V1PriceDeletedEvent, and V1PriceUpdatedEvent with related object Price

      • Add support for event notifications V1ProductCreatedEvent, V1ProductDeletedEvent, and V1ProductUpdatedEvent with related object Product

      • Add support for event notifications V1PromotionCodeCreatedEvent and V1PromotionCodeUpdatedEvent with related object PromotionCode

      • Add support for event notifications V1QuoteAcceptedEvent, V1QuoteCanceledEvent, V1QuoteCreatedEvent, and V1QuoteFinalizedEvent with related object Quote

      • Add support for event notifications V1RadarEarlyFraudWarningCreatedEvent and V1RadarEarlyFraudWarningUpdatedEvent with related object Radar.EarlyFraudWarning

      • Add support for event notifications V1ReviewClosedEvent and V1ReviewOpenedEvent with related object Review

      • Add support for event notifications V1SetupIntentCanceledEvent, V1SetupIntentCreatedEvent, V1SetupIntentRequiresActionEvent, V1SetupIntentSetupFailedEvent, and V1SetupIntentSucceededEvent with related object SetupIntent

      • Add support for event notification V1SigmaScheduledQueryRunCreatedEvent with related object Sigma.ScheduledQueryRun

      • Add support for event notifications V1SourceCanceledEvent, V1SourceChargeableEvent, V1SourceFailedEvent, and V1SourceRefundAttributesRequiredEvent with related object Source

      • Add support for event notifications V1SubscriptionScheduleAbortedEvent, V1SubscriptionScheduleCanceledEvent, V1SubscriptionScheduleCompletedEvent, V1SubscriptionScheduleCreatedEvent, V1SubscriptionScheduleExpiringEvent, V1SubscriptionScheduleReleasedEvent, and V1SubscriptionScheduleUpdatedEvent with related object SubscriptionSchedule

      • Add support for event notification V1TaxSettingsUpdatedEvent with related object Tax.Settings

      • Add support for event notifications V1TaxRateCreatedEvent and V1TaxRateUpdatedEvent with related object TaxRate

      • Add support for event notifications V1TerminalReaderActionFailedEvent, V1TerminalReaderActionSucceededEvent, and V1TerminalReaderActionUpdatedEvent with related object Terminal.Reader

      • Add support for event notifications V1TestHelpersTestClockAdvancingEvent, V1TestHelpersTestClockCreatedEvent, V1TestHelpersTestClockDeletedEvent, V1TestHelpersTestClockInternalFailureEvent, and V1TestHelpersTestClockReadyEvent with related object TestHelpers.TestClock

      • Add support for event notifications V1TopupCanceledEvent, V1TopupCreatedEvent, V1TopupFailedEvent, V1TopupReversedEvent, and V1TopupSucceededEvent with related object Topup

      • Add support for event notifications V1TransferCreatedEvent, V1TransferReversedEvent, and V1TransferUpdatedEvent with related object Transfer

      • Add support for error codes dispute_evidence_page_limit_exceeded, financial_connections_consent_locale_invalid, financial_connections_consent_locale_unsupported, and payment_evaluation_on_api_version_not_supported on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, StripeError, and Terminal.Reader.action.api_error

  2. 22.6.2

    9 September 2026
    Validate that webhook secrets are non-empty

    • Validate that webhook secrets are non-empty

    See the changelog for more details.

  3. 22.6.1

    1 September 2026
    Use cryptographically secure boundaries for multipart file uploads

    • Use cryptographically secure boundaries for multipart file uploads

    • update OtherString docstring

    • Fix request coercion for GET and DELETE parameters

      • Fixes serialization of schema-coerced values, including Decimal, in GET and DELETE query parameters.

    • Harden API requestor code against malicious URLs

    See the changelog for more details.

  4. 22.6.0

    27 August 2026
    This release changes the pinned API version to 2026-08-26.dahlia.

    This release changes the pinned API version to 2026-08-26.dahlia.

    • Add discriminatedUnion kind to V2RuntimeSchema coercion

      • Adds runtime support for coercing int64/decimal fields within discriminated union variants in V2 API requests and responses.

      • ⚠️ Throws when serializing a discriminated union parameter whose discriminator is missing or is not a string. This avoids skipping coercion entirely which could silently truncate int64 fields above Number.MAX_SAFE_INTEGER.

    • Add new EventNotificationHandler class for better thin event management

      • We've been putting a lot of time into rethinking the event handling experience in the SDKs. This new class is the culmination of that effort.

      • They're designed for a tight coupling with both StripeClient and the fully-typed nature of thin events. This delivers painless event destination upgrades, in-editor checks for common mistakes, and better code modularity.

      • Now that we've released thin event notifications for v1 objects, these new handlers are our recommended path for all integrations using thin event notifications.

      • See more detailed docs here: docs.stripe.com/webhooks/event-notification-han…

    • correctly throw connection errors if the server drops while sending the HTTP response body

      • This change results in new exceptions being thrown instead of hanging indefinitely

      • in an effort to make this change backwards compatible, it doesn't affect a case that was already throwing an error: if the stripe API sends invalid JSON, we were treating it as an API error instead of a connection error.

        • In the next major version, we'll change the exception thrown from StripeAPIError to StripeConnectionError and document it accordingly.

    • Update generated code

      • Add support for new resource Billing.FeedbackOption

      • Add support for create, deactivate, list, retrieve, and update methods on resource Billing.FeedbackOption

      • Add support for payment_method_settings on AccountSession.components and AccountSessionCreateParams.components

      • Add support for feedback_options on BillingPortal.Configuration.features.subscription_cancel.cancellation_reason, BillingPortal.ConfigurationCreateParams.features.subscription_cancel.cancellation_reason, and BillingPortal.ConfigurationUpdateParams.features.subscription_cancel.cancellation_reason

      • Add support for new value customer_update on enums BillingPortal.Session.flow.type and BillingPortal.SessionCreateParams.flow_data.type

      • Add support for customer_update on BillingPortal.Session.flow

      • Add support for funding_source_group on Charge.payment_method_details.card.wallet.link and Charge.payment_method_details.link

      • Add support for funding_types_blocked on Checkout.Session.payment_method_options.card.restrictions and Checkout.SessionCreateParams.payment_method_options.card.restrictions

      • Add support for metadata on ConfirmationToken

      • Add support for active_entitlements and customer_portal on CustomerSession.components and CustomerSessionCreateParams.components

      • Add support for country on FinancialConnections.Session.filters

      • Add support for frozen_fields on InvoiceItem

      • Add support for billie 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 value billie 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

      • ⚠️ Remove support for cryptogram on PaymentAttemptRecord.payment_method_details.card.three_d_secure and PaymentRecord.payment_method_details.card.three_d_secure

      • Add support for new value touch_n_go on enums PaymentIntent.allowed_payment_method_types, PaymentIntentConfirmParams.allowed_payment_method_types, PaymentIntentCreateParams.allowed_payment_method_types, PaymentIntentUpdateParams.allowed_payment_method_types, SetupIntent.allowed_payment_method_types, SetupIntentConfirmParams.allowed_payment_method_types, SetupIntentCreateParams.allowed_payment_method_types, and SetupIntentUpdateParams.allowed_payment_method_types

      • Change PaymentIntent.allowed_payment_method_types and SetupIntent.allowed_payment_method_types to be required

      • Add support for application_fee_amount, application_fee_percent, on_behalf_of, and transfer_data on PaymentLinkUpdateParams

      • Add support for feedback_option on Subscription.cancellation_details, SubscriptionCancelParams.cancellation_details, and SubscriptionUpdateParams.cancellation_details

      • Add support for igic on Tax.Registration.country_options.at, Tax.Registration.country_options.be, Tax.Registration.country_options.bg, Tax.Registration.country_options.cy, Tax.Registration.country_options.cz, Tax.Registration.country_options.de, Tax.Registration.country_options.dk, Tax.Registration.country_options.ee, Tax.Registration.country_options.es, Tax.Registration.country_options.fi, Tax.Registration.country_options.fr, Tax.Registration.country_options.gr, Tax.Registration.country_options.hr, Tax.Registration.country_options.hu, Tax.Registration.country_options.ie, Tax.Registration.country_options.it, Tax.Registration.country_options.lt, Tax.Registration.country_options.lu, Tax.Registration.country_options.lv, Tax.Registration.country_options.mt, Tax.Registration.country_options.nl, Tax.Registration.country_options.pl, Tax.Registration.country_options.pt, Tax.Registration.country_options.ro, Tax.Registration.country_options.se, Tax.Registration.country_options.si, Tax.Registration.country_options.sk, Tax.RegistrationCreateParams.country_options.at, Tax.RegistrationCreateParams.country_options.be, Tax.RegistrationCreateParams.country_options.bg, Tax.RegistrationCreateParams.country_options.cy, Tax.RegistrationCreateParams.country_options.cz, Tax.RegistrationCreateParams.country_options.de, Tax.RegistrationCreateParams.country_options.dk, Tax.RegistrationCreateParams.country_options.ee, Tax.RegistrationCreateParams.country_options.es, Tax.RegistrationCreateParams.country_options.fi, Tax.RegistrationCreateParams.country_options.fr, Tax.RegistrationCreateParams.country_options.gr, Tax.RegistrationCreateParams.country_options.hr, Tax.RegistrationCreateParams.country_options.hu, Tax.RegistrationCreateParams.country_options.ie, Tax.RegistrationCreateParams.country_options.it, Tax.RegistrationCreateParams.country_options.lt, Tax.RegistrationCreateParams.country_options.lu, Tax.RegistrationCreateParams.country_options.lv, Tax.RegistrationCreateParams.country_options.mt, Tax.RegistrationCreateParams.country_options.nl, Tax.RegistrationCreateParams.country_options.pl, Tax.RegistrationCreateParams.country_options.pt, Tax.RegistrationCreateParams.country_options.ro, Tax.RegistrationCreateParams.country_options.se, Tax.RegistrationCreateParams.country_options.si, and Tax.RegistrationCreateParams.country_options.sk

      • Add support for new value 2026-08-26.dahlia on enum WebhookEndpointCreateParams.api_version

      • Add support for error codes authentication_failure, capability_not_active, expired_payment_method, incorrect_postal_code, invalid_canceled_subscription_fields, and payment_method_restricted on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, StripeError, and Terminal.Reader.action.api_error

  5. 22.5.0

    10 August 2026
    Emit Claude Code plugin hint at module load time

    • Emit Claude Code plugin hint at module load time

      • Emits new Claude Code plugin hint when CLAUDECODE or CLAUDE_CODE_CHILD_SESSION environment variables are detected.

    • add/adjust event parsing helpers

      • Added methods that return their respective Event/EventNotification objects without verifying authenticity. Use them when you've previously verified an event (e.g. you verified, put the event in a queue, and are now processing). Supports events from AWS EventBridge and Azure Event Grid natively.

        • stripe.webhooks.constructEventWithoutVerification(payload)

        • stripe.constructEventWithoutVerification(payload)

        • stripe.parseEventNotificationWithoutVerification(payload)

    • Add stripe.major_api_version constant

    See the changelog for more details.

  6. 22.4.0

    29 July 2026
    This release changes the pinned API version to 2026-07-29.dahlia.

    This release changes the pinned API version to 2026-07-29.dahlia.

    • Update generated code

      • Add support for new resource FinancialConnections.Authorization

      • Add support for unreject method on resource Account

      • Add support for list method on resource PaymentRecord

      • Add support for administrative_address and principal_place_of_business on Account.company, AccountCreateParams.company, AccountUpdateParams.company, and TokenCreateParams.account.company

      • Add support for sepa_debit_payments on AccountUpdateParams.settings

      • Remove support for proof_of_registration on AccountCreateParams.documents. This field was limited-use and is being deprecated.

      • Add support for payouts_action on AccountRejectParams

      • Add support for new values mass_transit_parking_tax and parking_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 new value chaps on enums FundingInstructions.bank_transfer.financial_addresses.supported_networks and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses.supported_networks

      • Add support for smart_disputes_management on AccountSession.components.disputes_list.features, AccountSession.components.payment_details.features, AccountSession.components.payment_disputes.features, AccountSession.components.payments.features, AccountSessionCreateParams.components.disputes_list.features, AccountSessionCreateParams.components.payment_details.features, AccountSessionCreateParams.components.payment_disputes.features, and AccountSessionCreateParams.components.payments.features

      • Add support for new value data_share_only on enums Charge.payment_method_details.card.three_d_secure.result, PaymentAttemptRecord.payment_method_details.card.three_d_secure.result, PaymentRecord.payment_method_details.card.three_d_secure.result, and SetupAttempt.payment_method_details.card.three_d_secure.result

      • Add support for new values bnp_paribas, citibank, and mbsb_bank on enums Charge.payment_method_details.fpx.bank, ConfirmationToken.payment_method_preview.fpx.bank, PaymentAttemptRecord.payment_method_details.fpx.bank, PaymentMethod.fpx.bank, and PaymentRecord.payment_method_details.fpx.bank

      • Remove support for dynamic_tax_rates on Checkout.SessionCreateParams.line_items. This field was limited-use and is being deprecated.

      • Add support for setup_future_usage on Checkout.Session.payment_method_options.payco, Checkout.Session.payment_method_options.samsung_pay, Checkout.SessionCreateParams.payment_method_options.payco, Checkout.SessionCreateParams.payment_method_options.samsung_pay, PaymentIntent.payment_method_options.payco, PaymentIntent.payment_method_options.samsung_pay, PaymentIntentConfirmParams.payment_method_options.payco, PaymentIntentConfirmParams.payment_method_options.samsung_pay, PaymentIntentCreateParams.payment_method_options.payco, PaymentIntentCreateParams.payment_method_options.samsung_pay, PaymentIntentUpdateParams.payment_method_options.payco, PaymentIntentUpdateParams.payment_method_options.samsung_pay, and PaymentLinkUpdateParams.payment_intent_data

      • Add support for new value ic_nif 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 values bnp_paribas, citibank, and mbsb_bank on enums ConfirmationTokenCreateParams.testHelpers.payment_method_data.fpx.bank, PaymentIntentConfirmParams.payment_method_data.fpx.bank, PaymentIntentCreateParams.payment_method_data.fpx.bank, PaymentIntentUpdateParams.payment_method_data.fpx.bank, PaymentMethodCreateParams.fpx.bank, SetupIntentConfirmParams.payment_method_data.fpx.bank, SetupIntentCreateParams.payment_method_data.fpx.bank, and SetupIntentUpdateParams.payment_method_data.fpx.bank

      • Add support for new value ic_nif 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 network on Dispute.payment_method_details.card

      • Add support for new values financial_connections.account.expected_deactivation_date_updated, financial_connections.account.supported_payment_method_types_updated, financial_connections.account.upcoming_deactivation, financial_connections.authorization.expected_deactivation_date_updated, and financial_connections.authorization.upcoming_deactivation on enum Event.type

      • Add support for limits and manual_entry on FinancialConnections.SessionCreateParams and FinancialConnections.Session

      • Add support for require_payment_method_support on FinancialConnections.Session.filters and FinancialConnections.SessionCreateParams.filters

      • Add support for bank_account_token on FinancialConnections.Session

      • Add support for new values alipay and mb_way 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 new values mass_transit_parking_tax and parking_tax on enums InvoiceAddLinesParams.lines.tax_amounts.tax_rate_data.tax_type, InvoiceLineItemUpdateParams.tax_amounts.tax_rate_data.tax_type, InvoiceUpdateLinesParams.lines.tax_amounts.tax_rate_data.tax_type, TaxRate.tax_type, TaxRateCreateParams.tax_type, and TaxRateUpdateParams.tax_type

      • Add support for metadata on InvoiceCreatePreviewParams.subscription_details

      • Add support for new value stripe_internal_error on enum Issuing.Authorization.request_history.reason

      • Add support for business_name on Issuing.Card.shipping, Issuing.CardCreateParams.shipping, and Issuing.CardUpdateParams.shipping

      • Add support for new value correos on enum Issuing.Card.shipping.carrier

      • Add support for allowed_payment_method_types on PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentUpdateParams, PaymentIntent, SetupIntentConfirmParams, SetupIntentCreateParams, SetupIntentUpdateParams, and SetupIntent

      • Add support for referrer on PaymentIntentConfirmParams.radar_options and PaymentIntentCreateParams.radar_options

      • Add support for consent_collection and shipping_options on PaymentLinkUpdateParams

      • Add support for custom_fields, description, and footer on Quote.invoice_settings, QuoteCreateParams.invoice_settings, QuoteUpdateParams.invoice_settings, SubscriptionSchedule.default_settings.invoice_settings, SubscriptionSchedule.phases.invoice_settings, SubscriptionScheduleCreateParams.default_settings.invoice_settings, SubscriptionScheduleCreateParams.phases.invoice_settings, SubscriptionScheduleUpdateParams.default_settings.invoice_settings, and SubscriptionScheduleUpdateParams.phases.invoice_settings

      • Add support for customer_account and customer on Refund

      • Add support for payment_method on Refund and Topup

      • Add support for trial on SubscriptionSchedule.phases

      • Add support for mass_transit_parking_tax and parking_tax on Tax.Registration.country_options.us and Tax.RegistrationCreateParams.country_options.us

      • Add support for new values mass_transit_parking_tax and parking_tax on enum Tax.RegistrationCreateParams.country_options.us.type

      • Add support for new values mass_transit_parking_tax and parking_tax on enum Tax.Registration.country_options.us.type

      • Add support for initiated_by and payment_method_options on Topup

      • Add support for new values financial_connections.account.expected_deactivation_date_updated, financial_connections.account.supported_payment_method_types_updated, financial_connections.account.upcoming_deactivation, financial_connections.authorization.expected_deactivation_date_updated, and financial_connections.authorization.upcoming_deactivation on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_events

      • Add support for new value 2026-07-29.dahlia on enum WebhookEndpointCreateParams.api_version

      • Add support for additional_addresses 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 snapshot events FinancialConnectionsAccountExpectedDeactivationDateUpdatedEvent, FinancialConnectionsAccountSupportedPaymentMethodTypesUpdatedEvent, and FinancialConnectionsAccountUpcomingDeactivationEvent with resource FinancialConnections.Account

      • Add support for snapshot events FinancialConnectionsAuthorizationExpectedDeactivationDateUpdatedEvent and FinancialConnectionsAuthorizationUpcomingDeactivationEvent with resource FinancialConnections.Authorization

    • Adds shared OtherString type to better annotate non-exhaustive enums

All 603 releases

Major versions

  • 23.xsince 1 October 2026 · latest 23.0.0 · 1 release
  • 22.xsince 3 April 2026 · latest 22.6.2 · 17 releases
  • 21.xsince 26 March 2026 · latest 21.0.1 · 2 releases
  • 20.xsince 18 November 2025 · latest 20.4.1 · 9 releases
  • 19.xsince 30 September 2025 · latest 19.3.1 · 6 releases
  • 18.xsince 1 April 2025 · latest 18.5.0 · 8 releases
  • 17.xsince 1 October 2024 · latest 17.7.0 · 10 releases
  • 16.xsince 24 June 2024 · latest 16.12.0 · 12 releases
  • 15.xsince 10 April 2024 · latest 15.12.0 · 13 releases
  • 14.xsince 16 October 2023 · latest 14.25.0 · 26 releases
  • 13.xsince 16 August 2023 · latest 13.11.0 · 12 releases
  • 12.xsince 6 April 2023 · latest 12.18.0 · 20 releases
  • 11.xsince 16 November 2022 · latest 11.18.0 · 20 releases
  • 10.xsince 2 August 2022 · latest 10.17.0 · 17 releases
  • 9.xsince 10 May 2022 · latest 9.16.0 · 17 releases
  • 8.xsince 10 January 2020 · latest 8.222.0 · 235 releases
  • 7.xsince 14 May 2019 · latest 7.63.1 · 28 releases
  • 6.xsince 14 May 2018 · latest 6.36.0 · 49 releases
  • 5.xsince 12 September 2017 · latest 5.10.0 · 13 releases
  • 4.xsince 17 September 2015 · latest 4.25.0 · 35 releases
  • 3.xsince 18 November 2014 · latest 3.9.0 · 19 releases
  • 2.xsince 21 October 2013 · latest 2.9.1 · 26 releases
  • 1.xsince 6 December 2011 · latest 1.3.0 · 4 releases
  • 0.xsince 6 December 2011 · latest 0.0.5 · 4 releases

Quality and security signals

What npm and deps.dev say about the latest release. Signals, not a verdict.

Reading npm and deps.dev…

Registry facts last checked 20 October 2026. Releases and advisories last read 20 October 2026.

Know when your own dependencies move

Inlinr tracks your coding time automatically. Switch dependency tracking on for a project and it reads that repository's manifest to show what is behind and what has been deprecated — off by default, one project at a time.

See what Inlinr doesAll packages