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
+0822236fb875490aa7ccc7b66dbb52f8965ee062

OPENAPI_VERSION

@@ -1 +1 @@
-v2141
+v2148

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/_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/_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"

stripe/events/_event_classes.py

@@ -22,6 +22,12 @@
     from stripe.events._v2_billing_cadence_created_event import (
         V2BillingCadenceCreatedEventNotification,
     )
+    from stripe.events._v2_billing_licensed_item_created_event import (
+        V2BillingLicensedItemCreatedEventNotification,
+    )
+    from stripe.events._v2_billing_licensed_item_updated_event import (
+        V2BillingLicensedItemUpdatedEventNotification,
+    )
     from stripe.events._v2_billing_license_fee_created_event import (
         V2BillingLicenseFeeCreatedEventNotification,
     )
@@ -31,30 +37,21 @@
     from stripe.events._v2_billing_license_fee_version_created_event import (
         V2BillingLicenseFeeVersionCreatedEventNotification,
     )
-    from stripe.events._v2_billing_licensed_item_created_event import (
-        V2BillingLicensedItemCreatedEventNotification,
-    )
-    from stripe.events._v2_billing_licensed_item_updated_event import (
-        V2BillingLicensedItemUpdatedEventNotification,
-    )
     from stripe.events._v2_billing_metered_item_created_event import (
         V2BillingMeteredItemCreatedEventNotification,
     )
     from stripe.events._v2_billing_metered_item_updated_event import (
         V2BillingMeteredItemUpdatedEventNotification,
     )
-    from stripe.events._v2_billing_pricing_plan_created_event import (
-        V2BillingPricingPlanCreatedEventNotification,
-    )
-    from stripe.events._v2_billing_pricing_plan_updated_event import (
-        V2BillingPricingPlanUpdatedEventNotification,
-    )
     from stripe.events._v2_billing_pricing_plan_component_created_event import (
         V2BillingPricingPlanComponentCreatedEventNotification,
     )
     from stripe.events._v2_billing_pricing_plan_component_updated_event import (
         V2BillingPricingPlanComponentUpdatedEventNotification,
     )
+    from stripe.events._v2_billing_pricing_plan_created_event import (
+        V2BillingPricingPlanCreatedEventNotification,
+    )
     from stripe.events._v2_billing_pricing_plan_subscription_collection_awaiting_customer_action_event import (
         V2BillingPricingPlanSubscriptionCollectionAwaitingCustomerActionEventNotification,
     )
@@ -79,15 +76,15 @@
     from stripe.events._v2_billing_pricing_plan_subscription_servicing_paused_event import (
         V2BillingPricingPlanSubscriptionServicingPausedEventNotification,
     )
+    from stripe.events._v2_billing_pricing_plan_updated_event import (
+        V2BillingPricingPlanUpdatedEventNotification,
+    )
     from stripe.events._v2_billing_pricing_plan_version_created_event import (
         V2BillingPricingPlanVersionCreatedEventNotification,
     )
     from stripe.events._v2_billing_rate_card_created_event import (
         V2BillingRateCardCreatedEventNotification,
     )
-    from stripe.events._v2_billing_rate_card_updated_event import (
-        V2BillingRateCardUpdatedEventNotification,
-    )
     from stripe.events._v2_billing_rate_card_rate_created_event import (
         V2BillingRateCardRateCreatedEventNotification,
     )
@@ -121,6 +118,9 @@
     from stripe.events._v2_billing_rate_card_subscription_servicing_paused_event import (
         V2BillingRateCardSubscriptionServicingPausedEventNotification,
     )
+    from stripe.events._v2_billing_rate_card_updated_event import (
+        V2BillingRateCardUpdatedEventNotification,
+    )
     from stripe.events._v2_billing_rate_card_version_created_event import (
         V2BillingRateCardVersionCreatedEventNotification,
     )
@@ -130,9 +130,6 @@
     from stripe.events._v2_core_account_created_event import (
         V2CoreAccountCreatedEventNotification,
     )
-    from stripe.events._v2_core_account_updated_event import (
-        V2CoreAccountUpdatedEventNotification,
-    )
     from stripe.events._v2_core_account_including_configuration_card_creator_capability_status_updated_event import (
         V2CoreAccountIncludingConfigurationCardCreatorCapabilityStatusUpdatedEventNotification,
     )
@@ -184,6 +181,9 @@
     from stripe.events._v2_core_account_person_updated_event import (
         V2CoreAccountPersonUpdatedEventNotification,
     )
+    from stripe.events._v2_core_account_updated_event import (
+        V2CoreAccountUpdatedEventNotification,
+    )
     from stripe.events._v2_core_claimable_sandbox_claimed_event import (
         V2CoreClaimableSandboxClaimedEventNotification,
     )
@@ -442,9 +442,6 @@
     from stripe.events._v2_payments_settlement_allocation_intent_settled_event import (
         V2PaymentsSettlementAllocationIntentSettledEventNotification,
     )
-    from stripe.events._v2_payments_settlement_allocation_intent_submitted_event import (
-        V2PaymentsSettlementAllocationIntentSubmittedEventNotification,
-    )
     from stripe.events._v2_payments_settlement_allocation_intent_split_canceled_event import (
         V2PaymentsSettlementAllocationIntentSplitCanceledEventNotification,
     )
@@ -454,6 +451,9 @@
     from stripe.events._v2_payments_settlement_allocation_intent_split_settled_event import (
         V2PaymentsSettlementAllocationIntentSplitSettledEventNotification,
     )
+    from stripe.events._v2_payments_settlement_allocation_intent_submitted_event import (
+        V2PaymentsSettlementAllocationIntentSubmittedEventNotification,
+    )
     from stripe.events._v2_reporting_report_run_created_event import (
         V2ReportingReportRunCreatedEventNotification,
     )

stripe/params/__init__.py

@@ -4081,6 +4081,7 @@
     from stripe.params._plan_create_params import (
         PlanCreateParams as PlanCreateParams,
         PlanCreateParamsProduct as PlanCreateParamsProduct,
+        PlanCreateParamsProductTaxDetails as PlanCreateParamsProductTaxDetails,
         PlanCreateParamsTier as PlanCreateParamsTier,
         PlanCreateParamsTransformUsage as PlanCreateParamsTransformUsage,
     )
@@ -4107,6 +4108,7 @@
         PriceCreateParamsCurrencyOptionsTier as PriceCreateParamsCurrencyOptionsTier,
         PriceCreateParamsCustomUnitAmount as PriceCreateParamsCustomUnitAmount,
         PriceCreateParamsProductData as PriceCreateParamsProductData,
+        PriceCreateParamsProductDataTaxDetails as PriceCreateParamsProductDataTaxDetails,
         PriceCreateParamsRecurring as PriceCreateParamsRecurring,
         PriceCreateParamsTier as PriceCreateParamsTier,
         PriceCreateParamsTransformQuantity as PriceCreateParamsTransformQuantity,
@@ -19346,6 +19348,10 @@
     "PayoutUpdateParams": ("stripe.params._payout_update_params", False),
     "PlanCreateParams": ("stripe.params._plan_create_params", False),
     "PlanCreateParamsProduct": ("stripe.params._plan_create_params", False),
+    "PlanCreateParamsProductTaxDetails": (
+        "stripe.params._plan_create_params",
+        False,
+    ),
     "PlanCreateParamsTier": ("stripe.params._plan_create_params", False),
     "PlanCreateParamsTransformUsage": (
         "stripe.params._plan_create_params",
@@ -19378,6 +19384,10 @@
         "stripe.params._price_create_params",
         False,
     ),
+    "PriceCreateParamsProductDataTaxDetails": (
+        "stripe.params._price_create_params",
+        False,
+    ),
     "PriceCreateParamsRecurring": (
         "stripe.params._price_create_params",
         False,

stripe/params/_invoice_add_lines_params.py

@@ -198,6 +198,10 @@ class InvoiceAddLinesParamsLinePriceDataProductData(TypedDict):
 
 
 class InvoiceAddLinesParamsLinePriceDataProductDataTaxDetails(TypedDict):
+    performance_location: NotRequired[str]
+    """
+    A tax location ID. Depending on the [tax code](https://docs.stripe.com/tax/tax-for-tickets/reference/tax-location-performance), this is required, optional, or not supported.
+    """
     tax_code: str
     """
     A [tax code](https://docs.stripe.com/tax/tax-categories) ID.

stripe/params/_invoice_create_preview_params.py

@@ -621,7 +621,7 @@ class InvoiceCreatePreviewParamsScheduleDetailsAmendment(TypedDict):
         Literal["amendment_start", "billing_period_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.
     """
     item_actions: NotRequired[
         List["InvoiceCreatePreviewParamsScheduleDetailsAmendmentItemAction"]
@@ -1357,7 +1357,7 @@ class InvoiceCreatePreviewParamsScheduleDetailsPhase(TypedDict):
     """
     effective_at: NotRequired[Literal["billing_period_start", "phase_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.
     """
     end_date: NotRequired["int|Literal['now']"]
     """

stripe/params/_invoice_line_item_update_params.py

@@ -184,6 +184,10 @@ class InvoiceLineItemUpdateParamsPriceDataProductData(TypedDict):
 
 
 class InvoiceLineItemUpdateParamsPriceDataProductDataTaxDetails(TypedDict):
+    performance_location: NotRequired[str]
+    """
+    A tax location ID. Depending on the [tax code](https://docs.stripe.com/tax/tax-for-tickets/reference/tax-location-performance), this is required, optional, or not supported.
+    """
     tax_code: str
     """
     A [tax code](https://docs.stripe.com/tax/tax-categories) ID.

stripe/params/_invoice_update_lines_params.py

@@ -202,6 +202,10 @@ class InvoiceUpdateLinesParamsLinePriceDataProductData(TypedDict):
 
 
 class InvoiceUpdateLinesParamsLinePriceDataProductDataTaxDetails(TypedDict):
+    performance_location: NotRequired[str]
+    """
+    A tax location ID. Depending on the [tax code](https://docs.stripe.com/tax/tax-for-tickets/reference/tax-location-performance), this is required, optional, or not supported.
+    """
     tax_code: str
     """
     A [tax code](https://docs.stripe.com/tax/tax-categories) ID.

stripe/params/_payment_intent_confirm_params.py

@@ -466,7 +466,7 @@ class PaymentIntentConfirmParamsPaymentDetails(TypedDict):
 
 class PaymentIntentConfirmParamsPaymentDetailsBenefit(TypedDict):
     fr_meal_voucher: NotRequired[
-        "PaymentIntentConfirmParamsPaymentDetailsBenefitFrMealVoucher"
+        "Literal['']|PaymentIntentConfirmParamsPaymentDetailsBenefitFrMealVoucher"
     ]
     """
     French meal voucher benefit details for this PaymentIntent.

stripe/params/_payment_intent_create_params.py

@@ -613,7 +613,7 @@ class PaymentIntentCreateParamsPaymentDetails(TypedDict):
 
 class PaymentIntentCreateParamsPaymentDetailsBenefit(TypedDict):
     fr_meal_voucher: NotRequired[
-        "PaymentIntentCreateParamsPaymentDetailsBenefitFrMealVoucher"
+        "Literal['']|PaymentIntentCreateParamsPaymentDetailsBenefitFrMealVoucher"
     ]
     """
     French meal voucher benefit details for this PaymentIntent.

stripe/params/_payment_intent_modify_params.py

@@ -461,7 +461,7 @@ class PaymentIntentModifyParamsPaymentDetails(TypedDict):
 
 class PaymentIntentModifyParamsPaymentDetailsBenefit(TypedDict):
     fr_meal_voucher: NotRequired[
-        "PaymentIntentModifyParamsPaymentDetailsBenefitFrMealVoucher"
+        "Literal['']|PaymentIntentModifyParamsPaymentDetailsBenefitFrMealVoucher"
     ]
     """
     French meal voucher benefit details for this PaymentIntent.

stripe/params/_payment_intent_update_params.py

@@ -460,7 +460,7 @@ class PaymentIntentUpdateParamsPaymentDetails(TypedDict):
 
 class PaymentIntentUpdateParamsPaymentDetailsBenefit(TypedDict):
     fr_meal_voucher: NotRequired[
-        "PaymentIntentUpdateParamsPaymentDetailsBenefitFrMealVoucher"
+        "Literal['']|PaymentIntentUpdateParamsPaymentDetailsBenefitFrMealVoucher"
     ]
     """
     French meal voucher benefit details for this PaymentIntent.

stripe/params/_payment_link_create_params.py

@@ -617,6 +617,10 @@ class PaymentLinkCreateParamsLineItemPriceDataProductData(TypedDict):
 
 
 class PaymentLinkCreateParamsLineItemPriceDataProductDataTaxDetails(TypedDict):
+    performance_location: NotRequired[str]
+    """
+    A tax location ID. Depending on the [tax code](https://docs.stripe.com/tax/tax-for-tickets/reference/tax-location-performance), this is required, optional, or not supported.
+    """
     tax_code: str
     """
     A [tax code](https://docs.stripe.com/tax/tax-categories) ID.