v9.0.0

• #1286

  • This release changes the pinned API version to 2024-04-10. Please read the API Upgrade Guide and carefully review the API changes before upgrading.

  ⚠️ Breaking changes

  • Remove FinancialAccountFeaturesService.CreateParams, FinancialAccountFeaturesService.ListParams, FinancialAccountFeaturesService.create(), FinancialAccountFeaturesService.list() as Financial account features is a singleton and so should have retrieve and update methods instead of create and list methods.
  • Rename features to marketing_features on parameter classes stripe.Product.CreateParams and stripe.Product.ModifyParams and resource stripe.Product.

  ⚠️ Removal of enum values, properties and events that are no longer part of the publicly documented Stripe API

  • Remove .subscription_pause from the below as the feature to pause subscription on the portal has been deprecated
    • Configuration.Features
    • ConfigurationService.CreateParamsFeatures
    • ConfigurationService.UpdateParamsFeatures
  • Remove the below deprecated values for BalanceTransaction.type
    • obligation_inbound
    • obligation_payout
    • obligation_payout_failure
    • obligation_reversal_outbound
  • Remove the below deprecated events from Event.type, WebhookEndpoint.CreateParams.enabled_events, WebhookEndpoint.ModifyParams.enabled_events, WebhookEndpointService.CreateParams.enabled_events, WebhookEndpointService.ModifyParams.enabled_events
    • invoiceitem.updated
    • order.created
    • recipient.created
    • recipient.deleted
    • recipient.updated
    • sku.created
    • sku.deleted
    • sku.updated
  • Remove the deprecated value include_and_require for Invoice.CreateParams.pending_invoice_items_behavior and InvoiceService.CreateParams.pending_invoice_items_behavior
  • Remove the deprecated value service_tax for
    • TaxRate.RetrieveParams.tax_type
    • TaxRate.CreateParams.tax_type
    • TaxRate.ModifyParams.tax_type
    • TaxRateService.CreateParams.tax_type
    • TaxRateService.UpdateParams.tax_type
    • InvoiceLineItem.ModifyParamsTaxAmountTaxRateData.tax_type
    • InvoiceLineItemService.UpdateParamsTaxAmountTaxRateData.tax_type
  • Remove request_incremental_authorization from
    • PaymentIntent.ConfirmParamsPaymentMethodOptionsCardPresent
    • PaymentIntent.CreateParamsPaymentMethodOptionsCardPresent
    • PaymentIntent.ModifyParamsPaymentMethodOptionsCardPresent
    • PaymentIntentService.ConfirmParamsPaymentMethodOptionsCardPresent
    • PaymentIntentService.CreateParamsPaymentMethodOptionsCardPresent
    • PaymentIntentService.ModifyParamsPaymentMethodOptionsCardPresent
  • Remove support for id_bank_transfer, multibanco, netbanking, pay_by_bank, and upi on PaymentMethodConfiguration
  • Remove the deprecated value challenge_only from SetupIntent.PaymentMethodOptions.Card.request_three_d_secure
  • Remove deprecated value various for Climate.Supplier.removal_pathway
  • Remove the deprecated value obligation for ReportRun.CreateParamsParameters.reporting_category and ReportRunService.CreateParamsParameters.reporting_category
  • Remove the legacy field rendering_options on parameter classes stripe.Invoice.CreateParams and stripe.Invoice.ModifyParams and resource stripe.Invoice. Use rendering instead.

See the changelog for more details.

v8.11.0

• #1295 Update generated code

  • Add support for fees, losses, requirement_collection & stripe_dashboard on resource class stripe.Account.Controller
  • Add support for controller on parameter class stripe.Account.CreateParams
  • Add support for create_feature, delete_feature, list_features, retrieve_feature on resource stripe.Product
  • Add support for resource stripe.ProductFeature
  • Add support for event_name on parameter class stripe.billing.MeterEventAdjustment.CreateParams and resource stripe.billing.MeterEventAdjustment
  • Add support for cancel and type on resource stripe.billing.MeterEventAdjustment
  • Add support for resource stripe.entitlements.ActiveEntitlement
  • Add support for resource stripe.entitlements.Feature
  • Add support for none on enum stripe.Account.type

• #1299 Fix README.md

• #1292 Tweak changelog for python async note

See the changelog for more details.

v8.11.0b1

• #1293 Update generated code for beta
  • Add support for risk_controls on parameter class stripe.Account.CreateParams and resource stripe.Account
  • Add support for promotion_code on parameter classes stripe.Invoice.AddLinesParamsLineDiscount, stripe.Invoice.CreateParamsDiscount, stripe.Invoice.ModifyParamsDiscount, stripe.Invoice.UpdateLinesParamsLineDiscount, stripe.InvoiceItem.CreateParamsDiscount, stripe.InvoiceItem.ModifyParamsDiscount, stripe.InvoiceLineItem.ModifyParamsDiscount, stripe.Quote.CreateParamsDiscount, stripe.Quote.CreateParamsLineActionAddDiscount, stripe.Quote.CreateParamsLineItemDiscount, stripe.Quote.CreateParamsPhaseLineItemDiscount, stripe.Quote.ModifyParamsDiscount, stripe.Quote.ModifyParamsLineActionAddDiscount, stripe.Quote.ModifyParamsLineItemDiscount, and stripe.Quote.ModifyParamsPhaseLineItemDiscount
  • Add support for zip on parameter classes stripe.PaymentMethodConfiguration.CreateParams and stripe.PaymentMethodConfiguration.ModifyParams and resource stripe.PaymentMethodConfiguration
  • Add support for offline on resource class stripe.SetupAttempt.PaymentMethodDetails.CardPresent
  • Add support for card_present on parameter classes stripe.SetupIntent.ConfirmParamsPaymentMethodOptions, stripe.SetupIntent.CreateParamsPaymentMethodOptions, and stripe.SetupIntent.ModifyParamsPaymentMethodOptions and resource class stripe.SetupIntent.PaymentMethodOptions
  • Add support for modify on resource stripe.entitlements.Feature
  • Add support for email on resource stripe.identity.VerificationReport, parameter classes stripe.identity.VerificationSession.CreateParamsOptions and stripe.identity.VerificationSession.ModifyParamsOptions, and resource classes stripe.identity.VerificationSession.Options and stripe.identity.VerificationSession.VerifiedOutputs
  • Add support for phone on resource stripe.identity.VerificationReport, parameter classes stripe.identity.VerificationSession.CreateParamsOptions and stripe.identity.VerificationSession.ModifyParamsOptions, and resource classes stripe.identity.VerificationSession.Options and stripe.identity.VerificationSession.VerifiedOutputs
  • Add support for verification_flow on resources stripe.identity.VerificationReport and stripe.identity.VerificationSession and parameter class stripe.identity.VerificationSession.CreateParams
  • Add support for provided_details on parameter classes stripe.identity.VerificationSession.CreateParams and stripe.identity.VerificationSession.ModifyParams and resource stripe.identity.VerificationSession
  • Add support for allowed_merchant_countries on parameter classes stripe.issuing.Card.CreateParamsSpendingControls, stripe.issuing.Card.ModifyParamsSpendingControls, stripe.issuing.Cardholder.CreateParamsSpendingControls, and stripe.issuing.Cardholder.ModifyParamsSpendingControls and resource classes stripe.issuing.Card.SpendingControls and stripe.issuing.Cardholder.SpendingControls
  • Add support for blocked_merchant_countries on parameter classes stripe.issuing.Card.CreateParamsSpendingControls, stripe.issuing.Card.ModifyParamsSpendingControls, stripe.issuing.Cardholder.CreateParamsSpendingControls, and stripe.issuing.Cardholder.ModifyParamsSpendingControls and resource classes stripe.issuing.Card.SpendingControls and stripe.issuing.Cardholder.SpendingControls
  • Change type of field stripe.checkout.Session.CreateParamsPaymentMethodOptionsSwish from Literal['']|str to str of reference
  • Add support for verification_flow on enums stripe.identity.VerificationReport.type and stripe.identity.VerificationSession.type
  • Add support for email_unverified_other on enum stripe.identity.VerificationSession.LastError.code
  • Add support for email_verification_declined on enum stripe.identity.VerificationSession.LastError.code
  • Add support for phone_unverified_other on enum stripe.identity.VerificationSession.LastError.code
  • Add support for phone_verification_declined on enum stripe.identity.VerificationSession.LastError.code
  • Add support for mobile_phone_reader on enums stripe.terminal.Reader.device_type and stripe.terminal.Reader.ListParams.device_type
  • Change type of field stripe.identity.VerificationSession.CreateParams from Literal['document', 'id_number'] to NotRequired[Literal['document', 'id_number']] of type
  • Change type of fields stripe.Invoice, stripe.InvoiceLineItem, stripe.QuotePreviewInvoice, stripe.Subscription, and stripe.SubscriptionItem from Optional[List[ExpandableField[Discount]]] to List[ExpandableField[Discount]] of discounts
  • Change type of field stripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode.QrCode from Optional[str] to str of data
  • Change type of field stripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode.QrCode from Optional[str] to str of image_url_png
  • Change type of field stripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode.QrCode from Optional[str] to str of image_url_svg
  • Change type of field stripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode from Optional[str] to str of hosted_instructions_url
  • Change type of field stripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode from Optional[str] to str of mobile_auth_url
  • Change type of field stripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode from Optional[QrCode] to QrCode of qr_code
  • Change type of fields stripe.QuoteLine.Action.AddItem, stripe.QuoteLine.Action.SetItem, stripe.QuotePreviewSubscriptionSchedule.Phase.AddInvoiceItem, stripe.QuotePreviewSubscriptionSchedule.Phase.Item, stripe.QuotePreviewSubscriptionSchedule.Phase, stripe.SubscriptionSchedule.Phase.AddInvoiceItem, stripe.SubscriptionSchedule.Phase.Item, and stripe.SubscriptionSchedule.Phase from Optional[List[Discount]] to List[Discount] of discounts

See the changelog for more details.

v8.10.0

• #1288 Add async support to stripe-python. To use it, add an _async suffix to any request-making method.

  - cus = stripe.Customer.create(...)
  + cus = await stripe.Customer.create_async(...)

  See the README for detailed usage instructions. Support is provided out of the box for async requests via the HTTPX (used by default) and aiohttp libraries. For other libraries, you can also provide your own stripe.HTTPClient implementation. Please do not hesitate to open a Github issue if you have any feedback on this feature.

• #1284 Update generated code

  • Add support for subscription_item on resource stripe.Discount
  • Add support for promotion_code on parameter classes stripe.Invoice.CreateParamsDiscount, stripe.Invoice.ModifyParamsDiscount, stripe.InvoiceItem.CreateParamsDiscount, stripe.InvoiceItem.ModifyParamsDiscount, stripe.InvoiceLineItem.ModifyParamsDiscount, stripe.Quote.CreateParamsDiscount, and stripe.Quote.ModifyParamsDiscount
  • Add support for discounts on parameter classes stripe.Invoice.UpcomingLinesParamsSubscriptionItem, stripe.Invoice.UpcomingParamsSubscriptionItem, stripe.Quote.CreateParamsLineItem, stripe.Quote.ModifyParamsLineItem, stripe.Subscription.CreateParams, stripe.Subscription.CreateParamsAddInvoiceItem, stripe.Subscription.CreateParamsItem, stripe.Subscription.ModifyParams, stripe.Subscription.ModifyParamsAddInvoiceItem, stripe.Subscription.ModifyParamsItem, stripe.SubscriptionItem.CreateParams, stripe.SubscriptionItem.ModifyParams, stripe.SubscriptionSchedule.CreateParamsPhase, stripe.SubscriptionSchedule.CreateParamsPhaseAddInvoiceItem, stripe.SubscriptionSchedule.CreateParamsPhaseItem, stripe.SubscriptionSchedule.ModifyParamsPhase, stripe.SubscriptionSchedule.ModifyParamsPhaseAddInvoiceItem, and stripe.SubscriptionSchedule.ModifyParamsPhaseItem, resources stripe.Subscription and stripe.SubscriptionItem, and resource classes stripe.SubscriptionSchedule.Phase.AddInvoiceItem, stripe.SubscriptionSchedule.Phase.Item, and stripe.SubscriptionSchedule.Phase
  • Add support for zip on parameter classes stripe.PaymentMethodConfiguration.CreateParams and stripe.PaymentMethodConfiguration.ModifyParams and resource stripe.PaymentMethodConfiguration
  • Add support for offline on resource class stripe.SetupAttempt.PaymentMethodDetails.CardPresent
  • Add support for card_present on parameter classes stripe.SetupIntent.ConfirmParamsPaymentMethodOptions, stripe.SetupIntent.CreateParamsPaymentMethodOptions, and stripe.SetupIntent.ModifyParamsPaymentMethodOptions and resource class stripe.SetupIntent.PaymentMethodOptions
  • Add support for email on resource stripe.identity.VerificationReport, parameter classes stripe.identity.VerificationSession.CreateParamsOptions and stripe.identity.VerificationSession.ModifyParamsOptions, and resource classes stripe.identity.VerificationSession.Options and stripe.identity.VerificationSession.VerifiedOutputs
  • Add support for phone on resource stripe.identity.VerificationReport, parameter classes stripe.identity.VerificationSession.CreateParamsOptions and stripe.identity.VerificationSession.ModifyParamsOptions, and resource classes stripe.identity.VerificationSession.Options and stripe.identity.VerificationSession.VerifiedOutputs
  • Add support for verification_flow on resources stripe.identity.VerificationReport and stripe.identity.VerificationSession and parameter class stripe.identity.VerificationSession.CreateParams
  • Add support for provided_details on parameter classes stripe.identity.VerificationSession.CreateParams and stripe.identity.VerificationSession.ModifyParams and resource stripe.identity.VerificationSession
  • Add support for allowed_merchant_countries on parameter classes stripe.issuing.Card.CreateParamsSpendingControls, stripe.issuing.Card.ModifyParamsSpendingControls, stripe.issuing.Cardholder.CreateParamsSpendingControls, and stripe.issuing.Cardholder.ModifyParamsSpendingControls and resource classes stripe.issuing.Card.SpendingControls and stripe.issuing.Cardholder.SpendingControls
  • Add support for blocked_merchant_countries on parameter classes stripe.issuing.Card.CreateParamsSpendingControls, stripe.issuing.Card.ModifyParamsSpendingControls, stripe.issuing.Cardholder.CreateParamsSpendingControls, and stripe.issuing.Cardholder.ModifyParamsSpendingControls and resource classes stripe.issuing.Card.SpendingControls and stripe.issuing.Cardholder.SpendingControls
  • Change type of reference on stripe.checkout.Session.CreateParamsPaymentMethodOptionsSwish from Literal['']|str to str
  • Add support for verification_flow on enums stripe.identity.VerificationReport.type and stripe.identity.VerificationSession.type
  • Add support for email_unverified_other on enum stripe.identity.VerificationSession.LastError.code
  • Add support for email_verification_declined on enum stripe.identity.VerificationSession.LastError.code
  • Add support for phone_unverified_other on enum stripe.identity.VerificationSession.LastError.code
  • Add support for phone_verification_declined on enum stripe.identity.VerificationSession.LastError.code
  • Add support for mobile_phone_reader on enums stripe.terminal.Reader.device_type and stripe.terminal.Reader.ListParams.device_type
  • Change type of type on stripe.identity.VerificationSession.CreateParams from Literal['document', 'id_number'] to NotRequired[Literal['document', 'id_number']]
  • Change type of discounts on stripe.Invoice and stripe.InvoiceLineItem from Optional[List[ExpandableField[Discount]]] to List[ExpandableField[Discount]]
  • Change type of data on stripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode.QrCode from Optional[str] to str
  • Change type of image_url_png on stripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode.QrCode from Optional[str] to str
  • Change type of image_url_svg on stripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode.QrCode from Optional[str] to str
  • Change type of hosted_instructions_url on stripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode from Optional[str] to str
  • Change type of mobile_auth_url on stripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode from Optional[str] to str
  • Change type of qr_code on stripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode from Optional[QrCode] to QrCode

• #1289 Bump aiohttp from 3.9.0 to 3.9.2

See the changelog for more details.

v8.10.0b1

• #1277 Update generated code for beta

  • Add support for financial_account_transactions, financial_account, issuing_card, and issuing_cards_list on AccountSession.CreateParamsComponents and AccountSessionService.CreateParamsComponents
  • Remove support for subscription_billing_cycle_anchor, subscription_cancel_at_period_end, subscription_cancel_at, subscription_cancel_now, subscription_default_tax_rates, subscription_items, subscription_prebilling, subscription_proration_behavior, subscription_proration_date, subscription_resume_at, subscription_start_date, and subscription_trial_end on Invoice.CreatePreviewParams and InvoiceService.CreatePreviewParams

• #1283 Fix unneccessary quotes

See the changelog for more details.

v8.9.0

• #1276 Update generated code
  • Add support for new resources Billing.MeterEventAdjustment, Billing.MeterEvent, and Billing.Meter
  • Add support for create, deactivate, list, modify, reactivate, and retrieve methods on resource Meter
  • Add support for create method on resources MeterEventAdjustment and MeterEvent
  • Add support for amazon_pay_payments on Account.Capabilities, Account.CreateParamsCapabilities, Account.UpdateParamsCapabilities,AccountService.CreateParamsCapabilities, and AccountService.UpdateParamsCapabilities
  • Add support for new value verification_failed_representative_authority on enums Account.FutureRequirements.Error.code, Account.Requirements.Errors.code, BankAccount.FutureRequirements.Error.code, BankAccount.Requirements.Errors.code, Capability.FutureRequirements.Error.code, Capability.Requirements.Errors.code, Person.FutureRequirements.Error.code, Person.Requirements.Errors.code,
  • Add support for destination_on_behalf_of_charge_management on AccountSession.Components.PaymentDetails.Features, AccountSession.Components.Payments.Features, AccountSession.CreateParamsComponentsPaymentDetailsFeatures, AccountSession.CreateParamsComponentsPaymentsFeatures, AccountSessionService.CreateParamsComponentsPaymentDetailsFeatures and AccountSessionService.CreateParamsComponentsPaymentsFeatures
  • Add support for meter on Plan.CreateParams, Plan, PlanService.CreateParams, Price.Recurring, Price.CreateParamsRecurring, Price.ListParamsRecurring, PriceService.CreateParamsRecurring, and PriceService.ListParamsRecurring
  • Add support for mandate on Charge.PaymentMethodDetails.USBankAccount, Treasury.InboundTransfer.OriginPaymentMethodDetails.USBankAccount, Treasury.OutboundPayment.DestinationPaymentMethodDetails.USBankAccount, and Treasury.OutboundTransfer.DestinationPaymentMethodDetails.USBankAccount
  • Add support for second_line on Issuing.Card.CreateParams
• #1278 Types: remove unnecessary quotes
• #1279 Update README.md

See the changelog for more details.

v8.9.0b1

• #1272 Update generated code for beta
  • Add support for new resources Entitlements.ActiveEntitlementSummary and Entitlements.ActiveEntitlement
  • Add support for list method on resource ActiveEntitlement
• #1271 Support AIOHTTPClient init without running event loop

See the changelog for more details.

v8.8.0

• #1273 Update generated code
  • Add support for new resources ConfirmationToken and Forwarding.Request
  • Add support for retrieve method on resource ConfirmationToken
  • Add support for create, list, and retrieve methods on resource Request
  • Add support for mobilepay_payments on Account.Capabilities, Account.CreateParamsCapabilities, and Account.UpdateParamsCapabilities
  • Add support for new values forwarding_api_inactive, forwarding_api_invalid_parameter, forwarding_api_upstream_connection_error, and forwarding_api_upstream_connection_timeout on enums Invoice.LastFinalizationError.code, PaymentIntent.LastPaymentError.code, SetupAttempt.SetupError.code, SetupIntent.LastSetupError.code, and StripeError.code
  • Add support for payment_reference on Charge.PaymentMethodDetails.UsBankAccount
  • Add support for payout on Treasury.ReceivedDebit.LinkedFlows
  • Add support for name on ConfigurationService.CreateParams, ConfigurationService.UpdateParams, and Configuration for terminal
  • Add support for confirmation_token on PaymentIntentService.ConfirmParams, PaymentIntentService.CreateParams, SetupIntentService.ConfirmParams, and SetupIntentService.CreateParams
  • Add support for new value mobilepay on enums Customer.ListPaymentMethodsParams.type, PaymentMethod.CreateParams.type, and PaymentMethod.ListParams.type
  • Add support for mobilepay on Charge.PaymentMethodDetails, PaymentIntent.PaymentMethodOptions, PaymentIntentService.ConfirmParamsPaymentMethodData, PaymentIntentService.ConfirmParamsPaymentMethodOptions, PaymentIntentService.CreateParamsPaymentMethodData, PaymentIntentService.CreateParamsPaymentMethodOptions, PaymentIntentService.UpdateParamsPaymentMethodData, PaymentIntentService.UpdateParamsPaymentMethodOptions, PaymentMethod.CreateParams, PaymentMethod, SetupIntentService.ConfirmParamsPaymentMethodData, SetupIntentService.CreateParamsPaymentMethodData, and SetupIntentService.UpdateParamsPaymentMethodData
  • Add support for new value mobilepay on enums PaymentIntentService.ConfirmParamsPaymentMethodData.type, PaymentIntentService.CreateParamsPaymentMethodData.type, PaymentIntentService.UpdateParamsPaymentMethodData.type, SetupIntentService.ConfirmParamsPaymentMethodData.type, SetupIntentService.CreateParamsPaymentMethodData.type, and SetupIntentService.UpdateParamsPaymentMethodData.type
  • Add support for new value mobilepay on enum PaymentMethod.type

See the changelog for more details.

v8.8.0b1

• #1270 Update generated code for beta
  • Add support for new resources Billing.MeterEventAdjustment, Billing.MeterEvent, and Billing.Meter
  • Add support for create, deactivate, list, modify, reactivate, and retrieve methods on resource Meter
  • Add support for create method on resources MeterEventAdjustment and MeterEvent
  • Add support for create test helper method on resource ConfirmationToken
  • Add support for add_lines, remove_lines, and update_lines methods on resource Invoice
• #1266 Beta: record usage of async interface

See the changelog for more details.

v8.7.0

• #1269 Update generated code
  • Add support for personalization_design on parameter classes CardService.CreateParams, CardService.ListParams, CardService.UpdateParams, stripe.issuing.Card.CreateParams, stripe.issuing.Card.ListParams, and stripe.issuing.Card.ModifyParams and resource stripe.issuing.Card
  • Add support for sepa_debit on parameter classes SubscriptionService.CreateParamsPaymentSettingsPaymentMethodOptions, SubscriptionService.UpdateParamsPaymentSettingsPaymentMethodOptions, stripe.Subscription.CreateParamsPaymentSettingsPaymentMethodOptions, and stripe.Subscription.ModifyParamsPaymentSettingsPaymentMethodOptions and resource class stripe.Subscription.PaymentSettings.PaymentMethodOptions
  • Add support for resource stripe.issuing.PersonalizationDesign
  • Add support for resource stripe.issuing.PhysicalBundle
  • Change type from float to Literal['']|float of application_fee_percent on fields stripe.Subscription.CreateParams, stripe.Subscription.ModifyParams, SubscriptionService.UpdateParams, and SubscriptionService.CreateParams

See the changelog for more details.