Packages/stripe

Releases of stripe

603 stable releases, newest first. Release notes are kept for the last 90 days; older ones link to where they were published.

  1. 23.0.0

    1 October 2026

    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.

  2. 22.6.2

    9 September 2026

    • 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

    • 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

  4. 22.6.0

    27 August 2026

    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.

  5. 22.5.0

    10 August 2026

    • 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

  6. 22.4.0

    29 July 2026

    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

  7. 22.3.2

    16 July 2026

  8. 22.3.1

    9 July 2026

  9. 22.3.0

    24 June 2026

  10. 22.2.3

    22 June 2026

  11. 22.2.2

    18 June 2026

  12. 22.2.1

    12 June 2026

  13. 22.2.0

    27 May 2026

  14. 22.1.1

    6 May 2026

  15. 22.1.0

    24 April 2026

  16. 22.0.2

    16 April 2026

  17. 22.0.1

    8 April 2026

  18. 22.0.0

    3 April 2026

  19. 21.0.1

    26 March 2026

  20. 21.0.0

    26 March 2026

  21. 20.4.1

    6 March 2026

  22. 20.4.0

    25 February 2026

  23. 20.3.1

    5 February 2026

  24. 20.3.0

    28 January 2026

  25. 20.2.0

    16 January 2026

  26. 20.1.2

    7 January 2026

  27. 20.1.1

    6 January 2026

  28. 20.1.0

    16 December 2025

  29. 20.0.0

    18 November 2025

  30. 19.3.1

    12 November 2025

  31. 19.3.0

    5 November 2025

  32. 19.2.1

    4 November 2025

  33. 19.2.0

    29 October 2025

  34. 19.1.0

    3 October 2025

  35. 19.0.0

    30 September 2025

  36. 18.5.0

    27 August 2025

  37. 18.4.0

    30 July 2025

  38. 18.3.0

    1 July 2025

  39. 18.2.1

    2 June 2025

  40. 18.2.0

    28 May 2025

  41. 18.1.1

    19 May 2025

  42. 18.1.0

    30 April 2025

  43. 18.0.0

    1 April 2025

  44. 17.7.0

    24 February 2025

  45. 17.6.0

    27 January 2025

  46. 17.5.0

    18 December 2024

  47. 17.4.0

    20 November 2024

  48. 17.3.1

    1 November 2024

  49. 17.3.0

    29 October 2024

  50. 17.2.1

    18 October 2024