NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #633 most downloaded on PyPI
Python bindings for the Stripe API
Last release 7 days ago
23 Sep 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
568 releases · first in 2011
Rename resources Issuing.CardDesign and Issuing.CardBundle to Issuing.PersonalizationDesign and Issuing.PhysicalBundle
See the changelog for more details.
One column per quarter.
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
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.
Add support for resume method on resource Subscription
Updated stable APIs to the latest version
list_transactions method on resource Tax.TransactionUpdated stable APIs to the latest version
Tax.Settings resource.Updated stable APIs to the latest version
quote.draft_quote implementation to from calling POST /v1/quotes/{quote}/draft to POST /v1/quotes/{quote}/mark_drafttax.Registration resourceUpdated stable APIs to the latest version
mark_stale_quote method on resource QuoteUpdated stable APIs to the latest version
stripe.TaxCalculation and stripe.TaxTranscation to stripe.tax.Calculation and stripe.tax.Transaction.Updated stable APIs to the latest version
QuoteLine, TaxCalculation, and TaxTransactioncreate and list_line_items methods on resource TaxCalculationcreate_reversal, create, and retrieve methods on resource TaxTransactionUpdated stable APIs to the latest version
Breaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the Stripe products, re…
Breaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the Stripe products, read more at https://docs.stripe.com/changelog/2022-11-15.
"⚠️" symbol highlights breaking changes.
This release changes the pinned API version to 2022-11-15.
Breaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the Stripe products, read more at https://docs.stripe.com/changelog/2022-11-15.
"⚠️" symbol highlights breaking changes.
UnsupportedGrantTypError->UnsupportedGrantTypeError and UnsupportedResponseTypError->UnsupportedResponseTypeErrorsave method on resources (#887). Use modify instead.# Before
customer = stripe.Customer.retrieve("cus_123")
customer.email = "example@test.com"
customer.save()
# After
stripe.Customer.modify("cus_123", email="example@test.com")
Updated beta APIs to the latest stable version
Nothing published for this version
Updated stable APIs to the latest version
FinancingOffer, FinancingSummary and FinancingTransaction resources.Add upcoming_lines method to the Invoice resource.
Updated stable APIs to the latest version
Updated stable APIs to the latest version
Stripe-Version beta headers are not pinned by-default and need to be manually specified, please refer to beta SDKs README sectionAdd support for new resource CustomerCashBalanceTransaction
Updated stable APIs to the latest version
refund_payment method to Terminal resourceUpdated stable APIs to the latest version
Order resource supportSee the changelog for more details.
Fixes issue where using special parameter like api_key, idempotency_key, stripe_version, stripe_account, headers can cause a Received unknown paramete
api_key, idempotency_key, stripe_version, stripe_account, headers can cause a Received unknown parameter error.Breaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the SDK, read more deta…
Breaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the SDK, read more detailed description at https://github.com/stripe/stripe-python/wiki/Migration-guide-for-v4. For changes to the Stripe products, read more at https://docs.stripe.com/changelog/2022-08-01.
"⚠️" symbol highlights breaking changes.
This release changes the pinned API version to 2022-08-01.
Breaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the SDK, read more detailed description at https://github.com/stripe/stripe-python/wiki/Migration-guide-for-v4. For changes to the Stripe products, read more at https://docs.stripe.com/changelog/2022-08-01.
"⚠️" symbol highlights breaking changes.
ApplicationFee.refund returns an instance of ApplicationFee and doesn't mutate the instance of ApplicationFee.Customer.delete_discount no longer resets the discount property to None and returns the deleted discount instead. If you were relying on this behavior, reset the discount property manually:Subscription.delete_discount returns an instance of deleted discount and doesn't mutate the instance of Subscription.LineItem resource now inherits from StripeObject as it has no methods of it's own.AlipayAccount, BitcoinReceiver, BitcoinTransaction, IssuerFraudRecord, Recipient, RecipientTransfer, and ThreeDSecure classes.Card.details method and CardDetails resource. The REST API endpoint is not longer supported.Charge.update_dispute and Charge.close_dispute methods that were using legacy REST API endpoint. Prefer Dispute.modify and Dispute.closeCharge.refund method. Prefer Refund.createSource.source_transactions method. Prefer SubscriptionItem.list_source_transactionsSubscriptionItem.usage_record_summaries method. Prefer SubscriptionItem.list_usage_record_summariesUpdated stable APIs to the latest version
QuotePhase resourceSubscriptionSchedule.amend method.server_side_confirmation_beta=v1 betasecretKeyConfirmation to PaymentIntentAdd support for deliver_card, fail_card, return_card, and ship_card test helper methods on resource Issuing.Card
deliver_card, fail_card, return_card, and ship_card test helper methods on resource Issuing.Cardinstance_url to computing method path in place for custom methods.Add support for fund_cash_balance test helper method on resource Customer
See the changelog for more details.
Add support for new resource Apps.Secret
Apps.SecretAdd support for new resources Treasury.CreditReversal, Treasury.DebitReversal, Treasury.FinancialAccountFeatures, Treasury.FinancialAccount, Treasury.
Treasury.CreditReversal, Treasury.DebitReversal, Treasury.FinancialAccountFeatures, Treasury.FinancialAccount, Treasury.FlowDetails, Treasury.InboundTransfer, Treasury.OutboundPayment, Treasury.OutboundTransfer, Treasury.ReceivedCredit, Treasury.ReceivedDebit, Treasury.TransactionEntry, and Treasury.Transactionretrieve_payment_method method on resource Customerlist_owners and list methods on resource FinancialConnections.AccountYour coding agent can read these notes before it upgrades. Set up the MCP server →