- #951 Update generated code
- Remove support for
createmethod on resourceTax.Transaction- This is not a breaking change, as this method was deprecated before the Tax Transactions API was released in favor of the
create_from_calculationmethod.
- This is not a breaking change, as this method was deprecated before the Tax Transactions API was released in favor of the
- Remove support for
- #947 Update generated code
- Add support for new resources
Tax.CalculationLineItem,Tax.Calculation,Tax.TransactionLineItem, andTax.Transaction - Add support for
createandlist_line_itemsmethods on resourceCalculation - Add support for
create_from_calculation,create_reversal,create,list_line_items, andretrievemethods on resourceTransaction
- Add support for new resources
- #924 API Updates
- Add support for
refund_paymentmethod on resourceTerminal.Reader
- Add support for
- #923 Bugfix: revert "Pass params into logger.{info,debug}"
- #920 API Updates
- Add support for
resumemethod on resourceSubscription
- Add support for
- #913 Pass params into logger.{info,debug}
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://stripe.com/docs/upgrades#2022-11-15.
"
-
#895 Next major release changes
-
#889 API Updates
-
#888 Do not run Coveralls if secret token is not available
-
#875 hide misleading ssl security warning in python>=2.7.9
- Dropped support for Python version 3.4 and 3.5 (#881). We now support Python 2.7 or 3.6+.
- Fixed mistyped names for two OAuth exceptions:
UnsupportedGrantTypError->UnsupportedGrantTypeErrorandUnsupportedResponseTypError->UnsupportedResponseTypeError(#872).
- Deprecate
savemethod on resources (#887). Usemodifyinstead.# Before customer = stripe.Customer.retrieve("cus_123") customer.email = "example@test.com" customer.save() # After stripe.Customer.modify("cus_123", email="example@test.com")
- Removed
Ordersresource (#882). - Removed
SKUresource (#883).
- #877 API Updates
- Add
upcoming_linesmethod to theInvoiceresource.
- Add
- #873 Add abstract methods for SearchableAPIResource
- #867 API Updates
- Update links in documentation to be absolute.
- #861 API Updates
- Add support for new resource
CustomerCashBalanceTransaction
- Add support for new resource
- #860 Add a support section to the readme
- #717 Fix test TestCharge.test_is_saveable().
- #855 Fix issue where auto_paging_iter failed on nested list objects.
- #850 Fix incorrect handling of additional request parameters
- Fixes issue where using special parameter like
api_key,idempotency_key,stripe_version,stripe_account,headerscan cause aReceived unknown parameter error.
- Fixes issue where using special parameter like
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://stripe.com/docs/upgrades#2022-08-01.
"
- #847 API Updates
- #845 Next major release changes
- #836 API Updates. Add Price.create tests.
- #835 API Updates. Use auto-generation for credit_note and invoice methods.
- Removed deprecated
AlipayAccount,BitcoinReceiver,BitcoinTransaction,IssuerFraudRecord,Recipient,RecipientTransfer, andThreeDSecureclasses. - Removed deprecated
Charge.update_disputeandCharge.close_disputemethods that were using legacy REST API endpoint. Prefer Dispute.modify and Dispute.close - Removed deprecated
Card.detailsmethod andCardDetailsresource. The REST API endpoint is not longer supported. - Removed the deprecated
Source.source_transactionsmethod. PreferSubscriptionItem.list_source_transactions - Removed the deprecated
SubscriptionItem.usage_record_summariesmethod. PreferSubscriptionItem.list_usage_record_summaries - Removed the deprecated
Charge.refundmethod. Prefer Refund.create
- To be consistent with other resource methods,
ApplicationFee.refundreturns an instance ofApplicationFeeand doesn't mutate the instance ofApplicationFee. - To be consistent with other resource methods, the
Customer.delete_discountno longer resets thediscountproperty toNoneand returns the deleted discount instead. If you were relying on this behavior, reset the discount property manually: - The
LineItemresource now inherits fromStripeObjectas it has no methods of it's own. - To be consistent with other resource methods, the
Subscription.delete_discountreturns an instance of deleted discount and doesn't mutate the instance ofSubscription. - Update the CA certificate bundle.
- Request sending logic unified across standard and custom methods (stripe#832)
- #831 API Updates
- Add support for
deliver_card,fail_card,return_card, andship_cardtest helper methods on resourceIssuing.Card - Switch from using
instance_urlto computing method path in place for custom methods. - Switch from using explicit class methods for test helpers instead of using meta-programming.
- Add support for
- #824 API Updates
- Add support for
fund_cash_balancetest helper method on resourceCustomer
- Add support for
- #823 Trigger workflows on beta branches
- #818 fix: Update cash balance methods to no longer require nested ID.
- #812 API Updates
- Add support for new resource
Apps.Secret
- Add support for new resource
- #810 API Updates
- Add support for new resources
Treasury.CreditReversal,Treasury.DebitReversal,Treasury.FinancialAccountFeatures,Treasury.FinancialAccount,Treasury.FlowDetails,Treasury.InboundTransfer,Treasury.OutboundPayment,Treasury.OutboundTransfer,Treasury.ReceivedCredit,Treasury.ReceivedDebit,Treasury.TransactionEntry, andTreasury.Transaction - Add support for
retrieve_payment_methodmethod on resourceCustomer - Add support for
list_ownersandlistmethods on resourceFinancialConnections.Account
- Add support for new resources
- #719 Set daemon attribute instead of using setDaemon method that was deprecated in Python 3.10
- #767 Bump vendored six to 1.16.0
- #806 Start testing on pypy-3.8
- #811 Add sanitize_id method
- #809 Release of major version v3.0.0. The migration guide contains more information.
(
⚠️ = breaking changes):⚠️ Replace the legacyOrderAPI with the newOrderAPI.- New methods:
cancel,list_line_items,reopen, andsubmit - Removed methods:
payandreturn_order - Removed resources:
OrderItemandOrderReturn
- New methods:
⚠️ Renamefinancial_connections.account.refreshtofinancial_connections.refresh_account- Add support for
amount_discount,amount_tax, andproductonLineItem
- #808 API Updates
- Add support for new resources
FinancialConnections.AccountOwner,FinancialConnections.AccountOwnership,FinancialConnections.Account, andFinancialConnections.Session
- Add support for new resources
- #805 API Updates
- Add support for new resource
CashBalance
- Add support for new resource
- #796 API Updates
- Add support for
expiretest helper method on resourceRefund
- Add support for
- #792 #794 #795 API Updates
- Add support for new resources
FundingInstructionsandTerminal.Configuration
- Add support for new resources
- #791 API Updates
- Add support for
increment_authorizationmethod on resourcePaymentIntent
- Add support for
- #788 API Updates
- Add support for
apply_customer_balancemethod on resourcePaymentIntent
- Add support for
- #785 API Updates
- Add support for
cancel_action,process_payment_intent,process_setup_intent, andset_reader_displaymethods on resourceTerminal.Reader
- Add support for
- #783 API Updates
- Add support for Search API
- Add support for
searchmethod on resourcesCharge,Customer,Invoice,PaymentIntent,Price,Product, andSubscription
- Add support for
- Add support for Search API
- #784 Pin click dependency to 8.0.4 to avoid breakage in black
- #773 Add infrastructure for test-helper methods
- #782 Revert Orders to use qualified name for upload_api_base
- #781 API Updates
- Add support for
cancelmethod on resourceRefund
- Add support for
- #777 Add support for SearchResult.
- #774 API Updates
- Add support for new resource
TestHelpers.TestClock
- Add support for new resource
- #771 API Updates
- Add support for
verify_microdepositsmethod on resourcesPaymentIntentandSetupIntent
- Add support for
- #757 Update class custom methods to save list object parameters.
- #756 Introduce custom listing methods on objects.
- #754 Clarify metadata deletion message.
- #748 API Updates
- Add support for new resource
ShippingRate
- Add support for new resource
- #745 API Updates
- Add support for
expiremethod on resourceCheckout.Session
- Add support for
- #738 API Updates
- Add support for
list_payment_methodsmethod on resourceCustomer
- Add support for
- #736 Stop sending raw exception message as part of Stripe user agent.
- #728 API Updates
- Add support for
list_computed_upfront_line_itemsmethod on resourceQuote
- Add support for
- #722 API Updates
- Add support for new
TaxCodeAPI.
- Add support for new
- #720 Add support for Identity VerificationSession and VerificationReport APIs
- #713 Add support for the Billing Portal Configuration API
- #704 Fix CA bundle path issue
- #698 Fix issue where StripeObjects in lists would not be converted to dicts
- #699 Start testing Python 3.9
- #691 Include the examples in the built sources
- #684 Add support for the Payout Reverse API
- #681 Add support for the
SetupAttemptresource and List API - 2.52.0 and 2.53.0 were empty releases that contained no additional changes.
- #676 Add support for the Issuing Dispute Submit API
- #669 Add support for the
PromotionCoderesource and APIs
- #665 Support stripe.File.create(stripe_version='...')
- #655 Add support for the
LineItemresource and APIs
- #652 Add support for the
Priceresource and APIs
- #651 Add support for
billing_portalnamespace andSessionresource and APIs
- #648 Add support for Express links in
authorize_urlforOAuth
- #646 Allow overriding API key in OAuth methods
- #644 Add support for listing Checkout
Session
- #636 Fix uploading files with Unicode names (Python 2.7)
- #635 Update Python API docs inline link
- #631 Update
proxy.py
- #630 Add support for
CreditNotepreview
- #627 Add list_usage_record_summaries and list_source_transactions
- #625 Add support for
Mandate
- #621 Implement support for stripe-should-retry and retry-after headers
- #620 Check that
erroris a dict before trying to use it to create aStripeError
- #614 Use
OrderedDictto maintain key order in API requests and responses
- #612 Use
ListObjectproperties as default values in request methods
- #610 Add support for header parameters in
ListObjectrequest methods
- #607 Add
SubscriptionItem.create_usage_recordmethod
- #604 Remove subscription schedule revisions
- This 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
delstatement to not raiseKeyError
- #595 Listing
BalanceTransactionobjects now uses/v1/balance_transactionsinstead of/v1/balance/history
- #592 Fix argument name conflict
- #590 Add support for the
SetupIntentresource and APIs
- #587 Enable request latency telemetry by default
- #589 Fix support for
CustomerBalanceTransaction
- #564 Add support for
CustomerBalanceTransactionresource and APIs
- #583 Remove Poetry and reinstate
setup.py
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.
- #561 Replace pipenv with poetry
- #578 Verify signatures before deserializing events
- #575 Add support for
radar.early_fraud_warningresource
- #574 Fix a few more code quality issues
- #572 Fix a few code quality issues
- #566 Add support for the
Capabilityresource and APIs
- #554 Add support for the
TaxRateresource and APIs
- #555 Add support for the
TaxIdresource and APIs
- #551 Add support for the
CreditNoteresource and APIs
- #550 Fix encoding of nested parameters in multipart requests
- #543 Add
deleteclass method on deletable API resources - #547 Add class methods for all custom API requests (e.g.
Charge.capture)
- #537 Add support for the
PaymentMethodresource and APIs - #540 Add support for retrieving a Checkout
Session - #542 Add support for deleting a Terminal
LocationandReader
- #541 Add
stripe.util.convert_to_dictmethod for convertingStripeObjectinstances to regulardicts
- #532 Add support for subscription schedules
- #530 Fix client telemetry implementation
- #534 Fix session initialization for multi-threaded environments
- #531 Make
RequestsClientthread-safe
- #526 Reuse the default HTTP client by default
- #524 Rename
CheckoutSessiontoSessionand move it under thecheckoutnamespace. 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
individualonAccountobjects
- #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
Reviewfor Radar
- #489 Add support for
ValueListandValueListItemfor Radar
- #495 Make
StripeResponsea new-style class
- #483 Add new API endpoints for the
Invoiceresource.
- #491 Bump minimum requests version to 2.20.0 (for CVE-2018-18074)
- #481 Correct behavior of
stripe.max_network_retriesif it's reset after initial use
- #478 Add support for Stripe Terminal
- #477 Rename
FileUploadtoFile
- #470 Add support for automatic network retries
- #469 Add support for reporting resources
- #467 Add support for usage record summaries
- #463 Remove unsupported Bitcoin endpoints (this is technically a breaking change, but we're releasing as a minor version because none of these APIs were usable anyway)
- #456 Add support for Sigma scheduled query run objects
- #455 Add support for Stripe Issuing
- #452 Add
InvoiceLineItemclass
- #450 Internal improvements to
ApiResource.class_url
- #448 Avoid duplicate dependency on
requestswith Python 2.7
- #445 Fix
setup.py
Major version release. List of backwards incompatible changes to watch out for:
- The minimum Python versions are now 2.7 / 3.4. If you're using Python 2.6 or 3.3, consider upgrading to a more recent version.
- Stripe exception classes should now be accessed via
stripe.errorrather than juststripe - Some older deprecated methods have been removed
- Trying to detach an unattached source will now raise a
stripe.error.InvalidRequestErrorexception instead of aNotImplementedErrorexception
For more information, check out the migration guide for v2
Pull requests included in this release:
- #385 Drop support for Python 2.6 and 3.3
- #384 Use py.test for tests
- #399 Remove deprecated code
- #402 Remove
util.jsonand usejsonmodule directly everywhere - #403 Update setup.py and test flow
- #410 Use pipenv
- #415 Change exception when detaching unattached sources from
NotImplementedErrortostripe.error.InvalidRequestError
- #441 Better (hopefully) fix for serialization of empty
ListObjects
- #439 Fix serialization of empty
ListObjects
- #436 Add support for payment intents
- #437 Add support for
partner_idinstripe.set_app_info()
- #365 Add
__repr__methods toStripeErrorexception classes
- #430 Handle the case where request ID is
Nonewhen formatting errors
- #422 Add
user_mesagetoStripeErrorfor a way in Python 3 to avoid the "Request req_...:" string normally appended to error messages
- #425 Add support for issuer fraud records
- #421 Add support for flexible billing and usage records
- #401 Drop conditional dependencies that incorrectly led to an added
simplejsondependency in Python 3+ after switching to universal wheel
- #396 Add support for topups
- #394 Make
last_responseavailable after callingsave()
- #389 Register unsaved attributes on assignment regardless of new value
- #371 Add accessor
last_responseonStripeObjectfor accessing request ID and other metadata
- #382 Add new
IdempotencyErrortype
- #378 Log encoded version of parameters instead of raw POST data
- (Accidental no-op release. See 1.75.3.)
- #372 Add only changed values to
_unsaved_valuesinStripeObject - #375 Use a custom JSON encoder to handle
datetimeobjects when serializingStripeObjects
- #369 Make custom actions on various resources (e.g.
Account.reject) more consistent with other APIs
- #368 Remove API that allowed the creation of new disputes (this was an erroneous addition; it never worked because the API would not allow it)
- #364 Switch to vendored version of the
sixpackage for compatibility between Python 2 and 3
- #361 Support for exchange rates APIs
- #362 Fix balance transaction and invoice item conversion into
StripeObjects
- #360 Fix
BytesWarningbeing issued on logging in Python 3
- #359 Support for listing source transactions
- #356 Support uploading files with
StringIOin addition to a file on disk
- #351 Break resource.py module into separate ones for each type of resource
- Classes are still into resource.py for backwards compatibility
- #353 Fix unpickling
StripeObjectin Python 3
- #350 Add static methods to manipulate resources from parent
Accountgains methods for external accounts and login links (e.g..create_account,create_login_link)ApplicationFeegains methods for refundsCustomergains methods for sourcesTransfergains methods for reversals
- #349 Rename source
deletetodetach(and deprecate the former)
- Support length reads on list objects
- Handle
bytearrayandbytes(in addition to string) inWebhook.construct_event
- Add support for passing a
stripe_versionargument to all API requests
- Error when an invalid type (i.e. non-string) passed as an API method argument
- Fix serialization of
itemson Relay order creation and order return
- Add support for
InvalidClientErrorOAuth error
- Change serialization of subscription items on update to encoded as an integer-indexed map
payon invoice can now take parameter
- Expose
codeonInvalidRequestError
- Add support for ephemeral keys
- Refactor OAuth implementation to have dedicated classes for errors
- Re-use connections with Pycurl
- Fix the pycurl client
- Add
api_keyparameter to webhook'sconstruct_event
- Add support for account login links
- Remove Requests constraint from 1.55.1 now that they've patched (as of 2.14.2)
- Constrain Requests to < 2.13.0 if on setuptools < 18.0.0
- Support for checking webhook signatures
- Add
stripe.set_app_infofor use by plugin creators
- Add support for payouts and recipient transfers
- No-op release: peg test suite to a specific API version
- Support OAuth operations (getting a token and deauthorizing)
- Support for detaching sources from customers
- Accept
sessionargument forRequestsClient
- Fix encoding of parameters when fetching upcoming invoices
- Add
Account.modify_external_accountto modify an account in one API call - Add
Customer.modify_sourceto modify a source in one API call
- Allow sources to be updated
- Use internal session for Requests for connection pooling
- request logging goes to stderr now
- Logs properly handle unicode
- Format is now the same between logging logs, and console logs
- Add request logging and some mechanisms to enable it when debugging
- Add support for verifying sources
- Add retrieve method for 3-D Secure resources
- Implement copy and deepcopy on StripeObject to fix these operations
- Add
Sourcemodel for generic payment sources
- Return subscription model instance on subscription create/modify
- Add configurable timeout for Requests HTTP library
- Add support for subscription items
- Add proxy support for pycurl, Requests, urlfetch, and urllib2 libraries
- Add support for Apple Pay domains
- Add
ThreeDSecuremodel for 3-D secure payments
- Add
updateclass method to resources that can be updated
- Add support for returning Relay orders
- Add support for Alipay accounts
- Add support for the new
/v1/subscriptionsendpointstripe.Subscription.retrievestripe.Subscription.updatestripe.Subscription.createstripe.Subscription.list
- Fix bug where file uploads could not be properly listed
- Fix bug where request parameters were not passed between pages with
auto_paging_iter
- Update CA cert bundle for compatibility with OpenSSL versions below 1.0.1
- Fix uploading of binary files in Python 3
- Add
rejectonAccountto support the new API feature
- Add
CountrySpecmodel for looking up country payment information
- Update bundled CA certs
- Add support for deleting Relay products and SKUs
- Add an automatic paginating iterator to lists available via
auto_paging_iter - List objects are now iterable
- Error messages set to
Noneare now handled properly - The
allmethod on list objects has been deprecated in favor oflist - Calls to
instance_urlare now side effect free
- Official Python 3.4 & 3.5 compatibility
- Add configurable HTTP client
- Add ability to delete attributes
- Products, SKUs, Orders resources
- Add support for new 429 rate limit response
- Added refund listing, creation and retrieval
- Fix error handling for Python 2.6
- Managed accounts can now be deleted
- Added dispute listing and retrieval
- Include response headers in exceptions
- Fix saving
additional_ownerson managed accounts
- Fix saving manage accounts
- Pass
stripe_accountto Balance.retrieve
- Added methods for updating and saving arrays of objects
- Added Bitcoin Receiver update and delete methods
- Remove support for top-level bitcoin transactions
- Adding bitcoin receiver and transaction objects
- Adding support for file uploads resource
- Remove redundant manual SSL blacklist preflight check
- Application Fee refunds now a list instead of array
- Add metadata for disputes and refunds
- Remove official support for Python 2.5
- Support for canceling transfers
- Support cards for recipients.
- Disable loading the ssl module on the Google App Engine dev server.
- Use DER encoded certificate for checksumming
- Don't rely on SNI support in integration tests
- Update bundled ca-certificates
- Add certificate blacklist for CVE-2014-0160 mitigation
- Fix syntax errors in setup.py metadata
- Added license and other metadata in setup.py
- Fix
__repr__in Python 3 - Support pickling of responses
- Added support for multiple subscriptions per customer
- Added extensive unit tests
- Extended functional test coverage
- Refactored code into modules and out of stripe/init.py
- Abstracted http library selection and use from the
APIRequestorintostripe.http_client - Refactored
StripeObjectto inherit fromdictand avoid direct access of__dict__. - PEP8ified the codebase and enforced with a test.
- Proper encoding of timezone aware datetimes
- The
to_dictandvaluesmethods on resources no longer recursively convert objects to plaindicts. All resources now inherit fromdictbut are functionally different in that you cannot set a value to an empty string and cannot delete items. - The
previous_metadataattribute on resources is now protected. - Timezone aware
datetimeobjects passed to the API will now be encoded in a way that does not depend on the local system time. If you are passing timezone-aware datetimes to our API and your server time is not already in UTC, this will change the value passed to our API.
- Add stripe.ApplicationFee resource
- Removed incorrect test.
- Add support for metadata.
- Fix issue with support for closing disputes.
- Add support for closing disputes.
- Add stripe.Balance and stripe.BalanceTransaction resources
- Add support for unsetting attributes by setting to None. Setting properties to a blank string is now an error.
- Add support for multiple cards API
- Remove 'id' from the list of permanent attributes
- Support for Python 3 (github issue #32)
- Allow transfers to be creatable
- Add new stripe.Recipient resource
- Add 'id' to the list of permanent attributes
- Add support for passing options when retrieving Stripe objects; e.g., stripe.Charge.retrieve("foo", params={"expand":["customer"]})
- Add support for setting a Stripe API version override
- Update requests version check to work with requests 1.x.x (github issue #24)
- Add support for updating charge disputes
- Add support for creating invoices
- Add support for new invoice lines return format
- Add support for new List objects
- Add update and pay methods for Invoice resource
- Add new stripe.Account resource
- Remove uncaptured_charge tests (this has been deprecated from the API).
- Fix a bug that would cause nested objects to be mis-rendered in str and repr methods (github issues #17, #18)
- Prefer App Engine's urlfetch over requests, as that's the only thing that will work in App Engine's environment. Previously, if requests was available in the App Engine environment, we would attempt to use it.
- Add new delete_discount method to stripe.Customer
- Add new stripe.Transfer resource
- Switch from using HTTP Basic auth to Bearer auth. (Note: Stripe will support Basic auth for the indefinite future, but recommends Bearer auth when possible going forward)
- Numerous test suite improvements
- Parameters with value None are no longer included in API requests