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.
* #651 Add support for billing_portal namespace and Session resource and APIs
billing_portal namespace and Session resource and APIs* #648 Add support for Express links in authorize_url for OAuth
authorize_url for OAuth* #646 Allow overriding API key in OAuth methods
Your coding agent can read these notes before it upgrades. Set up the MCP server →
* #644 Add support for listing Checkout Session
Session* #637 Start testing Python 3.8 * #640 Add support for CreditNoteLineItem * #639 Pin black version
* #631 Update proxy.py * #635 Update Python API docs inline link * #636 Fix uploading files with Unicode names (Python 2.7)
* #630 Add support for CreditNote preview
CreditNote preview* #627 Add list_usage_record_summaries and list_source_transactions
* #625 Add support for Mandate
Mandate* #624 Contributor Convenant * #623 Add support for reverse pagination
* #621 Implement support for stripe-should-retry and retry-after headers
* #620 Check that error is a dict before trying to use it to create a StripeError
error is a dict before trying to use it to create a StripeError* #616 Pass CFLAGS and LDFLAGS when running tests * #619 Add ErrorObject to StripeError exceptions
* #614 Use OrderedDict to maintain key order in API requests and responses
OrderedDict to maintain key order in API requests and responses* #612 Use ListObject properties as default values in request methods
ListObject properties as default values in request methods* #610 Add support for header parameters in ListObject request methods
ListObject request methods* #606 Clarify what max_network_retries does * #605 Fix automatic retries of failed requests
* #607 Add SubscriptionItem.create_usage_record method
SubscriptionItem.create_usage_record methodThis is technically a breaking change. We've chosen to release it as a minor vesion bump because the associated API is unused.
* #601 Add support for passing full objects instead of IDs to custom methods * #603 Bump vendored six to latest version
* #599 Fix del statement to not raise KeyError
del statement to not raise KeyError* #595 Listing BalanceTransaction objects now uses /v1/balance_transactions instead of /v1/balance/history
BalanceTransaction objects now uses /v1/balance_transactions instead of /v1/balance/history* #592 Fix argument name conflict
* #590 Add support for the SetupIntent resource and APIs
SetupIntent resource and APIs* #587 Enable request latency telemetry by default
* #589 Fix support for CustomerBalanceTransaction
CustomerBalanceTransaction* #564 Add support for CustomerBalanceTransaction resource and APIs
CustomerBalanceTransaction resource and APIs* #583 Remove Poetry and reinstate setup.py
setup.pyVersion 2.29.2 was non-functional due to a bugged version.py file. This release is identical to 2.29.2 save for the version number.
Version 2.29.2 was non-functional due to a bugged version.py file. This release is identical to 2.29.2 save for the version number.
* #578 Verify signatures before deserializing events
* #575 Add support for radar.early_fraud_warning resource
radar.early_fraud_warning resource* #574 Fix a few more code quality issues
* #572 Fix a few code quality issues
* #566 Add support for the Capability resource and APIs
Capability resource and APIs* #554 Add support for the TaxRate resource and APIs
TaxRate resource and APIs* #555 Add support for the TaxId resource and APIs
TaxId resource and APIs* #551 Add support for the CreditNote resource and APIs
CreditNote resource and APIs* #550 Fix encoding of nested parameters in multipart requests
* #547 Add class methods for all custom API requests (e.g. Charge.capture) * #543 Add delete class method on deletable API resources
* #542 Add support for deleting a Terminal Location and Reader * #537 Add support for the PaymentMethod resource and APIs * #540 Add support for retri
* #541 Add stripe.util.convert_to_dict method for converting StripeObject instances to regular dicts
stripe.util.convert_to_dict method for converting StripeObject instances to regular dicts* #532 Add support for subscription schedules
* #530 Fix client telemetry implementation
* #534 Fix session initialization for multi-threaded environments
* #531 Make RequestsClient thread-safe
RequestsClient thread-safe* #526 Reuse the default HTTP client by default
* #524 Rename CheckoutSession to Session and move it under the checkout namespace. This is a breaking change, but we've reached out to affected mercha
CheckoutSession to Session and move it under the checkout namespace. This is a breaking change, but we've reached out to affected merchants and all new merchants would use the new approach.* #525 Properly serialize individual on Account objects
individual on Account objects* #518 Add configurable telemetry to gather information on client-side request latency
* #510 Add support for Checkout sessions
* #507 Add support for account links
* #503 Add support for providing custom CA certificate bundle
* #500 Add support for Review for Radar
Review for Radar* #489 Add support for ValueList and ValueListItem for Radar
ValueList and ValueListItem for Radar* #495 Make StripeResponse a new-style class
StripeResponse a new-style class* #483 Add new API endpoints for the Invoice resource.
Invoice resource.* #491 Bump minimum requests version to 2.20.0 (for CVE-2018-18074)
* #482 Add support for the Person resource * #484 Add support for the WebhookEndpoint resource
* #481 Correct behavior of stripe.max_network_retries if it's reset after initial use
stripe.max_network_retries if it's reset after initial use* #478 Add support for Stripe Terminal
One column per quarter.