stripe-python

See the changelog for the full release notes.

See the changelog for the full release notes.

See the changelog for the full release notes.

The full release notes for this major version are in the linked changelog; the release body itself does not describe the changes.

See the changelog for the full release notes.

See the changelog for the full release notes.

Adds customer tax exemption to tax breakdowns, new data_share_only ThreeDSecure result value, backdate_start_date on checkout subscriptions, signals on Identity verification reports, network_response_code on issuing authorizations, and unit_cost_precision on payment intent line items. Makes PaymentIntent.payment_record and Subscription trial billing cycle anchors required fields.

This private-preview release adds Sequra payment method support across Charges, Checkout, PaymentIntents, and SetupIntents, plus new resources for billing evaluation, payment retry signals, and tax integration configuration. It removes the execute and submit methods on v2.core.ApprovalRequest, drops payment_method_types from PaymentIntent and SetupIntent create/modify params, and renames other breaking changes to enums and field types.

API requests are now hardened against malicious URLs, and multipart file uploads use cryptographically secure boundaries. Discriminated union fields now dispatch to their variant class.

Pinned to API version 2026-08-26.preview, adding a new CustomerTaxExemption resource with CRUD methods, plus new fields across Issuing, FinancialConnections, and identity. Removing sequra_payments on Account.Capability, sequra on several payment-method details, and cancel_at_period_end on Subscription.PendingUpdate; two FinancialConnections Transaction.Classification fields become optional.

Pinned API version to 2026-08-26.preview with new v2 resources for approval requests and signals. Removes payment_method_types from PaymentIntent and SetupIntent params, and changes PayoutMethod usage status enums to include disabled. Adds non-verified methods to managed handlers.

New EventNotificationHandler class provides a typed, integrated way to manage thin event notifications with StripeClient, and webhook-related methods now accept a wider range of framework types. Generated code adds a billing.FeedbackOption resource plus dozens of new fields and enum values, and removes cryptogram support on PaymentAttemptRecord and PaymentRecord 3DS card details.

Adds the PaymentPlan resource and billing.FeedbackOption, with create, list, modify, and retrieve methods, plus new payment_plan event types. Removes billing.FeedbackOptions and the cryptogram field on ThreeDSecure, and changes feedback_option types to the singular FeedbackOption.

Improved documentation for StripeObject's to_dict behavior.

Adds a new v2.tax OperationsResolveAddressResult resource with resolve_address, plus confirm and fx_quote methods on v2.money_management PayoutIntent. Removes pricing_group on Charge.PaymentMethodDetail.Link and several partner_disabled_* enum values, and broadens several type literals to enums.

Added async for support to v2 ListObject.auto_paging_iter(), plus new unverified event-construction helpers for previously verified webhook payloads (with native EventBridge and Event Grid support), a WebhookSignature.generate_signature_header() test utility, a new stripe.major_api_version constant, and an object property on EventNotification.

Adds support for the billing.FeedbackOptions resource and Sequra as a payment method across multiple API surfaces, plus field additions for card-present details, healthcare metadata, and checkout shipping tax rates. Two fields on Radar payment detail card now required, and pricing_lines on a billing contract is now optional.

This release pins the API version to 2026-07-29.preview and brings breaking changes: gift card brand enums narrowed from fiserv_valuelink|givex|svs to svs only, the managed_by field on FinancialAccount and payout_intent on OutboundPaymentCreateParams are removed. New resources include v2.signals.AccountEvaluation, v2.signals.AccountActivity, v2.risk.Inquiry, and v2.money_management.ReceivedDebitMandate, plus new account signal evaluation types.

This beta release pins the API version to 2026-07-29.preview and removes support for dozens of payment method types (acss_debit, afterpay_clearpay, alipay, etc.) from SharedPayment.GrantedToken.PaymentMethodDetail. Also removes taxes in favor of tax_items on payment detail tax fields, renames tax_ids to tax_id on Checkout.Session.CollectedInformation, replaces payout_v1 with payout on received credit balance transfers, and changes the issued token next action type enum to include redirect_to_url alongside use_stripe_sdk.

This release pins the API version to 2026-07-29.dahlia. It adds the new financial_connections.Authorization resource, an unreject method on Account, and a list method on PaymentRecord. It also removes limited-use fields dynamic_tax_rates on checkout session line items and proof_of_registration on account documents.