pypi / stripe

stripe

What changed in stripe 15 to 16, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-20.

13 breaking2 security44 new APIs and options4 behavior and defaults2 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli on npm

stripe 1633 changes

Breaking changes 10

The parameter type changes from string to an enum.
16.0.0release notes
The field type changes from string to expandable($Mandate).
16.0.0release notes
Removes support for countries from the session filter and its creation parameters.
16.0.0release notes
Removes support for this parameter on PaymentIntent, SetupIntent, and Checkout session creation or modification parameters.
16.0.0release notes
Removes support for payto on PaymentMethod modification parameters.
16.0.0release notes
On resource methods supporting both classmethod and instance-method call styles, path parameters must be passed positionally rather than by keyword.
16.0.0release notes
Path parameters must be passed positionally to service methods; keyword passing is no longer supported. Resource methods are unaffected except for methods supporting both class and instance call styles.
16.0.0release notes
The resource class is renamed to stripe.TransferReversal; update references and type annotations.
16.0.0release notes
The stripe.Reversal resource class is renamed; update references and type annotations to use stripe.TransferReversal.
16.0.0release notes
The deprecated method is removed; use StripeClient.raw_request for custom API requests.
16.0.0release notes

New APIs and options 20

Adds the apps.Install resource with create, list, modify, retrieve, and uninstall methods.
16.0.0release notes
Snapshot events apps.install.created, apps.install.deleted, and apps.install.updated are now supported for apps.Install.
16.0.0release notes
The account requirement capability enums now support blik_recurring_payments and satispay_payments.
16.0.0release notes
Adds allowed_payment_method_types to Checkout session objects and creation parameters.
16.0.0release notes
Several error codes are now supported on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, StripeError, and Terminal.Reader.Action.ApiError.
16.0.0release notes
Adds the country filter field.
16.0.0release notes
Adds the payment_record field to PaymentIntent.
16.0.0release notes
Adds mandate_options to Blik payment method options and the corresponding PaymentIntent parameter types.
16.0.0release notes
The Payment Link payment method type enums now accept paypay and sequra.
16.0.0release notes
Adds the product_catalog.TrialOffer resource with create, list, modify, and retrieve methods.
16.0.0release notes
Set this 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 for AI agents.
16.0.0release notes
Adds the pause method on the Subscription resource.
16.0.0release notes
Adds pause_schedules to subscription schedule creation, modification, and resource objects.
16.0.0release notes
Adds the tax.Location resource with create, list, and retrieve methods.
16.0.0release notes
Adds the requirements field to TaxCode.
16.0.0release notes
Adds the three_d_secure.Authentication resource with cancel, create, list, retrieve, and submit methods.
16.0.0release notes
The account capability status updated event now supports blik_recurring_payments, satispay_payments, and sequra_payments.
16.0.0release notes
Support was added for the V1 event notification types listed in the release notes, covering account, billing, payments, subscriptions, and other Stripe resources.
16.0.0release notes
V2.Core.Event now supports snapshot_event.
16.0.0release notes
The enum now accepts 2026-09-30.endive.
16.0.0release notes

Behavior and default changes 2

The pinned API version changes to 2026-09-30.endive.
16.0.0release notes
Event notifications now support singleton related objects.
16.0.0release notes

Fixes and other changes 1

Callback clients use the event's Stripe context while preserving the original client's non-account configuration, fixing API errors when the client is configured with a Stripe account.
16.0.0release notes

stripe 1532 changes

Breaking changes 3

Removes support for cryptogram from the three_d_secure details of PaymentAttemptRecord and PaymentRecord.
15.6.0release notes
Changes PaymentIntent.allowed_payment_method_types to be required.
15.6.0release notes
Changes SetupIntent.allowed_payment_method_types to be required.
15.6.0release notes

Security 2

Hardened API requestor code against malicious URLs.
15.6.1release notes
Uses cryptographically secure boundaries for multipart file uploads.
15.6.1release notes

New APIs and options 24

Adds active_entitlements to CustomerSession.Component and CustomerSessionCreateParamsComponent.
15.6.0release notes
Adds authentication_failure as a supported error code on invoice, payment, setup, Stripe, and Terminal error types.
15.6.0release notes
Adds billie as a payment method option and payment_method_types value for invoices and subscriptions.
15.6.0release notes
Adds the billing.FeedbackOption resource and its create, deactivate, list, modify, and retrieve methods.
15.6.0release notes
Adds capability_not_active as a supported error code on invoice, payment, setup, Stripe, and Terminal error types.
15.6.0release notes
Adds country to FinancialConnections.Session.Filter.
15.6.0release notes
Adds customer_portal to CustomerSession.Component and CustomerSessionCreateParamsComponent.
15.6.0release notes
Adds customer_update as a flow type value and to BillingPortal.Session.Flow.
15.6.0release notes
Adds a handler class for thin event notifications, designed to work with StripeClient and typed thin events.
15.6.0release notes
Adds expired_payment_method as a supported error code on invoice, payment, setup, Stripe, and Terminal error types.
15.6.0release notes
Adds feedback_option to subscription cancellation detail and its cancel and modify parameters.
15.6.0release notes
Adds feedback_options to billing portal subscription cancellation reason types.
15.6.0release notes
Adds frozen_fields to InvoiceItem.
15.6.0release notes
Adds funding_source_group to Link payment method details on Charge.
15.6.0release notes
Adds funding_types_blocked to Checkout card payment method restrictions and create parameters.
15.6.0release notes
Adds igic to the listed Tax.Registration.CountryOption country types and their registration create parameters.
15.6.0release notes
Adds incorrect_postal_code as a supported error code on invoice, payment, setup, Stripe, and Terminal error types.
15.6.0release notes
Adds invalid_canceled_subscription_fields as a supported error code on invoice, payment, setup, Stripe, and Terminal error types.
15.6.0release notes
Adds metadata to ConfirmationToken.
15.6.0release notes
Adds payment_method_restricted as a supported error code on invoice, payment, setup, Stripe, and Terminal error types.
15.6.0release notes
Adds payment_method_settings to AccountSession.Component and AccountSessionCreateParamsComponent.
15.6.0release notes
Adds application_fee_amount, application_fee_percent, on_behalf_of, and transfer_data to PaymentLinkModifyParams.
15.6.0release notes
Adds touch_n_go as an allowed payment method type for PaymentIntent and SetupIntent.
15.6.0release notes
Adds 2026-08-26.dahlia as a supported api_version enum value.
15.6.0release notes

Behavior and default changes 2

The pinned API version changes to 2026-08-26.dahlia.
15.6.0release notes
Some webhook-related methods accept wider types to work better with types commonly returned by popular web frameworks.
15.6.0release notes

Fixes and other changes 1

Dispatches discriminated union fields to their variant class.
15.6.1release notes