NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #470 most downloaded on PyPI
Python bindings for the Stripe API
Latest stable
17.1.0
Last release 3 days ago
19 Nov 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
2 versions withdrawn
withdrawn after publishing
15 years old
596 releases · first in 2011
Drag across the ruler to compare, or tap a release to open it.
See the changelog for more details.
Reports uses of the deprecated .save in X-Stripe-Client-Telemetry. (You can disable telemetry via stripe.enable_telemetry = false, see the README.)
#1161 Update generated code
payment_method_reuse_agreement on resource classes PaymentLink.ConsentCollection and checkout.Session.ConsentCollection and parameter classes PaymentLink.CreateParamsConsentCollection and checkout.Session.CreateParamsConsentCollectionafter_submit on parameter classes PaymentLink.CreateParamsCustomText, PaymentLink.ModifyParamsCustomText, and checkout.Session.CreateParamsCustomText and resource classes PaymentLink.CustomText and checkout.Session.CustomTextcreated on parameter class radar.EarlyFraudWarning.ListParams#1146 Track usage of deprecated save
.save in X-Stripe-Client-Telemetry. (You can disable telemetry via stripe.enable_telemetry = false, see the README.)#1101 Mark defunct and internal methods as deprecated
#1169 Add more types to _http_client.py
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Add support for retrieve method on resource FinancialConnections.Transaction
retrieve method on resource FinancialConnections.TransactionSee the changelog for more details.
stripe.app_infoSee the changelog for more details.
stripe.app_info, stripe.http_client, stripe.oauth, stripe.util, stripe.version, stripe.webhook, modules are deprecated. All types are available direct…
payment_details, payments, and payouts on AccountSession.components and CreateParams.componentsfeatures on AccountSession.components.account_onboarding and CreateParams.components.account_onboardingcustomer_tax_location_invalid and financial_connections_no_successful_transaction_refresh on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.codepayment_network_reserve_hold and payment_network_reserve_release on enum BalanceTransaction.typeClimate.Product.metric_tons_available to be requiredvarious from enum Climate.Supplier.removal_pathwaychallenge_only and challenge from enum PaymentIntent.payment_method_options.card.request_three_d_secureinactive_message and restrictions on CreateParams, ModifyParams, and PaymentLinktransfer_group on PaymentLink.payment_intent_data, CreateParams.payment_intent_data, and ModifyParams.payment_intent_datatrial_settings on PaymentLink.subscription_data, CreateParams.subscription_data, and ModifyParams.subscription_datastripe.app_info, stripe.http_client, stripe.oauth, stripe.util, stripe.version, stripe.webhook, modules are deprecated. All types are available directly from stripe module now.
Before:from stripe.util import convert_to_stripe_object
# or
stripe.util.convert_to_stripe_object
After:from stripe import convert_to_stripe_object
# or
stripe.convert_to_stripe_object
stripe.api_version, stripe.multipart_data_generator, stripe.request_metrics are deprecated and will be fully removed in the future.stripe.error, stripe.stripe_object, stripe.api_requestor, stripe.stripe_response, stripe.request_options, stripe.api_resources.*, stripe.api_resources.abstract.* modules are deprecated. All types are available directly from stripe module now.
Before:from stripe.error import APIError
# or
stripe.error.APIError
After:from stripe import APIError
# or
stripe.APIError
See the changelog for more details.
Add support for new resources Climate.Order, Climate.Product, and Climate.Supplier
Climate.Order, Climate.Product, and Climate.Suppliercancel, create, list, modify, and retrieve methods on resource Orderlist and retrieve methods on resources Product and Supplierfinancial_connections_account_inactive on enums Invoice.LastFinalizationError.code, PaymentIntent.LastPaymentError.code, SetupAttempt.SetupError.code, and SetupIntent.LastSetupError.codeclimate_order_purchase and climate_order_refund on enum BalanceTransaction.typecreated on Checkout.Session.ListParamsvalidate_location on Customer.CreateParamsTax and Customer.ModifyParamsTaxclimate.order.canceled, climate.order.created, climate.order.delayed, climate.order.delivered, climate.order.product_substituted, climate.product.created, and climate.product.pricing_updated on enum Event.typechallenge on enums PaymentIntent. PaymentMethodOptions.Card.request_three_d_secure and SetupIntent. PaymentMethodOptions.Card.request_three_d_secureclimate_order_purchase and climate_order_refund on enum Reporting.ReportRun. CreateParamsParameters.reporting_categoryclimate.order.canceled, climate.order.created, climate.order.delayed, climate.order.delivered, climate.order.product_substituted, climate.product.created, and climate.product.pricing_updated on enums WebhookEndpoint.CreateParams.enabled_events[] and WebhookEndpoint.ModifyParams.enabled_events[]Rename receipient to recipient beneath PaymentDetails on Charge and PaymentIntent APIs.* Add support for electronic_commerce_indicator on resource cla
receipient to recipient beneath PaymentDetails on Charge and PaymentIntent APIs.* Add support for electronic_commerce_indicator on resource classes Charge.PaymentMethodDetails.Card.ThreeDSecure and SetupAttempt.PaymentMethodDetails.Card.ThreeDSecurecomponents on parameter class CustomerSession.CreateParams and resource CustomerSessionAdd support for electronic_commerce_indicator on resource classes Charge.PaymentMethodDetails.Card.ThreeDSecure and SetupAttempt.PaymentMethodDetails.
electronic_commerce_indicator on resource classes Charge.PaymentMethodDetails.Card.ThreeDSecure and SetupAttempt.PaymentMethodDetails.Card.ThreeDSecureexemption_indicator on resource class Charge.PaymentMethodDetails.Card.ThreeDSecuretransaction_id on resource classes Charge.PaymentMethodDetails.Card.ThreeDSecure, SetupAttempt.PaymentMethodDetails.Card.ThreeDSecure, issuing.Authorization.NetworkData, and issuing.Transaction.NetworkDataoffline on resource class Charge.PaymentMethodDetails.CardPresenttransferred_to_balance on resource CustomerCashBalanceTransactionthree_d_secure on parameter classes PaymentIntent.ConfirmParamsPaymentMethodOptionsCard, PaymentIntent.CreateParamsPaymentMethodOptionsCard, PaymentIntent.ModifyParamsPaymentMethodOptionsCard, SetupIntent.ConfirmParamsPaymentMethodOptionsCard, SetupIntent.CreateParamsPaymentMethodOptionsCard, and SetupIntent.ModifyParamsPaymentMethodOptionsCardsystem_trace_audit_number on resource class issuing.Authorization.NetworkDatanetwork_risk_score on resource classes issuing.Authorization.PendingRequest and issuing.Authorization.RequestHistoryrequested_at on resource class issuing.Authorization.RequestHistoryauthorization_code on resource class issuing.Transaction.NetworkDataAdd support for issuing_card and issuing_cards_list on AccountSession.Components
issuing_card and issuing_cards_list on AccountSession.Componentsevent_details and subscription on payment_details typesaffiliate and delivery on payment_details.flight, payment_details.lodging, and payment_details.car_rental typesdrivers on payment_details.car_rental typespassengers on payment_details.flight and payment_details.lodging typescreated on CustomerSessionAdd support for bacs_debit_payments on Account.CreateParamsSettings
bacs_debit_payments on Account.CreateParamsSettingsservice_user_number on Account.Settings.BacsDebitPaymentscapture_before on Charge.PaymentMethodDetails.Card.capture_beforePaypal on Checkout.Session.PaymentMethodOptionstax_amounts on CreditNote.CreateParamsLine, CreditNote.PreviewParamsLine, and CreditNote.PreviewLinesParamsLinenetwork_data on Issuing.Transactionstatus on Checkout.Session.ListParamsSee the changelog for more details.
Add support for new value terminal_reader_hardware_fault on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAt
terminal_reader_hardware_fault on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.codemetadata on Quote.subscription_data, QuoteCreateParams.subscription_data, and QuoteUpdateParams.subscription_dataNone from optional param typesAdd support for attach_payment_intent method on resource Invoice
attach_payment_intent method on resource InvoiceAdd support for new resource Tax.Registration
Tax.Registrationcreate, list, and modify methods on resource RegistrationSee the changelog for more details.
Add support for new resource Margin
Margincreate, list, modify, and retrieve methods on resource MarginThis PR includes py.typed and enables inline type annotations for stripe-python package. Inline type annotations will now take precedence over Typeshe
py.typed and enable type annotations for the package
py.typed and enables inline type annotations for stripe-python package. Inline type annotations will now take precedence over Typeshed for users who use a type checker or IDE.StripeObject, instead of into generic StripeObject instances.PromotionCode.restrictions.currency_options will now deserialize into dict and not StripeObject.balance_invalid_parameter on enums Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, and SetupIntent.LastSetupErrorsave.Update pinned API version to 2023-10-16
This release changes the pinned API version to 2023-10-16. Please read the API Changelog and carefully review the API changes before upgrading stripe-
2023-10-16. Please read the API Changelog and carefully review the API changes before upgrading stripe-python.This release enables type annotations in the beta channel including types for resources, methods, properties, and parameters.
pip uninstall types-stripe).typings/stripe stubs set up in your project directorypip install types-stripe might be a quick fix. The stubs are outdated but much less opinionated so they might make unwanted type errors go away. This isn't a permanent solution however.# type: ignore.typings/stripeSee the changelog for more details.
Add support for mark_draft and mark_stale methods on resource Quote
mark_draft and mark_stale methods on resource Quotedraft_quote and mark_stale_quote methods on resource Quotepreview_invoice_lines to list_preview_invoice_lines on resource QuoteIssuing.CardDesign and Issuing.CardBundle to Issuing.PersonalizationDesign and Issuing.PhysicalBundleReplace the bundled CA certificates with Stripe's updated trusted root certificates (see https://docs.stripe.com/tls-certificates for more info). The
Add support for new resource Issuing.Token
Issuing.Tokenlist, modify, and retrieve methods on resource TokenRename resources Issuing.CardDesign and Issuing.CardBundle to Issuing.PersonalizationDesign and Issuing.PhysicalBundle
See the changelog for more details.
See the changelog for more details.
Add support for new resource ConfirmationToken
ConfirmationTokenretrieve method on resource ConfirmationTokencreate method on resource Issuing.CardDesignreject_testmode test helper method on resource Issuing.CardDesignAdd support for new resource PaymentMethodConfiguration
PaymentMethodConfigurationcreate, list, modify, and retrieve methods on resource PaymentMethodConfigurationcapture, create, expire, increment, and reverse test helper methods on resource Issuing.Authorizationcreate_force_capture, create_unlinked_refund, and refund test helper methods on resource Issuing.Transactioncapture, create, expire, increment, and reverse test helper methods on resource Issuing.Authorizationcreate_force_capture, create_unlinked_refund, and refund test helper methods on resource Issuing.TransactionPaymentMethodConfigurationcreate, list, modify, and retrieve methods on resource PaymentMethodConfigurationRemove support for submit_card test helper method on resource Issuing.Card
Add support for new resource PaymentMethodDomain
See the changelog for more details.
Rename Quote.preview_invoices and Quote.preview_subscription_schedules to Quote.list_preview_invoices and Quote.list_preview_schedules.
Quote.preview_invoices and Quote.preview_subscription_schedules to Quote.list_preview_invoices and Quote.list_preview_schedules.Add support for new resource AccountSession
See the changelog for more details.
See the changelog for more details.
Updated stable APIs to the latest version
⚠️ ACTION REQUIRED: the breaking change in this release likely affects you ⚠️
⚠️ ACTION REQUIRED: the breaking change in this release likely affects you ⚠️
#1001 #1008 Remove support for Python 2.
#987 ⚠️⚠️Pin to the latest API version⚠️⚠️
In this release, Stripe API Version 2023-08-16 (the latest at time of release) will be sent by default on all requests.
The previous default was to use your Stripe account's default API version.
To successfully upgrade to stripe-python v6, you must either
(Recommended) Upgrade your integration to be compatible with API Version 2023-08-16.
Please read the API Changelog carefully for each API Version from 2023-08-16 back to your Stripe account's default API version. Determine if you are using any of the APIs that have changed in a breaking way, and adjust your integration accordingly. Carefully test your changes with Stripe Test Mode before deploying them to production.
You can read the v6 migration guide for more detailed instructions.
(Alternative option) Specify a version other than 2023-08-16 when initializing stripe-python.
If you were previously initializing stripe-python without an explicit API Version, you can postpone modifying your integration by specifying a version equal to your Stripe account's default API version. For example:
import stripe
stripe.api_key = "sk_test_..."
+ stripe.api_version = '2020-08-27'
If you were already initializing stripe-python with an explicit API Version, upgrading to v6 will not affect your integration.
Read the v6 migration guide for more details.
Going forward, each major release of this library will be pinned by default to the latest Stripe API Version at the time of release.
That is, instead of upgrading stripe-python and separately upgrading your Stripe API Version through the Stripe Dashboard, whenever you upgrade major versions of stripe-python, you should also upgrade your integration to be compatible with the latest Stripe API version.
#1013 ⚠️Removed @test_helper decorator
#1015 ⚠️Assert types of pagination responses
Add support for submit_card test helper method on resource Issuing.Card
Add support for new resource Tax.Form
Add support for new resource PaymentMethodConfiguration
#991 Update generated code for beta Release specs are identical.
#989 Update generated code for beta
PaymentMethodConfigurationcreate, list, modify, and retrieve methods on resource PaymentMethodConfiguration#985 Update generated code for beta
#986 Consolidate beta SDKs section
Replace the bundled CA certificates with Stripe's updated trusted root certificates (see https://docs.stripe.com/tls-certificates for more info). The
Add support for new resource Tax.Settings
#990 Update generated code
Tax.Settingsmodify and retrieve methods on resource Settings#981 Update generated code
#984 Stop testing Python 2.7
#978 Update generated code
#977 Add information about accessing response headers
#972 Update generated code
#975 Add constraints.txt
#974 Pin cryptography version
#970 Update generated code
#967 Update generated code
Documentation updates.
#963 Update generated code
#962 ci: Fix github action warnings
#960 Fix build status badge in README.md
#955 Update generated code
#958 Fix coveralls condition
#952 Update generated code
Add support for new resource CustomerSession
See the changelog for more details.
Add support for subscribe and unsubscribe methods on resource FinancialConnections.Account
Add support for collect_payment_method and confirm_payment_intent methods on resource Terminal.Reader
See the changelog for more details.
This is not a breaking change, as this method was deprecated before the Tax Transactions API was released in favor of the create_from_calculation meth…
create method on resource Tax.Transaction
create_from_calculation method.Add support for new resources Tax.CalculationLineItem and Tax.TransactionLineItem
Tax.CalculationLineItem and Tax.TransactionLineItemcollect_inputs method on resource Terminal.ReaderAdd support for new resources Tax.CalculationLineItem, Tax.Calculation, Tax.TransactionLineItem, and Tax.Transaction
Tax.CalculationLineItem, Tax.Calculation, Tax.TransactionLineItem, and Tax.Transactioncreate and list_line_items methods on resource Calculationcreate_from_calculation, create_reversal, create, list_line_items, and retrieve methods on resource TransactionAdd support for create_from_calculation method on resource Tax.Transaction
create_from_calculation method on resource Tax.TransactionCapital.FinancingOffer and Capital.FinancingSummarylist, mark_delivered, and retrieve methods on resource FinancingOfferretrieve method on resource FinancingSummaryUpdated stable APIs to the latest version
list_transactions method on resource Tax.TransactionUpdated stable APIs to the latest version
Issuing.CardBundle and Issuing.CardDesignlist and retrieve methods on resource CardBundlelist, modify, and retrieve methods on resource CardDesignUpdated stable APIs to the latest version
Add support for refund_payment method on resource Terminal.Reader
refund_payment method on resource Terminal.ReaderUpdated stable APIs to the latest version
FinancialConnections.Transactionlist method on resource TransactionSee the changelog for more details.
One column per quarter.