Update generated code (#1369)

stripe-openapi[bot] · web-flow · commit 626a182340e3 · 2024-08-01T17:18:12.000-04:00
* Update generated code for v1157

* Update generated code for v1158

* Update generated code for v1159

* Update generated code for v1160

* Update generated code for v1162

* Update generated code for v1163

* Update generated code for v1166

* Update generated code for v1167

* Update generated code for v1169

---------

Co-authored-by: Stripe OpenAPI &lt;105521251+stripe-openapi[bot]@users.noreply.github.com&gt;
diff --git a/OPENAPI_VERSION b/OPENAPI_VERSION
@@ -1 +1 @@
-v1155
+v1169
diff --git a/stripe/_charge.py b/stripe/_charge.py
@@ -703,10 +703,6 @@ class ShippingAddress(StripeObject):
             """
             The authorized amount.
             """
-            authorization_code: Optional[str]
-            """
-            Authorization code on the charge.
-            """
             brand: Optional[str]
             """
             Card brand. Can be `amex`, `diners`, `discover`, `eftpos_au`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.
@@ -2182,7 +2178,7 @@ class SearchParams(RequestOptions):
     billing_details: BillingDetails
     calculated_statement_descriptor: Optional[str]
     """
-    The full statement descriptor that is passed to card networks, and that is displayed on your customers' credit card and bank statements. Allows you to see what the statement descriptor looks like after the static and dynamic portions are combined.
+    The full statement descriptor that is passed to card networks, and that is displayed on your customers' credit card and bank statements. Allows you to see what the statement descriptor looks like after the static and dynamic portions are combined. This only works for card payments.
     """
     captured: bool
     """
diff --git a/stripe/_event.py b/stripe/_event.py
@@ -166,6 +166,7 @@ class RetrieveParams(RequestOptions):
         "application_fee.refund.updated",
         "application_fee.refunded",
         "balance.available",
+        "billing.alert.triggered",
         "billing_portal.configuration.created",
         "billing_portal.configuration.updated",
         "billing_portal.session.created",
diff --git a/stripe/_invoice.py b/stripe/_invoice.py
@@ -351,6 +351,7 @@ class LastFinalizationError(StripeObject):
                 "charge_already_refunded",
                 "charge_disputed",
                 "charge_exceeds_source_limit",
+                "charge_exceeds_transaction_limit",
                 "charge_expired_for_capture",
                 "charge_invalid_parameter",
                 "charge_not_refundable",
diff --git a/stripe/_object_classes.py b/stripe/_object_classes.py
@@ -20,6 +20,8 @@
     stripe.BankAccount.OBJECT_NAME: stripe.BankAccount,
     stripe.billing_portal.Configuration.OBJECT_NAME: stripe.billing_portal.Configuration,
     stripe.billing_portal.Session.OBJECT_NAME: stripe.billing_portal.Session,
+    stripe.billing.Alert.OBJECT_NAME: stripe.billing.Alert,
+    stripe.billing.AlertTriggered.OBJECT_NAME: stripe.billing.AlertTriggered,
     stripe.billing.Meter.OBJECT_NAME: stripe.billing.Meter,
     stripe.billing.MeterEvent.OBJECT_NAME: stripe.billing.MeterEvent,
     stripe.billing.MeterEventAdjustment.OBJECT_NAME: stripe.billing.MeterEventAdjustment,
diff --git a/stripe/_payment_intent.py b/stripe/_payment_intent.py
diff --git a/stripe/_payment_intent_service.py b/stripe/_payment_intent_service.py
diff --git a/stripe/_setup_attempt.py b/stripe/_setup_attempt.py
@@ -460,6 +460,7 @@ class SetupError(StripeObject):
                 "charge_already_refunded",
                 "charge_disputed",
                 "charge_exceeds_source_limit",
+                "charge_exceeds_transaction_limit",
                 "charge_expired_for_capture",
                 "charge_invalid_parameter",
                 "charge_not_refundable",
diff --git a/stripe/_setup_intent.py b/stripe/_setup_intent.py
@@ -113,6 +113,7 @@ class LastSetupError(StripeObject):
                 "charge_already_refunded",
                 "charge_disputed",
                 "charge_exceeds_source_limit",
+                "charge_exceeds_transaction_limit",
                 "charge_expired_for_capture",
                 "charge_invalid_parameter",
                 "charge_not_refundable",
@@ -2904,7 +2905,7 @@ class ModifyParams(RequestOptions):
         """
         payment_method: NotRequired[str]
         """
-        ID of the payment method (a PaymentMethod, Card, or saved Source object) to attach to this SetupIntent.
+        ID of the payment method (a PaymentMethod, Card, or saved Source object) to attach to this SetupIntent. To unset this field to null, pass in an empty string.
         """
         payment_method_configuration: NotRequired[str]
         """
@@ -4000,7 +4001,7 @@ class VerifyMicrodepositsParams(RequestOptions):
     """
     payment_method: Optional[ExpandableField["PaymentMethod"]]
     """
-    ID of the payment method used with this SetupIntent.
+    ID of the payment method used with this SetupIntent. If the payment method is `card_present` and isn't a digital wallet, then the [generated_card](https://docs.corp.stripe.com/api/setup_attempts/object#setup_attempt_object-payment_method_details-card_present-generated_card) associated with the `latest_attempt` is attached to the Customer instead.
     """
     payment_method_configuration_details: Optional[
         PaymentMethodConfigurationDetails
diff --git a/stripe/_setup_intent_service.py b/stripe/_setup_intent_service.py
@@ -2370,7 +2370,7 @@ class UpdateParams(TypedDict):
         """
         payment_method: NotRequired[str]
         """
-        ID of the payment method (a PaymentMethod, Card, or saved Source object) to attach to this SetupIntent.
+        ID of the payment method (a PaymentMethod, Card, or saved Source object) to attach to this SetupIntent. To unset this field to null, pass in an empty string.
         """
         payment_method_configuration: NotRequired[str]
         """
diff --git a/stripe/_subscription.py b/stripe/_subscription.py
@@ -595,7 +595,7 @@ class CreateParams(RequestOptions):
         """
         off_session: NotRequired[bool]
         """
-        Indicates if a customer is on or off-session while an invoice payment is attempted.
+        Indicates if a customer is on or off-session while an invoice payment is attempted. Defaults to `false` (on-session).
         """
         on_behalf_of: NotRequired["Literal['']|str"]
         """
@@ -1408,7 +1408,7 @@ class ModifyParams(RequestOptions):
         """
         off_session: NotRequired[bool]
         """
-        Indicates if a customer is on or off-session while an invoice payment is attempted.
+        Indicates if a customer is on or off-session while an invoice payment is attempted. Defaults to `false` (on-session).
         """
         on_behalf_of: NotRequired["Literal['']|str"]
         """
diff --git a/stripe/_subscription_item.py b/stripe/_subscription_item.py
@@ -277,7 +277,7 @@ class ModifyParams(RequestOptions):
         """
         off_session: NotRequired[bool]
         """
-        Indicates if a customer is on or off-session while an invoice payment is attempted.
+        Indicates if a customer is on or off-session while an invoice payment is attempted. Defaults to `false` (on-session).
         """
         payment_behavior: NotRequired[
             Literal[
diff --git a/stripe/_subscription_item_service.py b/stripe/_subscription_item_service.py
@@ -227,7 +227,7 @@ class UpdateParams(TypedDict):
         """
         off_session: NotRequired[bool]
         """
-        Indicates if a customer is on or off-session while an invoice payment is attempted.
+        Indicates if a customer is on or off-session while an invoice payment is attempted. Defaults to `false` (on-session).
         """
         payment_behavior: NotRequired[
             Literal[
diff --git a/stripe/_subscription_service.py b/stripe/_subscription_service.py
@@ -153,7 +153,7 @@ class CreateParams(TypedDict):
         """
         off_session: NotRequired[bool]
         """
-        Indicates if a customer is on or off-session while an invoice payment is attempted.
+        Indicates if a customer is on or off-session while an invoice payment is attempted. Defaults to `false` (on-session).
         """
         on_behalf_of: NotRequired["Literal['']|str"]
         """
@@ -1024,7 +1024,7 @@ class UpdateParams(TypedDict):
         """
         off_session: NotRequired[bool]
         """
-        Indicates if a customer is on or off-session while an invoice payment is attempted.
+        Indicates if a customer is on or off-session while an invoice payment is attempted. Defaults to `false` (on-session).
         """
         on_behalf_of: NotRequired["Literal['']|str"]
         """
diff --git a/stripe/_webhook_endpoint.py b/stripe/_webhook_endpoint.py
@@ -160,6 +160,7 @@ class CreateParams(RequestOptions):
                 "application_fee.refund.updated",
                 "application_fee.refunded",
                 "balance.available",
+                "billing.alert.triggered",
                 "billing_portal.configuration.created",
                 "billing_portal.configuration.updated",
                 "billing_portal.session.created",
@@ -448,6 +449,7 @@ class ModifyParams(RequestOptions):
                     "application_fee.refund.updated",
                     "application_fee.refunded",
                     "balance.available",
+                    "billing.alert.triggered",
                     "billing_portal.configuration.created",
                     "billing_portal.configuration.updated",
                     "billing_portal.session.created",
diff --git a/stripe/_webhook_endpoint_service.py b/stripe/_webhook_endpoint_service.py
@@ -141,6 +141,7 @@ class CreateParams(TypedDict):
                 "application_fee.refund.updated",
                 "application_fee.refunded",
                 "balance.available",
+                "billing.alert.triggered",
                 "billing_portal.configuration.created",
                 "billing_portal.configuration.updated",
                 "billing_portal.session.created",
@@ -435,6 +436,7 @@ class UpdateParams(TypedDict):
                     "application_fee.refund.updated",
                     "application_fee.refunded",
                     "balance.available",
+                    "billing.alert.triggered",
                     "billing_portal.configuration.created",
                     "billing_portal.configuration.updated",
                     "billing_portal.session.created",
diff --git a/stripe/api_resources/billing/__init__.py b/stripe/api_resources/billing/__init__.py
@@ -16,6 +16,8 @@
     stacklevel=2,
 )
 if not TYPE_CHECKING:
+    from stripe.api_resources.billing.alert import Alert
+    from stripe.api_resources.billing.alert_triggered import AlertTriggered
     from stripe.api_resources.billing.meter import Meter
     from stripe.api_resources.billing.meter_event import MeterEvent
     from stripe.api_resources.billing.meter_event_adjustment import (
diff --git a/stripe/api_resources/billing/alert.py b/stripe/api_resources/billing/alert.py
@@ -0,0 +1,21 @@
+# -*- coding: utf-8 -*-
+# File generated from our OpenAPI spec
+from typing_extensions import TYPE_CHECKING
+from warnings import warn
+
+warn(
+    """
+    The stripe.api_resources.billing.alert package is deprecated, please change your
+    imports to import from stripe.billing directly.
+    From:
+      from stripe.api_resources.billing.alert import Alert
+    To:
+      from stripe.billing import Alert
+    """,
+    DeprecationWarning,
+    stacklevel=2,
+)
+if not TYPE_CHECKING:
+    from stripe.billing._alert import (  # noqa
+        Alert,
+    )
diff --git a/stripe/api_resources/billing/alert_triggered.py b/stripe/api_resources/billing/alert_triggered.py
@@ -0,0 +1,21 @@
+# -*- coding: utf-8 -*-
+# File generated from our OpenAPI spec
+from typing_extensions import TYPE_CHECKING
+from warnings import warn
+
+warn(
+    """
+    The stripe.api_resources.billing.alert_triggered package is deprecated, please change your
+    imports to import from stripe.billing directly.
+    From:
+      from stripe.api_resources.billing.alert_triggered import AlertTriggered
+    To:
+      from stripe.billing import AlertTriggered
+    """,
+    DeprecationWarning,
+    stacklevel=2,
+)
+if not TYPE_CHECKING:
+    from stripe.billing._alert_triggered import (  # noqa
+        AlertTriggered,
+    )
diff --git a/stripe/billing/__init__.py b/stripe/billing/__init__.py
@@ -1,5 +1,7 @@
 # -*- coding: utf-8 -*-
 # File generated from our OpenAPI spec
+from stripe.billing._alert import Alert as Alert
+from stripe.billing._alert_triggered import AlertTriggered as AlertTriggered
 from stripe.billing._meter import Meter as Meter
 from stripe.billing._meter_event import MeterEvent as MeterEvent
 from stripe.billing._meter_event_adjustment import (
diff --git a/stripe/billing/_alert.py b/stripe/billing/_alert.py
@@ -0,0 +1,75 @@
+# -*- coding: utf-8 -*-
+# File generated from our OpenAPI spec
+from stripe._expandable_field import ExpandableField
+from stripe._stripe_object import StripeObject
+from typing import ClassVar, Optional
+from typing_extensions import Literal, TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from stripe._customer import Customer
+    from stripe.billing._meter import Meter
+
+
+class Alert(StripeObject):
+    """
+    A billing alert is a resource that notifies you when a certain usage threshold on a meter is crossed. For example, you might create a billing alert to notify you when a certain user made 100 API requests.
+    """
+
+    OBJECT_NAME: ClassVar[Literal["billing.alert"]] = "billing.alert"
+
+    class Filter(StripeObject):
+        customer: Optional[ExpandableField["Customer"]]
+        """
+        Limit the scope of the alert to this customer ID
+        """
+
+    class UsageThresholdConfig(StripeObject):
+        gte: int
+        """
+        The value at which this alert will trigger.
+        """
+        meter: ExpandableField["Meter"]
+        """
+        The [Billing Meter](https://stripe.com/api/billing/meter) ID whose usage is monitored.
+        """
+        recurrence: Literal["one_time"]
+        """
+        Defines how the alert will behave.
+        """
+
+    alert_type: Literal["usage_threshold"]
+    """
+    Defines the type of the alert.
+    """
+    filter: Optional[Filter]
+    """
+    Limits the scope of the alert to a specific [customer](https://stripe.com/docs/api/customers).
+    """
+    id: str
+    """
+    Unique identifier for the object.
+    """
+    livemode: bool
+    """
+    Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+    """
+    object: Literal["billing.alert"]
+    """
+    String representing the object's type. Objects of the same type share the same value.
+    """
+    status: Optional[Literal["active", "archived", "inactive"]]
+    """
+    Status of the alert. This can be active, inactive or archived.
+    """
+    title: str
+    """
+    Title of the alert.
+    """
+    usage_threshold_config: Optional[UsageThresholdConfig]
+    """
+    Encapsulates configuration of the alert to monitor usage on a specific [Billing Meter](https://stripe.com/docs/api/billing/meter).
+    """
+    _inner_class_types = {
+        "filter": Filter,
+        "usage_threshold_config": UsageThresholdConfig,
+    }
diff --git a/stripe/billing/_alert_triggered.py b/stripe/billing/_alert_triggered.py
@@ -0,0 +1,38 @@
+# -*- coding: utf-8 -*-
+# File generated from our OpenAPI spec
+from stripe._stripe_object import StripeObject
+from typing import ClassVar
+from typing_extensions import Literal, TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from stripe.billing._alert import Alert
+
+
+class AlertTriggered(StripeObject):
+    OBJECT_NAME: ClassVar[Literal["billing.alert_triggered"]] = (
+        "billing.alert_triggered"
+    )
+    alert: "Alert"
+    """
+    A billing alert is a resource that notifies you when a certain usage threshold on a meter is crossed. For example, you might create a billing alert to notify you when a certain user made 100 API requests.
+    """
+    created: int
+    """
+    Time at which the object was created. Measured in seconds since the Unix epoch.
+    """
+    customer: str
+    """
+    ID of customer for which the alert triggered
+    """
+    livemode: bool
+    """
+    Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+    """
+    object: Literal["billing.alert_triggered"]
+    """
+    String representing the object's type. Objects of the same type share the same value.
+    """
+    value: int
+    """
+    The value triggering the alert
+    """
diff --git a/stripe/checkout/_session.py b/stripe/checkout/_session.py
diff --git a/stripe/checkout/_session_service.py b/stripe/checkout/_session_service.py
diff --git a/stripe/financial_connections/_account.py b/stripe/financial_connections/_account.py
