stripe 17.3.0.pre.alpha.1 → 17.3.0.pre.alpha.2

data/rbi/stripe.rbi

@@ -692,6 +692,9 @@ module Stripe
     # The subscription item that this coupon is applied to, if it is applied to a particular subscription item.
     sig { returns(T.nilable(String)) }
     def subscription_item; end
+    # The subscription schedule that this coupon is applied to, if it is applied to a particular subscription schedule.
+    sig { returns(T.nilable(String)) }
+    def schedule; end
     # Always true for a deleted object
     sig { returns(T.nilable(T::Boolean)) }
     def deleted; end
@@ -5619,6 +5622,34 @@ module Stripe
         @field_remappings = {}
       end
     end
+    class SelfReportedIncome < ::Stripe::StripeObject
+      # Amount in the minor currency unit (e.g., cents for USD)
+      sig { returns(Integer) }
+      def amount; end
+      # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+      sig { returns(String) }
+      def currency; end
+      def self.inner_class_types
+        @inner_class_types = {}
+      end
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+    class SelfReportedMonthlyHousingPayment < ::Stripe::StripeObject
+      # Amount in the minor currency unit (e.g., cents for USD)
+      sig { returns(Integer) }
+      def amount; end
+      # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+      sig { returns(String) }
+      def currency; end
+      def self.inner_class_types
+        @inner_class_types = {}
+      end
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
     # The account the person is associated with.
     sig { returns(T.nilable(String)) }
     def account; end
@@ -5715,6 +5746,12 @@ module Stripe
     # Attribute for field verification
     sig { returns(T.nilable(Verification)) }
     def verification; end
+    # Attribute for field self_reported_income
+    sig { returns(T.nilable(SelfReportedIncome)) }
+    def self_reported_income; end
+    # Attribute for field self_reported_monthly_housing_payment
+    sig { returns(T.nilable(SelfReportedMonthlyHousingPayment)) }
+    def self_reported_monthly_housing_payment; end
     # Always true for a deleted object
     sig { returns(T.nilable(T::Boolean)) }
     def deleted; end
@@ -17914,6 +17951,23 @@ module Stripe
         end
       end
       class TotalDetails < ::Stripe::StripeObject
+        class ApplicableFee < ::Stripe::StripeObject
+          # The amount of the applicable fee.
+          sig { returns(Integer) }
+          def amount; end
+          # The description of the applicable fee.
+          sig { returns(T.nilable(String)) }
+          def description; end
+          # The display name of the applicable fee.
+          sig { returns(String) }
+          def display_name; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
         # The amount discount of the total details.
         sig { returns(T.nilable(Integer)) }
         def amount_discount; end
@@ -17923,8 +17977,11 @@ module Stripe
         # The amount tax of the total details.
         sig { returns(T.nilable(Integer)) }
         def amount_tax; end
+        # The applicable fees of the total details.
+        sig { returns(T.nilable(T::Array[ApplicableFee])) }
+        def applicable_fees; end
         def self.inner_class_types
-          @inner_class_types = {}
+          @inner_class_types = {applicable_fees: ApplicableFee}
         end
         def self.field_remappings
           @field_remappings = {}
@@ -21064,6 +21121,17 @@ module Stripe
           @field_remappings = {}
         end
       end
+      class ScheduleDetails < ::Stripe::StripeObject
+        # The subscription schedule that generated this invoice item
+        sig { returns(String) }
+        def schedule; end
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
       class SubscriptionDetails < ::Stripe::StripeObject
         # The subscription that generated this invoice item
         sig { returns(String) }
@@ -21090,11 +21158,15 @@ module Stripe
       # The type of parent that generated this invoice item
       sig { returns(String) }
       def type; end
+      # Details about the subscription schedule that generated this invoice item
+      sig { returns(T.nilable(ScheduleDetails)) }
+      def schedule_details; end
       def self.inner_class_types
         @inner_class_types = {
           license_fee_subscription_details: LicenseFeeSubscriptionDetails,
           rate_card_subscription_details: RateCardSubscriptionDetails,
           subscription_details: SubscriptionDetails,
+          schedule_details: ScheduleDetails,
         }
       end
       def self.field_remappings
@@ -21682,6 +21754,17 @@ module Stripe
           @field_remappings = {}
         end
       end
+      class ScheduleDetails < ::Stripe::StripeObject
+        # The schedule that generated this invoice
+        sig { returns(String) }
+        def schedule; end
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
       class SubscriptionDetails < ::Stripe::StripeObject
         class PauseCollection < ::Stripe::StripeObject
           # The payment collection behavior for this subscription while paused. One of `keep_as_draft`, `mark_uncollectible`, or `void`.
@@ -21729,11 +21812,15 @@ module Stripe
       # The type of parent that generated this invoice
       sig { returns(String) }
       def type; end
+      # Details about the schedule that generated this invoice
+      sig { returns(T.nilable(ScheduleDetails)) }
+      def schedule_details; end
       def self.inner_class_types
         @inner_class_types = {
           billing_cadence_details: BillingCadenceDetails,
           quote_details: QuoteDetails,
           subscription_details: SubscriptionDetails,
+          schedule_details: ScheduleDetails,
         }
       end
       def self.field_remappings
@@ -22851,6 +22938,17 @@ module Stripe
           @field_remappings = {}
         end
       end
+      class ScheduleDetails < ::Stripe::StripeObject
+        # The subscription schedule that generated this line item
+        sig { returns(String) }
+        def schedule; end
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
       class SubscriptionItemDetails < ::Stripe::StripeObject
         class ProrationDetails < ::Stripe::StripeObject
           class CreditedItems < ::Stripe::StripeObject
@@ -22914,12 +23012,16 @@ module Stripe
       # The type of parent that generated this line item
       sig { returns(String) }
       def type; end
+      # Details about the subscription schedule that generated this line item
+      sig { returns(T.nilable(ScheduleDetails)) }
+      def schedule_details; end
       def self.inner_class_types
         @inner_class_types = {
           invoice_item_details: InvoiceItemDetails,
           license_fee_subscription_details: LicenseFeeSubscriptionDetails,
           rate_card_subscription_details: RateCardSubscriptionDetails,
           subscription_item_details: SubscriptionItemDetails,
+          schedule_details: ScheduleDetails,
         }
       end
       def self.field_remappings
@@ -25090,6 +25192,49 @@ module Stripe
   end
 end
 # typed: true
+module Stripe
+  module Issuing
+    # An Issuing `Program` represents a card program that the user has access to.
+    class Program < APIResource
+      # Time at which the object was created. Measured in seconds since the Unix epoch.
+      sig { returns(Integer) }
+      def created; end
+      # Unique identifier for the object.
+      sig { returns(String) }
+      def id; end
+      # Whether or not this is the "default" issuing program new cards are created on. Only one active `is_default` program at the same time.
+      sig { returns(T::Boolean) }
+      def is_default; end
+      # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+      sig { returns(T::Hash[String, String]) }
+      def metadata; end
+      # String representing the object's type. Objects of the same type share the same value.
+      sig { returns(String) }
+      def object; end
+      # The platform's Issuing Program for which this program is associated.
+      sig { returns(T.nilable(String)) }
+      def platform_program; end
+      # Create a Program object.
+      sig {
+        params(params: T.any(::Stripe::Issuing::ProgramCreateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(::Stripe::Issuing::Program)
+       }
+      def self.create(params = {}, opts = {}); end
+
+      # List all of the programs the given Issuing user has access to.
+      sig {
+        params(params: T.any(::Stripe::Issuing::ProgramListParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(::Stripe::ListObject)
+       }
+      def self.list(params = {}, opts = {}); end
+
+      # Updates a Program object.
+      sig {
+        params(program: String, params: T.any(::Stripe::Issuing::ProgramUpdateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(::Stripe::Issuing::Program)
+       }
+      def self.update(program, params = {}, opts = {}); end
+    end
+  end
+end
+# typed: true
 module Stripe
   module Issuing
     # An issuing token object is created when an issued card is added to a digital wallet. As a [card issuer](https://stripe.com/docs/issuing), you can [view and manage these tokens](https://stripe.com/docs/issuing/controls/token-management) through Stripe.
@@ -42350,6 +42495,172 @@ module Stripe
           @field_remappings = {}
         end
       end
+      class BillingSchedule < ::Stripe::StripeObject
+        class AppliesTo < ::Stripe::StripeObject
+          # The billing schedule will apply to the subscription item with the given price ID.
+          sig { returns(T.nilable(T.any(String, ::Stripe::Price))) }
+          def price; end
+          # Controls which subscription items the billing schedule applies to.
+          sig { returns(String) }
+          def type; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        class BillFrom < ::Stripe::StripeObject
+          class AmendmentStart < ::Stripe::StripeObject
+            # Use an index to specify the position of an amendment to start prebilling with.
+            sig { returns(Integer) }
+            def index; end
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          class LineStartsAt < ::Stripe::StripeObject
+            # Unique identifier for the object.
+            sig { returns(String) }
+            def id; end
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          class Relative < ::Stripe::StripeObject
+            # Specifies billing duration. Possible values are `day`, `week`, `month`, or `year`.
+            sig { returns(String) }
+            def interval; end
+            # The multiplier applied to the interval.
+            sig { returns(T.nilable(Integer)) }
+            def interval_count; end
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # Use an index to specify the position of an amendment to start prebilling with.
+          sig { returns(T.nilable(AmendmentStart)) }
+          def amendment_start; end
+          # The time the billing schedule applies from.
+          sig { returns(T.nilable(Integer)) }
+          def computed_timestamp; end
+          # Lets you bill the period starting from a particular Quote line.
+          sig { returns(T.nilable(LineStartsAt)) }
+          def line_starts_at; end
+          # Timestamp is calculated from the request time.
+          sig { returns(T.nilable(Relative)) }
+          def relative; end
+          # Use a precise Unix timestamp for prebilling to start. Must be earlier than `bill_until`.
+          sig { returns(T.nilable(Integer)) }
+          def timestamp; end
+          # Describes how the billing schedule determines the start date. Possible values are `timestamp`, `relative`, `amendment_start`, `now`, `quote_acceptance_date`, `line_starts_at`, or `pause_collection_start`.
+          sig { returns(String) }
+          def type; end
+          def self.inner_class_types
+            @inner_class_types = {
+              amendment_start: AmendmentStart,
+              line_starts_at: LineStartsAt,
+              relative: Relative,
+            }
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        class BillUntil < ::Stripe::StripeObject
+          class AmendmentEnd < ::Stripe::StripeObject
+            # Use an index to specify the position of an amendment to end prebilling with.
+            sig { returns(Integer) }
+            def index; end
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          class Duration < ::Stripe::StripeObject
+            # Specifies billing duration. Either `day`, `week`, `month` or `year`.
+            sig { returns(String) }
+            def interval; end
+            # The multiplier applied to the interval.
+            sig { returns(T.nilable(Integer)) }
+            def interval_count; end
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          class LineEndsAt < ::Stripe::StripeObject
+            # Unique identifier for the object.
+            sig { returns(String) }
+            def id; end
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # The timestamp the billing schedule will apply until.
+          sig { returns(Integer) }
+          def computed_timestamp; end
+          # Specifies the billing period.
+          sig { returns(T.nilable(Duration)) }
+          def duration; end
+          # If specified, the billing schedule will apply until the specified timestamp.
+          sig { returns(T.nilable(Integer)) }
+          def timestamp; end
+          # Describes how the billing schedule will determine the end date. Either `duration` or `timestamp`.
+          sig { returns(String) }
+          def type; end
+          # Use an index to specify the position of an amendment to end prebilling with.
+          sig { returns(T.nilable(AmendmentEnd)) }
+          def amendment_end; end
+          # Lets you bill the period ending at a particular Quote line.
+          sig { returns(T.nilable(LineEndsAt)) }
+          def line_ends_at; end
+          def self.inner_class_types
+            @inner_class_types = {
+              duration: Duration,
+              amendment_end: AmendmentEnd,
+              line_ends_at: LineEndsAt,
+            }
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Specifies which subscription items the billing schedule applies to.
+        sig { returns(T.nilable(T::Array[AppliesTo])) }
+        def applies_to; end
+        # Specifies the billing period.
+        sig { returns(BillUntil) }
+        def bill_until; end
+        # Unique identifier for the billing schedule.
+        sig { returns(String) }
+        def key; end
+        # Specifies the start of the billing period.
+        sig { returns(T.nilable(BillFrom)) }
+        def bill_from; end
+        def self.inner_class_types
+          @inner_class_types = {applies_to: AppliesTo, bill_until: BillUntil, bill_from: BillFrom}
+        end
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
       class Prebilling < ::Stripe::StripeObject
         # Attribute for field iterations
         sig { returns(Integer) }
@@ -42397,11 +42708,18 @@ module Stripe
       # Integer representing the number of trial period days before the customer is charged for the first time.
       sig { returns(T.nilable(Integer)) }
       def trial_period_days; end
+      # Billing schedules that will be applied to the subscription or subscription schedule created from this quote.
+      sig { returns(T.nilable(T::Array[BillingSchedule])) }
+      def billing_schedules; end
+      # 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.
+      sig { returns(T.nilable(String)) }
+      def phase_effective_at; end
       def self.inner_class_types
         @inner_class_types = {
           bill_on_acceptance: BillOnAcceptance,
           billing_mode: BillingMode,
           prebilling: Prebilling,
+          billing_schedules: BillingSchedule,
         }
       end
       def self.field_remappings
@@ -42519,6 +42837,172 @@ module Stripe
           @field_remappings = {}
         end
       end
+      class BillingSchedule < ::Stripe::StripeObject
+        class AppliesTo < ::Stripe::StripeObject
+          # The billing schedule will apply to the subscription item with the given price ID.
+          sig { returns(T.nilable(T.any(String, ::Stripe::Price))) }
+          def price; end
+          # Controls which subscription items the billing schedule applies to.
+          sig { returns(String) }
+          def type; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        class BillFrom < ::Stripe::StripeObject
+          class AmendmentStart < ::Stripe::StripeObject
+            # Use an index to specify the position of an amendment to start prebilling with.
+            sig { returns(Integer) }
+            def index; end
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          class LineStartsAt < ::Stripe::StripeObject
+            # Unique identifier for the object.
+            sig { returns(String) }
+            def id; end
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          class Relative < ::Stripe::StripeObject
+            # Specifies billing duration. Possible values are `day`, `week`, `month`, or `year`.
+            sig { returns(String) }
+            def interval; end
+            # The multiplier applied to the interval.
+            sig { returns(T.nilable(Integer)) }
+            def interval_count; end
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # Use an index to specify the position of an amendment to start prebilling with.
+          sig { returns(T.nilable(AmendmentStart)) }
+          def amendment_start; end
+          # The time the billing schedule applies from.
+          sig { returns(T.nilable(Integer)) }
+          def computed_timestamp; end
+          # Lets you bill the period starting from a particular Quote line.
+          sig { returns(T.nilable(LineStartsAt)) }
+          def line_starts_at; end
+          # Timestamp is calculated from the request time.
+          sig { returns(T.nilable(Relative)) }
+          def relative; end
+          # Use a precise Unix timestamp for prebilling to start. Must be earlier than `bill_until`.
+          sig { returns(T.nilable(Integer)) }
+          def timestamp; end
+          # Describes how the billing schedule determines the start date. Possible values are `timestamp`, `relative`, `amendment_start`, `now`, `quote_acceptance_date`, `line_starts_at`, or `pause_collection_start`.
+          sig { returns(String) }
+          def type; end
+          def self.inner_class_types
+            @inner_class_types = {
+              amendment_start: AmendmentStart,
+              line_starts_at: LineStartsAt,
+              relative: Relative,
+            }
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        class BillUntil < ::Stripe::StripeObject
+          class AmendmentEnd < ::Stripe::StripeObject
+            # Use an index to specify the position of an amendment to end prebilling with.
+            sig { returns(Integer) }
+            def index; end
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          class Duration < ::Stripe::StripeObject
+            # Specifies billing duration. Either `day`, `week`, `month` or `year`.
+            sig { returns(String) }
+            def interval; end
+            # The multiplier applied to the interval.
+            sig { returns(T.nilable(Integer)) }
+            def interval_count; end
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          class LineEndsAt < ::Stripe::StripeObject
+            # Unique identifier for the object.
+            sig { returns(String) }
+            def id; end
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # The timestamp the billing schedule will apply until.
+          sig { returns(Integer) }
+          def computed_timestamp; end
+          # Specifies the billing period.
+          sig { returns(T.nilable(Duration)) }
+          def duration; end
+          # If specified, the billing schedule will apply until the specified timestamp.
+          sig { returns(T.nilable(Integer)) }
+          def timestamp; end
+          # Describes how the billing schedule will determine the end date. Either `duration` or `timestamp`.
+          sig { returns(String) }
+          def type; end
+          # Use an index to specify the position of an amendment to end prebilling with.
+          sig { returns(T.nilable(AmendmentEnd)) }
+          def amendment_end; end
+          # Lets you bill the period ending at a particular Quote line.
+          sig { returns(T.nilable(LineEndsAt)) }
+          def line_ends_at; end
+          def self.inner_class_types
+            @inner_class_types = {
+              duration: Duration,
+              amendment_end: AmendmentEnd,
+              line_ends_at: LineEndsAt,
+            }
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Specifies which subscription items the billing schedule applies to.
+        sig { returns(T.nilable(T::Array[AppliesTo])) }
+        def applies_to; end
+        # Specifies the billing period.
+        sig { returns(BillUntil) }
+        def bill_until; end
+        # Unique identifier for the billing schedule.
+        sig { returns(String) }
+        def key; end
+        # Specifies the start of the billing period.
+        sig { returns(T.nilable(BillFrom)) }
+        def bill_from; end
+        def self.inner_class_types
+          @inner_class_types = {applies_to: AppliesTo, bill_until: BillUntil, bill_from: BillFrom}
+        end
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
       # Attribute for field applies_to
       sig { returns(AppliesTo) }
       def applies_to; end
@@ -42540,8 +43024,18 @@ module Stripe
       # Determines how to handle [prorations](https://stripe.com/docs/subscriptions/billing-cycle#prorations) when the quote is accepted.
       sig { returns(T.nilable(String)) }
       def proration_behavior; end
+      # Billing schedules that will be applied to the subscription or subscription schedule created from this quote.
+      sig { returns(T.nilable(T::Array[BillingSchedule])) }
+      def billing_schedules; end
+      # 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.
+      sig { returns(T.nilable(String)) }
+      def phase_effective_at; end
       def self.inner_class_types
-        @inner_class_types = {applies_to: AppliesTo, bill_on_acceptance: BillOnAcceptance}
+        @inner_class_types = {
+          applies_to: AppliesTo,
+          bill_on_acceptance: BillOnAcceptance,
+          billing_schedules: BillingSchedule,
+        }
       end
       def self.field_remappings
         @field_remappings = {}
@@ -43323,6 +43817,17 @@ module Stripe
           @field_remappings = {}
         end
       end
+      class ScheduleDetails < ::Stripe::StripeObject
+        # The schedule that generated this invoice
+        sig { returns(String) }
+        def schedule; end
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
       class SubscriptionDetails < ::Stripe::StripeObject
         class PauseCollection < ::Stripe::StripeObject
           # The payment collection behavior for this subscription while paused. One of `keep_as_draft`, `mark_uncollectible`, or `void`.
@@ -43370,11 +43875,15 @@ module Stripe
       # The type of parent that generated this invoice
       sig { returns(String) }
       def type; end
+      # Details about the schedule that generated this invoice
+      sig { returns(T.nilable(ScheduleDetails)) }
+      def schedule_details; end
       def self.inner_class_types
         @inner_class_types = {
           billing_cadence_details: BillingCadenceDetails,
           quote_details: QuoteDetails,
           subscription_details: SubscriptionDetails,
+          schedule_details: ScheduleDetails,
         }
       end
       def self.field_remappings
@@ -44348,6 +44857,9 @@ module Stripe
       # The account (if any) the associated subscription's payments will be attributed to for tax reporting, and where funds from each payment will be transferred to for each of the subscription's invoices.
       sig { returns(T.nilable(TransferData)) }
       def transfer_data; end
+      # 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.
+      sig { returns(T.nilable(String)) }
+      def phase_effective_at; end
       def self.inner_class_types
         @inner_class_types = {
           automatic_tax: AutomaticTax,
@@ -44852,6 +45364,172 @@ module Stripe
         @field_remappings = {}
       end
     end
+    class BillingSchedule < ::Stripe::StripeObject
+      class AppliesTo < ::Stripe::StripeObject
+        # The billing schedule will apply to the subscription item with the given price ID.
+        sig { returns(T.nilable(T.any(String, ::Stripe::Price))) }
+        def price; end
+        # Controls which subscription items the billing schedule applies to.
+        sig { returns(String) }
+        def type; end
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+      class BillFrom < ::Stripe::StripeObject
+        class AmendmentStart < ::Stripe::StripeObject
+          # Use an index to specify the position of an amendment to start prebilling with.
+          sig { returns(Integer) }
+          def index; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        class LineStartsAt < ::Stripe::StripeObject
+          # Unique identifier for the object.
+          sig { returns(String) }
+          def id; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        class Relative < ::Stripe::StripeObject
+          # Specifies billing duration. Possible values are `day`, `week`, `month`, or `year`.
+          sig { returns(String) }
+          def interval; end
+          # The multiplier applied to the interval.
+          sig { returns(T.nilable(Integer)) }
+          def interval_count; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Use an index to specify the position of an amendment to start prebilling with.
+        sig { returns(T.nilable(AmendmentStart)) }
+        def amendment_start; end
+        # The time the billing schedule applies from.
+        sig { returns(T.nilable(Integer)) }
+        def computed_timestamp; end
+        # Lets you bill the period starting from a particular Quote line.
+        sig { returns(T.nilable(LineStartsAt)) }
+        def line_starts_at; end
+        # Timestamp is calculated from the request time.
+        sig { returns(T.nilable(Relative)) }
+        def relative; end
+        # Use a precise Unix timestamp for prebilling to start. Must be earlier than `bill_until`.
+        sig { returns(T.nilable(Integer)) }
+        def timestamp; end
+        # Describes how the billing schedule determines the start date. Possible values are `timestamp`, `relative`, `amendment_start`, `now`, `quote_acceptance_date`, `line_starts_at`, or `pause_collection_start`.
+        sig { returns(String) }
+        def type; end
+        def self.inner_class_types
+          @inner_class_types = {
+            amendment_start: AmendmentStart,
+            line_starts_at: LineStartsAt,
+            relative: Relative,
+          }
+        end
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+      class BillUntil < ::Stripe::StripeObject
+        class AmendmentEnd < ::Stripe::StripeObject
+          # Use an index to specify the position of an amendment to end prebilling with.
+          sig { returns(Integer) }
+          def index; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        class Duration < ::Stripe::StripeObject
+          # Specifies billing duration. Either `day`, `week`, `month` or `year`.
+          sig { returns(String) }
+          def interval; end
+          # The multiplier applied to the interval.
+          sig { returns(T.nilable(Integer)) }
+          def interval_count; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        class LineEndsAt < ::Stripe::StripeObject
+          # Unique identifier for the object.
+          sig { returns(String) }
+          def id; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # The timestamp the billing schedule will apply until.
+        sig { returns(Integer) }
+        def computed_timestamp; end
+        # Specifies the billing period.
+        sig { returns(T.nilable(Duration)) }
+        def duration; end
+        # If specified, the billing schedule will apply until the specified timestamp.
+        sig { returns(T.nilable(Integer)) }
+        def timestamp; end
+        # Describes how the billing schedule will determine the end date. Either `duration` or `timestamp`.
+        sig { returns(String) }
+        def type; end
+        # Use an index to specify the position of an amendment to end prebilling with.
+        sig { returns(T.nilable(AmendmentEnd)) }
+        def amendment_end; end
+        # Lets you bill the period ending at a particular Quote line.
+        sig { returns(T.nilable(LineEndsAt)) }
+        def line_ends_at; end
+        def self.inner_class_types
+          @inner_class_types = {
+            duration: Duration,
+            amendment_end: AmendmentEnd,
+            line_ends_at: LineEndsAt,
+          }
+        end
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+      # Specifies which subscription items the billing schedule applies to.
+      sig { returns(T.nilable(T::Array[AppliesTo])) }
+      def applies_to; end
+      # Specifies the billing period.
+      sig { returns(BillUntil) }
+      def bill_until; end
+      # Unique identifier for the billing schedule.
+      sig { returns(String) }
+      def key; end
+      # Specifies the start of the billing period.
+      sig { returns(T.nilable(BillFrom)) }
+      def bill_from; end
+      def self.inner_class_types
+        @inner_class_types = {applies_to: AppliesTo, bill_until: BillUntil, bill_from: BillFrom}
+      end
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
     # ID of the Connect Application that created the schedule.
     sig { returns(T.nilable(T.any(String, ::Stripe::Application))) }
     def application; end
@@ -44924,6 +45602,12 @@ module Stripe
     # ID of the test clock this subscription schedule belongs to.
     sig { returns(T.nilable(T.any(String, ::Stripe::TestHelpers::TestClock))) }
     def test_clock; end
+    # Billing schedules for this subscription schedule.
+    sig { returns(T.nilable(T::Array[BillingSchedule])) }
+    def billing_schedules; end
+    # The most recent invoice this subscription schedule has generated.
+    sig { returns(T.nilable(T.any(String, ::Stripe::Invoice))) }
+    def latest_invoice; end
   end
 end
 # typed: true
@@ -49394,6 +50078,9 @@ module Stripe
       # The account (if any) the associated subscription's payments will be attributed to for tax reporting, and where funds from each payment will be transferred to for each of the subscription's invoices.
       sig { returns(T.nilable(TransferData)) }
       def transfer_data; end
+      # 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.
+      sig { returns(T.nilable(String)) }
+      def phase_effective_at; end
       def self.inner_class_types
         @inner_class_types = {
           automatic_tax: AutomaticTax,
@@ -49898,6 +50585,172 @@ module Stripe
         @field_remappings = {}
       end
     end
+    class BillingSchedule < ::Stripe::StripeObject
+      class AppliesTo < ::Stripe::StripeObject
+        # The billing schedule will apply to the subscription item with the given price ID.
+        sig { returns(T.nilable(T.any(String, ::Stripe::Price))) }
+        def price; end
+        # Controls which subscription items the billing schedule applies to.
+        sig { returns(String) }
+        def type; end
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+      class BillFrom < ::Stripe::StripeObject
+        class AmendmentStart < ::Stripe::StripeObject
+          # Use an index to specify the position of an amendment to start prebilling with.
+          sig { returns(Integer) }
+          def index; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        class LineStartsAt < ::Stripe::StripeObject
+          # Unique identifier for the object.
+          sig { returns(String) }
+          def id; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        class Relative < ::Stripe::StripeObject
+          # Specifies billing duration. Possible values are `day`, `week`, `month`, or `year`.
+          sig { returns(String) }
+          def interval; end
+          # The multiplier applied to the interval.
+          sig { returns(T.nilable(Integer)) }
+          def interval_count; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Use an index to specify the position of an amendment to start prebilling with.
+        sig { returns(T.nilable(AmendmentStart)) }
+        def amendment_start; end
+        # The time the billing schedule applies from.
+        sig { returns(T.nilable(Integer)) }
+        def computed_timestamp; end
+        # Lets you bill the period starting from a particular Quote line.
+        sig { returns(T.nilable(LineStartsAt)) }
+        def line_starts_at; end
+        # Timestamp is calculated from the request time.
+        sig { returns(T.nilable(Relative)) }
+        def relative; end
+        # Use a precise Unix timestamp for prebilling to start. Must be earlier than `bill_until`.
+        sig { returns(T.nilable(Integer)) }
+        def timestamp; end
+        # Describes how the billing schedule determines the start date. Possible values are `timestamp`, `relative`, `amendment_start`, `now`, `quote_acceptance_date`, `line_starts_at`, or `pause_collection_start`.
+        sig { returns(String) }
+        def type; end
+        def self.inner_class_types
+          @inner_class_types = {
+            amendment_start: AmendmentStart,
+            line_starts_at: LineStartsAt,
+            relative: Relative,
+          }
+        end
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+      class BillUntil < ::Stripe::StripeObject
+        class AmendmentEnd < ::Stripe::StripeObject
+          # Use an index to specify the position of an amendment to end prebilling with.
+          sig { returns(Integer) }
+          def index; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        class Duration < ::Stripe::StripeObject
+          # Specifies billing duration. Either `day`, `week`, `month` or `year`.
+          sig { returns(String) }
+          def interval; end
+          # The multiplier applied to the interval.
+          sig { returns(T.nilable(Integer)) }
+          def interval_count; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        class LineEndsAt < ::Stripe::StripeObject
+          # Unique identifier for the object.
+          sig { returns(String) }
+          def id; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # The timestamp the billing schedule will apply until.
+        sig { returns(Integer) }
+        def computed_timestamp; end
+        # Specifies the billing period.
+        sig { returns(T.nilable(Duration)) }
+        def duration; end
+        # If specified, the billing schedule will apply until the specified timestamp.
+        sig { returns(T.nilable(Integer)) }
+        def timestamp; end
+        # Describes how the billing schedule will determine the end date. Either `duration` or `timestamp`.
+        sig { returns(String) }
+        def type; end
+        # Use an index to specify the position of an amendment to end prebilling with.
+        sig { returns(T.nilable(AmendmentEnd)) }
+        def amendment_end; end
+        # Lets you bill the period ending at a particular Quote line.
+        sig { returns(T.nilable(LineEndsAt)) }
+        def line_ends_at; end
+        def self.inner_class_types
+          @inner_class_types = {
+            duration: Duration,
+            amendment_end: AmendmentEnd,
+            line_ends_at: LineEndsAt,
+          }
+        end
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+      # Specifies which subscription items the billing schedule applies to.
+      sig { returns(T.nilable(T::Array[AppliesTo])) }
+      def applies_to; end
+      # Specifies the billing period.
+      sig { returns(BillUntil) }
+      def bill_until; end
+      # Unique identifier for the billing schedule.
+      sig { returns(String) }
+      def key; end
+      # Specifies the start of the billing period.
+      sig { returns(T.nilable(BillFrom)) }
+      def bill_from; end
+      def self.inner_class_types
+        @inner_class_types = {applies_to: AppliesTo, bill_until: BillUntil, bill_from: BillFrom}
+      end
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
     # ID of the Connect Application that created the schedule.
     sig { returns(T.nilable(T.any(String, ::Stripe::Application))) }
     def application; end
@@ -49967,6 +50820,12 @@ module Stripe
     # ID of the test clock this subscription schedule belongs to.
     sig { returns(T.nilable(T.any(String, ::Stripe::TestHelpers::TestClock))) }
     def test_clock; end
+    # Billing schedules for this subscription schedule.
+    sig { returns(T.nilable(T::Array[BillingSchedule])) }
+    def billing_schedules; end
+    # The most recent invoice this subscription schedule has generated.
+    sig { returns(T.nilable(T.any(String, ::Stripe::Invoice))) }
+    def latest_invoice; end
     # Amends an existing subscription schedule.
     sig {
       params(params: T.any(::Stripe::SubscriptionScheduleAmendParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(::Stripe::SubscriptionSchedule)
@@ -50125,7 +50984,84 @@ module Stripe
           @field_remappings = {}
         end
       end
+      class BillFrom < ::Stripe::StripeObject
+        class AmendmentStart < ::Stripe::StripeObject
+          # Use an index to specify the position of an amendment to start prebilling with.
+          sig { returns(Integer) }
+          def index; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        class LineStartsAt < ::Stripe::StripeObject
+          # Unique identifier for the object.
+          sig { returns(String) }
+          def id; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        class Relative < ::Stripe::StripeObject
+          # Specifies billing duration. Possible values are `day`, `week`, `month`, or `year`.
+          sig { returns(String) }
+          def interval; end
+          # The multiplier applied to the interval.
+          sig { returns(T.nilable(Integer)) }
+          def interval_count; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Use an index to specify the position of an amendment to start prebilling with.
+        sig { returns(T.nilable(AmendmentStart)) }
+        def amendment_start; end
+        # The time the billing schedule applies from.
+        sig { returns(T.nilable(Integer)) }
+        def computed_timestamp; end
+        # Lets you bill the period starting from a particular Quote line.
+        sig { returns(T.nilable(LineStartsAt)) }
+        def line_starts_at; end
+        # Timestamp is calculated from the request time.
+        sig { returns(T.nilable(Relative)) }
+        def relative; end
+        # Use a precise Unix timestamp for prebilling to start. Must be earlier than `bill_until`.
+        sig { returns(T.nilable(Integer)) }
+        def timestamp; end
+        # Describes how the billing schedule determines the start date. Possible values are `timestamp`, `relative`, `amendment_start`, `now`, `quote_acceptance_date`, `line_starts_at`, or `pause_collection_start`.
+        sig { returns(String) }
+        def type; end
+        def self.inner_class_types
+          @inner_class_types = {
+            amendment_start: AmendmentStart,
+            line_starts_at: LineStartsAt,
+            relative: Relative,
+          }
+        end
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
       class BillUntil < ::Stripe::StripeObject
+        class AmendmentEnd < ::Stripe::StripeObject
+          # Use an index to specify the position of an amendment to end prebilling with.
+          sig { returns(Integer) }
+          def index; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
         class Duration < ::Stripe::StripeObject
           # Specifies billing duration. Either `day`, `week`, `month` or `year`.
           sig { returns(String) }
@@ -50140,6 +51076,17 @@ module Stripe
             @field_remappings = {}
           end
         end
+        class LineEndsAt < ::Stripe::StripeObject
+          # Unique identifier for the object.
+          sig { returns(String) }
+          def id; end
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
         # The timestamp the billing schedule will apply until.
         sig { returns(Integer) }
         def computed_timestamp; end
@@ -50152,8 +51099,18 @@ module Stripe
         # Describes how the billing schedule will determine the end date. Either `duration` or `timestamp`.
         sig { returns(String) }
         def type; end
+        # Use an index to specify the position of an amendment to end prebilling with.
+        sig { returns(T.nilable(AmendmentEnd)) }
+        def amendment_end; end
+        # Lets you bill the period ending at a particular Quote line.
+        sig { returns(T.nilable(LineEndsAt)) }
+        def line_ends_at; end
         def self.inner_class_types
-          @inner_class_types = {duration: Duration}
+          @inner_class_types = {
+            duration: Duration,
+            amendment_end: AmendmentEnd,
+            line_ends_at: LineEndsAt,
+          }
         end
         def self.field_remappings
           @field_remappings = {}
@@ -50168,8 +51125,11 @@ module Stripe
       # Unique identifier for the billing schedule.
       sig { returns(String) }
       def key; end
+      # Specifies the start of the billing period.
+      sig { returns(T.nilable(BillFrom)) }
+      def bill_from; end
       def self.inner_class_types
-        @inner_class_types = {applies_to: AppliesTo, bill_until: BillUntil}
+        @inner_class_types = {applies_to: AppliesTo, bill_until: BillUntil, bill_from: BillFrom}
       end
       def self.field_remappings
         @field_remappings = {}
@@ -70155,37 +71115,6 @@ module Stripe
   end
 end
 # typed: true
-module Stripe
-  module V2
-    module Tax
-      # An AutomaticRule holds automatic Tax configuration for a BillableItem.
-      class AutomaticRule < APIResource
-        # The ID of the BillableItem.
-        sig { returns(String) }
-        def billable_item; end
-        # The time at which the AutomaticRule object was created.
-        sig { returns(String) }
-        def created; end
-        # The ID of the AutomaticRule object.
-        sig { returns(String) }
-        def id; end
-        # String representing the object's type. Objects of the same type share the same value of the object field.
-        sig { returns(String) }
-        def object; end
-        # The status of the AutomaticRule object.
-        sig { returns(String) }
-        def status; end
-        # A TaxCode object that will be used for automatic tax calculations.
-        sig { returns(String) }
-        def tax_code; end
-        # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
-        sig { returns(T::Boolean) }
-        def livemode; end
-      end
-    end
-  end
-end
-# typed: true
 module Stripe
   class V1Services < StripeService
     attr_reader :accounts
@@ -72407,6 +73336,7 @@ module Stripe
     attr_reader :fraud_liability_debits
     attr_reader :personalization_designs
     attr_reader :physical_bundles
+    attr_reader :programs
     attr_reader :tokens
     attr_reader :transactions
   end
@@ -72672,6 +73602,36 @@ module Stripe
   end
 end
 # typed: true
+module Stripe
+  module Issuing
+    class ProgramService < StripeService
+      # Create a Program object.
+      sig {
+        params(params: T.any(::Stripe::Issuing::ProgramCreateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(::Stripe::Issuing::Program)
+       }
+      def create(params = {}, opts = {}); end
+
+      # List all of the programs the given Issuing user has access to.
+      sig {
+        params(params: T.any(::Stripe::Issuing::ProgramListParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(::Stripe::ListObject)
+       }
+      def list(params = {}, opts = {}); end
+
+      # Retrieves the program specified by the given id.
+      sig {
+        params(program: String, params: T.any(::Stripe::Issuing::ProgramRetrieveParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(::Stripe::Issuing::Program)
+       }
+      def retrieve(program, params = {}, opts = {}); end
+
+      # Updates a Program object.
+      sig {
+        params(program: String, params: T.any(::Stripe::Issuing::ProgramUpdateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(::Stripe::Issuing::Program)
+       }
+      def update(program, params = {}, opts = {}); end
+    end
+  end
+end
+# typed: true
 module Stripe
   module Issuing
     class TokenService < StripeService
@@ -75552,7 +76512,6 @@ module Stripe
     attr_reader :money_management
     attr_reader :payments
     attr_reader :reporting
-    attr_reader :tax
     attr_reader :test_helpers
   end
 end
@@ -77238,52 +78197,6 @@ module Stripe
   end
 end
 # typed: true
-module Stripe
-  module V2
-    class TaxService < StripeService
-      attr_reader :automatic_rules
-    end
-  end
-end
-# typed: true
-module Stripe
-  module V2
-    module Tax
-      class AutomaticRuleService < StripeService
-        # Creates an AutomaticRule object.
-        sig {
-          params(params: T.any(::Stripe::V2::Tax::AutomaticRuleCreateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(::Stripe::V2::Tax::AutomaticRule)
-         }
-        def create(params = {}, opts = {}); end
-
-        # Deactivates an AutomaticRule object. Deactivated AutomaticRule objects are ignored in future tax calculations.
-        sig {
-          params(id: String, params: T.any(::Stripe::V2::Tax::AutomaticRuleDeactivateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(::Stripe::V2::Tax::AutomaticRule)
-         }
-        def deactivate(id, params = {}, opts = {}); end
-
-        # Finds an AutomaticRule object by BillableItem ID.
-        sig {
-          params(params: T.any(::Stripe::V2::Tax::AutomaticRuleFindParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(::Stripe::V2::Tax::AutomaticRule)
-         }
-        def find(params = {}, opts = {}); end
-
-        # Retrieves an AutomaticRule object by ID.
-        sig {
-          params(id: String, params: T.any(::Stripe::V2::Tax::AutomaticRuleRetrieveParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(::Stripe::V2::Tax::AutomaticRule)
-         }
-        def retrieve(id, params = {}, opts = {}); end
-
-        # Updates the automatic Tax configuration for an AutomaticRule object.
-        sig {
-          params(id: String, params: T.any(::Stripe::V2::Tax::AutomaticRuleUpdateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(::Stripe::V2::Tax::AutomaticRule)
-         }
-        def update(id, params = {}, opts = {}); end
-      end
-    end
-  end
-end
-# typed: true
 module Stripe
   module V2
     class TestHelperService < StripeService
@@ -81302,6 +82215,34 @@ module Stripe
           title: nil
         ); end
       end
+      class SelfReportedIncome < ::Stripe::RequestParams
+        # Attribute for param field amount
+        sig { returns(Integer) }
+        def amount; end
+        sig { params(_amount: Integer).returns(Integer) }
+        def amount=(_amount); end
+        # Attribute for param field currency
+        sig { returns(String) }
+        def currency; end
+        sig { params(_currency: String).returns(String) }
+        def currency=(_currency); end
+        sig { params(amount: Integer, currency: String).void }
+        def initialize(amount: nil, currency: nil); end
+      end
+      class SelfReportedMonthlyHousingPayment < ::Stripe::RequestParams
+        # Attribute for param field amount
+        sig { returns(Integer) }
+        def amount; end
+        sig { params(_amount: Integer).returns(Integer) }
+        def amount=(_amount); end
+        # Attribute for param field currency
+        sig { returns(String) }
+        def currency; end
+        sig { params(_currency: String).returns(String) }
+        def currency=(_currency); end
+        sig { params(amount: Integer, currency: String).void }
+        def initialize(amount: nil, currency: nil); end
+      end
       class Verification < ::Stripe::RequestParams
         class AdditionalDocument < ::Stripe::RequestParams
           # The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.
@@ -81485,8 +82426,22 @@ module Stripe
         params(_verification: T.nilable(AccountUpdateParams::Individual::Verification)).returns(T.nilable(AccountUpdateParams::Individual::Verification))
        }
       def verification=(_verification); end
+      # The credit applicant's self-reported yearly income in minor units.
+      sig { returns(T.nilable(AccountUpdateParams::Individual::SelfReportedIncome)) }
+      def self_reported_income; end
       sig {
-        params(address: T.nilable(AccountUpdateParams::Individual::Address), address_kana: T.nilable(AccountUpdateParams::Individual::AddressKana), address_kanji: T.nilable(AccountUpdateParams::Individual::AddressKanji), dob: T.nilable(T.any(String, AccountUpdateParams::Individual::Dob)), email: T.nilable(String), first_name: T.nilable(String), first_name_kana: T.nilable(String), first_name_kanji: T.nilable(String), full_name_aliases: T.nilable(T.any(String, T::Array[String])), gender: T.nilable(String), id_number: T.nilable(String), id_number_secondary: T.nilable(String), last_name: T.nilable(String), last_name_kana: T.nilable(String), last_name_kanji: T.nilable(String), maiden_name: T.nilable(String), metadata: T.nilable(T.any(String, T::Hash[String, String])), phone: T.nilable(String), political_exposure: T.nilable(String), registered_address: T.nilable(AccountUpdateParams::Individual::RegisteredAddress), relationship: T.nilable(AccountUpdateParams::Individual::Relationship), ssn_last_4: T.nilable(String), verification: T.nilable(AccountUpdateParams::Individual::Verification)).void
+        params(_self_reported_income: T.nilable(AccountUpdateParams::Individual::SelfReportedIncome)).returns(T.nilable(AccountUpdateParams::Individual::SelfReportedIncome))
+       }
+      def self_reported_income=(_self_reported_income); end
+      # The credit applicant's self-reported monthly housing payment in minor units.
+      sig { returns(T.nilable(AccountUpdateParams::Individual::SelfReportedMonthlyHousingPayment)) }
+      def self_reported_monthly_housing_payment; end
+      sig {
+        params(_self_reported_monthly_housing_payment: T.nilable(AccountUpdateParams::Individual::SelfReportedMonthlyHousingPayment)).returns(T.nilable(AccountUpdateParams::Individual::SelfReportedMonthlyHousingPayment))
+       }
+      def self_reported_monthly_housing_payment=(_self_reported_monthly_housing_payment); end
+      sig {
+        params(address: T.nilable(AccountUpdateParams::Individual::Address), address_kana: T.nilable(AccountUpdateParams::Individual::AddressKana), address_kanji: T.nilable(AccountUpdateParams::Individual::AddressKanji), dob: T.nilable(T.any(String, AccountUpdateParams::Individual::Dob)), email: T.nilable(String), first_name: T.nilable(String), first_name_kana: T.nilable(String), first_name_kanji: T.nilable(String), full_name_aliases: T.nilable(T.any(String, T::Array[String])), gender: T.nilable(String), id_number: T.nilable(String), id_number_secondary: T.nilable(String), last_name: T.nilable(String), last_name_kana: T.nilable(String), last_name_kanji: T.nilable(String), maiden_name: T.nilable(String), metadata: T.nilable(T.any(String, T::Hash[String, String])), phone: T.nilable(String), political_exposure: T.nilable(String), registered_address: T.nilable(AccountUpdateParams::Individual::RegisteredAddress), relationship: T.nilable(AccountUpdateParams::Individual::Relationship), ssn_last_4: T.nilable(String), verification: T.nilable(AccountUpdateParams::Individual::Verification), self_reported_income: T.nilable(AccountUpdateParams::Individual::SelfReportedIncome), self_reported_monthly_housing_payment: T.nilable(AccountUpdateParams::Individual::SelfReportedMonthlyHousingPayment)).void
        }
       def initialize(
         address: nil,
@@ -81511,7 +82466,9 @@ module Stripe
         registered_address: nil,
         relationship: nil,
         ssn_last_4: nil,
-        verification: nil
+        verification: nil,
+        self_reported_income: nil,
+        self_reported_monthly_housing_payment: nil
       ); end
     end
     class RiskControls < ::Stripe::RequestParams
@@ -84732,6 +85689,34 @@ module Stripe
           title: nil
         ); end
       end
+      class SelfReportedIncome < ::Stripe::RequestParams
+        # Attribute for param field amount
+        sig { returns(Integer) }
+        def amount; end
+        sig { params(_amount: Integer).returns(Integer) }
+        def amount=(_amount); end
+        # Attribute for param field currency
+        sig { returns(String) }
+        def currency; end
+        sig { params(_currency: String).returns(String) }
+        def currency=(_currency); end
+        sig { params(amount: Integer, currency: String).void }
+        def initialize(amount: nil, currency: nil); end
+      end
+      class SelfReportedMonthlyHousingPayment < ::Stripe::RequestParams
+        # Attribute for param field amount
+        sig { returns(Integer) }
+        def amount; end
+        sig { params(_amount: Integer).returns(Integer) }
+        def amount=(_amount); end
+        # Attribute for param field currency
+        sig { returns(String) }
+        def currency; end
+        sig { params(_currency: String).returns(String) }
+        def currency=(_currency); end
+        sig { params(amount: Integer, currency: String).void }
+        def initialize(amount: nil, currency: nil); end
+      end
       class Verification < ::Stripe::RequestParams
         class AdditionalDocument < ::Stripe::RequestParams
           # The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.
@@ -84915,8 +85900,22 @@ module Stripe
         params(_verification: T.nilable(AccountCreateParams::Individual::Verification)).returns(T.nilable(AccountCreateParams::Individual::Verification))
        }
       def verification=(_verification); end
+      # The credit applicant's self-reported yearly income in minor units.
+      sig { returns(T.nilable(AccountCreateParams::Individual::SelfReportedIncome)) }
+      def self_reported_income; end
+      sig {
+        params(_self_reported_income: T.nilable(AccountCreateParams::Individual::SelfReportedIncome)).returns(T.nilable(AccountCreateParams::Individual::SelfReportedIncome))
+       }
+      def self_reported_income=(_self_reported_income); end
+      # The credit applicant's self-reported monthly housing payment in minor units.
+      sig { returns(T.nilable(AccountCreateParams::Individual::SelfReportedMonthlyHousingPayment)) }
+      def self_reported_monthly_housing_payment; end
       sig {
-        params(address: T.nilable(AccountCreateParams::Individual::Address), address_kana: T.nilable(AccountCreateParams::Individual::AddressKana), address_kanji: T.nilable(AccountCreateParams::Individual::AddressKanji), dob: T.nilable(T.any(String, AccountCreateParams::Individual::Dob)), email: T.nilable(String), first_name: T.nilable(String), first_name_kana: T.nilable(String), first_name_kanji: T.nilable(String), full_name_aliases: T.nilable(T.any(String, T::Array[String])), gender: T.nilable(String), id_number: T.nilable(String), id_number_secondary: T.nilable(String), last_name: T.nilable(String), last_name_kana: T.nilable(String), last_name_kanji: T.nilable(String), maiden_name: T.nilable(String), metadata: T.nilable(T.any(String, T::Hash[String, String])), phone: T.nilable(String), political_exposure: T.nilable(String), registered_address: T.nilable(AccountCreateParams::Individual::RegisteredAddress), relationship: T.nilable(AccountCreateParams::Individual::Relationship), ssn_last_4: T.nilable(String), verification: T.nilable(AccountCreateParams::Individual::Verification)).void
+        params(_self_reported_monthly_housing_payment: T.nilable(AccountCreateParams::Individual::SelfReportedMonthlyHousingPayment)).returns(T.nilable(AccountCreateParams::Individual::SelfReportedMonthlyHousingPayment))
+       }
+      def self_reported_monthly_housing_payment=(_self_reported_monthly_housing_payment); end
+      sig {
+        params(address: T.nilable(AccountCreateParams::Individual::Address), address_kana: T.nilable(AccountCreateParams::Individual::AddressKana), address_kanji: T.nilable(AccountCreateParams::Individual::AddressKanji), dob: T.nilable(T.any(String, AccountCreateParams::Individual::Dob)), email: T.nilable(String), first_name: T.nilable(String), first_name_kana: T.nilable(String), first_name_kanji: T.nilable(String), full_name_aliases: T.nilable(T.any(String, T::Array[String])), gender: T.nilable(String), id_number: T.nilable(String), id_number_secondary: T.nilable(String), last_name: T.nilable(String), last_name_kana: T.nilable(String), last_name_kanji: T.nilable(String), maiden_name: T.nilable(String), metadata: T.nilable(T.any(String, T::Hash[String, String])), phone: T.nilable(String), political_exposure: T.nilable(String), registered_address: T.nilable(AccountCreateParams::Individual::RegisteredAddress), relationship: T.nilable(AccountCreateParams::Individual::Relationship), ssn_last_4: T.nilable(String), verification: T.nilable(AccountCreateParams::Individual::Verification), self_reported_income: T.nilable(AccountCreateParams::Individual::SelfReportedIncome), self_reported_monthly_housing_payment: T.nilable(AccountCreateParams::Individual::SelfReportedMonthlyHousingPayment)).void
        }
       def initialize(
         address: nil,
@@ -84941,7 +85940,9 @@ module Stripe
         registered_address: nil,
         relationship: nil,
         ssn_last_4: nil,
-        verification: nil
+        verification: nil,
+        self_reported_income: nil,
+        self_reported_monthly_housing_payment: nil
       ); end
     end
     class RiskControls < ::Stripe::RequestParams
@@ -88466,7 +89467,7 @@ end
 module Stripe
   module Capital
     class FinancingOfferCreateParams < ::Stripe::RequestParams
-      # Attribute for param field advance_amount
+      # Amount of financing offered, in minor units. For example, 1,000 USD is represented as 100000.
       sig { returns(Integer) }
       def advance_amount; end
       sig { params(_advance_amount: Integer).returns(Integer) }
@@ -88476,22 +89477,22 @@ module Stripe
       def expand; end
       sig { params(_expand: T.nilable(T::Array[String])).returns(T.nilable(T::Array[String])) }
       def expand=(_expand); end
-      # Attribute for param field fee_amount
+      # Fixed fee amount, in minor units. For example, 100 USD is represented as 10000.
       sig { returns(Integer) }
       def fee_amount; end
       sig { params(_fee_amount: Integer).returns(Integer) }
       def fee_amount=(_fee_amount); end
-      # Attribute for param field financing_type
+      # The type of financing offer.
       sig { returns(String) }
       def financing_type; end
       sig { params(_financing_type: String).returns(String) }
       def financing_type=(_financing_type); end
-      # Attribute for param field status
+      # The status of the financing offer.
       sig { returns(T.nilable(String)) }
       def status; end
       sig { params(_status: T.nilable(String)).returns(T.nilable(String)) }
       def status=(_status); end
-      # Attribute for param field withhold_rate
+      # Per-transaction rate at which Stripe withholds funds to repay the financing.
       sig { returns(Float) }
       def withhold_rate; end
       sig { params(_withhold_rate: Float).returns(Float) }
@@ -88514,7 +89515,7 @@ end
 module Stripe
   module Capital
     class FinancingOfferRefillParams < ::Stripe::RequestParams
-      # Attribute for param field advance_amount
+      # Amount of financing offered, in minor units. For example, 1,000 USD is represented as 100000.
       sig { returns(Integer) }
       def advance_amount; end
       sig { params(_advance_amount: Integer).returns(Integer) }
@@ -88524,22 +89525,22 @@ module Stripe
       def expand; end
       sig { params(_expand: T.nilable(T::Array[String])).returns(T.nilable(T::Array[String])) }
       def expand=(_expand); end
-      # Attribute for param field fee_amount
+      # Fixed fee amount, in minor units. For example, 100 USD is represented as 10000.
       sig { returns(Integer) }
       def fee_amount; end
       sig { params(_fee_amount: Integer).returns(Integer) }
       def fee_amount=(_fee_amount); end
-      # Attribute for param field financing_type
+      # The type of financing offer
       sig { returns(String) }
       def financing_type; end
       sig { params(_financing_type: String).returns(String) }
       def financing_type=(_financing_type); end
-      # Attribute for param field status
+      # The status of the financing offer
       sig { returns(T.nilable(String)) }
       def status; end
       sig { params(_status: T.nilable(String)).returns(T.nilable(String)) }
       def status=(_status); end
-      # Attribute for param field withhold_rate
+      # Per-transaction rate at which Stripe withholds funds to repay the financing.
       sig { returns(Float) }
       def withhold_rate; end
       sig { params(_withhold_rate: Float).returns(Float) }
@@ -100116,7 +101117,7 @@ module Stripe
            }
           def initialize(shipping: nil, type: nil); end
         end
-        # Attribute for param field address
+        # The customer's address.
         sig {
           returns(T.nilable(DelegatedCheckout::RequestedSessionUpdateParams::FulfillmentDetails::Address))
          }
@@ -100414,7 +101415,7 @@ module Stripe
             state: nil
           ); end
         end
-        # Attribute for param field address
+        # The customer's address.
         sig {
           returns(T.nilable(DelegatedCheckout::RequestedSessionCreateParams::FulfillmentDetails::Address))
          }
@@ -108700,6 +109701,88 @@ module Stripe
          }
         def initialize(flexible: nil, type: nil); end
       end
+      class BillingSchedule < ::Stripe::RequestParams
+        class AppliesTo < ::Stripe::RequestParams
+          # The ID of the price object.
+          sig { returns(T.nilable(String)) }
+          def price; end
+          sig { params(_price: T.nilable(String)).returns(T.nilable(String)) }
+          def price=(_price); end
+          # Controls which subscription items the billing schedule applies to.
+          sig { returns(String) }
+          def type; end
+          sig { params(_type: String).returns(String) }
+          def type=(_type); end
+          sig { params(price: T.nilable(String), type: String).void }
+          def initialize(price: nil, type: nil); end
+        end
+        class BillUntil < ::Stripe::RequestParams
+          class Duration < ::Stripe::RequestParams
+            # Specifies billing duration. Either `day`, `week`, `month` or `year`.
+            sig { returns(String) }
+            def interval; end
+            sig { params(_interval: String).returns(String) }
+            def interval=(_interval); end
+            # The multiplier applied to the interval.
+            sig { returns(T.nilable(Integer)) }
+            def interval_count; end
+            sig { params(_interval_count: T.nilable(Integer)).returns(T.nilable(Integer)) }
+            def interval_count=(_interval_count); end
+            sig { params(interval: String, interval_count: T.nilable(Integer)).void }
+            def initialize(interval: nil, interval_count: nil); end
+          end
+          # Specifies the billing period.
+          sig {
+            returns(T.nilable(InvoiceCreatePreviewParams::ScheduleDetails::BillingSchedule::BillUntil::Duration))
+           }
+          def duration; end
+          sig {
+            params(_duration: T.nilable(InvoiceCreatePreviewParams::ScheduleDetails::BillingSchedule::BillUntil::Duration)).returns(T.nilable(InvoiceCreatePreviewParams::ScheduleDetails::BillingSchedule::BillUntil::Duration))
+           }
+          def duration=(_duration); end
+          # The end date of the billing schedule.
+          sig { returns(T.nilable(Integer)) }
+          def timestamp; end
+          sig { params(_timestamp: T.nilable(Integer)).returns(T.nilable(Integer)) }
+          def timestamp=(_timestamp); end
+          # Describes how the billing schedule will determine the end date. Either `duration` or `timestamp`.
+          sig { returns(String) }
+          def type; end
+          sig { params(_type: String).returns(String) }
+          def type=(_type); end
+          sig {
+            params(duration: T.nilable(InvoiceCreatePreviewParams::ScheduleDetails::BillingSchedule::BillUntil::Duration), timestamp: T.nilable(Integer), type: String).void
+           }
+          def initialize(duration: nil, timestamp: nil, type: nil); end
+        end
+        # Configure billing schedule differently for individual subscription items.
+        sig {
+          returns(T.nilable(T::Array[InvoiceCreatePreviewParams::ScheduleDetails::BillingSchedule::AppliesTo]))
+         }
+        def applies_to; end
+        sig {
+          params(_applies_to: T.nilable(T::Array[InvoiceCreatePreviewParams::ScheduleDetails::BillingSchedule::AppliesTo])).returns(T.nilable(T::Array[InvoiceCreatePreviewParams::ScheduleDetails::BillingSchedule::AppliesTo]))
+         }
+        def applies_to=(_applies_to); end
+        # The end date for the billing schedule.
+        sig {
+          returns(T.nilable(InvoiceCreatePreviewParams::ScheduleDetails::BillingSchedule::BillUntil))
+         }
+        def bill_until; end
+        sig {
+          params(_bill_until: T.nilable(InvoiceCreatePreviewParams::ScheduleDetails::BillingSchedule::BillUntil)).returns(T.nilable(InvoiceCreatePreviewParams::ScheduleDetails::BillingSchedule::BillUntil))
+         }
+        def bill_until=(_bill_until); end
+        # Specify a key for the billing schedule. Must be unique to this field, alphanumeric, and up to 200 characters. If not provided, a unique key will be generated.
+        sig { returns(T.nilable(String)) }
+        def key; end
+        sig { params(_key: T.nilable(String)).returns(T.nilable(String)) }
+        def key=(_key); end
+        sig {
+          params(applies_to: T.nilable(T::Array[InvoiceCreatePreviewParams::ScheduleDetails::BillingSchedule::AppliesTo]), bill_until: T.nilable(InvoiceCreatePreviewParams::ScheduleDetails::BillingSchedule::BillUntil), key: T.nilable(String)).void
+         }
+        def initialize(applies_to: nil, bill_until: nil, key: nil); end
+      end
       class Phase < ::Stripe::RequestParams
         class AddInvoiceItem < ::Stripe::RequestParams
           class Discount < ::Stripe::RequestParams
@@ -109703,8 +110786,17 @@ module Stripe
       def proration_behavior; end
       sig { params(_proration_behavior: T.nilable(String)).returns(T.nilable(String)) }
       def proration_behavior=(_proration_behavior); end
+      # Sets the billing schedules for the subscription schedule.
+      sig {
+        returns(T.nilable(T::Array[InvoiceCreatePreviewParams::ScheduleDetails::BillingSchedule]))
+       }
+      def billing_schedules; end
+      sig {
+        params(_billing_schedules: T.nilable(T::Array[InvoiceCreatePreviewParams::ScheduleDetails::BillingSchedule])).returns(T.nilable(T::Array[InvoiceCreatePreviewParams::ScheduleDetails::BillingSchedule]))
+       }
+      def billing_schedules=(_billing_schedules); end
       sig {
-        params(amendments: T.nilable(T::Array[InvoiceCreatePreviewParams::ScheduleDetails::Amendment]), billing_behavior: T.nilable(String), billing_mode: T.nilable(InvoiceCreatePreviewParams::ScheduleDetails::BillingMode), end_behavior: T.nilable(String), phases: T.nilable(T::Array[InvoiceCreatePreviewParams::ScheduleDetails::Phase]), prebilling: T.nilable(T.any(String, T::Array[InvoiceCreatePreviewParams::ScheduleDetails::Prebilling])), proration_behavior: T.nilable(String)).void
+        params(amendments: T.nilable(T::Array[InvoiceCreatePreviewParams::ScheduleDetails::Amendment]), billing_behavior: T.nilable(String), billing_mode: T.nilable(InvoiceCreatePreviewParams::ScheduleDetails::BillingMode), end_behavior: T.nilable(String), phases: T.nilable(T::Array[InvoiceCreatePreviewParams::ScheduleDetails::Phase]), prebilling: T.nilable(T.any(String, T::Array[InvoiceCreatePreviewParams::ScheduleDetails::Prebilling])), proration_behavior: T.nilable(String), billing_schedules: T.nilable(T::Array[InvoiceCreatePreviewParams::ScheduleDetails::BillingSchedule])).void
        }
       def initialize(
         amendments: nil,
@@ -109713,7 +110805,8 @@ module Stripe
         end_behavior: nil,
         phases: nil,
         prebilling: nil,
-        proration_behavior: nil
+        proration_behavior: nil,
+        billing_schedules: nil
       ); end
     end
     class SubscriptionDetails < ::Stripe::RequestParams
@@ -115856,6 +116949,91 @@ module Stripe
   end
 end
 # typed: true
+module Stripe
+  module Issuing
+    class ProgramListParams < ::Stripe::RequestParams
+      # A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.
+      sig { returns(T.nilable(String)) }
+      def ending_before; end
+      sig { params(_ending_before: T.nilable(String)).returns(T.nilable(String)) }
+      def ending_before=(_ending_before); end
+      # Specifies which fields in the response should be expanded.
+      sig { returns(T.nilable(T::Array[String])) }
+      def expand; end
+      sig { params(_expand: T.nilable(T::Array[String])).returns(T.nilable(T::Array[String])) }
+      def expand=(_expand); end
+      # A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
+      sig { returns(T.nilable(Integer)) }
+      def limit; end
+      sig { params(_limit: T.nilable(Integer)).returns(T.nilable(Integer)) }
+      def limit=(_limit); end
+      # A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list.
+      sig { returns(T.nilable(String)) }
+      def starting_after; end
+      sig { params(_starting_after: T.nilable(String)).returns(T.nilable(String)) }
+      def starting_after=(_starting_after); end
+      sig {
+        params(ending_before: T.nilable(String), expand: T.nilable(T::Array[String]), limit: T.nilable(Integer), starting_after: T.nilable(String)).void
+       }
+      def initialize(ending_before: nil, expand: nil, limit: nil, starting_after: nil); end
+    end
+  end
+end
+# typed: true
+module Stripe
+  module Issuing
+    class ProgramCreateParams < ::Stripe::RequestParams
+      # Specifies which fields in the response should be expanded.
+      sig { returns(T.nilable(T::Array[String])) }
+      def expand; end
+      sig { params(_expand: T.nilable(T::Array[String])).returns(T.nilable(T::Array[String])) }
+      def expand=(_expand); end
+      # If true, makes the specified program the default for the given account.
+      sig { returns(T.nilable(T::Boolean)) }
+      def is_default; end
+      sig { params(_is_default: T.nilable(T::Boolean)).returns(T.nilable(T::Boolean)) }
+      def is_default=(_is_default); end
+      # The program to use as the parent for the new program to create.
+      sig { returns(String) }
+      def platform_program; end
+      sig { params(_platform_program: String).returns(String) }
+      def platform_program=(_platform_program); end
+      sig {
+        params(expand: T.nilable(T::Array[String]), is_default: T.nilable(T::Boolean), platform_program: String).void
+       }
+      def initialize(expand: nil, is_default: nil, platform_program: nil); end
+    end
+  end
+end
+# typed: true
+module Stripe
+  module Issuing
+    class ProgramUpdateParams < ::Stripe::RequestParams
+      # Specifies which fields in the response should be expanded.
+      sig { returns(T.nilable(T::Array[String])) }
+      def expand; end
+      sig { params(_expand: T.nilable(T::Array[String])).returns(T.nilable(T::Array[String])) }
+      def expand=(_expand); end
+      # If true, makes the specified program the default.
+      sig { returns(T.nilable(T::Boolean)) }
+      def is_default; end
+      sig { params(_is_default: T.nilable(T::Boolean)).returns(T.nilable(T::Boolean)) }
+      def is_default=(_is_default); end
+      # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+      sig { returns(T.nilable(T.any(String, T::Hash[String, String]))) }
+      def metadata; end
+      sig {
+        params(_metadata: T.nilable(T.any(String, T::Hash[String, String]))).returns(T.nilable(T.any(String, T::Hash[String, String])))
+       }
+      def metadata=(_metadata); end
+      sig {
+        params(expand: T.nilable(T::Array[String]), is_default: T.nilable(T::Boolean), metadata: T.nilable(T.any(String, T::Hash[String, String]))).void
+       }
+      def initialize(expand: nil, is_default: nil, metadata: nil); end
+    end
+  end
+end
+# typed: true
 module Stripe
   module Issuing
     class TokenListParams < ::Stripe::RequestParams
@@ -152131,6 +153309,155 @@ module Stripe
          }
         def initialize(flexible: nil, type: nil); end
       end
+      class BillingSchedule < ::Stripe::RequestParams
+        class AppliesTo < ::Stripe::RequestParams
+          # The ID of the price object.
+          sig { returns(T.nilable(String)) }
+          def price; end
+          sig { params(_price: T.nilable(String)).returns(T.nilable(String)) }
+          def price=(_price); end
+          # Controls which subscription items the billing schedule applies to.
+          sig { returns(String) }
+          def type; end
+          sig { params(_type: String).returns(String) }
+          def type=(_type); end
+          sig { params(price: T.nilable(String), type: String).void }
+          def initialize(price: nil, type: nil); end
+        end
+        class BillFrom < ::Stripe::RequestParams
+          class LineStartsAt < ::Stripe::RequestParams
+            # The ID of a quote line.
+            sig { returns(T.nilable(String)) }
+            def id; end
+            sig { params(_id: T.nilable(String)).returns(T.nilable(String)) }
+            def id=(_id); end
+            # The position of the previous quote line in the `lines` array after which this line should begin. Indexes start from 0 and must be less than the index of the current line in the array.
+            sig { returns(T.nilable(Integer)) }
+            def index; end
+            sig { params(_index: T.nilable(Integer)).returns(T.nilable(Integer)) }
+            def index=(_index); end
+            sig { params(id: T.nilable(String), index: T.nilable(Integer)).void }
+            def initialize(id: nil, index: nil); end
+          end
+          # Details of a Quote line to start the bill period from.
+          sig {
+            returns(T.nilable(QuoteCreateParams::SubscriptionData::BillingSchedule::BillFrom::LineStartsAt))
+           }
+          def line_starts_at; end
+          sig {
+            params(_line_starts_at: T.nilable(QuoteCreateParams::SubscriptionData::BillingSchedule::BillFrom::LineStartsAt)).returns(T.nilable(QuoteCreateParams::SubscriptionData::BillingSchedule::BillFrom::LineStartsAt))
+           }
+          def line_starts_at=(_line_starts_at); end
+          # A precise Unix timestamp.
+          sig { returns(T.nilable(Integer)) }
+          def timestamp; end
+          sig { params(_timestamp: T.nilable(Integer)).returns(T.nilable(Integer)) }
+          def timestamp=(_timestamp); end
+          # The type of method to specify the `bill_from` time.
+          sig { returns(String) }
+          def type; end
+          sig { params(_type: String).returns(String) }
+          def type=(_type); end
+          sig {
+            params(line_starts_at: T.nilable(QuoteCreateParams::SubscriptionData::BillingSchedule::BillFrom::LineStartsAt), timestamp: T.nilable(Integer), type: String).void
+           }
+          def initialize(line_starts_at: nil, timestamp: nil, type: nil); end
+        end
+        class BillUntil < ::Stripe::RequestParams
+          class Duration < ::Stripe::RequestParams
+            # Specifies a type of interval unit. Either `day`, `week`, `month` or `year`.
+            sig { returns(String) }
+            def interval; end
+            sig { params(_interval: String).returns(String) }
+            def interval=(_interval); end
+            # The number of intervals, as an whole number greater than 0. Stripe multiplies this by the interval type to get the overall duration.
+            sig { returns(Integer) }
+            def interval_count; end
+            sig { params(_interval_count: Integer).returns(Integer) }
+            def interval_count=(_interval_count); end
+            sig { params(interval: String, interval_count: Integer).void }
+            def initialize(interval: nil, interval_count: nil); end
+          end
+          class LineEndsAt < ::Stripe::RequestParams
+            # The ID of a quote line.
+            sig { returns(T.nilable(String)) }
+            def id; end
+            sig { params(_id: T.nilable(String)).returns(T.nilable(String)) }
+            def id=(_id); end
+            # The position of the previous quote line in the `lines` array after which this line should begin. Indexes start from 0 and must be less than the index of the current line in the array.
+            sig { returns(T.nilable(Integer)) }
+            def index; end
+            sig { params(_index: T.nilable(Integer)).returns(T.nilable(Integer)) }
+            def index=(_index); end
+            sig { params(id: T.nilable(String), index: T.nilable(Integer)).void }
+            def initialize(id: nil, index: nil); end
+          end
+          # Details of the duration over which to bill.
+          sig {
+            returns(T.nilable(QuoteCreateParams::SubscriptionData::BillingSchedule::BillUntil::Duration))
+           }
+          def duration; end
+          sig {
+            params(_duration: T.nilable(QuoteCreateParams::SubscriptionData::BillingSchedule::BillUntil::Duration)).returns(T.nilable(QuoteCreateParams::SubscriptionData::BillingSchedule::BillUntil::Duration))
+           }
+          def duration=(_duration); end
+          # Details of a Quote line item from which to bill until.
+          sig {
+            returns(T.nilable(QuoteCreateParams::SubscriptionData::BillingSchedule::BillUntil::LineEndsAt))
+           }
+          def line_ends_at; end
+          sig {
+            params(_line_ends_at: T.nilable(QuoteCreateParams::SubscriptionData::BillingSchedule::BillUntil::LineEndsAt)).returns(T.nilable(QuoteCreateParams::SubscriptionData::BillingSchedule::BillUntil::LineEndsAt))
+           }
+          def line_ends_at=(_line_ends_at); end
+          # A precise Unix timestamp.
+          sig { returns(T.nilable(Integer)) }
+          def timestamp; end
+          sig { params(_timestamp: T.nilable(Integer)).returns(T.nilable(Integer)) }
+          def timestamp=(_timestamp); end
+          # The type of method to specify the `bill_until` time.
+          sig { returns(String) }
+          def type; end
+          sig { params(_type: String).returns(String) }
+          def type=(_type); end
+          sig {
+            params(duration: T.nilable(QuoteCreateParams::SubscriptionData::BillingSchedule::BillUntil::Duration), line_ends_at: T.nilable(QuoteCreateParams::SubscriptionData::BillingSchedule::BillUntil::LineEndsAt), timestamp: T.nilable(Integer), type: String).void
+           }
+          def initialize(duration: nil, line_ends_at: nil, timestamp: nil, type: nil); end
+        end
+        # Configure billing schedule differently for individual subscription items.
+        sig {
+          returns(T.nilable(T::Array[QuoteCreateParams::SubscriptionData::BillingSchedule::AppliesTo]))
+         }
+        def applies_to; end
+        sig {
+          params(_applies_to: T.nilable(T::Array[QuoteCreateParams::SubscriptionData::BillingSchedule::AppliesTo])).returns(T.nilable(T::Array[QuoteCreateParams::SubscriptionData::BillingSchedule::AppliesTo]))
+         }
+        def applies_to=(_applies_to); end
+        # The start of the period to bill from when the Quote is accepted.
+        sig { returns(QuoteCreateParams::SubscriptionData::BillingSchedule::BillFrom) }
+        def bill_from; end
+        sig {
+          params(_bill_from: QuoteCreateParams::SubscriptionData::BillingSchedule::BillFrom).returns(QuoteCreateParams::SubscriptionData::BillingSchedule::BillFrom)
+         }
+        def bill_from=(_bill_from); end
+        # The end of the period to bill until when the Quote is accepted.
+        sig { returns(QuoteCreateParams::SubscriptionData::BillingSchedule::BillUntil) }
+        def bill_until; end
+        sig {
+          params(_bill_until: QuoteCreateParams::SubscriptionData::BillingSchedule::BillUntil).returns(QuoteCreateParams::SubscriptionData::BillingSchedule::BillUntil)
+         }
+        def bill_until=(_bill_until); end
+        # Specify a key for the billing schedule. Must be unique to this field, alphanumeric, and up to 200 characters. If not provided, a unique key will be generated.
+        sig { returns(T.nilable(String)) }
+        def key; end
+        sig { params(_key: T.nilable(String)).returns(T.nilable(String)) }
+        def key=(_key); end
+        sig {
+          params(applies_to: T.nilable(T::Array[QuoteCreateParams::SubscriptionData::BillingSchedule::AppliesTo]), bill_from: QuoteCreateParams::SubscriptionData::BillingSchedule::BillFrom, bill_until: QuoteCreateParams::SubscriptionData::BillingSchedule::BillUntil, key: T.nilable(String)).void
+         }
+        def initialize(applies_to: nil, bill_from: nil, bill_until: nil, key: nil); end
+      end
       class Prebilling < ::Stripe::RequestParams
         # This is used to determine the number of billing cycles to prebill.
         sig { returns(Integer) }
@@ -152218,8 +153545,22 @@ module Stripe
         params(_trial_period_days: T.nilable(T.any(String, Integer))).returns(T.nilable(T.any(String, Integer)))
        }
       def trial_period_days=(_trial_period_days); end
+      # Billing schedules that will be applied to the subscription or subscription schedule created when the quote is accepted.
       sig {
-        params(bill_on_acceptance: T.nilable(QuoteCreateParams::SubscriptionData::BillOnAcceptance), billing_behavior: T.nilable(String), billing_cycle_anchor: T.nilable(String), billing_mode: T.nilable(QuoteCreateParams::SubscriptionData::BillingMode), description: T.nilable(String), effective_date: T.nilable(T.any(String, T.any(String, Integer))), end_behavior: T.nilable(String), from_subscription: T.nilable(String), metadata: T.nilable(T::Hash[String, String]), prebilling: T.nilable(T.any(String, QuoteCreateParams::SubscriptionData::Prebilling)), proration_behavior: T.nilable(String), trial_period_days: T.nilable(T.any(String, Integer))).void
+        returns(T.nilable(T.any(String, T::Array[QuoteCreateParams::SubscriptionData::BillingSchedule])))
+       }
+      def billing_schedules; end
+      sig {
+        params(_billing_schedules: T.nilable(T.any(String, T::Array[QuoteCreateParams::SubscriptionData::BillingSchedule]))).returns(T.nilable(T.any(String, T::Array[QuoteCreateParams::SubscriptionData::BillingSchedule])))
+       }
+      def billing_schedules=(_billing_schedules); end
+      # Configures how the subscription schedule handles billing for phase transitions when the quote is accepted. 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.
+      sig { returns(T.nilable(String)) }
+      def phase_effective_at; end
+      sig { params(_phase_effective_at: T.nilable(String)).returns(T.nilable(String)) }
+      def phase_effective_at=(_phase_effective_at); end
+      sig {
+        params(bill_on_acceptance: T.nilable(QuoteCreateParams::SubscriptionData::BillOnAcceptance), billing_behavior: T.nilable(String), billing_cycle_anchor: T.nilable(String), billing_mode: T.nilable(QuoteCreateParams::SubscriptionData::BillingMode), description: T.nilable(String), effective_date: T.nilable(T.any(String, T.any(String, Integer))), end_behavior: T.nilable(String), from_subscription: T.nilable(String), metadata: T.nilable(T::Hash[String, String]), prebilling: T.nilable(T.any(String, QuoteCreateParams::SubscriptionData::Prebilling)), proration_behavior: T.nilable(String), trial_period_days: T.nilable(T.any(String, Integer)), billing_schedules: T.nilable(T.any(String, T::Array[QuoteCreateParams::SubscriptionData::BillingSchedule])), phase_effective_at: T.nilable(String)).void
        }
       def initialize(
         bill_on_acceptance: nil,
@@ -152233,7 +153574,9 @@ module Stripe
         metadata: nil,
         prebilling: nil,
         proration_behavior: nil,
-        trial_period_days: nil
+        trial_period_days: nil,
+        billing_schedules: nil,
+        phase_effective_at: nil
       ); end
     end
     class SubscriptionDataOverride < ::Stripe::RequestParams
@@ -152383,6 +153726,155 @@ module Stripe
          }
         def initialize(bill_from: nil, bill_until: nil); end
       end
+      class BillingSchedule < ::Stripe::RequestParams
+        class AppliesTo < ::Stripe::RequestParams
+          # The ID of the price object.
+          sig { returns(T.nilable(String)) }
+          def price; end
+          sig { params(_price: T.nilable(String)).returns(T.nilable(String)) }
+          def price=(_price); end
+          # Controls which subscription items the billing schedule applies to.
+          sig { returns(String) }
+          def type; end
+          sig { params(_type: String).returns(String) }
+          def type=(_type); end
+          sig { params(price: T.nilable(String), type: String).void }
+          def initialize(price: nil, type: nil); end
+        end
+        class BillFrom < ::Stripe::RequestParams
+          class LineStartsAt < ::Stripe::RequestParams
+            # The ID of a quote line.
+            sig { returns(T.nilable(String)) }
+            def id; end
+            sig { params(_id: T.nilable(String)).returns(T.nilable(String)) }
+            def id=(_id); end
+            # The position of the previous quote line in the `lines` array after which this line should begin. Indexes start from 0 and must be less than the index of the current line in the array.
+            sig { returns(T.nilable(Integer)) }
+            def index; end
+            sig { params(_index: T.nilable(Integer)).returns(T.nilable(Integer)) }
+            def index=(_index); end
+            sig { params(id: T.nilable(String), index: T.nilable(Integer)).void }
+            def initialize(id: nil, index: nil); end
+          end
+          # Details of a Quote line to start the bill period from.
+          sig {
+            returns(T.nilable(QuoteCreateParams::SubscriptionDataOverride::BillingSchedule::BillFrom::LineStartsAt))
+           }
+          def line_starts_at; end
+          sig {
+            params(_line_starts_at: T.nilable(QuoteCreateParams::SubscriptionDataOverride::BillingSchedule::BillFrom::LineStartsAt)).returns(T.nilable(QuoteCreateParams::SubscriptionDataOverride::BillingSchedule::BillFrom::LineStartsAt))
+           }
+          def line_starts_at=(_line_starts_at); end
+          # A precise Unix timestamp.
+          sig { returns(T.nilable(Integer)) }
+          def timestamp; end
+          sig { params(_timestamp: T.nilable(Integer)).returns(T.nilable(Integer)) }
+          def timestamp=(_timestamp); end
+          # The type of method to specify the `bill_from` time.
+          sig { returns(String) }
+          def type; end
+          sig { params(_type: String).returns(String) }
+          def type=(_type); end
+          sig {
+            params(line_starts_at: T.nilable(QuoteCreateParams::SubscriptionDataOverride::BillingSchedule::BillFrom::LineStartsAt), timestamp: T.nilable(Integer), type: String).void
+           }
+          def initialize(line_starts_at: nil, timestamp: nil, type: nil); end
+        end
+        class BillUntil < ::Stripe::RequestParams
+          class Duration < ::Stripe::RequestParams
+            # Specifies a type of interval unit. Either `day`, `week`, `month` or `year`.
+            sig { returns(String) }
+            def interval; end
+            sig { params(_interval: String).returns(String) }
+            def interval=(_interval); end
+            # The number of intervals, as an whole number greater than 0. Stripe multiplies this by the interval type to get the overall duration.
+            sig { returns(Integer) }
+            def interval_count; end
+            sig { params(_interval_count: Integer).returns(Integer) }
+            def interval_count=(_interval_count); end
+            sig { params(interval: String, interval_count: Integer).void }
+            def initialize(interval: nil, interval_count: nil); end
+          end
+          class LineEndsAt < ::Stripe::RequestParams
+            # The ID of a quote line.
+            sig { returns(T.nilable(String)) }
+            def id; end
+            sig { params(_id: T.nilable(String)).returns(T.nilable(String)) }
+            def id=(_id); end
+            # The position of the previous quote line in the `lines` array after which this line should begin. Indexes start from 0 and must be less than the index of the current line in the array.
+            sig { returns(T.nilable(Integer)) }
+            def index; end
+            sig { params(_index: T.nilable(Integer)).returns(T.nilable(Integer)) }
+            def index=(_index); end
+            sig { params(id: T.nilable(String), index: T.nilable(Integer)).void }
+            def initialize(id: nil, index: nil); end
+          end
+          # Details of the duration over which to bill.
+          sig {
+            returns(T.nilable(QuoteCreateParams::SubscriptionDataOverride::BillingSchedule::BillUntil::Duration))
+           }
+          def duration; end
+          sig {
+            params(_duration: T.nilable(QuoteCreateParams::SubscriptionDataOverride::BillingSchedule::BillUntil::Duration)).returns(T.nilable(QuoteCreateParams::SubscriptionDataOverride::BillingSchedule::BillUntil::Duration))
+           }
+          def duration=(_duration); end
+          # Details of a Quote line item from which to bill until.
+          sig {
+            returns(T.nilable(QuoteCreateParams::SubscriptionDataOverride::BillingSchedule::BillUntil::LineEndsAt))
+           }
+          def line_ends_at; end
+          sig {
+            params(_line_ends_at: T.nilable(QuoteCreateParams::SubscriptionDataOverride::BillingSchedule::BillUntil::LineEndsAt)).returns(T.nilable(QuoteCreateParams::SubscriptionDataOverride::BillingSchedule::BillUntil::LineEndsAt))
+           }
+          def line_ends_at=(_line_ends_at); end
+          # A precise Unix timestamp.
+          sig { returns(T.nilable(Integer)) }
+          def timestamp; end
+          sig { params(_timestamp: T.nilable(Integer)).returns(T.nilable(Integer)) }
+          def timestamp=(_timestamp); end
+          # The type of method to specify the `bill_until` time.
+          sig { returns(String) }
+          def type; end
+          sig { params(_type: String).returns(String) }
+          def type=(_type); end
+          sig {
+            params(duration: T.nilable(QuoteCreateParams::SubscriptionDataOverride::BillingSchedule::BillUntil::Duration), line_ends_at: T.nilable(QuoteCreateParams::SubscriptionDataOverride::BillingSchedule::BillUntil::LineEndsAt), timestamp: T.nilable(Integer), type: String).void
+           }
+          def initialize(duration: nil, line_ends_at: nil, timestamp: nil, type: nil); end
+        end
+        # Configure billing schedule differently for individual subscription items.
+        sig {
+          returns(T.nilable(T::Array[QuoteCreateParams::SubscriptionDataOverride::BillingSchedule::AppliesTo]))
+         }
+        def applies_to; end
+        sig {
+          params(_applies_to: T.nilable(T::Array[QuoteCreateParams::SubscriptionDataOverride::BillingSchedule::AppliesTo])).returns(T.nilable(T::Array[QuoteCreateParams::SubscriptionDataOverride::BillingSchedule::AppliesTo]))
+         }
+        def applies_to=(_applies_to); end
+        # The start of the period to bill from when the Quote is accepted.
+        sig { returns(QuoteCreateParams::SubscriptionDataOverride::BillingSchedule::BillFrom) }
+        def bill_from; end
+        sig {
+          params(_bill_from: QuoteCreateParams::SubscriptionDataOverride::BillingSchedule::BillFrom).returns(QuoteCreateParams::SubscriptionDataOverride::BillingSchedule::BillFrom)
+         }
+        def bill_from=(_bill_from); end
+        # The end of the period to bill until when the Quote is accepted.
+        sig { returns(QuoteCreateParams::SubscriptionDataOverride::BillingSchedule::BillUntil) }
+        def bill_until; end
+        sig {
+          params(_bill_until: QuoteCreateParams::SubscriptionDataOverride::BillingSchedule::BillUntil).returns(QuoteCreateParams::SubscriptionDataOverride::BillingSchedule::BillUntil)
+         }
+        def bill_until=(_bill_until); end
+        # Specify a key for the billing schedule. Must be unique to this field, alphanumeric, and up to 200 characters. If not provided, a unique key will be generated.
+        sig { returns(T.nilable(String)) }
+        def key; end
+        sig { params(_key: T.nilable(String)).returns(T.nilable(String)) }
+        def key=(_key); end
+        sig {
+          params(applies_to: T.nilable(T::Array[QuoteCreateParams::SubscriptionDataOverride::BillingSchedule::AppliesTo]), bill_from: QuoteCreateParams::SubscriptionDataOverride::BillingSchedule::BillFrom, bill_until: QuoteCreateParams::SubscriptionDataOverride::BillingSchedule::BillUntil, key: T.nilable(String)).void
+         }
+        def initialize(applies_to: nil, bill_from: nil, bill_until: nil, key: nil); end
+      end
       # Whether the override applies to an existing Subscription Schedule or a new Subscription Schedule.
       sig { returns(QuoteCreateParams::SubscriptionDataOverride::AppliesTo) }
       def applies_to; end
@@ -152428,8 +153920,22 @@ module Stripe
       def proration_behavior; end
       sig { params(_proration_behavior: T.nilable(String)).returns(T.nilable(String)) }
       def proration_behavior=(_proration_behavior); end
+      # Billing schedules that will be applied to the subscription or subscription schedule created when the quote is accepted.
       sig {
-        params(applies_to: QuoteCreateParams::SubscriptionDataOverride::AppliesTo, bill_on_acceptance: T.nilable(QuoteCreateParams::SubscriptionDataOverride::BillOnAcceptance), billing_behavior: T.nilable(String), customer: T.nilable(String), description: T.nilable(String), end_behavior: T.nilable(String), proration_behavior: T.nilable(String)).void
+        returns(T.nilable(T.any(String, T::Array[QuoteCreateParams::SubscriptionDataOverride::BillingSchedule])))
+       }
+      def billing_schedules; end
+      sig {
+        params(_billing_schedules: T.nilable(T.any(String, T::Array[QuoteCreateParams::SubscriptionDataOverride::BillingSchedule]))).returns(T.nilable(T.any(String, T::Array[QuoteCreateParams::SubscriptionDataOverride::BillingSchedule])))
+       }
+      def billing_schedules=(_billing_schedules); end
+      # Configures how the subscription schedule handles billing for phase transitions when the quote is accepted. 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.
+      sig { returns(T.nilable(String)) }
+      def phase_effective_at; end
+      sig { params(_phase_effective_at: T.nilable(String)).returns(T.nilable(String)) }
+      def phase_effective_at=(_phase_effective_at); end
+      sig {
+        params(applies_to: QuoteCreateParams::SubscriptionDataOverride::AppliesTo, bill_on_acceptance: T.nilable(QuoteCreateParams::SubscriptionDataOverride::BillOnAcceptance), billing_behavior: T.nilable(String), customer: T.nilable(String), description: T.nilable(String), end_behavior: T.nilable(String), proration_behavior: T.nilable(String), billing_schedules: T.nilable(T.any(String, T::Array[QuoteCreateParams::SubscriptionDataOverride::BillingSchedule])), phase_effective_at: T.nilable(String)).void
        }
       def initialize(
         applies_to: nil,
@@ -152438,7 +153944,9 @@ module Stripe
         customer: nil,
         description: nil,
         end_behavior: nil,
-        proration_behavior: nil
+        proration_behavior: nil,
+        billing_schedules: nil,
+        phase_effective_at: nil
       ); end
     end
     class TransferData < ::Stripe::RequestParams
@@ -153806,6 +155314,155 @@ module Stripe
          }
         def initialize(bill_from: nil, bill_until: nil); end
       end
+      class BillingSchedule < ::Stripe::RequestParams
+        class AppliesTo < ::Stripe::RequestParams
+          # The ID of the price object.
+          sig { returns(T.nilable(String)) }
+          def price; end
+          sig { params(_price: T.nilable(String)).returns(T.nilable(String)) }
+          def price=(_price); end
+          # Controls which subscription items the billing schedule applies to.
+          sig { returns(String) }
+          def type; end
+          sig { params(_type: String).returns(String) }
+          def type=(_type); end
+          sig { params(price: T.nilable(String), type: String).void }
+          def initialize(price: nil, type: nil); end
+        end
+        class BillFrom < ::Stripe::RequestParams
+          class LineStartsAt < ::Stripe::RequestParams
+            # The ID of a quote line.
+            sig { returns(T.nilable(String)) }
+            def id; end
+            sig { params(_id: T.nilable(String)).returns(T.nilable(String)) }
+            def id=(_id); end
+            # The position of the previous quote line in the `lines` array after which this line should begin. Indexes start from 0 and must be less than the index of the current line in the array.
+            sig { returns(T.nilable(Integer)) }
+            def index; end
+            sig { params(_index: T.nilable(Integer)).returns(T.nilable(Integer)) }
+            def index=(_index); end
+            sig { params(id: T.nilable(String), index: T.nilable(Integer)).void }
+            def initialize(id: nil, index: nil); end
+          end
+          # Details of a Quote line to start the bill period from.
+          sig {
+            returns(T.nilable(QuoteUpdateParams::SubscriptionData::BillingSchedule::BillFrom::LineStartsAt))
+           }
+          def line_starts_at; end
+          sig {
+            params(_line_starts_at: T.nilable(QuoteUpdateParams::SubscriptionData::BillingSchedule::BillFrom::LineStartsAt)).returns(T.nilable(QuoteUpdateParams::SubscriptionData::BillingSchedule::BillFrom::LineStartsAt))
+           }
+          def line_starts_at=(_line_starts_at); end
+          # A precise Unix timestamp.
+          sig { returns(T.nilable(Integer)) }
+          def timestamp; end
+          sig { params(_timestamp: T.nilable(Integer)).returns(T.nilable(Integer)) }
+          def timestamp=(_timestamp); end
+          # The type of method to specify the `bill_from` time.
+          sig { returns(String) }
+          def type; end
+          sig { params(_type: String).returns(String) }
+          def type=(_type); end
+          sig {
+            params(line_starts_at: T.nilable(QuoteUpdateParams::SubscriptionData::BillingSchedule::BillFrom::LineStartsAt), timestamp: T.nilable(Integer), type: String).void
+           }
+          def initialize(line_starts_at: nil, timestamp: nil, type: nil); end
+        end
+        class BillUntil < ::Stripe::RequestParams
+          class Duration < ::Stripe::RequestParams
+            # Specifies a type of interval unit. Either `day`, `week`, `month` or `year`.
+            sig { returns(String) }
+            def interval; end
+            sig { params(_interval: String).returns(String) }
+            def interval=(_interval); end
+            # The number of intervals, as an whole number greater than 0. Stripe multiplies this by the interval type to get the overall duration.
+            sig { returns(Integer) }
+            def interval_count; end
+            sig { params(_interval_count: Integer).returns(Integer) }
+            def interval_count=(_interval_count); end
+            sig { params(interval: String, interval_count: Integer).void }
+            def initialize(interval: nil, interval_count: nil); end
+          end
+          class LineEndsAt < ::Stripe::RequestParams
+            # The ID of a quote line.
+            sig { returns(T.nilable(String)) }
+            def id; end
+            sig { params(_id: T.nilable(String)).returns(T.nilable(String)) }
+            def id=(_id); end
+            # The position of the previous quote line in the `lines` array after which this line should begin. Indexes start from 0 and must be less than the index of the current line in the array.
+            sig { returns(T.nilable(Integer)) }
+            def index; end
+            sig { params(_index: T.nilable(Integer)).returns(T.nilable(Integer)) }
+            def index=(_index); end
+            sig { params(id: T.nilable(String), index: T.nilable(Integer)).void }
+            def initialize(id: nil, index: nil); end
+          end
+          # Details of the duration over which to bill.
+          sig {
+            returns(T.nilable(QuoteUpdateParams::SubscriptionData::BillingSchedule::BillUntil::Duration))
+           }
+          def duration; end
+          sig {
+            params(_duration: T.nilable(QuoteUpdateParams::SubscriptionData::BillingSchedule::BillUntil::Duration)).returns(T.nilable(QuoteUpdateParams::SubscriptionData::BillingSchedule::BillUntil::Duration))
+           }
+          def duration=(_duration); end
+          # Details of a Quote line item from which to bill until.
+          sig {
+            returns(T.nilable(QuoteUpdateParams::SubscriptionData::BillingSchedule::BillUntil::LineEndsAt))
+           }
+          def line_ends_at; end
+          sig {
+            params(_line_ends_at: T.nilable(QuoteUpdateParams::SubscriptionData::BillingSchedule::BillUntil::LineEndsAt)).returns(T.nilable(QuoteUpdateParams::SubscriptionData::BillingSchedule::BillUntil::LineEndsAt))
+           }
+          def line_ends_at=(_line_ends_at); end
+          # A precise Unix timestamp.
+          sig { returns(T.nilable(Integer)) }
+          def timestamp; end
+          sig { params(_timestamp: T.nilable(Integer)).returns(T.nilable(Integer)) }
+          def timestamp=(_timestamp); end
+          # The type of method to specify the `bill_until` time.
+          sig { returns(String) }
+          def type; end
+          sig { params(_type: String).returns(String) }
+          def type=(_type); end
+          sig {
+            params(duration: T.nilable(QuoteUpdateParams::SubscriptionData::BillingSchedule::BillUntil::Duration), line_ends_at: T.nilable(QuoteUpdateParams::SubscriptionData::BillingSchedule::BillUntil::LineEndsAt), timestamp: T.nilable(Integer), type: String).void
+           }
+          def initialize(duration: nil, line_ends_at: nil, timestamp: nil, type: nil); end
+        end
+        # Configure billing schedule differently for individual subscription items.
+        sig {
+          returns(T.nilable(T::Array[QuoteUpdateParams::SubscriptionData::BillingSchedule::AppliesTo]))
+         }
+        def applies_to; end
+        sig {
+          params(_applies_to: T.nilable(T::Array[QuoteUpdateParams::SubscriptionData::BillingSchedule::AppliesTo])).returns(T.nilable(T::Array[QuoteUpdateParams::SubscriptionData::BillingSchedule::AppliesTo]))
+         }
+        def applies_to=(_applies_to); end
+        # The start of the period to bill from when the Quote is accepted.
+        sig { returns(T.nilable(QuoteUpdateParams::SubscriptionData::BillingSchedule::BillFrom)) }
+        def bill_from; end
+        sig {
+          params(_bill_from: T.nilable(QuoteUpdateParams::SubscriptionData::BillingSchedule::BillFrom)).returns(T.nilable(QuoteUpdateParams::SubscriptionData::BillingSchedule::BillFrom))
+         }
+        def bill_from=(_bill_from); end
+        # The end of the period to bill until when the Quote is accepted.
+        sig { returns(T.nilable(QuoteUpdateParams::SubscriptionData::BillingSchedule::BillUntil)) }
+        def bill_until; end
+        sig {
+          params(_bill_until: T.nilable(QuoteUpdateParams::SubscriptionData::BillingSchedule::BillUntil)).returns(T.nilable(QuoteUpdateParams::SubscriptionData::BillingSchedule::BillUntil))
+         }
+        def bill_until=(_bill_until); end
+        # Specify a key for the billing schedule. Must be unique to this field, alphanumeric, and up to 200 characters. If not provided, a unique key will be generated.
+        sig { returns(T.nilable(String)) }
+        def key; end
+        sig { params(_key: T.nilable(String)).returns(T.nilable(String)) }
+        def key=(_key); end
+        sig {
+          params(applies_to: T.nilable(T::Array[QuoteUpdateParams::SubscriptionData::BillingSchedule::AppliesTo]), bill_from: T.nilable(QuoteUpdateParams::SubscriptionData::BillingSchedule::BillFrom), bill_until: T.nilable(QuoteUpdateParams::SubscriptionData::BillingSchedule::BillUntil), key: T.nilable(String)).void
+         }
+        def initialize(applies_to: nil, bill_from: nil, bill_until: nil, key: nil); end
+      end
       class Prebilling < ::Stripe::RequestParams
         # This is used to determine the number of billing cycles to prebill.
         sig { returns(Integer) }
@@ -153883,8 +155540,22 @@ module Stripe
         params(_trial_period_days: T.nilable(T.any(String, Integer))).returns(T.nilable(T.any(String, Integer)))
        }
       def trial_period_days=(_trial_period_days); end
+      # Billing schedules that will be applied to the subscription or subscription schedule created when the quote is accepted.
+      sig {
+        returns(T.nilable(T.any(String, T::Array[QuoteUpdateParams::SubscriptionData::BillingSchedule])))
+       }
+      def billing_schedules; end
+      sig {
+        params(_billing_schedules: T.nilable(T.any(String, T::Array[QuoteUpdateParams::SubscriptionData::BillingSchedule]))).returns(T.nilable(T.any(String, T::Array[QuoteUpdateParams::SubscriptionData::BillingSchedule])))
+       }
+      def billing_schedules=(_billing_schedules); end
+      # Configures how the subscription schedule handles billing for phase transitions when the quote is accepted. 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.
+      sig { returns(T.nilable(String)) }
+      def phase_effective_at; end
+      sig { params(_phase_effective_at: T.nilable(String)).returns(T.nilable(String)) }
+      def phase_effective_at=(_phase_effective_at); end
       sig {
-        params(bill_on_acceptance: T.nilable(T.any(String, QuoteUpdateParams::SubscriptionData::BillOnAcceptance)), billing_behavior: T.nilable(String), billing_cycle_anchor: T.nilable(String), description: T.nilable(String), effective_date: T.nilable(T.any(String, T.any(String, Integer))), end_behavior: T.nilable(String), metadata: T.nilable(T::Hash[String, String]), prebilling: T.nilable(T.any(String, QuoteUpdateParams::SubscriptionData::Prebilling)), proration_behavior: T.nilable(String), trial_period_days: T.nilable(T.any(String, Integer))).void
+        params(bill_on_acceptance: T.nilable(T.any(String, QuoteUpdateParams::SubscriptionData::BillOnAcceptance)), billing_behavior: T.nilable(String), billing_cycle_anchor: T.nilable(String), description: T.nilable(String), effective_date: T.nilable(T.any(String, T.any(String, Integer))), end_behavior: T.nilable(String), metadata: T.nilable(T::Hash[String, String]), prebilling: T.nilable(T.any(String, QuoteUpdateParams::SubscriptionData::Prebilling)), proration_behavior: T.nilable(String), trial_period_days: T.nilable(T.any(String, Integer)), billing_schedules: T.nilable(T.any(String, T::Array[QuoteUpdateParams::SubscriptionData::BillingSchedule])), phase_effective_at: T.nilable(String)).void
        }
       def initialize(
         bill_on_acceptance: nil,
@@ -153896,7 +155567,9 @@ module Stripe
         metadata: nil,
         prebilling: nil,
         proration_behavior: nil,
-        trial_period_days: nil
+        trial_period_days: nil,
+        billing_schedules: nil,
+        phase_effective_at: nil
       ); end
     end
     class SubscriptionDataOverride < ::Stripe::RequestParams
@@ -154046,6 +155719,159 @@ module Stripe
          }
         def initialize(bill_from: nil, bill_until: nil); end
       end
+      class BillingSchedule < ::Stripe::RequestParams
+        class AppliesTo < ::Stripe::RequestParams
+          # The ID of the price object.
+          sig { returns(T.nilable(String)) }
+          def price; end
+          sig { params(_price: T.nilable(String)).returns(T.nilable(String)) }
+          def price=(_price); end
+          # Controls which subscription items the billing schedule applies to.
+          sig { returns(String) }
+          def type; end
+          sig { params(_type: String).returns(String) }
+          def type=(_type); end
+          sig { params(price: T.nilable(String), type: String).void }
+          def initialize(price: nil, type: nil); end
+        end
+        class BillFrom < ::Stripe::RequestParams
+          class LineStartsAt < ::Stripe::RequestParams
+            # The ID of a quote line.
+            sig { returns(T.nilable(String)) }
+            def id; end
+            sig { params(_id: T.nilable(String)).returns(T.nilable(String)) }
+            def id=(_id); end
+            # The position of the previous quote line in the `lines` array after which this line should begin. Indexes start from 0 and must be less than the index of the current line in the array.
+            sig { returns(T.nilable(Integer)) }
+            def index; end
+            sig { params(_index: T.nilable(Integer)).returns(T.nilable(Integer)) }
+            def index=(_index); end
+            sig { params(id: T.nilable(String), index: T.nilable(Integer)).void }
+            def initialize(id: nil, index: nil); end
+          end
+          # Details of a Quote line to start the bill period from.
+          sig {
+            returns(T.nilable(QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule::BillFrom::LineStartsAt))
+           }
+          def line_starts_at; end
+          sig {
+            params(_line_starts_at: T.nilable(QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule::BillFrom::LineStartsAt)).returns(T.nilable(QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule::BillFrom::LineStartsAt))
+           }
+          def line_starts_at=(_line_starts_at); end
+          # A precise Unix timestamp.
+          sig { returns(T.nilable(Integer)) }
+          def timestamp; end
+          sig { params(_timestamp: T.nilable(Integer)).returns(T.nilable(Integer)) }
+          def timestamp=(_timestamp); end
+          # The type of method to specify the `bill_from` time.
+          sig { returns(String) }
+          def type; end
+          sig { params(_type: String).returns(String) }
+          def type=(_type); end
+          sig {
+            params(line_starts_at: T.nilable(QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule::BillFrom::LineStartsAt), timestamp: T.nilable(Integer), type: String).void
+           }
+          def initialize(line_starts_at: nil, timestamp: nil, type: nil); end
+        end
+        class BillUntil < ::Stripe::RequestParams
+          class Duration < ::Stripe::RequestParams
+            # Specifies a type of interval unit. Either `day`, `week`, `month` or `year`.
+            sig { returns(String) }
+            def interval; end
+            sig { params(_interval: String).returns(String) }
+            def interval=(_interval); end
+            # The number of intervals, as an whole number greater than 0. Stripe multiplies this by the interval type to get the overall duration.
+            sig { returns(Integer) }
+            def interval_count; end
+            sig { params(_interval_count: Integer).returns(Integer) }
+            def interval_count=(_interval_count); end
+            sig { params(interval: String, interval_count: Integer).void }
+            def initialize(interval: nil, interval_count: nil); end
+          end
+          class LineEndsAt < ::Stripe::RequestParams
+            # The ID of a quote line.
+            sig { returns(T.nilable(String)) }
+            def id; end
+            sig { params(_id: T.nilable(String)).returns(T.nilable(String)) }
+            def id=(_id); end
+            # The position of the previous quote line in the `lines` array after which this line should begin. Indexes start from 0 and must be less than the index of the current line in the array.
+            sig { returns(T.nilable(Integer)) }
+            def index; end
+            sig { params(_index: T.nilable(Integer)).returns(T.nilable(Integer)) }
+            def index=(_index); end
+            sig { params(id: T.nilable(String), index: T.nilable(Integer)).void }
+            def initialize(id: nil, index: nil); end
+          end
+          # Details of the duration over which to bill.
+          sig {
+            returns(T.nilable(QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule::BillUntil::Duration))
+           }
+          def duration; end
+          sig {
+            params(_duration: T.nilable(QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule::BillUntil::Duration)).returns(T.nilable(QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule::BillUntil::Duration))
+           }
+          def duration=(_duration); end
+          # Details of a Quote line item from which to bill until.
+          sig {
+            returns(T.nilable(QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule::BillUntil::LineEndsAt))
+           }
+          def line_ends_at; end
+          sig {
+            params(_line_ends_at: T.nilable(QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule::BillUntil::LineEndsAt)).returns(T.nilable(QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule::BillUntil::LineEndsAt))
+           }
+          def line_ends_at=(_line_ends_at); end
+          # A precise Unix timestamp.
+          sig { returns(T.nilable(Integer)) }
+          def timestamp; end
+          sig { params(_timestamp: T.nilable(Integer)).returns(T.nilable(Integer)) }
+          def timestamp=(_timestamp); end
+          # The type of method to specify the `bill_until` time.
+          sig { returns(String) }
+          def type; end
+          sig { params(_type: String).returns(String) }
+          def type=(_type); end
+          sig {
+            params(duration: T.nilable(QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule::BillUntil::Duration), line_ends_at: T.nilable(QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule::BillUntil::LineEndsAt), timestamp: T.nilable(Integer), type: String).void
+           }
+          def initialize(duration: nil, line_ends_at: nil, timestamp: nil, type: nil); end
+        end
+        # Configure billing schedule differently for individual subscription items.
+        sig {
+          returns(T.nilable(T::Array[QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule::AppliesTo]))
+         }
+        def applies_to; end
+        sig {
+          params(_applies_to: T.nilable(T::Array[QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule::AppliesTo])).returns(T.nilable(T::Array[QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule::AppliesTo]))
+         }
+        def applies_to=(_applies_to); end
+        # The start of the period to bill from when the Quote is accepted.
+        sig {
+          returns(T.nilable(QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule::BillFrom))
+         }
+        def bill_from; end
+        sig {
+          params(_bill_from: T.nilable(QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule::BillFrom)).returns(T.nilable(QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule::BillFrom))
+         }
+        def bill_from=(_bill_from); end
+        # The end of the period to bill until when the Quote is accepted.
+        sig {
+          returns(T.nilable(QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule::BillUntil))
+         }
+        def bill_until; end
+        sig {
+          params(_bill_until: T.nilable(QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule::BillUntil)).returns(T.nilable(QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule::BillUntil))
+         }
+        def bill_until=(_bill_until); end
+        # Specify a key for the billing schedule. Must be unique to this field, alphanumeric, and up to 200 characters. If not provided, a unique key will be generated.
+        sig { returns(T.nilable(String)) }
+        def key; end
+        sig { params(_key: T.nilable(String)).returns(T.nilable(String)) }
+        def key=(_key); end
+        sig {
+          params(applies_to: T.nilable(T::Array[QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule::AppliesTo]), bill_from: T.nilable(QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule::BillFrom), bill_until: T.nilable(QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule::BillUntil), key: T.nilable(String)).void
+         }
+        def initialize(applies_to: nil, bill_from: nil, bill_until: nil, key: nil); end
+      end
       # Whether the override applies to an existing Subscription Schedule or a new Subscription Schedule.
       sig { returns(QuoteUpdateParams::SubscriptionDataOverride::AppliesTo) }
       def applies_to; end
@@ -154093,8 +155919,22 @@ module Stripe
       def proration_behavior; end
       sig { params(_proration_behavior: T.nilable(String)).returns(T.nilable(String)) }
       def proration_behavior=(_proration_behavior); end
+      # Billing schedules that will be applied to the subscription or subscription schedule created when the quote is accepted.
       sig {
-        params(applies_to: QuoteUpdateParams::SubscriptionDataOverride::AppliesTo, bill_on_acceptance: T.nilable(T.any(String, QuoteUpdateParams::SubscriptionDataOverride::BillOnAcceptance)), billing_behavior: T.nilable(String), customer: T.nilable(String), description: T.nilable(String), end_behavior: T.nilable(String), proration_behavior: T.nilable(String)).void
+        returns(T.nilable(T.any(String, T::Array[QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule])))
+       }
+      def billing_schedules; end
+      sig {
+        params(_billing_schedules: T.nilable(T.any(String, T::Array[QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule]))).returns(T.nilable(T.any(String, T::Array[QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule])))
+       }
+      def billing_schedules=(_billing_schedules); end
+      # Configures how the subscription schedule handles billing for phase transitions when the quote is accepted. 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.
+      sig { returns(T.nilable(String)) }
+      def phase_effective_at; end
+      sig { params(_phase_effective_at: T.nilable(String)).returns(T.nilable(String)) }
+      def phase_effective_at=(_phase_effective_at); end
+      sig {
+        params(applies_to: QuoteUpdateParams::SubscriptionDataOverride::AppliesTo, bill_on_acceptance: T.nilable(T.any(String, QuoteUpdateParams::SubscriptionDataOverride::BillOnAcceptance)), billing_behavior: T.nilable(String), customer: T.nilable(String), description: T.nilable(String), end_behavior: T.nilable(String), proration_behavior: T.nilable(String), billing_schedules: T.nilable(T.any(String, T::Array[QuoteUpdateParams::SubscriptionDataOverride::BillingSchedule])), phase_effective_at: T.nilable(String)).void
        }
       def initialize(
         applies_to: nil,
@@ -154103,7 +155943,9 @@ module Stripe
         customer: nil,
         description: nil,
         end_behavior: nil,
-        proration_behavior: nil
+        proration_behavior: nil,
+        billing_schedules: nil,
+        phase_effective_at: nil
       ); end
     end
     class TransferData < ::Stripe::RequestParams
@@ -163573,6 +165415,86 @@ module Stripe
        }
       def initialize(flexible: nil, type: nil); end
     end
+    class BillingSchedule < ::Stripe::RequestParams
+      class AppliesTo < ::Stripe::RequestParams
+        # The ID of the price object.
+        sig { returns(T.nilable(String)) }
+        def price; end
+        sig { params(_price: T.nilable(String)).returns(T.nilable(String)) }
+        def price=(_price); end
+        # Controls which subscription items the billing schedule applies to.
+        sig { returns(String) }
+        def type; end
+        sig { params(_type: String).returns(String) }
+        def type=(_type); end
+        sig { params(price: T.nilable(String), type: String).void }
+        def initialize(price: nil, type: nil); end
+      end
+      class BillUntil < ::Stripe::RequestParams
+        class Duration < ::Stripe::RequestParams
+          # Specifies billing duration. Either `day`, `week`, `month` or `year`.
+          sig { returns(String) }
+          def interval; end
+          sig { params(_interval: String).returns(String) }
+          def interval=(_interval); end
+          # The multiplier applied to the interval.
+          sig { returns(T.nilable(Integer)) }
+          def interval_count; end
+          sig { params(_interval_count: T.nilable(Integer)).returns(T.nilable(Integer)) }
+          def interval_count=(_interval_count); end
+          sig { params(interval: String, interval_count: T.nilable(Integer)).void }
+          def initialize(interval: nil, interval_count: nil); end
+        end
+        # Specifies the billing period.
+        sig {
+          returns(T.nilable(SubscriptionScheduleCreateParams::BillingSchedule::BillUntil::Duration))
+         }
+        def duration; end
+        sig {
+          params(_duration: T.nilable(SubscriptionScheduleCreateParams::BillingSchedule::BillUntil::Duration)).returns(T.nilable(SubscriptionScheduleCreateParams::BillingSchedule::BillUntil::Duration))
+         }
+        def duration=(_duration); end
+        # The end date of the billing schedule.
+        sig { returns(T.nilable(Integer)) }
+        def timestamp; end
+        sig { params(_timestamp: T.nilable(Integer)).returns(T.nilable(Integer)) }
+        def timestamp=(_timestamp); end
+        # Describes how the billing schedule will determine the end date. Either `duration` or `timestamp`.
+        sig { returns(String) }
+        def type; end
+        sig { params(_type: String).returns(String) }
+        def type=(_type); end
+        sig {
+          params(duration: T.nilable(SubscriptionScheduleCreateParams::BillingSchedule::BillUntil::Duration), timestamp: T.nilable(Integer), type: String).void
+         }
+        def initialize(duration: nil, timestamp: nil, type: nil); end
+      end
+      # Configure billing schedule differently for individual subscription items.
+      sig {
+        returns(T.nilable(T::Array[SubscriptionScheduleCreateParams::BillingSchedule::AppliesTo]))
+       }
+      def applies_to; end
+      sig {
+        params(_applies_to: T.nilable(T::Array[SubscriptionScheduleCreateParams::BillingSchedule::AppliesTo])).returns(T.nilable(T::Array[SubscriptionScheduleCreateParams::BillingSchedule::AppliesTo]))
+       }
+      def applies_to=(_applies_to); end
+      # The end date for the billing schedule.
+      sig { returns(SubscriptionScheduleCreateParams::BillingSchedule::BillUntil) }
+      def bill_until; end
+      sig {
+        params(_bill_until: SubscriptionScheduleCreateParams::BillingSchedule::BillUntil).returns(SubscriptionScheduleCreateParams::BillingSchedule::BillUntil)
+       }
+      def bill_until=(_bill_until); end
+      # Specify a key for the billing schedule. Must be unique to this field, alphanumeric, and up to 200 characters. If not provided, a unique key will be generated.
+      sig { returns(T.nilable(String)) }
+      def key; end
+      sig { params(_key: T.nilable(String)).returns(T.nilable(String)) }
+      def key=(_key); end
+      sig {
+        params(applies_to: T.nilable(T::Array[SubscriptionScheduleCreateParams::BillingSchedule::AppliesTo]), bill_until: SubscriptionScheduleCreateParams::BillingSchedule::BillUntil, key: T.nilable(String)).void
+       }
+      def initialize(applies_to: nil, bill_until: nil, key: nil); end
+    end
     class DefaultSettings < ::Stripe::RequestParams
       class AutomaticTax < ::Stripe::RequestParams
         class Liability < ::Stripe::RequestParams
@@ -163743,8 +165665,13 @@ module Stripe
         params(_transfer_data: T.nilable(T.any(String, SubscriptionScheduleCreateParams::DefaultSettings::TransferData))).returns(T.nilable(T.any(String, SubscriptionScheduleCreateParams::DefaultSettings::TransferData)))
        }
       def transfer_data=(_transfer_data); end
+      # 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.
+      sig { returns(T.nilable(String)) }
+      def phase_effective_at; end
+      sig { params(_phase_effective_at: T.nilable(String)).returns(T.nilable(String)) }
+      def phase_effective_at=(_phase_effective_at); end
       sig {
-        params(application_fee_percent: T.nilable(Float), automatic_tax: T.nilable(SubscriptionScheduleCreateParams::DefaultSettings::AutomaticTax), billing_cycle_anchor: T.nilable(String), billing_thresholds: T.nilable(T.any(String, SubscriptionScheduleCreateParams::DefaultSettings::BillingThresholds)), collection_method: T.nilable(String), default_payment_method: T.nilable(String), description: T.nilable(String), invoice_settings: T.nilable(SubscriptionScheduleCreateParams::DefaultSettings::InvoiceSettings), on_behalf_of: T.nilable(String), transfer_data: T.nilable(T.any(String, SubscriptionScheduleCreateParams::DefaultSettings::TransferData))).void
+        params(application_fee_percent: T.nilable(Float), automatic_tax: T.nilable(SubscriptionScheduleCreateParams::DefaultSettings::AutomaticTax), billing_cycle_anchor: T.nilable(String), billing_thresholds: T.nilable(T.any(String, SubscriptionScheduleCreateParams::DefaultSettings::BillingThresholds)), collection_method: T.nilable(String), default_payment_method: T.nilable(String), description: T.nilable(String), invoice_settings: T.nilable(SubscriptionScheduleCreateParams::DefaultSettings::InvoiceSettings), on_behalf_of: T.nilable(String), transfer_data: T.nilable(T.any(String, SubscriptionScheduleCreateParams::DefaultSettings::TransferData)), phase_effective_at: T.nilable(String)).void
        }
       def initialize(
         application_fee_percent: nil,
@@ -163756,7 +165683,8 @@ module Stripe
         description: nil,
         invoice_settings: nil,
         on_behalf_of: nil,
-        transfer_data: nil
+        transfer_data: nil,
+        phase_effective_at: nil
       ); end
     end
     class Phase < ::Stripe::RequestParams
@@ -164688,8 +166616,15 @@ module Stripe
       params(_start_date: T.nilable(T.any(Integer, String))).returns(T.nilable(T.any(Integer, String)))
      }
     def start_date=(_start_date); end
+    # Sets the billing schedules for the subscription schedule.
+    sig { returns(T.nilable(T::Array[SubscriptionScheduleCreateParams::BillingSchedule])) }
+    def billing_schedules; end
+    sig {
+      params(_billing_schedules: T.nilable(T::Array[SubscriptionScheduleCreateParams::BillingSchedule])).returns(T.nilable(T::Array[SubscriptionScheduleCreateParams::BillingSchedule]))
+     }
+    def billing_schedules=(_billing_schedules); end
     sig {
-      params(billing_behavior: T.nilable(String), billing_mode: T.nilable(SubscriptionScheduleCreateParams::BillingMode), customer: T.nilable(String), customer_account: T.nilable(String), default_settings: T.nilable(SubscriptionScheduleCreateParams::DefaultSettings), end_behavior: T.nilable(String), expand: T.nilable(T::Array[String]), from_subscription: T.nilable(String), metadata: T.nilable(T.any(String, T::Hash[String, String])), phases: T.nilable(T::Array[SubscriptionScheduleCreateParams::Phase]), prebilling: T.nilable(SubscriptionScheduleCreateParams::Prebilling), start_date: T.nilable(T.any(Integer, String))).void
+      params(billing_behavior: T.nilable(String), billing_mode: T.nilable(SubscriptionScheduleCreateParams::BillingMode), customer: T.nilable(String), customer_account: T.nilable(String), default_settings: T.nilable(SubscriptionScheduleCreateParams::DefaultSettings), end_behavior: T.nilable(String), expand: T.nilable(T::Array[String]), from_subscription: T.nilable(String), metadata: T.nilable(T.any(String, T::Hash[String, String])), phases: T.nilable(T::Array[SubscriptionScheduleCreateParams::Phase]), prebilling: T.nilable(SubscriptionScheduleCreateParams::Prebilling), start_date: T.nilable(T.any(Integer, String)), billing_schedules: T.nilable(T::Array[SubscriptionScheduleCreateParams::BillingSchedule])).void
      }
     def initialize(
       billing_behavior: nil,
@@ -164703,13 +166638,94 @@ module Stripe
       metadata: nil,
       phases: nil,
       prebilling: nil,
-      start_date: nil
+      start_date: nil,
+      billing_schedules: nil
     ); end
   end
 end
 # typed: true
 module Stripe
   class SubscriptionScheduleUpdateParams < ::Stripe::RequestParams
+    class BillingSchedule < ::Stripe::RequestParams
+      class AppliesTo < ::Stripe::RequestParams
+        # The ID of the price object.
+        sig { returns(T.nilable(String)) }
+        def price; end
+        sig { params(_price: T.nilable(String)).returns(T.nilable(String)) }
+        def price=(_price); end
+        # Controls which subscription items the billing schedule applies to.
+        sig { returns(String) }
+        def type; end
+        sig { params(_type: String).returns(String) }
+        def type=(_type); end
+        sig { params(price: T.nilable(String), type: String).void }
+        def initialize(price: nil, type: nil); end
+      end
+      class BillUntil < ::Stripe::RequestParams
+        class Duration < ::Stripe::RequestParams
+          # Specifies billing duration. Either `day`, `week`, `month` or `year`.
+          sig { returns(String) }
+          def interval; end
+          sig { params(_interval: String).returns(String) }
+          def interval=(_interval); end
+          # The multiplier applied to the interval.
+          sig { returns(T.nilable(Integer)) }
+          def interval_count; end
+          sig { params(_interval_count: T.nilable(Integer)).returns(T.nilable(Integer)) }
+          def interval_count=(_interval_count); end
+          sig { params(interval: String, interval_count: T.nilable(Integer)).void }
+          def initialize(interval: nil, interval_count: nil); end
+        end
+        # Specifies the billing period.
+        sig {
+          returns(T.nilable(SubscriptionScheduleUpdateParams::BillingSchedule::BillUntil::Duration))
+         }
+        def duration; end
+        sig {
+          params(_duration: T.nilable(SubscriptionScheduleUpdateParams::BillingSchedule::BillUntil::Duration)).returns(T.nilable(SubscriptionScheduleUpdateParams::BillingSchedule::BillUntil::Duration))
+         }
+        def duration=(_duration); end
+        # The end date of the billing schedule.
+        sig { returns(T.nilable(Integer)) }
+        def timestamp; end
+        sig { params(_timestamp: T.nilable(Integer)).returns(T.nilable(Integer)) }
+        def timestamp=(_timestamp); end
+        # Describes how the billing schedule will determine the end date. Either `duration` or `timestamp`.
+        sig { returns(String) }
+        def type; end
+        sig { params(_type: String).returns(String) }
+        def type=(_type); end
+        sig {
+          params(duration: T.nilable(SubscriptionScheduleUpdateParams::BillingSchedule::BillUntil::Duration), timestamp: T.nilable(Integer), type: String).void
+         }
+        def initialize(duration: nil, timestamp: nil, type: nil); end
+      end
+      # Configure billing schedule differently for individual subscription items.
+      sig {
+        returns(T.nilable(T::Array[SubscriptionScheduleUpdateParams::BillingSchedule::AppliesTo]))
+       }
+      def applies_to; end
+      sig {
+        params(_applies_to: T.nilable(T::Array[SubscriptionScheduleUpdateParams::BillingSchedule::AppliesTo])).returns(T.nilable(T::Array[SubscriptionScheduleUpdateParams::BillingSchedule::AppliesTo]))
+       }
+      def applies_to=(_applies_to); end
+      # The end date for the billing schedule.
+      sig { returns(T.nilable(SubscriptionScheduleUpdateParams::BillingSchedule::BillUntil)) }
+      def bill_until; end
+      sig {
+        params(_bill_until: T.nilable(SubscriptionScheduleUpdateParams::BillingSchedule::BillUntil)).returns(T.nilable(SubscriptionScheduleUpdateParams::BillingSchedule::BillUntil))
+       }
+      def bill_until=(_bill_until); end
+      # Specify a key for the billing schedule. Must be unique to this field, alphanumeric, and up to 200 characters. If not provided, a unique key will be generated.
+      sig { returns(T.nilable(String)) }
+      def key; end
+      sig { params(_key: T.nilable(String)).returns(T.nilable(String)) }
+      def key=(_key); end
+      sig {
+        params(applies_to: T.nilable(T::Array[SubscriptionScheduleUpdateParams::BillingSchedule::AppliesTo]), bill_until: T.nilable(SubscriptionScheduleUpdateParams::BillingSchedule::BillUntil), key: T.nilable(String)).void
+       }
+      def initialize(applies_to: nil, bill_until: nil, key: nil); end
+    end
     class DefaultSettings < ::Stripe::RequestParams
       class AutomaticTax < ::Stripe::RequestParams
         class Liability < ::Stripe::RequestParams
@@ -164880,8 +166896,13 @@ module Stripe
         params(_transfer_data: T.nilable(T.any(String, SubscriptionScheduleUpdateParams::DefaultSettings::TransferData))).returns(T.nilable(T.any(String, SubscriptionScheduleUpdateParams::DefaultSettings::TransferData)))
        }
       def transfer_data=(_transfer_data); end
+      # 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.
+      sig { returns(T.nilable(String)) }
+      def phase_effective_at; end
+      sig { params(_phase_effective_at: T.nilable(String)).returns(T.nilable(String)) }
+      def phase_effective_at=(_phase_effective_at); end
       sig {
-        params(application_fee_percent: T.nilable(Float), automatic_tax: T.nilable(SubscriptionScheduleUpdateParams::DefaultSettings::AutomaticTax), billing_cycle_anchor: T.nilable(String), billing_thresholds: T.nilable(T.any(String, SubscriptionScheduleUpdateParams::DefaultSettings::BillingThresholds)), collection_method: T.nilable(String), default_payment_method: T.nilable(String), description: T.nilable(String), invoice_settings: T.nilable(SubscriptionScheduleUpdateParams::DefaultSettings::InvoiceSettings), on_behalf_of: T.nilable(String), transfer_data: T.nilable(T.any(String, SubscriptionScheduleUpdateParams::DefaultSettings::TransferData))).void
+        params(application_fee_percent: T.nilable(Float), automatic_tax: T.nilable(SubscriptionScheduleUpdateParams::DefaultSettings::AutomaticTax), billing_cycle_anchor: T.nilable(String), billing_thresholds: T.nilable(T.any(String, SubscriptionScheduleUpdateParams::DefaultSettings::BillingThresholds)), collection_method: T.nilable(String), default_payment_method: T.nilable(String), description: T.nilable(String), invoice_settings: T.nilable(SubscriptionScheduleUpdateParams::DefaultSettings::InvoiceSettings), on_behalf_of: T.nilable(String), transfer_data: T.nilable(T.any(String, SubscriptionScheduleUpdateParams::DefaultSettings::TransferData)), phase_effective_at: T.nilable(String)).void
        }
       def initialize(
         application_fee_percent: nil,
@@ -164893,7 +166914,8 @@ module Stripe
         description: nil,
         invoice_settings: nil,
         on_behalf_of: nil,
-        transfer_data: nil
+        transfer_data: nil,
+        phase_effective_at: nil
       ); end
     end
     class Phase < ::Stripe::RequestParams
@@ -165813,8 +167835,15 @@ module Stripe
     def proration_behavior; end
     sig { params(_proration_behavior: T.nilable(String)).returns(T.nilable(String)) }
     def proration_behavior=(_proration_behavior); end
+    # Sets the billing schedules for the subscription schedule.
+    sig { returns(T.nilable(T::Array[SubscriptionScheduleUpdateParams::BillingSchedule])) }
+    def billing_schedules; end
     sig {
-      params(billing_behavior: T.nilable(String), default_settings: T.nilable(SubscriptionScheduleUpdateParams::DefaultSettings), end_behavior: T.nilable(String), expand: T.nilable(T::Array[String]), metadata: T.nilable(T.any(String, T::Hash[String, String])), phases: T.nilable(T::Array[SubscriptionScheduleUpdateParams::Phase]), prebilling: T.nilable(SubscriptionScheduleUpdateParams::Prebilling), proration_behavior: T.nilable(String)).void
+      params(_billing_schedules: T.nilable(T::Array[SubscriptionScheduleUpdateParams::BillingSchedule])).returns(T.nilable(T::Array[SubscriptionScheduleUpdateParams::BillingSchedule]))
+     }
+    def billing_schedules=(_billing_schedules); end
+    sig {
+      params(billing_behavior: T.nilable(String), default_settings: T.nilable(SubscriptionScheduleUpdateParams::DefaultSettings), end_behavior: T.nilable(String), expand: T.nilable(T::Array[String]), metadata: T.nilable(T.any(String, T::Hash[String, String])), phases: T.nilable(T::Array[SubscriptionScheduleUpdateParams::Phase]), prebilling: T.nilable(SubscriptionScheduleUpdateParams::Prebilling), proration_behavior: T.nilable(String), billing_schedules: T.nilable(T::Array[SubscriptionScheduleUpdateParams::BillingSchedule])).void
      }
     def initialize(
       billing_behavior: nil,
@@ -165824,7 +167853,8 @@ module Stripe
       metadata: nil,
       phases: nil,
       prebilling: nil,
-      proration_behavior: nil
+      proration_behavior: nil,
+      billing_schedules: nil
     ); end
   end
 end
@@ -178320,6 +180350,34 @@ module Stripe
             title: nil
           ); end
         end
+        class SelfReportedIncome < ::Stripe::RequestParams
+          # Attribute for param field amount
+          sig { returns(Integer) }
+          def amount; end
+          sig { params(_amount: Integer).returns(Integer) }
+          def amount=(_amount); end
+          # Attribute for param field currency
+          sig { returns(String) }
+          def currency; end
+          sig { params(_currency: String).returns(String) }
+          def currency=(_currency); end
+          sig { params(amount: Integer, currency: String).void }
+          def initialize(amount: nil, currency: nil); end
+        end
+        class SelfReportedMonthlyHousingPayment < ::Stripe::RequestParams
+          # Attribute for param field amount
+          sig { returns(Integer) }
+          def amount; end
+          sig { params(_amount: Integer).returns(Integer) }
+          def amount=(_amount); end
+          # Attribute for param field currency
+          sig { returns(String) }
+          def currency; end
+          sig { params(_currency: String).returns(String) }
+          def currency=(_currency); end
+          sig { params(amount: Integer, currency: String).void }
+          def initialize(amount: nil, currency: nil); end
+        end
         class Verification < ::Stripe::RequestParams
           class AdditionalDocument < ::Stripe::RequestParams
             # The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.
@@ -178503,8 +180561,24 @@ module Stripe
           params(_verification: T.nilable(TokenCreateParams::Account::Individual::Verification)).returns(T.nilable(TokenCreateParams::Account::Individual::Verification))
          }
         def verification=(_verification); end
+        # The credit applicant's self-reported yearly income in minor units.
+        sig { returns(T.nilable(TokenCreateParams::Account::Individual::SelfReportedIncome)) }
+        def self_reported_income; end
+        sig {
+          params(_self_reported_income: T.nilable(TokenCreateParams::Account::Individual::SelfReportedIncome)).returns(T.nilable(TokenCreateParams::Account::Individual::SelfReportedIncome))
+         }
+        def self_reported_income=(_self_reported_income); end
+        # The credit applicant's self-reported monthly housing payment in minor units.
         sig {
-          params(address: T.nilable(TokenCreateParams::Account::Individual::Address), address_kana: T.nilable(TokenCreateParams::Account::Individual::AddressKana), address_kanji: T.nilable(TokenCreateParams::Account::Individual::AddressKanji), dob: T.nilable(T.any(String, TokenCreateParams::Account::Individual::Dob)), email: T.nilable(String), first_name: T.nilable(String), first_name_kana: T.nilable(String), first_name_kanji: T.nilable(String), full_name_aliases: T.nilable(T.any(String, T::Array[String])), gender: T.nilable(String), id_number: T.nilable(String), id_number_secondary: T.nilable(String), last_name: T.nilable(String), last_name_kana: T.nilable(String), last_name_kanji: T.nilable(String), maiden_name: T.nilable(String), metadata: T.nilable(T.any(String, T::Hash[String, String])), phone: T.nilable(String), political_exposure: T.nilable(String), registered_address: T.nilable(TokenCreateParams::Account::Individual::RegisteredAddress), relationship: T.nilable(TokenCreateParams::Account::Individual::Relationship), ssn_last_4: T.nilable(String), verification: T.nilable(TokenCreateParams::Account::Individual::Verification)).void
+          returns(T.nilable(TokenCreateParams::Account::Individual::SelfReportedMonthlyHousingPayment))
+         }
+        def self_reported_monthly_housing_payment; end
+        sig {
+          params(_self_reported_monthly_housing_payment: T.nilable(TokenCreateParams::Account::Individual::SelfReportedMonthlyHousingPayment)).returns(T.nilable(TokenCreateParams::Account::Individual::SelfReportedMonthlyHousingPayment))
+         }
+        def self_reported_monthly_housing_payment=(_self_reported_monthly_housing_payment); end
+        sig {
+          params(address: T.nilable(TokenCreateParams::Account::Individual::Address), address_kana: T.nilable(TokenCreateParams::Account::Individual::AddressKana), address_kanji: T.nilable(TokenCreateParams::Account::Individual::AddressKanji), dob: T.nilable(T.any(String, TokenCreateParams::Account::Individual::Dob)), email: T.nilable(String), first_name: T.nilable(String), first_name_kana: T.nilable(String), first_name_kanji: T.nilable(String), full_name_aliases: T.nilable(T.any(String, T::Array[String])), gender: T.nilable(String), id_number: T.nilable(String), id_number_secondary: T.nilable(String), last_name: T.nilable(String), last_name_kana: T.nilable(String), last_name_kanji: T.nilable(String), maiden_name: T.nilable(String), metadata: T.nilable(T.any(String, T::Hash[String, String])), phone: T.nilable(String), political_exposure: T.nilable(String), registered_address: T.nilable(TokenCreateParams::Account::Individual::RegisteredAddress), relationship: T.nilable(TokenCreateParams::Account::Individual::Relationship), ssn_last_4: T.nilable(String), verification: T.nilable(TokenCreateParams::Account::Individual::Verification), self_reported_income: T.nilable(TokenCreateParams::Account::Individual::SelfReportedIncome), self_reported_monthly_housing_payment: T.nilable(TokenCreateParams::Account::Individual::SelfReportedMonthlyHousingPayment)).void
          }
         def initialize(
           address: nil,
@@ -178529,7 +180603,9 @@ module Stripe
           registered_address: nil,
           relationship: nil,
           ssn_last_4: nil,
-          verification: nil
+          verification: nil,
+          self_reported_income: nil,
+          self_reported_monthly_housing_payment: nil
         ); end
       end
       # The business type.
@@ -179075,6 +181151,34 @@ module Stripe
           title: nil
         ); end
       end
+      class SelfReportedIncome < ::Stripe::RequestParams
+        # Attribute for param field amount
+        sig { returns(Integer) }
+        def amount; end
+        sig { params(_amount: Integer).returns(Integer) }
+        def amount=(_amount); end
+        # Attribute for param field currency
+        sig { returns(String) }
+        def currency; end
+        sig { params(_currency: String).returns(String) }
+        def currency=(_currency); end
+        sig { params(amount: Integer, currency: String).void }
+        def initialize(amount: nil, currency: nil); end
+      end
+      class SelfReportedMonthlyHousingPayment < ::Stripe::RequestParams
+        # Attribute for param field amount
+        sig { returns(Integer) }
+        def amount; end
+        sig { params(_amount: Integer).returns(Integer) }
+        def amount=(_amount); end
+        # Attribute for param field currency
+        sig { returns(String) }
+        def currency; end
+        sig { params(_currency: String).returns(String) }
+        def currency=(_currency); end
+        sig { params(amount: Integer, currency: String).void }
+        def initialize(amount: nil, currency: nil); end
+      end
       class UsCfpbData < ::Stripe::RequestParams
         class EthnicityDetails < ::Stripe::RequestParams
           # The persons ethnicity
@@ -179339,8 +181443,22 @@ module Stripe
         params(_verification: T.nilable(TokenCreateParams::Person::Verification)).returns(T.nilable(TokenCreateParams::Person::Verification))
        }
       def verification=(_verification); end
+      # The credit applicant's self-reported yearly income in minor units.
+      sig { returns(T.nilable(TokenCreateParams::Person::SelfReportedIncome)) }
+      def self_reported_income; end
+      sig {
+        params(_self_reported_income: T.nilable(TokenCreateParams::Person::SelfReportedIncome)).returns(T.nilable(TokenCreateParams::Person::SelfReportedIncome))
+       }
+      def self_reported_income=(_self_reported_income); end
+      # The credit applicant's self-reported monthly housing payment in minor units.
+      sig { returns(T.nilable(TokenCreateParams::Person::SelfReportedMonthlyHousingPayment)) }
+      def self_reported_monthly_housing_payment; end
+      sig {
+        params(_self_reported_monthly_housing_payment: T.nilable(TokenCreateParams::Person::SelfReportedMonthlyHousingPayment)).returns(T.nilable(TokenCreateParams::Person::SelfReportedMonthlyHousingPayment))
+       }
+      def self_reported_monthly_housing_payment=(_self_reported_monthly_housing_payment); end
       sig {
-        params(additional_tos_acceptances: T.nilable(TokenCreateParams::Person::AdditionalTosAcceptances), address: T.nilable(TokenCreateParams::Person::Address), address_kana: T.nilable(TokenCreateParams::Person::AddressKana), address_kanji: T.nilable(TokenCreateParams::Person::AddressKanji), dob: T.nilable(T.any(String, TokenCreateParams::Person::Dob)), documents: T.nilable(TokenCreateParams::Person::Documents), email: T.nilable(String), first_name: T.nilable(String), first_name_kana: T.nilable(String), first_name_kanji: T.nilable(String), full_name_aliases: T.nilable(T.any(String, T::Array[String])), gender: T.nilable(String), id_number: T.nilable(String), id_number_secondary: T.nilable(String), last_name: T.nilable(String), last_name_kana: T.nilable(String), last_name_kanji: T.nilable(String), maiden_name: T.nilable(String), metadata: T.nilable(T.any(String, T::Hash[String, String])), nationality: T.nilable(String), phone: T.nilable(String), political_exposure: T.nilable(String), registered_address: T.nilable(TokenCreateParams::Person::RegisteredAddress), relationship: T.nilable(TokenCreateParams::Person::Relationship), ssn_last_4: T.nilable(String), us_cfpb_data: T.nilable(TokenCreateParams::Person::UsCfpbData), verification: T.nilable(TokenCreateParams::Person::Verification)).void
+        params(additional_tos_acceptances: T.nilable(TokenCreateParams::Person::AdditionalTosAcceptances), address: T.nilable(TokenCreateParams::Person::Address), address_kana: T.nilable(TokenCreateParams::Person::AddressKana), address_kanji: T.nilable(TokenCreateParams::Person::AddressKanji), dob: T.nilable(T.any(String, TokenCreateParams::Person::Dob)), documents: T.nilable(TokenCreateParams::Person::Documents), email: T.nilable(String), first_name: T.nilable(String), first_name_kana: T.nilable(String), first_name_kanji: T.nilable(String), full_name_aliases: T.nilable(T.any(String, T::Array[String])), gender: T.nilable(String), id_number: T.nilable(String), id_number_secondary: T.nilable(String), last_name: T.nilable(String), last_name_kana: T.nilable(String), last_name_kanji: T.nilable(String), maiden_name: T.nilable(String), metadata: T.nilable(T.any(String, T::Hash[String, String])), nationality: T.nilable(String), phone: T.nilable(String), political_exposure: T.nilable(String), registered_address: T.nilable(TokenCreateParams::Person::RegisteredAddress), relationship: T.nilable(TokenCreateParams::Person::Relationship), ssn_last_4: T.nilable(String), us_cfpb_data: T.nilable(TokenCreateParams::Person::UsCfpbData), verification: T.nilable(TokenCreateParams::Person::Verification), self_reported_income: T.nilable(TokenCreateParams::Person::SelfReportedIncome), self_reported_monthly_housing_payment: T.nilable(TokenCreateParams::Person::SelfReportedMonthlyHousingPayment)).void
        }
       def initialize(
         additional_tos_acceptances: nil,
@@ -179369,7 +181487,9 @@ module Stripe
         relationship: nil,
         ssn_last_4: nil,
         us_cfpb_data: nil,
-        verification: nil
+        verification: nil,
+        self_reported_income: nil,
+        self_reported_monthly_housing_payment: nil
       ); end
     end
     class Pii < ::Stripe::RequestParams
@@ -183725,6 +185845,34 @@ module Stripe
         title: nil
       ); end
     end
+    class SelfReportedIncome < ::Stripe::RequestParams
+      # Attribute for param field amount
+      sig { returns(Integer) }
+      def amount; end
+      sig { params(_amount: Integer).returns(Integer) }
+      def amount=(_amount); end
+      # Attribute for param field currency
+      sig { returns(String) }
+      def currency; end
+      sig { params(_currency: String).returns(String) }
+      def currency=(_currency); end
+      sig { params(amount: Integer, currency: String).void }
+      def initialize(amount: nil, currency: nil); end
+    end
+    class SelfReportedMonthlyHousingPayment < ::Stripe::RequestParams
+      # Attribute for param field amount
+      sig { returns(Integer) }
+      def amount; end
+      sig { params(_amount: Integer).returns(Integer) }
+      def amount=(_amount); end
+      # Attribute for param field currency
+      sig { returns(String) }
+      def currency; end
+      sig { params(_currency: String).returns(String) }
+      def currency=(_currency); end
+      sig { params(amount: Integer, currency: String).void }
+      def initialize(amount: nil, currency: nil); end
+    end
     class UsCfpbData < ::Stripe::RequestParams
       class EthnicityDetails < ::Stripe::RequestParams
         # The persons ethnicity
@@ -183997,8 +186145,22 @@ module Stripe
       params(_verification: T.nilable(AccountPersonUpdateParams::Verification)).returns(T.nilable(AccountPersonUpdateParams::Verification))
      }
     def verification=(_verification); end
+    # The credit applicant's self-reported yearly income in minor units.
+    sig { returns(T.nilable(AccountPersonUpdateParams::SelfReportedIncome)) }
+    def self_reported_income; end
     sig {
-      params(additional_tos_acceptances: T.nilable(AccountPersonUpdateParams::AdditionalTosAcceptances), address: T.nilable(AccountPersonUpdateParams::Address), address_kana: T.nilable(AccountPersonUpdateParams::AddressKana), address_kanji: T.nilable(AccountPersonUpdateParams::AddressKanji), dob: T.nilable(T.any(String, AccountPersonUpdateParams::Dob)), documents: T.nilable(AccountPersonUpdateParams::Documents), email: T.nilable(String), expand: T.nilable(T::Array[String]), first_name: T.nilable(String), first_name_kana: T.nilable(String), first_name_kanji: T.nilable(String), full_name_aliases: T.nilable(T.any(String, T::Array[String])), gender: T.nilable(String), id_number: T.nilable(String), id_number_secondary: T.nilable(String), last_name: T.nilable(String), last_name_kana: T.nilable(String), last_name_kanji: T.nilable(String), maiden_name: T.nilable(String), metadata: T.nilable(T.any(String, T::Hash[String, String])), nationality: T.nilable(String), person_token: T.nilable(String), phone: T.nilable(String), political_exposure: T.nilable(String), registered_address: T.nilable(AccountPersonUpdateParams::RegisteredAddress), relationship: T.nilable(AccountPersonUpdateParams::Relationship), ssn_last_4: T.nilable(String), us_cfpb_data: T.nilable(AccountPersonUpdateParams::UsCfpbData), verification: T.nilable(AccountPersonUpdateParams::Verification)).void
+      params(_self_reported_income: T.nilable(AccountPersonUpdateParams::SelfReportedIncome)).returns(T.nilable(AccountPersonUpdateParams::SelfReportedIncome))
+     }
+    def self_reported_income=(_self_reported_income); end
+    # The credit applicant's self-reported monthly housing payment in minor units.
+    sig { returns(T.nilable(AccountPersonUpdateParams::SelfReportedMonthlyHousingPayment)) }
+    def self_reported_monthly_housing_payment; end
+    sig {
+      params(_self_reported_monthly_housing_payment: T.nilable(AccountPersonUpdateParams::SelfReportedMonthlyHousingPayment)).returns(T.nilable(AccountPersonUpdateParams::SelfReportedMonthlyHousingPayment))
+     }
+    def self_reported_monthly_housing_payment=(_self_reported_monthly_housing_payment); end
+    sig {
+      params(additional_tos_acceptances: T.nilable(AccountPersonUpdateParams::AdditionalTosAcceptances), address: T.nilable(AccountPersonUpdateParams::Address), address_kana: T.nilable(AccountPersonUpdateParams::AddressKana), address_kanji: T.nilable(AccountPersonUpdateParams::AddressKanji), dob: T.nilable(T.any(String, AccountPersonUpdateParams::Dob)), documents: T.nilable(AccountPersonUpdateParams::Documents), email: T.nilable(String), expand: T.nilable(T::Array[String]), first_name: T.nilable(String), first_name_kana: T.nilable(String), first_name_kanji: T.nilable(String), full_name_aliases: T.nilable(T.any(String, T::Array[String])), gender: T.nilable(String), id_number: T.nilable(String), id_number_secondary: T.nilable(String), last_name: T.nilable(String), last_name_kana: T.nilable(String), last_name_kanji: T.nilable(String), maiden_name: T.nilable(String), metadata: T.nilable(T.any(String, T::Hash[String, String])), nationality: T.nilable(String), person_token: T.nilable(String), phone: T.nilable(String), political_exposure: T.nilable(String), registered_address: T.nilable(AccountPersonUpdateParams::RegisteredAddress), relationship: T.nilable(AccountPersonUpdateParams::Relationship), ssn_last_4: T.nilable(String), us_cfpb_data: T.nilable(AccountPersonUpdateParams::UsCfpbData), verification: T.nilable(AccountPersonUpdateParams::Verification), self_reported_income: T.nilable(AccountPersonUpdateParams::SelfReportedIncome), self_reported_monthly_housing_payment: T.nilable(AccountPersonUpdateParams::SelfReportedMonthlyHousingPayment)).void
      }
     def initialize(
       additional_tos_acceptances: nil,
@@ -184029,7 +186191,9 @@ module Stripe
       relationship: nil,
       ssn_last_4: nil,
       us_cfpb_data: nil,
-      verification: nil
+      verification: nil,
+      self_reported_income: nil,
+      self_reported_monthly_housing_payment: nil
     ); end
   end
 end
@@ -184469,6 +186633,34 @@ module Stripe
         title: nil
       ); end
     end
+    class SelfReportedIncome < ::Stripe::RequestParams
+      # Attribute for param field amount
+      sig { returns(Integer) }
+      def amount; end
+      sig { params(_amount: Integer).returns(Integer) }
+      def amount=(_amount); end
+      # Attribute for param field currency
+      sig { returns(String) }
+      def currency; end
+      sig { params(_currency: String).returns(String) }
+      def currency=(_currency); end
+      sig { params(amount: Integer, currency: String).void }
+      def initialize(amount: nil, currency: nil); end
+    end
+    class SelfReportedMonthlyHousingPayment < ::Stripe::RequestParams
+      # Attribute for param field amount
+      sig { returns(Integer) }
+      def amount; end
+      sig { params(_amount: Integer).returns(Integer) }
+      def amount=(_amount); end
+      # Attribute for param field currency
+      sig { returns(String) }
+      def currency; end
+      sig { params(_currency: String).returns(String) }
+      def currency=(_currency); end
+      sig { params(amount: Integer, currency: String).void }
+      def initialize(amount: nil, currency: nil); end
+    end
     class UsCfpbData < ::Stripe::RequestParams
       class EthnicityDetails < ::Stripe::RequestParams
         # The persons ethnicity
@@ -184741,8 +186933,22 @@ module Stripe
       params(_verification: T.nilable(AccountPersonCreateParams::Verification)).returns(T.nilable(AccountPersonCreateParams::Verification))
      }
     def verification=(_verification); end
+    # The credit applicant's self-reported yearly income in minor units.
+    sig { returns(T.nilable(AccountPersonCreateParams::SelfReportedIncome)) }
+    def self_reported_income; end
+    sig {
+      params(_self_reported_income: T.nilable(AccountPersonCreateParams::SelfReportedIncome)).returns(T.nilable(AccountPersonCreateParams::SelfReportedIncome))
+     }
+    def self_reported_income=(_self_reported_income); end
+    # The credit applicant's self-reported monthly housing payment in minor units.
+    sig { returns(T.nilable(AccountPersonCreateParams::SelfReportedMonthlyHousingPayment)) }
+    def self_reported_monthly_housing_payment; end
+    sig {
+      params(_self_reported_monthly_housing_payment: T.nilable(AccountPersonCreateParams::SelfReportedMonthlyHousingPayment)).returns(T.nilable(AccountPersonCreateParams::SelfReportedMonthlyHousingPayment))
+     }
+    def self_reported_monthly_housing_payment=(_self_reported_monthly_housing_payment); end
     sig {
-      params(additional_tos_acceptances: T.nilable(AccountPersonCreateParams::AdditionalTosAcceptances), address: T.nilable(AccountPersonCreateParams::Address), address_kana: T.nilable(AccountPersonCreateParams::AddressKana), address_kanji: T.nilable(AccountPersonCreateParams::AddressKanji), dob: T.nilable(T.any(String, AccountPersonCreateParams::Dob)), documents: T.nilable(AccountPersonCreateParams::Documents), email: T.nilable(String), expand: T.nilable(T::Array[String]), first_name: T.nilable(String), first_name_kana: T.nilable(String), first_name_kanji: T.nilable(String), full_name_aliases: T.nilable(T.any(String, T::Array[String])), gender: T.nilable(String), id_number: T.nilable(String), id_number_secondary: T.nilable(String), last_name: T.nilable(String), last_name_kana: T.nilable(String), last_name_kanji: T.nilable(String), maiden_name: T.nilable(String), metadata: T.nilable(T.any(String, T::Hash[String, String])), nationality: T.nilable(String), person_token: T.nilable(String), phone: T.nilable(String), political_exposure: T.nilable(String), registered_address: T.nilable(AccountPersonCreateParams::RegisteredAddress), relationship: T.nilable(AccountPersonCreateParams::Relationship), ssn_last_4: T.nilable(String), us_cfpb_data: T.nilable(AccountPersonCreateParams::UsCfpbData), verification: T.nilable(AccountPersonCreateParams::Verification)).void
+      params(additional_tos_acceptances: T.nilable(AccountPersonCreateParams::AdditionalTosAcceptances), address: T.nilable(AccountPersonCreateParams::Address), address_kana: T.nilable(AccountPersonCreateParams::AddressKana), address_kanji: T.nilable(AccountPersonCreateParams::AddressKanji), dob: T.nilable(T.any(String, AccountPersonCreateParams::Dob)), documents: T.nilable(AccountPersonCreateParams::Documents), email: T.nilable(String), expand: T.nilable(T::Array[String]), first_name: T.nilable(String), first_name_kana: T.nilable(String), first_name_kanji: T.nilable(String), full_name_aliases: T.nilable(T.any(String, T::Array[String])), gender: T.nilable(String), id_number: T.nilable(String), id_number_secondary: T.nilable(String), last_name: T.nilable(String), last_name_kana: T.nilable(String), last_name_kanji: T.nilable(String), maiden_name: T.nilable(String), metadata: T.nilable(T.any(String, T::Hash[String, String])), nationality: T.nilable(String), person_token: T.nilable(String), phone: T.nilable(String), political_exposure: T.nilable(String), registered_address: T.nilable(AccountPersonCreateParams::RegisteredAddress), relationship: T.nilable(AccountPersonCreateParams::Relationship), ssn_last_4: T.nilable(String), us_cfpb_data: T.nilable(AccountPersonCreateParams::UsCfpbData), verification: T.nilable(AccountPersonCreateParams::Verification), self_reported_income: T.nilable(AccountPersonCreateParams::SelfReportedIncome), self_reported_monthly_housing_payment: T.nilable(AccountPersonCreateParams::SelfReportedMonthlyHousingPayment)).void
      }
     def initialize(
       additional_tos_acceptances: nil,
@@ -184773,7 +186979,9 @@ module Stripe
       relationship: nil,
       ssn_last_4: nil,
       us_cfpb_data: nil,
-      verification: nil
+      verification: nil,
+      self_reported_income: nil,
+      self_reported_monthly_housing_payment: nil
     ); end
   end
 end
@@ -187387,6 +189595,20 @@ module Stripe
   end
 end
 # typed: true
+module Stripe
+  module Issuing
+    class ProgramRetrieveParams < ::Stripe::RequestParams
+      # Specifies which fields in the response should be expanded.
+      sig { returns(T.nilable(T::Array[String])) }
+      def expand; end
+      sig { params(_expand: T.nilable(T::Array[String])).returns(T.nilable(T::Array[String])) }
+      def expand=(_expand); end
+      sig { params(expand: T.nilable(T::Array[String])).void }
+      def initialize(expand: nil); end
+    end
+  end
+end
+# typed: true
 module Stripe
   module Issuing
     class TokenRetrieveParams < ::Stripe::RequestParams
@@ -188410,7 +190632,7 @@ module Stripe
   module TestHelpers
     module Capital
       class FinancingOfferCreateParams < ::Stripe::RequestParams
-        # Attribute for param field advance_amount
+        # Amount of financing offered, in minor units. For example, 1,000 USD is represented as 100000.
         sig { returns(Integer) }
         def advance_amount; end
         sig { params(_advance_amount: Integer).returns(Integer) }
@@ -188420,22 +190642,22 @@ module Stripe
         def expand; end
         sig { params(_expand: T.nilable(T::Array[String])).returns(T.nilable(T::Array[String])) }
         def expand=(_expand); end
-        # Attribute for param field fee_amount
+        # Fixed fee amount, in minor units. For example, 100 USD is represented as 10000.
         sig { returns(Integer) }
         def fee_amount; end
         sig { params(_fee_amount: Integer).returns(Integer) }
         def fee_amount=(_fee_amount); end
-        # Attribute for param field financing_type
+        # The type of financing offer.
         sig { returns(String) }
         def financing_type; end
         sig { params(_financing_type: String).returns(String) }
         def financing_type=(_financing_type); end
-        # Attribute for param field status
+        # The status of the financing offer.
         sig { returns(T.nilable(String)) }
         def status; end
         sig { params(_status: T.nilable(String)).returns(T.nilable(String)) }
         def status=(_status); end
-        # Attribute for param field withhold_rate
+        # Per-transaction rate at which Stripe withholds funds to repay the financing.
         sig { returns(Float) }
         def withhold_rate; end
         sig { params(_withhold_rate: Float).returns(Float) }
@@ -188460,7 +190682,7 @@ module Stripe
   module TestHelpers
     module Capital
       class FinancingOfferRefillParams < ::Stripe::RequestParams
-        # Attribute for param field advance_amount
+        # Amount of financing offered, in minor units. For example, 1,000 USD is represented as 100000.
         sig { returns(Integer) }
         def advance_amount; end
         sig { params(_advance_amount: Integer).returns(Integer) }
@@ -188470,22 +190692,22 @@ module Stripe
         def expand; end
         sig { params(_expand: T.nilable(T::Array[String])).returns(T.nilable(T::Array[String])) }
         def expand=(_expand); end
-        # Attribute for param field fee_amount
+        # Fixed fee amount, in minor units. For example, 100 USD is represented as 10000.
         sig { returns(Integer) }
         def fee_amount; end
         sig { params(_fee_amount: Integer).returns(Integer) }
         def fee_amount=(_fee_amount); end
-        # Attribute for param field financing_type
+        # The type of financing offer
         sig { returns(String) }
         def financing_type; end
         sig { params(_financing_type: String).returns(String) }
         def financing_type=(_financing_type); end
-        # Attribute for param field status
+        # The status of the financing offer
         sig { returns(T.nilable(String)) }
         def status; end
         sig { params(_status: T.nilable(String)).returns(T.nilable(String)) }
         def status=(_status); end
-        # Attribute for param field withhold_rate
+        # Per-transaction rate at which Stripe withholds funds to repay the financing.
         sig { returns(Float) }
         def withhold_rate; end
         sig { params(_withhold_rate: Float).returns(Float) }
@@ -212092,75 +214314,6 @@ module Stripe
   end
 end
 # typed: true
-module Stripe
-  module V2
-    module Tax
-      class AutomaticRuleCreateParams < ::Stripe::RequestParams
-        # The BillableItem ID to set automatic Tax configuration for.
-        sig { returns(String) }
-        def billable_item; end
-        sig { params(_billable_item: String).returns(String) }
-        def billable_item=(_billable_item); end
-        # The TaxCode object to be used for automatic tax calculations.
-        sig { returns(String) }
-        def tax_code; end
-        sig { params(_tax_code: String).returns(String) }
-        def tax_code=(_tax_code); end
-        sig { params(billable_item: String, tax_code: String).void }
-        def initialize(billable_item: nil, tax_code: nil); end
-      end
-    end
-  end
-end
-# typed: true
-module Stripe
-  module V2
-    module Tax
-      class AutomaticRuleFindParams < ::Stripe::RequestParams
-        # The BillableItem ID to search by.
-        sig { returns(String) }
-        def billable_item; end
-        sig { params(_billable_item: String).returns(String) }
-        def billable_item=(_billable_item); end
-        sig { params(billable_item: String).void }
-        def initialize(billable_item: nil); end
-      end
-    end
-  end
-end
-# typed: true
-module Stripe
-  module V2
-    module Tax
-      class AutomaticRuleRetrieveParams < ::Stripe::RequestParams; end
-    end
-  end
-end
-# typed: true
-module Stripe
-  module V2
-    module Tax
-      class AutomaticRuleUpdateParams < ::Stripe::RequestParams
-        # The TaxCode object to be used for automatic tax calculations.
-        sig { returns(String) }
-        def tax_code; end
-        sig { params(_tax_code: String).returns(String) }
-        def tax_code=(_tax_code); end
-        sig { params(tax_code: String).void }
-        def initialize(tax_code: nil); end
-      end
-    end
-  end
-end
-# typed: true
-module Stripe
-  module V2
-    module Tax
-      class AutomaticRuleDeactivateParams < ::Stripe::RequestParams; end
-    end
-  end
-end
-# typed: true
 module Stripe
   module V2
     module TestHelpers