v11.0.0

Compare Source

• #​1404 Support for APIs in the new API version 2024-09-30.acacia

  This release changes the pinned API version to 2024-09-30.acacia. Please read the API Upgrade Guide and carefully review the API changes before upgrading.

⚠️ Breaking changes due to changes in the API

• Rename for usage_threshold_config to usage_threshold on parameter class stripe.billing.Alert.CreateParams and resource stripe.billing.Alert
• Remove support for filter on parameter class stripe.billing.Alert.CreateParams and resource stripe.billing.Alert. Use the filters on the usage_threshold instead
• • Remove support for customer_consent_collected on parameter class stripe.terminal.Reader.ProcessSetupIntentParams

⚠️ Other Breaking changes in the SDK

• Adjusted default values for HTTP requests. You can use the old defaults by setting them explicitly. New values are:
  • max retries: 0 -> 2
  • max timeout (seconds): 2 -> 5
• Add method parse_thin_event() on the StripeClient class to parse thin events. Rename construct_event() method on the same class to parse_snapshot_event() to clearly distinguish between the two kinds of events.

Additions

• Add support for custom_unit_amount on parameter class stripe.Product.CreateParamsDefaultPriceData
• Add support for usage_threshold on parameter class stripe.billing.Alert.CreateParams and resource stripe.billing.Alert
• Add support for allow_redisplay on parameter classes stripe.terminal.Reader.ProcessPaymentIntentParamsProcessConfig and stripe.terminal.Reader.ProcessSetupIntentParams
• Add support for international_transaction on enum stripe.treasury.ReceivedCredit.failure_code
• Add support for 2024-09-30.acacia on enum stripe.WebhookEndpoint.CreateParams.api_version
• Add support for new Usage Billing APIs stripe.v2.billing.MeterEvent, stripe.v2.billing.MeterEventAdjustments, stripe.v2.billing.MeterEventSession, stripe.v2.billing.MeterEventStream and the new Events API stripe.v2.core.Events under the v2 namespace
• Add method rawRequest() on the StripeClient class that takes a HTTP method type, url and relevant parameters to make requests to the Stripe API that are not yet supported in the SDK.

Other changes

• Change type of default_allowed_updates on stripe.billing_portal.Configuration.CreateParamsFeaturesSubscriptionUpdate from Union[Literal[''], List[Literal['price', 'promotion_code', 'quantity']]] to NotRequired[Literal['']|List[Literal['price', 'promotion_code', 'quantity']]]
• Change type of products on stripe.billing_portal.Configuration.CreateParamsFeaturesSubscriptionUpdate from Union[Literal[''], List[Configuration.CreateParamsFeaturesSubscriptionUpdateProduct]] to NotRequired[Literal['']|List[Configuration.CreateParamsFeaturesSubscriptionUpdateProduct]]