v8.4.0b1

• #1235 Update generated code for beta
  • Add support for payto and twint payment methods throughout the API
  • Add support for decrement_authorization method on resource PaymentIntent
• #1236 Beta: StripeStreamResponseAsync.read helper
• #1233 Beta: async streaming

See the changelog for more details.

v8.3.0

• #1230 Update generated code
  • Add support for networks on Card, PaymentMethod.CreateParamsCard, PaymentMethod.ModifyParamsCard, and Token.CreateParamsCard
  • Add support for new value no_voec on enums Checkout.Session.CustomerDetails.TaxId.type, Invoice.CustomerTaxId.type, Tax.Calculation.CustomerDetails.TaxId.type, Tax.Transaction.CustomerDetails.TaxId.type, and TaxId.type
  • Add support for new value no_voec on enums Customer.CreateParams.tax_id_data[].type, Invoice.UpcomingLinesParams.customer_details.tax_ids[].type, Invoice.UpcomingParams.customer_details.tax_ids[].type, and Tax.Calculation.CreateParams.customer_details.tax_ids[].type
  • Add support for new value financial_connections.account.refreshed_ownership on enum Event.type
  • Add support for display_brand on PaymentMethod.card
  • Add support for new value financial_connections.account.refreshed_ownership on enums WebhookEndpoint.CreateParams.enabled_events[] and WebhookEndpoint.UpdateParams.enabled_events[]
• #1237 Remove broken child methods
  • Bugfix: remove support for CreditNoteLineItem.list, CustomerCashBalanceTransaction.list, and CustomerCashBalanceTransaction.retrieve. These methods were included in the library unintentionally and never functioned.
• #1232 Improve types in _http_client.py

See the changelog for more details.

v8.3.0b1

• #1226 Update generated code for beta
  • Add support for payment_method_options on ConfirmationToken
• #1228 Beta: add _async methods for StripeClient

See the changelog for more details.

v8.2.0

• #1225 Update generated code
  • Add support for invoices on Account.Settings
  • Add support for new value velobank on various enums PaymentMethodDetails.P24.bank
  • Add support for setup_future_usage on PaymentMethodOptions.Blik
  • Add support for require_cvc_recollection on PaymentMethodOptions.Card
  • Add support for account_tax_ids on various InvoiceSettings request parameters
• #1223 Move StripeClient usage collection onto StripeService
• #1220 Measure StripeClient usage

See the changelog for more details.

v8.2.0b1

• #1218 Update generated code for beta
  • Add support for new resources Entitlements.Event and Entitlements.Feature
  • Add support for create method on resource Event
  • Add support for create and list methods on resource Feature
• #1171 Beta: codegenned async methods on resources
• #1219 Beta: more async infrastructure
• #1210 Beta: better support for trio in HTTPClientAsync
  • Fixes support for trio on HttpClientAsync.
• #1209 Beta: Fix HTTPXClient retries

See the changelog for more details.

v8.1.0

• #1213 Update generated code
  • Add support for swish payment method throughout the API
  • Add support for relationship on parameter classes Account.CreateParamsIndividual and Token.CreateParamsAccountIndividual
  • Add support for jurisdiction_level on resource TaxRate
  • Change type from str to Literal["offline", "online"] of status on field terminal.Reader

See the changelog for more details.

v8.1.0b1

• #1198 Update generated code for beta
  • Add support for create_preview method on resource Invoice
• #1211 Merge master into beta

See the changelog for more details.

v8.0.0

• #1206 stripe-python v8 release
  This release introduces StripeClient and a service-based call pattern. This new interface allows you to easily call Stripe APIs and has several benefits over the existing resource-based pattern:

  • No global config: you can simultaneously use multiple clients with different configuration options (such as API keys)
  • No static methods for easier mocking

  For full migration instructions, please refer to the v8 migration guide.

  "⚠️" symbol highlights breaking changes

  ⚠️ Changed

  • ⚠️ Request options like api_key, stripe_account, stripe_version, and idempotency_key can no longer be passed in positionally on resource methods. Please pass these in as keyword arguments.

  BEFORE

  stripe.Customer.create(
    "sk_test_123",  # api key
    "KG5LxwFBepaKHyUD",  # idempotency key
    "2022-11-15",  # stripe version
    "acct_123",  # stripe account
  )

  AFTER

  stripe.Customer.create(
    api_key="sk_test_123",
    idempotency_key="KG5LxwFBepaKHyUD",
    stripe_version="2022-11-15",
    stripe_account="acct_123",
  )

  • ⚠️ Methods that turn a response stream (Quote.pdf) now returns a single value of type StripeResponseStream instead of a tuple containing (StripeResponseStream, api_key).
  • ⚠️ Removed public access to APIRequestor. APIRequestor's main use is internal, and we don't have a good understanding of its external use cases. We had to make several breaking changes to its interface as part of this update, so rather than leaving it public we made it private. If you have a use case for APIRequestor, please open up a Github issue describing it. We'd rather you rely on something specifically designed for your use case than having to reach into the library's internals.

  ⚠️ Removed

  • ⚠️ Remove api_version from File.create parameters. Please use stripe_version instead.
  • ⚠️ Remove util.read_special_variable() utility method (importing directly from stripe.util is deprecated as of v7.8.0)
  • ⚠️ Remove StripeError.construct_error_object(). This method was intended for internal stripe-python use only.
  • ⚠️ Remove ListObject.empty_list(). This method was intended for internal stripe-python use only.
  • ⚠️ Remove SearchResultObject.empty_search_result(). This method was intended for internal stripe-python use only.
  • ⚠️ Remove StripeObject.ReprJSONEncoder. This class was intended for internal stripe-python use only.
  • ⚠️ Remove StripeObject.api_base. This property was defunct and returned None.

See the changelog for more details.

v7.14.0

• #1199 Update generated code
  • Add support for annual_revenue and estimated_worker_count on Account.business_profile, Account.CreateParams.business_profile, and Account.UpdateParams.business_profile
  • Add support for new value registered_charity on enums Account.CreateParams.company.structure, Account.UpdateParams.company.structure, and Token.CreateParams.account.company.structure
  • Add support for collection_options on AccountLink.CreateParams
  • Add support for liability on Checkout.Session.automatic_tax, PaymentLink.automatic_tax, PaymentLink.CreateParams.automatic_tax, PaymentLink.UpdateParams.automatic_tax, Quote.automatic_tax, Quote.CreateParams.automatic_tax, Quote.UpdateParams.automatic_tax, SubscriptionSchedule.default_settings.automatic_tax, SubscriptionSchedule.phases[].automatic_tax, SubscriptionSchedule.CreateParams.default_settings.automatic_tax, SubscriptionSchedule.CreateParams.phases[].automatic_tax, SubscriptionSchedule.UpdateParams.default_settings.automatic_tax, SubscriptionSchedule.UpdateParams.phases[].automatic_tax, and checkout.Session.CreateParams.automatic_tax
  • Add support for issuer on Checkout.Session.invoice_creation.invoice_data, PaymentLink.invoice_creation.invoice_data, PaymentLink.CreateParams.invoice_creation.invoice_data, PaymentLink.UpdateParams.invoice_creation.invoice_data, Quote.invoice_settings, Quote.CreateParams.invoice_settings, Quote.UpdateParams.invoice_settings, SubscriptionSchedule.default_settings.invoice_settings, SubscriptionSchedule.phases[].invoice_settings, SubscriptionSchedule.CreateParams.default_settings.invoice_settings, SubscriptionSchedule.CreateParams.phases[].invoice_settings, SubscriptionSchedule.UpdateParams.default_settings.invoice_settings, SubscriptionSchedule.UpdateParams.phases[].invoice_settings, and checkout.Session.CreateParams.invoice_creation.invoice_data
  • Add support for invoice_settings on PaymentLink.subscription_data, PaymentLink.CreateParams.subscription_data, PaymentLink.UpdateParams.subscription_data, and checkout.Session.CreateParams.subscription_data
  • Add support for new value challenge on enums Invoice.CreateParams.payment_settings.payment_method_options.card.request_three_d_secure, Invoice.UpdateParams.payment_settings.payment_method_options.card.request_three_d_secure, Subscription.CreateParams.payment_settings.payment_method_options.card.request_three_d_secure, and Subscription.UpdateParams.payment_settings.payment_method_options.card.request_three_d_secure
  • Add support for promotion_code on Invoice.UpcomingLinesParams.discounts[], Invoice.UpcomingLinesParams.invoice_items[].discounts[], Invoice.UpcomingParams.discounts[], and Invoice.UpcomingParams.invoice_items[].discounts[]
  • Add support for account_type on PaymentMethod.UpdateParams.us_bank_account

See the changelog for more details.

v7.14.0b1

• #1197 Update generated code for beta
  Release specs are identical.
• #1192 Update generated code for beta
  • Add support for new value nn on enum ConfirmationToken.PaymentMethodPreview.Ideal.bank
  • Add support for new value NNBANL2G on enum ConfirmationToken.PaymentMethodPreview.Ideal.bic
  • Change Invoice.AutomaticTax.liability, Invoice.issuer, and Subscription.AutomaticTax.liability to be required

See the changelog for more details.