Update generated code for private-preview

.github/workflows/ci.yml

@@ -87,6 +87,7 @@ jobs:
           - "3.11"
           - "3.12"
           - "3.13"
+          - "3.14"
           - "pypy-3.7"
           - "pypy-3.8"
           - "pypy-3.9"

API_VERSION

@@ -1 +1 @@
-3602014a6583f6c0fbfdde3c575839ac7d0b4e9c
+5abe0e44caedb3474ee672265284096ec89e0fa3

OPENAPI_VERSION

@@ -1 +1 @@
-v2141
+v2150

stripe/_encode.py

@@ -31,8 +31,8 @@ def _api_encode(data) -> Generator[Tuple[str, Any], None, None]:
     for key, value in data.items():
         if value is None:
             continue
-        elif hasattr(value, "stripe_id"):
-            yield (key, value.stripe_id)
+        elif hasattr(value, "id"):
+            yield (key, getattr(value, "id"))
         elif isinstance(value, list) or isinstance(value, tuple):
             for i, sv in enumerate(value):
                 # Always use indexed format for arrays

stripe/_invoice.py

@@ -746,6 +746,10 @@ class ScheduleDetails(StripeObject):
             """
             The schedule that generated this invoice
             """
+            subscription: Optional[ExpandableField["Subscription"]]
+            """
+            The subscription associated with this schedule
+            """
 
         class SubscriptionDetails(StripeObject):
             class PauseCollection(StripeObject):

stripe/_object_classes.py

@@ -324,6 +324,7 @@
         "CalculationLineItem",
     ),
     "tax.form": ("stripe.tax._form", "Form"),
+    "tax.location": ("stripe.tax._location", "Location"),
     "tax.registration": ("stripe.tax._registration", "Registration"),
     "tax.settings": ("stripe.tax._settings", "Settings"),
     "tax.transaction": ("stripe.tax._transaction", "Transaction"),

stripe/_plan.py

@@ -99,6 +99,10 @@ class TransformUsage(StripeObject):
     """
     Always true for a deleted object
     """
+    external_reference: Optional[str]
+    """
+    A custom identifier for this price, such as a SKU number or product code, that can be used to reference records from external systems.
+    """
     id: str
     """
     Unique identifier for the object.

stripe/_price.py

@@ -220,6 +220,10 @@ class TransformQuantity(StripeObject):
     """
     Always true for a deleted object
     """
+    external_reference: Optional[str]
+    """
+    A custom identifier for this price, such as a SKU number or product code, that can be used to reference records from external systems.
+    """
     id: str
     """
     Unique identifier for the object.

stripe/_quote.py

@@ -771,10 +771,10 @@ class Prebilling(StripeObject):
         Set of [key-value pairs](https://docs.stripe.com/api/metadata) that will set metadata on the subscription or subscription schedule when the quote is accepted. If a recurring price is included in `line_items`, this field will be passed to the resulting subscription's `metadata` field. If `subscription_data.effective_date` is used, this field will be passed to the resulting subscription schedule's `phases.metadata` field. Unlike object-level metadata, this field is declarative. Updates will clear prior values.
         """
         phase_effective_at: Optional[
-            Literal["billing_period_start", "line_start"]
+            Literal["billing_period_start", "phase_start"]
         ]
         """
-        Configures how the quote handles billing for line transitions. Possible values are `line_start` (default) or `billing_period_start`. `line_start` bills based on the current state of the line, ignoring changes scheduled for future lines. `billing_period_start` bills predictively for upcoming line transitions within the current billing cycle, including pricing changes and service period adjustments that will occur before the next invoice.
+        Configures how the subscription schedule handles billing for phase transitions when the quote is accepted.
         """
         prebilling: Optional[Prebilling]
         """
@@ -1041,10 +1041,10 @@ class LineEndsAt(StripeObject):
         Behavior of the subscription schedule and underlying subscription when it ends.
         """
         phase_effective_at: Optional[
-            Literal["billing_period_start", "line_start"]
+            Literal["billing_period_start", "phase_start"]
         ]
         """
-        Configures how the quote handles billing for line transitions. Possible values are `line_start` (default) or `billing_period_start`. `line_start` bills based on the current state of the line, ignoring changes scheduled for future lines. `billing_period_start` bills predictively for upcoming line transitions within the current billing cycle, including pricing changes and service period adjustments that will occur before the next invoice.
+        Configures how the subscription schedule handles billing for phase transitions when the quote is accepted.
         """
         proration_behavior: Optional[
             Literal["always_invoice", "create_prorations", "none"]

stripe/_quote_line.py

@@ -487,7 +487,7 @@ class EndBehavior(StripeObject):
     """
     effective_at: Optional[Literal["billing_period_start", "line_start"]]
     """
-    Configures how the subscription schedule handles billing for phase transitions. Possible values are `phase_start` (default) or `billing_period_start`. `phase_start` bills based on the current state of the subscription, ignoring changes scheduled in future phases. `billing_period_start` bills predictively for upcoming phase transitions within the current billing cycle, including pricing changes and service period adjustments that will occur before the next invoice.
+    Configures how the subscription schedule handles billing for phase transitions.
     """
     ends_at: Optional[EndsAt]
     """

stripe/_quote_preview_invoice.py

@@ -704,6 +704,10 @@ class ScheduleDetails(StripeObject):
             """
             The schedule that generated this invoice
             """
+            subscription: Optional[ExpandableField["Subscription"]]
+            """
+            The subscription associated with this schedule
+            """
 
         class SubscriptionDetails(StripeObject):
             class PauseCollection(StripeObject):

stripe/_subscription.py

@@ -58,6 +58,9 @@
     from stripe.params._subscription_modify_params import (
         SubscriptionModifyParams,
     )
+    from stripe.params._subscription_pause_params import (
+        SubscriptionPauseParams,
+    )
     from stripe.params._subscription_resume_params import (
         SubscriptionResumeParams,
     )
@@ -1629,6 +1632,116 @@ async def modify_async(
             ),
         )
 
+    @classmethod
+    def _cls_pause(
+        cls, subscription: str, **params: Unpack["SubscriptionPauseParams"]
+    ) -> "Subscription":
+        """
+        Pauses a subscription by transitioning it to the paused status. A paused subscription does not generate invoices and will not advance to new billing periods. The subscription can be resumed later using the resume endpoint. Cannot pause subscriptions with attached schedules.
+        """
+        return cast(
+            "Subscription",
+            cls._static_request(
+                "post",
+                "/v1/subscriptions/{subscription}/pause".format(
+                    subscription=sanitize_id(subscription)
+                ),
+                params=params,
+            ),
+        )
+
+    @overload
+    @staticmethod
+    def pause(
+        subscription: str, **params: Unpack["SubscriptionPauseParams"]
+    ) -> "Subscription":
+        """
+        Pauses a subscription by transitioning it to the paused status. A paused subscription does not generate invoices and will not advance to new billing periods. The subscription can be resumed later using the resume endpoint. Cannot pause subscriptions with attached schedules.
+        """
+        ...
+
+    @overload
+    def pause(
+        self, **params: Unpack["SubscriptionPauseParams"]
+    ) -> "Subscription":
+        """
+        Pauses a subscription by transitioning it to the paused status. A paused subscription does not generate invoices and will not advance to new billing periods. The subscription can be resumed later using the resume endpoint. Cannot pause subscriptions with attached schedules.
+        """
+        ...
+
+    @class_method_variant("_cls_pause")
+    def pause(  # pyright: ignore[reportGeneralTypeIssues]
+        self, **params: Unpack["SubscriptionPauseParams"]
+    ) -> "Subscription":
+        """
+        Pauses a subscription by transitioning it to the paused status. A paused subscription does not generate invoices and will not advance to new billing periods. The subscription can be resumed later using the resume endpoint. Cannot pause subscriptions with attached schedules.
+        """
+        return cast(
+            "Subscription",
+            self._request(
+                "post",
+                "/v1/subscriptions/{subscription}/pause".format(
+                    subscription=sanitize_id(self.get("id"))
+                ),
+                params=params,
+            ),
+        )
+
+    @classmethod
+    async def _cls_pause_async(
+        cls, subscription: str, **params: Unpack["SubscriptionPauseParams"]
+    ) -> "Subscription":
+        """
+        Pauses a subscription by transitioning it to the paused status. A paused subscription does not generate invoices and will not advance to new billing periods. The subscription can be resumed later using the resume endpoint. Cannot pause subscriptions with attached schedules.
+        """
+        return cast(
+            "Subscription",
+            await cls._static_request_async(
+                "post",
+                "/v1/subscriptions/{subscription}/pause".format(
+                    subscription=sanitize_id(subscription)
+                ),
+                params=params,
+            ),
+        )
+
+    @overload
+    @staticmethod
+    async def pause_async(
+        subscription: str, **params: Unpack["SubscriptionPauseParams"]
+    ) -> "Subscription":
+        """
+        Pauses a subscription by transitioning it to the paused status. A paused subscription does not generate invoices and will not advance to new billing periods. The subscription can be resumed later using the resume endpoint. Cannot pause subscriptions with attached schedules.
+        """
+        ...
+
+    @overload
+    async def pause_async(
+        self, **params: Unpack["SubscriptionPauseParams"]
+    ) -> "Subscription":
+        """
+        Pauses a subscription by transitioning it to the paused status. A paused subscription does not generate invoices and will not advance to new billing periods. The subscription can be resumed later using the resume endpoint. Cannot pause subscriptions with attached schedules.
+        """
+        ...
+
+    @class_method_variant("_cls_pause_async")
+    async def pause_async(  # pyright: ignore[reportGeneralTypeIssues]
+        self, **params: Unpack["SubscriptionPauseParams"]
+    ) -> "Subscription":
+        """
+        Pauses a subscription by transitioning it to the paused status. A paused subscription does not generate invoices and will not advance to new billing periods. The subscription can be resumed later using the resume endpoint. Cannot pause subscriptions with attached schedules.
+        """
+        return cast(
+            "Subscription",
+            await self._request_async(
+                "post",
+                "/v1/subscriptions/{subscription}/pause".format(
+                    subscription=sanitize_id(self.get("id"))
+                ),
+                params=params,
+            ),
+        )
+
     @classmethod
     def _cls_resume(
         cls, subscription: str, **params: Unpack["SubscriptionResumeParams"]

stripe/_subscription_service.py

@@ -27,6 +27,9 @@
     from stripe.params._subscription_migrate_params import (
         SubscriptionMigrateParams,
     )
+    from stripe.params._subscription_pause_params import (
+        SubscriptionPauseParams,
+    )
     from stripe.params._subscription_resume_params import (
         SubscriptionResumeParams,
     )
@@ -502,6 +505,50 @@ async def migrate_async(
             ),
         )
 
+    def pause(
+        self,
+        subscription: str,
+        params: "SubscriptionPauseParams",
+        options: Optional["RequestOptions"] = None,
+    ) -> "Subscription":
+        """
+        Pauses a subscription by transitioning it to the paused status. A paused subscription does not generate invoices and will not advance to new billing periods. The subscription can be resumed later using the resume endpoint. Cannot pause subscriptions with attached schedules.
+        """
+        return cast(
+            "Subscription",
+            self._request(
+                "post",
+                "/v1/subscriptions/{subscription}/pause".format(
+                    subscription=sanitize_id(subscription),
+                ),
+                base_address="api",
+                params=params,
+                options=options,
+            ),
+        )
+
+    async def pause_async(
+        self,
+        subscription: str,
+        params: "SubscriptionPauseParams",
+        options: Optional["RequestOptions"] = None,
+    ) -> "Subscription":
+        """
+        Pauses a subscription by transitioning it to the paused status. A paused subscription does not generate invoices and will not advance to new billing periods. The subscription can be resumed later using the resume endpoint. Cannot pause subscriptions with attached schedules.
+        """
+        return cast(
+            "Subscription",
+            await self._request_async(
+                "post",
+                "/v1/subscriptions/{subscription}/pause".format(
+                    subscription=sanitize_id(subscription),
+                ),
+                base_address="api",
+                params=params,
+                options=options,
+            ),
+        )
+
     def resume(
         self,
         subscription: str,

stripe/_tax_code.py

@@ -2,7 +2,8 @@
 # File generated from our OpenAPI spec
 from stripe._list_object import ListObject
 from stripe._listable_api_resource import ListableAPIResource
-from typing import ClassVar
+from stripe._stripe_object import StripeObject
+from typing import ClassVar, Optional
 from typing_extensions import Literal, Unpack, TYPE_CHECKING
 
 if TYPE_CHECKING:
@@ -16,6 +17,13 @@ class TaxCode(ListableAPIResource["TaxCode"]):
     """
 
     OBJECT_NAME: ClassVar[Literal["tax_code"]] = "tax_code"
+
+    class Requirements(StripeObject):
+        performance_location: Optional[Literal["optional", "required"]]
+        """
+        Describes whether a performance location is required for a successful tax calculation with a tax code.
+        """
+
     description: str
     """
     A detailed description of which types of products the tax code represents.
@@ -32,6 +40,10 @@ class TaxCode(ListableAPIResource["TaxCode"]):
     """
     String representing the object's type. Objects of the same type share the same value.
     """
+    requirements: Optional[Requirements]
+    """
+    An object that describes more information about the tax location required for this tax code. Some [tax codes](https://docs.stripe.com/tax/tax-for-tickets/integration-guide#types-of-products) require a tax location of type `performance` to calculate tax correctly.
+    """
 
     @classmethod
     def list(
@@ -94,3 +106,5 @@ async def retrieve_async(
         instance = cls(id, **params)
         await instance.refresh_async()
         return instance
+
+    _inner_class_types = {"requirements": Requirements}

stripe/_tax_service.py

@@ -8,6 +8,7 @@
     from stripe.tax._association_service import AssociationService
     from stripe.tax._calculation_service import CalculationService
     from stripe.tax._form_service import FormService
+    from stripe.tax._location_service import LocationService
     from stripe.tax._registration_service import RegistrationService
     from stripe.tax._settings_service import SettingsService
     from stripe.tax._transaction_service import TransactionService
@@ -16,6 +17,7 @@
     "associations": ["stripe.tax._association_service", "AssociationService"],
     "calculations": ["stripe.tax._calculation_service", "CalculationService"],
     "forms": ["stripe.tax._form_service", "FormService"],
+    "locations": ["stripe.tax._location_service", "LocationService"],
     "registrations": [
         "stripe.tax._registration_service",
         "RegistrationService",
@@ -29,6 +31,7 @@ class TaxService(StripeService):
     associations: "AssociationService"
     calculations: "CalculationService"
     forms: "FormService"
+    locations: "LocationService"
     registrations: "RegistrationService"
     settings: "SettingsService"
     transactions: "TransactionService"