# What changed in stripe

> 65 changes in stripe 15 to 16 from its official release notes, upgrade guides and advisories: 13 breaking, 2 security, 44 new APIs and options. Each one cited. Sources checked 2026-10-20. HTML: https://unstale.sh/pypi/stripe/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## stripe 16

### Breaking changes

- The parameter type changes from `string` to an enum. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- The field type changes from `string` to `expandable($Mandate)`. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- Removes support for `countries` from the session filter and its creation parameters. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- Removes support for this parameter on PaymentIntent, SetupIntent, and Checkout session creation or modification parameters. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- Removes support for `payto` on PaymentMethod modification parameters. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- On resource methods supporting both classmethod and instance-method call styles, path parameters must be passed positionally rather than by keyword. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- 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.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- The resource class is renamed to `stripe.TransferReversal`; update references and type annotations. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- The `stripe.Reversal` resource class is renamed; update references and type annotations to use `stripe.TransferReversal`. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- The deprecated method is removed; use `StripeClient.raw_request` for custom API requests. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)

### New APIs and options

- Adds the `apps.Install` resource with `create`, `list`, `modify`, `retrieve`, and `uninstall` methods. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- Snapshot events apps.install.created, apps.install.deleted, and apps.install.updated are now supported for apps.Install. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- The account requirement capability enums now support blik_recurring_payments and satispay_payments. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- Adds `allowed_payment_method_types` to Checkout session objects and creation parameters. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- Several error codes are now supported on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, StripeError, and Terminal.Reader.Action.ApiError. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- Adds the `country` filter field. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- Adds the `payment_record` field to PaymentIntent. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- Adds `mandate_options` to Blik payment method options and the corresponding PaymentIntent parameter types. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- The Payment Link payment method type enums now accept `paypay` and `sequra`. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- Adds the `product_catalog.TrialOffer` resource with `create`, `list`, `modify`, and `retrieve` methods. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- 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.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- Adds the `pause` method on the `Subscription` resource. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- Adds `pause_schedules` to subscription schedule creation, modification, and resource objects. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- Adds the `tax.Location` resource with `create`, `list`, and `retrieve` methods. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- Adds the `requirements` field to TaxCode. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- Adds the `three_d_secure.Authentication` resource with `cancel`, `create`, `list`, `retrieve`, and `submit` methods. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- The account capability status updated event now supports blik_recurring_payments, satispay_payments, and sequra_payments. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- 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.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- V2.Core.Event now supports snapshot_event. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- The enum now accepts `2026-09-30.endive`. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)

### Behavior and default changes

- The pinned API version changes to 2026-09-30.endive. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)
- Event notifications now support singleton related objects. (16.0.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)

### Fixes and other changes

- 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.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v16.0.0)

## stripe 15

### Breaking changes

- Removes support for cryptogram from the three_d_secure details of PaymentAttemptRecord and PaymentRecord. (15.6.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v15.6.0)
- Changes PaymentIntent.allowed_payment_method_types to be required. (15.6.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v15.6.0)
- Changes SetupIntent.allowed_payment_method_types to be required. (15.6.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v15.6.0)

### Security

- Hardened API requestor code against malicious URLs. (15.6.1) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v15.6.1)
- Uses cryptographically secure boundaries for multipart file uploads. (15.6.1) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v15.6.1)

### New APIs and options

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

### Behavior and default changes

- The pinned API version changes to 2026-08-26.dahlia. (15.6.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v15.6.0)
- Some webhook-related methods accept wider types to work better with types commonly returned by popular web frameworks. (15.6.0) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v15.6.0)

### Fixes and other changes

- Dispatches discriminated union fields to their variant class. (15.6.1) — [release notes](https://github.com/stripe/stripe-python/releases/tag/v15.6.1)