• #1168 Do not raise a DeprecationWarning in stripe.app_info

See the changelog for more details.

• #1163 Update generated code for beta
  • Add support for retrieve method on resource FinancialConnections.Transaction

See the changelog for more details.

• #1159 Fix getattr to raise AttributeError rather than returning None. This fixes a regression in 7.8.0 that caused stripe.checkout/stripe.issuing etc. to return None.
• #1157 Add missing explicit reexport for OAuth, Webhook, WebhookSignature

See the changelog for more details.

• #1155 Update generated code
  • Add support for payment_details, payments, and payouts on AccountSession.components and CreateParams.components
  • Add support for features on AccountSession.components.account_onboarding and CreateParams.components.account_onboarding
  • Add support for new values customer_tax_location_invalid and financial_connections_no_successful_transaction_refresh on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.code
  • Add support for new values payment_network_reserve_hold and payment_network_reserve_release on enum BalanceTransaction.type
  • Change Climate.Product.metric_tons_available to be required
  • Remove support for value various from enum Climate.Supplier.removal_pathway
  • Remove support for values challenge_only and challenge from enum PaymentIntent.payment_method_options.card.request_three_d_secure
  • Add support for inactive_message and restrictions on CreateParams, ModifyParams, and PaymentLink
  • Add support for transfer_group on PaymentLink.payment_intent_data, CreateParams.payment_intent_data, and ModifyParams.payment_intent_data
  • Add support for trial_settings on PaymentLink.subscription_data, CreateParams.subscription_data, and ModifyParams.subscription_data
• #1153 Move exports for more modules
  • stripe.app_info, stripe.http_client, stripe.oauth, stripe.util, stripe.version, stripe.webhook, modules are deprecated. All types are available directly from stripe module now. Before:

    from stripe.util import convert_to_stripe_object
    # or
    stripe.util.convert_to_stripe_object
    

    After:

    from stripe import convert_to_stripe_object
    # or
    stripe.convert_to_stripe_object
    

  • stripe.api_version, stripe.multipart_data_generator, stripe.request_metrics are deprecated and will be fully removed in the future.
• #1142 Move resource type exports to stripe.___
  • stripe.error, stripe.stripe_object, stripe.api_requestor, stripe.stripe_response, stripe.request_options, stripe.api_resources.*, stripe.api_resources.abstract.* modules are deprecated. All types are available directly from stripe module now. Before:

    from stripe.error import APIError
    # or
    stripe.error.APIError
    

    After:

    from stripe import APIError
    # or
    stripe.APIError
    

See the changelog for more details.

• #1148 Update generated code for beta

See the changelog for more details.

• #1147 Update generated code
  • Add support for new resources Climate.Order, Climate.Product, and Climate.Supplier
  • Add support for cancel, create, list, modify, and retrieve methods on resource Order
  • Add support for list and retrieve methods on resources Product and Supplier
  • Add support for new value financial_connections_account_inactive on enums Invoice.LastFinalizationError.code, PaymentIntent.LastPaymentError.code, SetupAttempt.SetupError.code, and SetupIntent.LastSetupError.code
  • Add support for new values climate_order_purchase and climate_order_refund on enum BalanceTransaction.type
  • Add support for created on Checkout.Session.ListParams
  • Add support for validate_location on Customer.CreateParamsTax and Customer.ModifyParamsTax
  • Add support for new values climate.order.canceled, climate.order.created, climate.order.delayed, climate.order.delivered, climate.order.product_substituted, climate.product.created, and climate.product.pricing_updated on enum Event.type
  • Add support for new value challenge on enums PaymentIntent. PaymentMethodOptions.Card.request_three_d_secure and SetupIntent. PaymentMethodOptions.Card.request_three_d_secure
  • Add support for new values climate_order_purchase and climate_order_refund on enum Reporting.ReportRun. CreateParamsParameters.reporting_category
  • Add support for new values climate.order.canceled, climate.order.created, climate.order.delayed, climate.order.delivered, climate.order.product_substituted, climate.product.created, and climate.product.pricing_updated on enums WebhookEndpoint.CreateParams.enabled_events[] and WebhookEndpoint.ModifyParams.enabled_events[]
• #1145 Refactor integration test

See the changelog for more details.

• #1141 Update generated code for beta
• Rename receipient to recipient beneath PaymentDetails on Charge and PaymentIntent APIs.* Add support for electronic_commerce_indicator on resource classes Charge.PaymentMethodDetails.Card.ThreeDSecure and SetupAttempt.PaymentMethodDetails.Card.ThreeDSecure
• Add support for components on parameter class CustomerSession.CreateParams and resource CustomerSession

See the changelog for more details.

• #1138 Update generated code
  • Add support for electronic_commerce_indicator on resource classes Charge.PaymentMethodDetails.Card.ThreeDSecure and SetupAttempt.PaymentMethodDetails.Card.ThreeDSecure
  • Add support for exemption_indicator on resource class Charge.PaymentMethodDetails.Card.ThreeDSecure
  • Add support for transaction_id on resource classes Charge.PaymentMethodDetails.Card.ThreeDSecure, SetupAttempt.PaymentMethodDetails.Card.ThreeDSecure, issuing.Authorization.NetworkData, and issuing.Transaction.NetworkData
  • Add support for offline on resource class Charge.PaymentMethodDetails.CardPresent
  • Add support for transferred_to_balance on resource CustomerCashBalanceTransaction
  • Add support for three_d_secure on parameter classes PaymentIntent.ConfirmParamsPaymentMethodOptionsCard, PaymentIntent.CreateParamsPaymentMethodOptionsCard, PaymentIntent.ModifyParamsPaymentMethodOptionsCard, SetupIntent.ConfirmParamsPaymentMethodOptionsCard, SetupIntent.CreateParamsPaymentMethodOptionsCard, and SetupIntent.ModifyParamsPaymentMethodOptionsCard
  • Add support for system_trace_audit_number on resource class issuing.Authorization.NetworkData
  • Add support for network_risk_score on resource classes issuing.Authorization.PendingRequest and issuing.Authorization.RequestHistory
  • Add support for requested_at on resource class issuing.Authorization.RequestHistory
  • Add support for authorization_code on resource class issuing.Transaction.NetworkData

See the changelog for more details.

• #1128 Update generated code for beta
  • Add support for issuing_card and issuing_cards_list on AccountSession.Components
  • Add support for event_details and subscription on payment_details types
  • Add support for affiliate and delivery on payment_details.flight, payment_details.lodging, and payment_details.car_rental types
  • Add support for drivers on payment_details.car_rental types
  • Add support for passengers on payment_details.flight and payment_details.lodging types
  • Add support for created on CustomerSession

See the changelog for more details.

• #1127 Update generated code
  • Add support for bacs_debit_payments on Account.CreateParamsSettings
  • Add support for service_user_number on Account.Settings.BacsDebitPayments
  • Add support for capture_before on Charge.PaymentMethodDetails.Card.capture_before
  • Add support for Paypal on Checkout.Session.PaymentMethodOptions
  • Add support for tax_amounts on CreditNote.CreateParamsLine, CreditNote.PreviewParamsLine, and CreditNote.PreviewLinesParamsLine
  • Add support for network_data on Issuing.Transaction
  • Add support for status on Checkout.Session.ListParams
• #1135 Add initial tests for exports and run them in mypy and pyright
• #1130 Mention types in README.md
• #1134 Run pyright via tox
• #1131 Upgrade black dependency
• #1132 Fix unnecessary casts from pyright 1.1.336
• #1126 Suppress type errors from latest pyright
• #1125 Add support for Python 3.11/3.12
• #1123 Move to python3 venv and update vscode settings

See the changelog for more details.

• #1120 Update generated code for beta

See the changelog for more details.

• #1119 Update generated code
  • Add support for new value terminal_reader_hardware_fault on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.code
  • Add support for metadata on Quote.subscription_data, QuoteCreateParams.subscription_data, and QuoteUpdateParams.subscription_data
• #1121 [types] Remove None from optional param types

See the changelog for more details.

• #1110 Update generated code for beta
  • Add support for attach_payment_intent method on resource Invoice

See the changelog for more details.

• #1112 Update generated code
  • Add support for new resource Tax.Registration
  • Add support for create, list, and modify methods on resource Registration

See the changelog for more details.

• #1115 Types: Add types for ErrorObject.
• #1116 Types: Use @staticmethod overloads instead of @classmethod to fix MyPy compatibility.

See the changelog for more details.

• #1107 Update generated code for beta
  • Add support for new resource Margin
  • Add support for create, list, modify, and retrieve methods on resource Margin

See the changelog for more details.

• #1104 Include py.typed and enable type annotations for the package
  • This PR includes py.typed and enables inline type annotations for stripe-python package. Inline type annotations will now take precedence over Typeshed for users who use a type checker or IDE.
  • See a detailed guide on the Github Wiki.
• #1103 Inner resource classes
  • Behavior change: nested json objects will now deserialize into instances of specific classes that subclass StripeObject, instead of into generic StripeObject instances.
  • ⚠️ Behavior change: PromotionCode.restrictions.currency_options will now deserialize into dict and not StripeObject.
• #1090 Update generated code
  • Add support for new value balance_invalid_parameter on enums Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, and SetupIntent.LastSetupError
• #1096 Add @util.deprecated decorator and deprecate save.
• #1091 APIRequestor: don't mutate incoming multipart headers

Changelog

See the changelog for more details.

• #1084 Update generated code for beta
  • Update pinned API version to 2023-10-16
• #1083 Update generated code for beta

See the changelog for more details.

• This release changes the pinned API version to 2023-10-16. Please read the API Changelog and carefully review the API changes before upgrading stripe-python.
• #1085 Update generated code
  • Updated pinned API version

See the changelog for more details.

Enable inline type annotations in the beta channel

• This release enables type annotations in the beta channel including types for resources, methods, properties, and parameters.
• Some type annotations on "infrastructure" (such as http_client) are still a work in progress.
• We do not consider the type annotations to be part of the library's "stable" interface. We may change the types in a way that changes the type errors you experience in a minor release.
• Please report inaccurate types. Contributions are welcome to non-generated files (check for a comment near the top of the file).

To use the inline type annotations:

• make sure you don't have a stubs library types-stripe installed (pip uninstall types-stripe).
• make sure you don't have typings/stripe stubs set up in your project directory
• the inline annotations should take precedence over everything else

To ignore the inline type annotations:

• pip install types-stripe might be a quick fix. The stubs are outdated but much less opinionated so they might make unwanted type errors go away. This isn't a permanent solution however.
• Suppress errors with # type: ignore.
• Register your own stubs locally in your project beneath typings/stripe

Changes

• #1080 Types: Polymorphic groups
• #1078 Parameter types
• #1077 Additional type annotations
• #1074 Start shipping py.typed with the beta library

See the changelog for more details.