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.
Add support for resume method on resource Subscription
Your coding agent can read these notes before it upgrades. Set up the MCP server →
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->UnsupportedResponseTypeErrorDeprecate save 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.Replace the bundled CA certificates with Stripe's updated trusted root certificates (see https://docs.stripe.com/tls-certificates for more info). The
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.Account⚠️ Replace the legacy Order API with the new Order API.
Order API with the new Order API.
cancel, list_line_items, reopen, and submitpay and return_orderOrderItem and OrderReturnfinancial_connections.account.refresh to financial_connections.refresh_accountamount_discount, amount_tax, and product on LineItemAdd support for new resources FinancialConnections.AccountOwner, FinancialConnections.AccountOwnership, FinancialConnections.Account, and FinancialCon
FinancialConnections.AccountOwner, FinancialConnections.AccountOwnership, FinancialConnections.Account, and FinancialConnections.SessionAdd support for new resource CashBalance
CashBalanceAdd support for expire test helper method on resource Refund
expire test helper method on resource RefundAdd support for new resources FundingInstructions and Terminal.Configuration
Add support for increment_authorization method on resource PaymentIntent
increment_authorization method on resource PaymentIntentAdd support for apply_customer_balance method on resource PaymentIntent
apply_customer_balance method on resource PaymentIntentAdd support for cancel_action, process_payment_intent, process_setup_intent, and set_reader_display methods on resource Terminal.Reader
cancel_action, process_payment_intent, process_setup_intent, and set_reader_display methods on resource Terminal.ReaderAdd support for search method on resources Charge, Customer, Invoice, PaymentIntent, Price, Product, and Subscription
search method on resources Charge, Customer, Invoice, PaymentIntent, Price, Product, and SubscriptionAdd support for cancel method on resource Refund
Add support for new resource TestHelpers.TestClock
TestHelpers.TestClockAdd support for verify_microdeposits method on resources PaymentIntent and SetupIntent
verify_microdeposits method on resources PaymentIntent and SetupIntentAdd support for new resource PaymentLink
* #754 Clarify metadata deletion message. * #756 Introduce custom listing methods on objects. * #757 Update class custom methods to save list object p
Add support for new resource ShippingRate
ShippingRateAdd support for expire method on resource Checkout.Session
expire method on resource Checkout.SessionAdd support for list_payment_methods method on resource Customer
Add support for list_computed_upfront_line_items method on resource Quote
list_computed_upfront_line_items method on resource Quote* #727 #725 Add support for new Quote API.
Add support for new TaxCode API.
TaxCode API.* #720 Add support for Identity VerificationSession and VerificationReport APIs
* #713 Add support for the Billing Portal Configuration API
* #704 Fix CA bundle path issue
* #691 Include the examples in the built sources * #699 Start testing Python 3.9 * #698 Fix issue where StripeObjects in lists would not be converted
* #684 Add support for the Payout Reverse API
2.52.0 and 2.53.0 were empty releases that contained no additional changes.
SetupAttempt resource and List APINothing published for this version
* #676 Add support for the Issuing Dispute Submit API
* #669 Add support for the PromotionCode resource and APIs
PromotionCode resource and APIs* #665 Support stripe.File.create(stripe_version='...')
* #655 Add support for the LineItem resource and APIs
LineItem resource and APIs* #652 Add support for the Price resource and APIs
Price resource and APIsOne column per quarter.