orb-billing 1.13.0 → 1.15.0

data/lib/orb/models/plan_create_params.rb

@@ -43,6 +43,12 @@ module Orb
       #   @return [String, nil]
       optional :default_invoice_memo, String, nil?: true
 
+      # @!attribute description
+      #   An optional user-defined description of the plan.
+      #
+      #   @return [String, nil]
+      optional :description, String, nil?: true
+
       # @!attribute external_plan_id
       #
       #   @return [String, nil]
@@ -78,7 +84,7 @@ module Orb
       #   @return [Symbol, Orb::Models::PlanCreateParams::Status, nil]
       optional :status, enum: -> { Orb::PlanCreateParams::Status }
 
-      # @!method initialize(currency:, name:, prices:, adjustments: nil, default_invoice_memo: nil, external_plan_id: nil, metadata: nil, net_terms: nil, plan_phases: nil, status: nil, request_options: {})
+      # @!method initialize(currency:, name:, prices:, adjustments: nil, default_invoice_memo: nil, description: nil, external_plan_id: nil, metadata: nil, net_terms: nil, plan_phases: nil, status: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Orb::Models::PlanCreateParams} for more details.
       #
@@ -92,6 +98,8 @@ module Orb
       #
       #   @param default_invoice_memo [String, nil] Free-form text which is available on the invoice PDF and the Orb invoice portal.
       #
+      #   @param description [String, nil] An optional user-defined description of the plan.
+      #
       #   @param external_plan_id [String, nil]
       #
       #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
@@ -111,6 +119,14 @@ module Orb
         #   @return [Orb::Models::NewAllocationPrice, nil]
         optional :allocation_price, -> { Orb::NewAllocationPrice }, nil?: true
 
+        # @!attribute license_allocation_price
+        #   The license allocation price to add to the plan.
+        #
+        #   @return [Orb::Models::PlanCreateParams::Price::LicenseAllocationPrice, nil]
+        optional :license_allocation_price,
+                 -> { Orb::PlanCreateParams::Price::LicenseAllocationPrice },
+                 nil?: true
+
         # @!attribute plan_phase_order
         #   The phase to add this price to.
         #
@@ -120,15 +136,254 @@ module Orb
         # @!attribute price
         #   New plan price request body params.
         #
-        #   @return [Orb::Models::NewPlanUnitPrice, Orb::Models::NewPlanTieredPrice, Orb::Models::NewPlanBulkPrice, Orb::Models::PlanCreateParams::Price::Price::BulkWithFilters, Orb::Models::NewPlanPackagePrice, Orb::Models::NewPlanMatrixPrice, Orb::Models::NewPlanThresholdTotalAmountPrice, Orb::Models::NewPlanTieredPackagePrice, Orb::Models::NewPlanTieredWithMinimumPrice, Orb::Models::NewPlanGroupedTieredPrice, Orb::Models::NewPlanTieredPackageWithMinimumPrice, Orb::Models::NewPlanPackageWithAllocationPrice, Orb::Models::NewPlanUnitWithPercentPrice, Orb::Models::NewPlanMatrixWithAllocationPrice, Orb::Models::PlanCreateParams::Price::Price::TieredWithProration, Orb::Models::NewPlanUnitWithProrationPrice, Orb::Models::NewPlanGroupedAllocationPrice, Orb::Models::NewPlanBulkWithProrationPrice, Orb::Models::NewPlanGroupedWithProratedMinimumPrice, Orb::Models::NewPlanGroupedWithMeteredMinimumPrice, Orb::Models::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds, Orb::Models::NewPlanMatrixWithDisplayNamePrice, Orb::Models::NewPlanGroupedTieredPackagePrice, Orb::Models::NewPlanMaxGroupTieredPackagePrice, Orb::Models::NewPlanScalableMatrixWithUnitPricingPrice, Orb::Models::NewPlanScalableMatrixWithTieredPricingPrice, Orb::Models::NewPlanCumulativeGroupedBulkPrice, Orb::Models::PlanCreateParams::Price::Price::CumulativeGroupedAllocation, Orb::Models::NewPlanMinimumCompositePrice, Orb::Models::PlanCreateParams::Price::Price::Percent, Orb::Models::PlanCreateParams::Price::Price::EventOutput, nil]
+        #   @return [Orb::Models::NewPlanUnitPrice, Orb::Models::NewPlanTieredPrice, Orb::Models::NewPlanBulkPrice, Orb::Models::PlanCreateParams::Price::Price::BulkWithFilters, Orb::Models::NewPlanPackagePrice, Orb::Models::NewPlanMatrixPrice, Orb::Models::NewPlanThresholdTotalAmountPrice, Orb::Models::NewPlanTieredPackagePrice, Orb::Models::NewPlanTieredWithMinimumPrice, Orb::Models::NewPlanGroupedTieredPrice, Orb::Models::NewPlanTieredPackageWithMinimumPrice, Orb::Models::NewPlanPackageWithAllocationPrice, Orb::Models::NewPlanUnitWithPercentPrice, Orb::Models::NewPlanMatrixWithAllocationPrice, Orb::Models::PlanCreateParams::Price::Price::MatrixWithThresholdDiscounts, Orb::Models::PlanCreateParams::Price::Price::TieredWithProration, Orb::Models::NewPlanUnitWithProrationPrice, Orb::Models::NewPlanGroupedAllocationPrice, Orb::Models::NewPlanBulkWithProrationPrice, Orb::Models::NewPlanGroupedWithProratedMinimumPrice, Orb::Models::NewPlanGroupedWithMeteredMinimumPrice, Orb::Models::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds, Orb::Models::NewPlanMatrixWithDisplayNamePrice, Orb::Models::NewPlanGroupedTieredPackagePrice, Orb::Models::NewPlanMaxGroupTieredPackagePrice, Orb::Models::NewPlanScalableMatrixWithUnitPricingPrice, Orb::Models::NewPlanScalableMatrixWithTieredPricingPrice, Orb::Models::NewPlanCumulativeGroupedBulkPrice, Orb::Models::PlanCreateParams::Price::Price::CumulativeGroupedAllocation, Orb::Models::PlanCreateParams::Price::Price::DailyCreditAllowance, Orb::Models::PlanCreateParams::Price::Price::MeteredAllowance, Orb::Models::NewPlanMinimumCompositePrice, Orb::Models::PlanCreateParams::Price::Price::Percent, Orb::Models::PlanCreateParams::Price::Price::EventOutput, nil]
         optional :price, union: -> { Orb::PlanCreateParams::Price::Price }, nil?: true
 
-        # @!method initialize(allocation_price: nil, plan_phase_order: nil, price: nil)
+        # @!method initialize(allocation_price: nil, license_allocation_price: nil, plan_phase_order: nil, price: nil)
         #   @param allocation_price [Orb::Models::NewAllocationPrice, nil] The allocation price to add to the plan.
         #
+        #   @param license_allocation_price [Orb::Models::PlanCreateParams::Price::LicenseAllocationPrice, nil] The license allocation price to add to the plan.
+        #
         #   @param plan_phase_order [Integer, nil] The phase to add this price to.
         #
-        #   @param price [Orb::Models::NewPlanUnitPrice, Orb::Models::NewPlanTieredPrice, Orb::Models::NewPlanBulkPrice, Orb::Models::PlanCreateParams::Price::Price::BulkWithFilters, Orb::Models::NewPlanPackagePrice, Orb::Models::NewPlanMatrixPrice, Orb::Models::NewPlanThresholdTotalAmountPrice, Orb::Models::NewPlanTieredPackagePrice, Orb::Models::NewPlanTieredWithMinimumPrice, Orb::Models::NewPlanGroupedTieredPrice, Orb::Models::NewPlanTieredPackageWithMinimumPrice, Orb::Models::NewPlanPackageWithAllocationPrice, Orb::Models::NewPlanUnitWithPercentPrice, Orb::Models::NewPlanMatrixWithAllocationPrice, Orb::Models::PlanCreateParams::Price::Price::TieredWithProration, Orb::Models::NewPlanUnitWithProrationPrice, Orb::Models::NewPlanGroupedAllocationPrice, Orb::Models::NewPlanBulkWithProrationPrice, Orb::Models::NewPlanGroupedWithProratedMinimumPrice, Orb::Models::NewPlanGroupedWithMeteredMinimumPrice, Orb::Models::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds, Orb::Models::NewPlanMatrixWithDisplayNamePrice, Orb::Models::NewPlanGroupedTieredPackagePrice, Orb::Models::NewPlanMaxGroupTieredPackagePrice, Orb::Models::NewPlanScalableMatrixWithUnitPricingPrice, Orb::Models::NewPlanScalableMatrixWithTieredPricingPrice, Orb::Models::NewPlanCumulativeGroupedBulkPrice, Orb::Models::PlanCreateParams::Price::Price::CumulativeGroupedAllocation, Orb::Models::NewPlanMinimumCompositePrice, Orb::Models::PlanCreateParams::Price::Price::Percent, Orb::Models::PlanCreateParams::Price::Price::EventOutput, nil] New plan price request body params.
+        #   @param price [Orb::Models::NewPlanUnitPrice, Orb::Models::NewPlanTieredPrice, Orb::Models::NewPlanBulkPrice, Orb::Models::PlanCreateParams::Price::Price::BulkWithFilters, Orb::Models::NewPlanPackagePrice, Orb::Models::NewPlanMatrixPrice, Orb::Models::NewPlanThresholdTotalAmountPrice, Orb::Models::NewPlanTieredPackagePrice, Orb::Models::NewPlanTieredWithMinimumPrice, Orb::Models::NewPlanGroupedTieredPrice, Orb::Models::NewPlanTieredPackageWithMinimumPrice, Orb::Models::NewPlanPackageWithAllocationPrice, Orb::Models::NewPlanUnitWithPercentPrice, Orb::Models::NewPlanMatrixWithAllocationPrice, Orb::Models::PlanCreateParams::Price::Price::MatrixWithThresholdDiscounts, Orb::Models::PlanCreateParams::Price::Price::TieredWithProration, Orb::Models::NewPlanUnitWithProrationPrice, Orb::Models::NewPlanGroupedAllocationPrice, Orb::Models::NewPlanBulkWithProrationPrice, Orb::Models::NewPlanGroupedWithProratedMinimumPrice, Orb::Models::NewPlanGroupedWithMeteredMinimumPrice, Orb::Models::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds, Orb::Models::NewPlanMatrixWithDisplayNamePrice, Orb::Models::NewPlanGroupedTieredPackagePrice, Orb::Models::NewPlanMaxGroupTieredPackagePrice, Orb::Models::NewPlanScalableMatrixWithUnitPricingPrice, Orb::Models::NewPlanScalableMatrixWithTieredPricingPrice, Orb::Models::NewPlanCumulativeGroupedBulkPrice, Orb::Models::PlanCreateParams::Price::Price::CumulativeGroupedAllocation, Orb::Models::PlanCreateParams::Price::Price::DailyCreditAllowance, Orb::Models::PlanCreateParams::Price::Price::MeteredAllowance, Orb::Models::NewPlanMinimumCompositePrice, Orb::Models::PlanCreateParams::Price::Price::Percent, Orb::Models::PlanCreateParams::Price::Price::EventOutput, nil] New plan price request body params.
+
+        # @see Orb::Models::PlanCreateParams::Price#license_allocation_price
+        class LicenseAllocationPrice < Orb::Internal::Type::BaseModel
+          # @!attribute cadence
+          #   The cadence to bill for this price on.
+          #
+          #   @return [Symbol, Orb::Models::PlanCreateParams::Price::LicenseAllocationPrice::Cadence]
+          required :cadence, enum: -> { Orb::PlanCreateParams::Price::LicenseAllocationPrice::Cadence }
+
+          # @!attribute item_id
+          #   The id of the item the price will be associated with.
+          #
+          #   @return [String]
+          required :item_id, String
+
+          # @!attribute license_allocations
+          #   License allocations to associate with this price. Each entry defines a
+          #   per-license credit pool granted each cadence. Requires license_type_id or
+          #   license_type_configuration to be set.
+          #
+          #   @return [Array<Orb::Models::PlanCreateParams::Price::LicenseAllocationPrice::LicenseAllocation>]
+          required :license_allocations,
+                   -> { Orb::Internal::Type::ArrayOf[Orb::PlanCreateParams::Price::LicenseAllocationPrice::LicenseAllocation] }
+
+          # @!attribute model_type
+          #   The pricing model type
+          #
+          #   @return [Symbol, Orb::Models::PlanCreateParams::Price::LicenseAllocationPrice::ModelType]
+          required :model_type, enum: -> { Orb::PlanCreateParams::Price::LicenseAllocationPrice::ModelType }
+
+          # @!attribute name
+          #   The name of the price.
+          #
+          #   @return [String]
+          required :name, String
+
+          # @!attribute unit_config
+          #   Configuration for unit pricing
+          #
+          #   @return [Orb::Models::UnitConfig]
+          required :unit_config, -> { Orb::UnitConfig }
+
+          # @!attribute billable_metric_id
+          #   The id of the billable metric for the price. Only needed if the price is
+          #   usage-based.
+          #
+          #   @return [String, nil]
+          optional :billable_metric_id, String, nil?: true
+
+          # @!attribute billed_in_advance
+          #   If the Price represents a fixed cost, the price will be billed in-advance if
+          #   this is true, and in-arrears if this is false.
+          #
+          #   @return [Boolean, nil]
+          optional :billed_in_advance, Orb::Internal::Type::Boolean, nil?: true
+
+          # @!attribute billing_cycle_configuration
+          #   For custom cadence: specifies the duration of the billing period in days or
+          #   months.
+          #
+          #   @return [Orb::Models::NewBillingCycleConfiguration, nil]
+          optional :billing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
+
+          # @!attribute conversion_rate
+          #   The per unit conversion rate of the price currency to the invoicing currency.
+          #
+          #   @return [Float, nil]
+          optional :conversion_rate, Float, nil?: true
+
+          # @!attribute conversion_rate_config
+          #   The configuration for the rate of the price currency to the invoicing currency.
+          #
+          #   @return [Orb::Models::UnitConversionRateConfig, Orb::Models::TieredConversionRateConfig, nil]
+          optional :conversion_rate_config, union: -> { Orb::ConversionRateConfig }, nil?: true
+
+          # @!attribute currency
+          #   An ISO 4217 currency string, or custom pricing unit identifier, in which this
+          #   price is billed.
+          #
+          #   @return [String, nil]
+          optional :currency, String, nil?: true
+
+          # @!attribute dimensional_price_configuration
+          #   For dimensional price: specifies a price group and dimension values
+          #
+          #   @return [Orb::Models::NewDimensionalPriceConfiguration, nil]
+          optional :dimensional_price_configuration, -> { Orb::NewDimensionalPriceConfiguration }, nil?: true
+
+          # @!attribute external_price_id
+          #   An alias for the price.
+          #
+          #   @return [String, nil]
+          optional :external_price_id, String, nil?: true
+
+          # @!attribute fixed_price_quantity
+          #   If the Price represents a fixed cost, this represents the quantity of units
+          #   applied.
+          #
+          #   @return [Float, nil]
+          optional :fixed_price_quantity, Float, nil?: true
+
+          # @!attribute invoice_grouping_key
+          #   The property used to group this price on an invoice
+          #
+          #   @return [String, nil]
+          optional :invoice_grouping_key, String, nil?: true
+
+          # @!attribute invoicing_cycle_configuration
+          #   Within each billing cycle, specifies the cadence at which invoices are produced.
+          #   If unspecified, a single invoice is produced per billing cycle.
+          #
+          #   @return [Orb::Models::NewBillingCycleConfiguration, nil]
+          optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
+
+          # @!attribute license_type_id
+          #   The ID of the license type to associate with this price.
+          #
+          #   @return [String, nil]
+          optional :license_type_id, String, nil?: true
+
+          # @!attribute metadata
+          #   User-specified key/value pairs for the resource. Individual keys can be removed
+          #   by setting the value to `null`, and the entire metadata mapping can be cleared
+          #   by setting `metadata` to `null`.
+          #
+          #   @return [Hash{Symbol=>String, nil}, nil]
+          optional :metadata, Orb::Internal::Type::HashOf[String, nil?: true], nil?: true
+
+          # @!attribute reference_id
+          #   A transient ID that can be used to reference this price when adding adjustments
+          #   in the same API call.
+          #
+          #   @return [String, nil]
+          optional :reference_id, String, nil?: true
+
+          # @!method initialize(cadence:, item_id:, license_allocations:, model_type:, name:, unit_config:, billable_metric_id: nil, billed_in_advance: nil, billing_cycle_configuration: nil, conversion_rate: nil, conversion_rate_config: nil, currency: nil, dimensional_price_configuration: nil, external_price_id: nil, fixed_price_quantity: nil, invoice_grouping_key: nil, invoicing_cycle_configuration: nil, license_type_id: nil, metadata: nil, reference_id: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Orb::Models::PlanCreateParams::Price::LicenseAllocationPrice} for more details.
+          #
+          #   The license allocation price to add to the plan.
+          #
+          #   @param cadence [Symbol, Orb::Models::PlanCreateParams::Price::LicenseAllocationPrice::Cadence] The cadence to bill for this price on.
+          #
+          #   @param item_id [String] The id of the item the price will be associated with.
+          #
+          #   @param license_allocations [Array<Orb::Models::PlanCreateParams::Price::LicenseAllocationPrice::LicenseAllocation>] License allocations to associate with this price. Each entry defines a per-licen
+          #
+          #   @param model_type [Symbol, Orb::Models::PlanCreateParams::Price::LicenseAllocationPrice::ModelType] The pricing model type
+          #
+          #   @param name [String] The name of the price.
+          #
+          #   @param unit_config [Orb::Models::UnitConfig] Configuration for unit pricing
+          #
+          #   @param billable_metric_id [String, nil] The id of the billable metric for the price. Only needed if the price is usage-b
+          #
+          #   @param billed_in_advance [Boolean, nil] If the Price represents a fixed cost, the price will be billed in-advance if thi
+          #
+          #   @param billing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] For custom cadence: specifies the duration of the billing period in days or mont
+          #
+          #   @param conversion_rate [Float, nil] The per unit conversion rate of the price currency to the invoicing currency.
+          #
+          #   @param conversion_rate_config [Orb::Models::UnitConversionRateConfig, Orb::Models::TieredConversionRateConfig, nil] The configuration for the rate of the price currency to the invoicing currency.
+          #
+          #   @param currency [String, nil] An ISO 4217 currency string, or custom pricing unit identifier, in which this pr
+          #
+          #   @param dimensional_price_configuration [Orb::Models::NewDimensionalPriceConfiguration, nil] For dimensional price: specifies a price group and dimension values
+          #
+          #   @param external_price_id [String, nil] An alias for the price.
+          #
+          #   @param fixed_price_quantity [Float, nil] If the Price represents a fixed cost, this represents the quantity of units appl
+          #
+          #   @param invoice_grouping_key [String, nil] The property used to group this price on an invoice
+          #
+          #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
+          #
+          #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+          #
+          #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
+          #
+          #   @param reference_id [String, nil] A transient ID that can be used to reference this price when adding adjustments
+
+          # The cadence to bill for this price on.
+          #
+          # @see Orb::Models::PlanCreateParams::Price::LicenseAllocationPrice#cadence
+          module Cadence
+            extend Orb::Internal::Type::Enum
+
+            ANNUAL = :annual
+            SEMI_ANNUAL = :semi_annual
+            MONTHLY = :monthly
+            QUARTERLY = :quarterly
+            ONE_TIME = :one_time
+            CUSTOM = :custom
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          class LicenseAllocation < Orb::Internal::Type::BaseModel
+            # @!attribute amount
+            #   The amount of credits granted per active license per cadence.
+            #
+            #   @return [String]
+            required :amount, String
+
+            # @!attribute currency
+            #   The currency of the license allocation.
+            #
+            #   @return [String]
+            required :currency, String
+
+            # @!attribute write_off_overage
+            #   When True, overage beyond the allocation is written off.
+            #
+            #   @return [Boolean, nil]
+            optional :write_off_overage, Orb::Internal::Type::Boolean, nil?: true
+
+            # @!method initialize(amount:, currency:, write_off_overage: nil)
+            #   @param amount [String] The amount of credits granted per active license per cadence.
+            #
+            #   @param currency [String] The currency of the license allocation.
+            #
+            #   @param write_off_overage [Boolean, nil] When True, overage beyond the allocation is written off.
+          end
+
+          # The pricing model type
+          #
+          # @see Orb::Models::PlanCreateParams::Price::LicenseAllocationPrice#model_type
+          module ModelType
+            extend Orb::Internal::Type::Enum
+
+            UNIT = :unit
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
 
         # New plan price request body params.
         #
@@ -166,6 +421,9 @@ module Orb
 
           variant :matrix_with_allocation, -> { Orb::NewPlanMatrixWithAllocationPrice }
 
+          variant :matrix_with_threshold_discounts,
+                  -> { Orb::PlanCreateParams::Price::Price::MatrixWithThresholdDiscounts }
+
           variant :tiered_with_proration, -> { Orb::PlanCreateParams::Price::Price::TieredWithProration }
 
           variant :unit_with_proration, -> { Orb::NewPlanUnitWithProrationPrice }
@@ -196,6 +454,10 @@ module Orb
           variant :cumulative_grouped_allocation,
                   -> { Orb::PlanCreateParams::Price::Price::CumulativeGroupedAllocation }
 
+          variant :daily_credit_allowance, -> { Orb::PlanCreateParams::Price::Price::DailyCreditAllowance }
+
+          variant :metered_allowance, -> { Orb::PlanCreateParams::Price::Price::MeteredAllowance }
+
           variant :minimum_composite, -> { Orb::NewPlanMinimumCompositePrice }
 
           variant :percent, -> { Orb::PlanCreateParams::Price::Price::Percent }
@@ -265,9 +527,7 @@ module Orb
             #   The configuration for the rate of the price currency to the invoicing currency.
             #
             #   @return [Orb::Models::UnitConversionRateConfig, Orb::Models::TieredConversionRateConfig, nil]
-            optional :conversion_rate_config,
-                     union: -> { Orb::PlanCreateParams::Price::Price::BulkWithFilters::ConversionRateConfig },
-                     nil?: true
+            optional :conversion_rate_config, union: -> { Orb::ConversionRateConfig }, nil?: true
 
             # @!attribute currency
             #   An ISO 4217 currency string, or custom pricing unit identifier, in which this
@@ -459,12 +719,12 @@ module Orb
             end
           end
 
-          class TieredWithProration < Orb::Internal::Type::BaseModel
+          class MatrixWithThresholdDiscounts < Orb::Internal::Type::BaseModel
             # @!attribute cadence
             #   The cadence to bill for this price on.
             #
-            #   @return [Symbol, Orb::Models::PlanCreateParams::Price::Price::TieredWithProration::Cadence]
-            required :cadence, enum: -> { Orb::PlanCreateParams::Price::Price::TieredWithProration::Cadence }
+            #   @return [Symbol, Orb::Models::PlanCreateParams::Price::Price::MatrixWithThresholdDiscounts::Cadence]
+            required :cadence, enum: -> { Orb::PlanCreateParams::Price::Price::MatrixWithThresholdDiscounts::Cadence }
 
             # @!attribute item_id
             #   The id of the item the price will be associated with.
@@ -472,11 +732,18 @@ module Orb
             #   @return [String]
             required :item_id, String
 
+            # @!attribute matrix_with_threshold_discounts_config
+            #   Configuration for matrix_with_threshold_discounts pricing
+            #
+            #   @return [Orb::Models::PlanCreateParams::Price::Price::MatrixWithThresholdDiscounts::MatrixWithThresholdDiscountsConfig]
+            required :matrix_with_threshold_discounts_config,
+                     -> { Orb::PlanCreateParams::Price::Price::MatrixWithThresholdDiscounts::MatrixWithThresholdDiscountsConfig }
+
             # @!attribute model_type
             #   The pricing model type
             #
-            #   @return [Symbol, :tiered_with_proration]
-            required :model_type, const: :tiered_with_proration
+            #   @return [Symbol, :matrix_with_threshold_discounts]
+            required :model_type, const: :matrix_with_threshold_discounts
 
             # @!attribute name
             #   The name of the price.
@@ -484,13 +751,6 @@ module Orb
             #   @return [String]
             required :name, String
 
-            # @!attribute tiered_with_proration_config
-            #   Configuration for tiered_with_proration pricing
-            #
-            #   @return [Orb::Models::PlanCreateParams::Price::Price::TieredWithProration::TieredWithProrationConfig]
-            required :tiered_with_proration_config,
-                     -> { Orb::PlanCreateParams::Price::Price::TieredWithProration::TieredWithProrationConfig }
-
             # @!attribute billable_metric_id
             #   The id of the billable metric for the price. Only needed if the price is
             #   usage-based.
@@ -522,11 +782,7 @@ module Orb
             #   The configuration for the rate of the price currency to the invoicing currency.
             #
             #   @return [Orb::Models::UnitConversionRateConfig, Orb::Models::TieredConversionRateConfig, nil]
-            optional :conversion_rate_config,
-                     union: -> {
-                       Orb::PlanCreateParams::Price::Price::TieredWithProration::ConversionRateConfig
-                     },
-                     nil?: true
+            optional :conversion_rate_config, union: -> { Orb::ConversionRateConfig }, nil?: true
 
             # @!attribute currency
             #   An ISO 4217 currency string, or custom pricing unit identifier, in which this
@@ -592,18 +848,18 @@ module Orb
             #   @return [String, nil]
             optional :reference_id, String, nil?: true
 
-            # @!method initialize(cadence:, item_id:, name:, tiered_with_proration_config:, billable_metric_id: nil, billed_in_advance: nil, billing_cycle_configuration: nil, conversion_rate: nil, conversion_rate_config: nil, currency: nil, dimensional_price_configuration: nil, external_price_id: nil, fixed_price_quantity: nil, invoice_grouping_key: nil, invoicing_cycle_configuration: nil, license_type_id: nil, metadata: nil, reference_id: nil, model_type: :tiered_with_proration)
+            # @!method initialize(cadence:, item_id:, matrix_with_threshold_discounts_config:, name:, billable_metric_id: nil, billed_in_advance: nil, billing_cycle_configuration: nil, conversion_rate: nil, conversion_rate_config: nil, currency: nil, dimensional_price_configuration: nil, external_price_id: nil, fixed_price_quantity: nil, invoice_grouping_key: nil, invoicing_cycle_configuration: nil, license_type_id: nil, metadata: nil, reference_id: nil, model_type: :matrix_with_threshold_discounts)
             #   Some parameter documentations has been truncated, see
-            #   {Orb::Models::PlanCreateParams::Price::Price::TieredWithProration} for more
-            #   details.
+            #   {Orb::Models::PlanCreateParams::Price::Price::MatrixWithThresholdDiscounts} for
+            #   more details.
             #
-            #   @param cadence [Symbol, Orb::Models::PlanCreateParams::Price::Price::TieredWithProration::Cadence] The cadence to bill for this price on.
+            #   @param cadence [Symbol, Orb::Models::PlanCreateParams::Price::Price::MatrixWithThresholdDiscounts::Cadence] The cadence to bill for this price on.
             #
             #   @param item_id [String] The id of the item the price will be associated with.
             #
-            #   @param name [String] The name of the price.
+            #   @param matrix_with_threshold_discounts_config [Orb::Models::PlanCreateParams::Price::Price::MatrixWithThresholdDiscounts::MatrixWithThresholdDiscountsConfig] Configuration for matrix_with_threshold_discounts pricing
             #
-            #   @param tiered_with_proration_config [Orb::Models::PlanCreateParams::Price::Price::TieredWithProration::TieredWithProrationConfig] Configuration for tiered_with_proration pricing
+            #   @param name [String] The name of the price.
             #
             #   @param billable_metric_id [String, nil] The id of the billable metric for the price. Only needed if the price is usage-b
             #
@@ -633,11 +889,11 @@ module Orb
             #
             #   @param reference_id [String, nil] A transient ID that can be used to reference this price when adding adjustments
             #
-            #   @param model_type [Symbol, :tiered_with_proration] The pricing model type
+            #   @param model_type [Symbol, :matrix_with_threshold_discounts] The pricing model type
 
             # The cadence to bill for this price on.
             #
-            # @see Orb::Models::PlanCreateParams::Price::Price::TieredWithProration#cadence
+            # @see Orb::Models::PlanCreateParams::Price::Price::MatrixWithThresholdDiscounts#cadence
             module Cadence
               extend Orb::Internal::Type::Enum
 
@@ -652,61 +908,138 @@ module Orb
               #   @return [Array<Symbol>]
             end
 
-            # @see Orb::Models::PlanCreateParams::Price::Price::TieredWithProration#tiered_with_proration_config
-            class TieredWithProrationConfig < Orb::Internal::Type::BaseModel
-              # @!attribute tiers
-              #   Tiers for rating based on total usage quantities into the specified tier with
-              #   proration
+            # @see Orb::Models::PlanCreateParams::Price::Price::MatrixWithThresholdDiscounts#matrix_with_threshold_discounts_config
+            class MatrixWithThresholdDiscountsConfig < Orb::Internal::Type::BaseModel
+              # @!attribute default_unit_amount
+              #   Unit price used for usage that does not match any defined matrix cell.
               #
-              #   @return [Array<Orb::Models::PlanCreateParams::Price::Price::TieredWithProration::TieredWithProrationConfig::Tier>]
-              required :tiers,
-                       -> { Orb::Internal::Type::ArrayOf[Orb::PlanCreateParams::Price::Price::TieredWithProration::TieredWithProrationConfig::Tier] }
+              #   @return [String]
+              required :default_unit_amount, String
 
-              # @!method initialize(tiers:)
-              #   Some parameter documentations has been truncated, see
-              #   {Orb::Models::PlanCreateParams::Price::Price::TieredWithProration::TieredWithProrationConfig}
-              #   for more details.
+              # @!attribute first_dimension
+              #   First matrix dimension key.
               #
-              #   Configuration for tiered_with_proration pricing
+              #   @return [String]
+              required :first_dimension, String
+
+              # @!attribute matrix_values
+              #   Per-cell unit prices.
               #
-              #   @param tiers [Array<Orb::Models::PlanCreateParams::Price::Price::TieredWithProration::TieredWithProrationConfig::Tier>] Tiers for rating based on total usage quantities into the specified tier with pr
+              #   @return [Array<Orb::Models::PlanCreateParams::Price::Price::MatrixWithThresholdDiscounts::MatrixWithThresholdDiscountsConfig::MatrixValue>]
+              required :matrix_values,
+                       -> do
+                         Orb::Internal::Type::ArrayOf[
+                           Orb::PlanCreateParams::Price::Price::MatrixWithThresholdDiscounts::MatrixWithThresholdDiscountsConfig::MatrixValue
+                         ]
+                       end
+
+              # @!attribute second_dimension
+              #   Optional second matrix dimension key.
+              #
+              #   @return [String, nil]
+              optional :second_dimension, String, nil?: true
 
-              class Tier < Orb::Internal::Type::BaseModel
-                # @!attribute tier_lower_bound
-                #   Inclusive tier starting value
+              # @!attribute threshold_discount_groups
+              #
+              #   @return [Array<Orb::Models::PlanCreateParams::Price::Price::MatrixWithThresholdDiscounts::MatrixWithThresholdDiscountsConfig::ThresholdDiscountGroup>, nil]
+              optional :threshold_discount_groups,
+                       -> do
+                         Orb::Internal::Type::ArrayOf[
+                           Orb::PlanCreateParams::Price::Price::MatrixWithThresholdDiscounts::MatrixWithThresholdDiscountsConfig::ThresholdDiscountGroup
+                         ]
+                       end
+
+              # @!method initialize(default_unit_amount:, first_dimension:, matrix_values:, second_dimension: nil, threshold_discount_groups: nil)
+              #   Configuration for matrix_with_threshold_discounts pricing
+              #
+              #   @param default_unit_amount [String] Unit price used for usage that does not match any defined matrix cell.
+              #
+              #   @param first_dimension [String] First matrix dimension key.
+              #
+              #   @param matrix_values [Array<Orb::Models::PlanCreateParams::Price::Price::MatrixWithThresholdDiscounts::MatrixWithThresholdDiscountsConfig::MatrixValue>] Per-cell unit prices.
+              #
+              #   @param second_dimension [String, nil] Optional second matrix dimension key.
+              #
+              #   @param threshold_discount_groups [Array<Orb::Models::PlanCreateParams::Price::Price::MatrixWithThresholdDiscounts::MatrixWithThresholdDiscountsConfig::ThresholdDiscountGroup>]
+
+              class MatrixValue < Orb::Internal::Type::BaseModel
+                # @!attribute first_dimension_value
                 #
                 #   @return [String]
-                required :tier_lower_bound, String
+                required :first_dimension_value, String
 
                 # @!attribute unit_amount
-                #   Amount per unit
                 #
                 #   @return [String]
                 required :unit_amount, String
 
-                # @!method initialize(tier_lower_bound:, unit_amount:)
-                #   Configuration for a single tiered with proration tier
+                # @!attribute second_dimension_value
                 #
-                #   @param tier_lower_bound [String] Inclusive tier starting value
+                #   @return [String, nil]
+                optional :second_dimension_value, String, nil?: true
+
+                # @!method initialize(first_dimension_value:, unit_amount:, second_dimension_value: nil)
+                #   @param first_dimension_value [String]
+                #   @param unit_amount [String]
+                #   @param second_dimension_value [String, nil]
+              end
+
+              class ThresholdDiscountGroup < Orb::Internal::Type::BaseModel
+                # @!attribute above_threshold_discount_percentage
+                #   Discount rate applied to spend above the threshold.
                 #
-                #   @param unit_amount [String] Amount per unit
+                #   @return [String]
+                required :above_threshold_discount_percentage, String
+
+                # @!attribute below_threshold_discount_percentage
+                #   Discount rate applied to spend at or below the threshold. Set to 0 for no
+                #   baseline discount.
+                #
+                #   @return [String]
+                required :below_threshold_discount_percentage, String
+
+                # @!attribute cell_coordinates
+                #   Semicolon-separated list of matrix cell coordinates targeted by this group. Each
+                #   coordinate is `first,second` when the matrix has two dimensions, or just `first`
+                #   for a single-dimension matrix. Example: `blue,circle;green,triangle`.
+                #
+                #   @return [String]
+                required :cell_coordinates, String
+
+                # @!attribute threshold_amount
+                #
+                #   @return [String]
+                required :threshold_amount, String
+
+                # @!attribute description
+                #
+                #   @return [String, nil]
+                optional :description, String, nil?: true
+
+                # @!method initialize(above_threshold_discount_percentage:, below_threshold_discount_percentage:, cell_coordinates:, threshold_amount:, description: nil)
+                #   Some parameter documentations has been truncated, see
+                #   {Orb::Models::PlanCreateParams::Price::Price::MatrixWithThresholdDiscounts::MatrixWithThresholdDiscountsConfig::ThresholdDiscountGroup}
+                #   for more details.
+                #
+                #   @param above_threshold_discount_percentage [String] Discount rate applied to spend above the threshold.
+                #
+                #   @param below_threshold_discount_percentage [String] Discount rate applied to spend at or below the threshold. Set to 0 for no baseli
+                #
+                #   @param cell_coordinates [String] Semicolon-separated list of matrix cell coordinates targeted by this group. Each
+                #
+                #   @param threshold_amount [String]
+                #
+                #   @param description [String, nil]
               end
             end
           end
 
-          class GroupedWithMinMaxThresholds < Orb::Internal::Type::BaseModel
+          class TieredWithProration < Orb::Internal::Type::BaseModel
             # @!attribute cadence
             #   The cadence to bill for this price on.
             #
-            #   @return [Symbol, Orb::Models::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds::Cadence]
-            required :cadence, enum: -> { Orb::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds::Cadence }
-
-            # @!attribute grouped_with_min_max_thresholds_config
-            #   Configuration for grouped_with_min_max_thresholds pricing
-            #
-            #   @return [Orb::Models::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds::GroupedWithMinMaxThresholdsConfig]
-            required :grouped_with_min_max_thresholds_config,
-                     -> { Orb::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds::GroupedWithMinMaxThresholdsConfig }
+            #   @return [Symbol, Orb::Models::PlanCreateParams::Price::Price::TieredWithProration::Cadence]
+            required :cadence, enum: -> { Orb::PlanCreateParams::Price::Price::TieredWithProration::Cadence }
 
             # @!attribute item_id
             #   The id of the item the price will be associated with.
@@ -717,8 +1050,8 @@ module Orb
             # @!attribute model_type
             #   The pricing model type
             #
-            #   @return [Symbol, :grouped_with_min_max_thresholds]
-            required :model_type, const: :grouped_with_min_max_thresholds
+            #   @return [Symbol, :tiered_with_proration]
+            required :model_type, const: :tiered_with_proration
 
             # @!attribute name
             #   The name of the price.
@@ -726,6 +1059,13 @@ module Orb
             #   @return [String]
             required :name, String
 
+            # @!attribute tiered_with_proration_config
+            #   Configuration for tiered_with_proration pricing
+            #
+            #   @return [Orb::Models::PlanCreateParams::Price::Price::TieredWithProration::TieredWithProrationConfig]
+            required :tiered_with_proration_config,
+                     -> { Orb::PlanCreateParams::Price::Price::TieredWithProration::TieredWithProrationConfig }
+
             # @!attribute billable_metric_id
             #   The id of the billable metric for the price. Only needed if the price is
             #   usage-based.
@@ -757,11 +1097,7 @@ module Orb
             #   The configuration for the rate of the price currency to the invoicing currency.
             #
             #   @return [Orb::Models::UnitConversionRateConfig, Orb::Models::TieredConversionRateConfig, nil]
-            optional :conversion_rate_config,
-                     union: -> {
-                       Orb::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds::ConversionRateConfig
-                     },
-                     nil?: true
+            optional :conversion_rate_config, union: -> { Orb::ConversionRateConfig }, nil?: true
 
             # @!attribute currency
             #   An ISO 4217 currency string, or custom pricing unit identifier, in which this
@@ -827,19 +1163,19 @@ module Orb
             #   @return [String, nil]
             optional :reference_id, String, nil?: true
 
-            # @!method initialize(cadence:, grouped_with_min_max_thresholds_config:, item_id:, name:, billable_metric_id: nil, billed_in_advance: nil, billing_cycle_configuration: nil, conversion_rate: nil, conversion_rate_config: nil, currency: nil, dimensional_price_configuration: nil, external_price_id: nil, fixed_price_quantity: nil, invoice_grouping_key: nil, invoicing_cycle_configuration: nil, license_type_id: nil, metadata: nil, reference_id: nil, model_type: :grouped_with_min_max_thresholds)
+            # @!method initialize(cadence:, item_id:, name:, tiered_with_proration_config:, billable_metric_id: nil, billed_in_advance: nil, billing_cycle_configuration: nil, conversion_rate: nil, conversion_rate_config: nil, currency: nil, dimensional_price_configuration: nil, external_price_id: nil, fixed_price_quantity: nil, invoice_grouping_key: nil, invoicing_cycle_configuration: nil, license_type_id: nil, metadata: nil, reference_id: nil, model_type: :tiered_with_proration)
             #   Some parameter documentations has been truncated, see
-            #   {Orb::Models::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds} for
-            #   more details.
-            #
-            #   @param cadence [Symbol, Orb::Models::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds::Cadence] The cadence to bill for this price on.
+            #   {Orb::Models::PlanCreateParams::Price::Price::TieredWithProration} for more
+            #   details.
             #
-            #   @param grouped_with_min_max_thresholds_config [Orb::Models::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds::GroupedWithMinMaxThresholdsConfig] Configuration for grouped_with_min_max_thresholds pricing
+            #   @param cadence [Symbol, Orb::Models::PlanCreateParams::Price::Price::TieredWithProration::Cadence] The cadence to bill for this price on.
             #
             #   @param item_id [String] The id of the item the price will be associated with.
             #
             #   @param name [String] The name of the price.
             #
+            #   @param tiered_with_proration_config [Orb::Models::PlanCreateParams::Price::Price::TieredWithProration::TieredWithProrationConfig] Configuration for tiered_with_proration pricing
+            #
             #   @param billable_metric_id [String, nil] The id of the billable metric for the price. Only needed if the price is usage-b
             #
             #   @param billed_in_advance [Boolean, nil] If the Price represents a fixed cost, the price will be billed in-advance if thi
@@ -868,11 +1204,11 @@ module Orb
             #
             #   @param reference_id [String, nil] A transient ID that can be used to reference this price when adding adjustments
             #
-            #   @param model_type [Symbol, :grouped_with_min_max_thresholds] The pricing model type
+            #   @param model_type [Symbol, :tiered_with_proration] The pricing model type
 
             # The cadence to bill for this price on.
             #
-            # @see Orb::Models::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds#cadence
+            # @see Orb::Models::PlanCreateParams::Price::Price::TieredWithProration#cadence
             module Cadence
               extend Orb::Internal::Type::Enum
 
@@ -887,58 +1223,61 @@ module Orb
               #   @return [Array<Symbol>]
             end
 
-            # @see Orb::Models::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds#grouped_with_min_max_thresholds_config
-            class GroupedWithMinMaxThresholdsConfig < Orb::Internal::Type::BaseModel
-              # @!attribute grouping_key
-              #   The event property used to group before applying thresholds
+            # @see Orb::Models::PlanCreateParams::Price::Price::TieredWithProration#tiered_with_proration_config
+            class TieredWithProrationConfig < Orb::Internal::Type::BaseModel
+              # @!attribute tiers
+              #   Tiers for rating based on total usage quantities into the specified tier with
+              #   proration
               #
-              #   @return [String]
-              required :grouping_key, String
+              #   @return [Array<Orb::Models::PlanCreateParams::Price::Price::TieredWithProration::TieredWithProrationConfig::Tier>]
+              required :tiers,
+                       -> { Orb::Internal::Type::ArrayOf[Orb::PlanCreateParams::Price::Price::TieredWithProration::TieredWithProrationConfig::Tier] }
 
-              # @!attribute maximum_charge
-              #   The maximum amount to charge each group
+              # @!method initialize(tiers:)
+              #   Some parameter documentations has been truncated, see
+              #   {Orb::Models::PlanCreateParams::Price::Price::TieredWithProration::TieredWithProrationConfig}
+              #   for more details.
               #
-              #   @return [String]
-              required :maximum_charge, String
-
-              # @!attribute minimum_charge
-              #   The minimum amount to charge each group, regardless of usage
+              #   Configuration for tiered_with_proration pricing
               #
-              #   @return [String]
-              required :minimum_charge, String
+              #   @param tiers [Array<Orb::Models::PlanCreateParams::Price::Price::TieredWithProration::TieredWithProrationConfig::Tier>] Tiers for rating based on total usage quantities into the specified tier with pr
 
-              # @!attribute per_unit_rate
-              #   The base price charged per group
-              #
-              #   @return [String]
-              required :per_unit_rate, String
+              class Tier < Orb::Internal::Type::BaseModel
+                # @!attribute tier_lower_bound
+                #   Inclusive tier starting value
+                #
+                #   @return [String]
+                required :tier_lower_bound, String
 
-              # @!method initialize(grouping_key:, maximum_charge:, minimum_charge:, per_unit_rate:)
-              #   Configuration for grouped_with_min_max_thresholds pricing
-              #
-              #   @param grouping_key [String] The event property used to group before applying thresholds
-              #
-              #   @param maximum_charge [String] The maximum amount to charge each group
-              #
-              #   @param minimum_charge [String] The minimum amount to charge each group, regardless of usage
-              #
-              #   @param per_unit_rate [String] The base price charged per group
+                # @!attribute unit_amount
+                #   Amount per unit
+                #
+                #   @return [String]
+                required :unit_amount, String
+
+                # @!method initialize(tier_lower_bound:, unit_amount:)
+                #   Configuration for a single tiered with proration tier
+                #
+                #   @param tier_lower_bound [String] Inclusive tier starting value
+                #
+                #   @param unit_amount [String] Amount per unit
+              end
             end
           end
 
-          class CumulativeGroupedAllocation < Orb::Internal::Type::BaseModel
+          class GroupedWithMinMaxThresholds < Orb::Internal::Type::BaseModel
             # @!attribute cadence
             #   The cadence to bill for this price on.
             #
-            #   @return [Symbol, Orb::Models::PlanCreateParams::Price::Price::CumulativeGroupedAllocation::Cadence]
-            required :cadence, enum: -> { Orb::PlanCreateParams::Price::Price::CumulativeGroupedAllocation::Cadence }
+            #   @return [Symbol, Orb::Models::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds::Cadence]
+            required :cadence, enum: -> { Orb::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds::Cadence }
 
-            # @!attribute cumulative_grouped_allocation_config
-            #   Configuration for cumulative_grouped_allocation pricing
+            # @!attribute grouped_with_min_max_thresholds_config
+            #   Configuration for grouped_with_min_max_thresholds pricing
             #
-            #   @return [Orb::Models::PlanCreateParams::Price::Price::CumulativeGroupedAllocation::CumulativeGroupedAllocationConfig]
-            required :cumulative_grouped_allocation_config,
-                     -> { Orb::PlanCreateParams::Price::Price::CumulativeGroupedAllocation::CumulativeGroupedAllocationConfig }
+            #   @return [Orb::Models::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds::GroupedWithMinMaxThresholdsConfig]
+            required :grouped_with_min_max_thresholds_config,
+                     -> { Orb::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds::GroupedWithMinMaxThresholdsConfig }
 
             # @!attribute item_id
             #   The id of the item the price will be associated with.
@@ -949,8 +1288,8 @@ module Orb
             # @!attribute model_type
             #   The pricing model type
             #
-            #   @return [Symbol, :cumulative_grouped_allocation]
-            required :model_type, const: :cumulative_grouped_allocation
+            #   @return [Symbol, :grouped_with_min_max_thresholds]
+            required :model_type, const: :grouped_with_min_max_thresholds
 
             # @!attribute name
             #   The name of the price.
@@ -989,11 +1328,7 @@ module Orb
             #   The configuration for the rate of the price currency to the invoicing currency.
             #
             #   @return [Orb::Models::UnitConversionRateConfig, Orb::Models::TieredConversionRateConfig, nil]
-            optional :conversion_rate_config,
-                     union: -> {
-                       Orb::PlanCreateParams::Price::Price::CumulativeGroupedAllocation::ConversionRateConfig
-                     },
-                     nil?: true
+            optional :conversion_rate_config, union: -> { Orb::ConversionRateConfig }, nil?: true
 
             # @!attribute currency
             #   An ISO 4217 currency string, or custom pricing unit identifier, in which this
@@ -1059,14 +1394,14 @@ module Orb
             #   @return [String, nil]
             optional :reference_id, String, nil?: true
 
-            # @!method initialize(cadence:, cumulative_grouped_allocation_config:, item_id:, name:, billable_metric_id: nil, billed_in_advance: nil, billing_cycle_configuration: nil, conversion_rate: nil, conversion_rate_config: nil, currency: nil, dimensional_price_configuration: nil, external_price_id: nil, fixed_price_quantity: nil, invoice_grouping_key: nil, invoicing_cycle_configuration: nil, license_type_id: nil, metadata: nil, reference_id: nil, model_type: :cumulative_grouped_allocation)
+            # @!method initialize(cadence:, grouped_with_min_max_thresholds_config:, item_id:, name:, billable_metric_id: nil, billed_in_advance: nil, billing_cycle_configuration: nil, conversion_rate: nil, conversion_rate_config: nil, currency: nil, dimensional_price_configuration: nil, external_price_id: nil, fixed_price_quantity: nil, invoice_grouping_key: nil, invoicing_cycle_configuration: nil, license_type_id: nil, metadata: nil, reference_id: nil, model_type: :grouped_with_min_max_thresholds)
             #   Some parameter documentations has been truncated, see
-            #   {Orb::Models::PlanCreateParams::Price::Price::CumulativeGroupedAllocation} for
+            #   {Orb::Models::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds} for
             #   more details.
             #
-            #   @param cadence [Symbol, Orb::Models::PlanCreateParams::Price::Price::CumulativeGroupedAllocation::Cadence] The cadence to bill for this price on.
+            #   @param cadence [Symbol, Orb::Models::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds::Cadence] The cadence to bill for this price on.
             #
-            #   @param cumulative_grouped_allocation_config [Orb::Models::PlanCreateParams::Price::Price::CumulativeGroupedAllocation::CumulativeGroupedAllocationConfig] Configuration for cumulative_grouped_allocation pricing
+            #   @param grouped_with_min_max_thresholds_config [Orb::Models::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds::GroupedWithMinMaxThresholdsConfig] Configuration for grouped_with_min_max_thresholds pricing
             #
             #   @param item_id [String] The id of the item the price will be associated with.
             #
@@ -1100,11 +1435,11 @@ module Orb
             #
             #   @param reference_id [String, nil] A transient ID that can be used to reference this price when adding adjustments
             #
-            #   @param model_type [Symbol, :cumulative_grouped_allocation] The pricing model type
+            #   @param model_type [Symbol, :grouped_with_min_max_thresholds] The pricing model type
 
             # The cadence to bill for this price on.
             #
-            # @see Orb::Models::PlanCreateParams::Price::Price::CumulativeGroupedAllocation#cadence
+            # @see Orb::Models::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds#cadence
             module Cadence
               extend Orb::Internal::Type::Enum
 
@@ -1119,42 +1454,794 @@ module Orb
               #   @return [Array<Symbol>]
             end
 
-            # @see Orb::Models::PlanCreateParams::Price::Price::CumulativeGroupedAllocation#cumulative_grouped_allocation_config
-            class CumulativeGroupedAllocationConfig < Orb::Internal::Type::BaseModel
+            # @see Orb::Models::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds#grouped_with_min_max_thresholds_config
+            class GroupedWithMinMaxThresholdsConfig < Orb::Internal::Type::BaseModel
+              # @!attribute grouping_key
+              #   The event property used to group before applying thresholds
+              #
+              #   @return [String]
+              required :grouping_key, String
+
+              # @!attribute maximum_charge
+              #   The maximum amount to charge each group
+              #
+              #   @return [String]
+              required :maximum_charge, String
+
+              # @!attribute minimum_charge
+              #   The minimum amount to charge each group, regardless of usage
+              #
+              #   @return [String]
+              required :minimum_charge, String
+
+              # @!attribute per_unit_rate
+              #   The base price charged per group
+              #
+              #   @return [String]
+              required :per_unit_rate, String
+
+              # @!method initialize(grouping_key:, maximum_charge:, minimum_charge:, per_unit_rate:)
+              #   Configuration for grouped_with_min_max_thresholds pricing
+              #
+              #   @param grouping_key [String] The event property used to group before applying thresholds
+              #
+              #   @param maximum_charge [String] The maximum amount to charge each group
+              #
+              #   @param minimum_charge [String] The minimum amount to charge each group, regardless of usage
+              #
+              #   @param per_unit_rate [String] The base price charged per group
+            end
+          end
+
+          class CumulativeGroupedAllocation < Orb::Internal::Type::BaseModel
+            # @!attribute cadence
+            #   The cadence to bill for this price on.
+            #
+            #   @return [Symbol, Orb::Models::PlanCreateParams::Price::Price::CumulativeGroupedAllocation::Cadence]
+            required :cadence, enum: -> { Orb::PlanCreateParams::Price::Price::CumulativeGroupedAllocation::Cadence }
+
+            # @!attribute cumulative_grouped_allocation_config
+            #   Configuration for cumulative_grouped_allocation pricing
+            #
+            #   @return [Orb::Models::PlanCreateParams::Price::Price::CumulativeGroupedAllocation::CumulativeGroupedAllocationConfig]
+            required :cumulative_grouped_allocation_config,
+                     -> { Orb::PlanCreateParams::Price::Price::CumulativeGroupedAllocation::CumulativeGroupedAllocationConfig }
+
+            # @!attribute item_id
+            #   The id of the item the price will be associated with.
+            #
+            #   @return [String]
+            required :item_id, String
+
+            # @!attribute model_type
+            #   The pricing model type
+            #
+            #   @return [Symbol, :cumulative_grouped_allocation]
+            required :model_type, const: :cumulative_grouped_allocation
+
+            # @!attribute name
+            #   The name of the price.
+            #
+            #   @return [String]
+            required :name, String
+
+            # @!attribute billable_metric_id
+            #   The id of the billable metric for the price. Only needed if the price is
+            #   usage-based.
+            #
+            #   @return [String, nil]
+            optional :billable_metric_id, String, nil?: true
+
+            # @!attribute billed_in_advance
+            #   If the Price represents a fixed cost, the price will be billed in-advance if
+            #   this is true, and in-arrears if this is false.
+            #
+            #   @return [Boolean, nil]
+            optional :billed_in_advance, Orb::Internal::Type::Boolean, nil?: true
+
+            # @!attribute billing_cycle_configuration
+            #   For custom cadence: specifies the duration of the billing period in days or
+            #   months.
+            #
+            #   @return [Orb::Models::NewBillingCycleConfiguration, nil]
+            optional :billing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
+
+            # @!attribute conversion_rate
+            #   The per unit conversion rate of the price currency to the invoicing currency.
+            #
+            #   @return [Float, nil]
+            optional :conversion_rate, Float, nil?: true
+
+            # @!attribute conversion_rate_config
+            #   The configuration for the rate of the price currency to the invoicing currency.
+            #
+            #   @return [Orb::Models::UnitConversionRateConfig, Orb::Models::TieredConversionRateConfig, nil]
+            optional :conversion_rate_config, union: -> { Orb::ConversionRateConfig }, nil?: true
+
+            # @!attribute currency
+            #   An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            #   price is billed.
+            #
+            #   @return [String, nil]
+            optional :currency, String, nil?: true
+
+            # @!attribute dimensional_price_configuration
+            #   For dimensional price: specifies a price group and dimension values
+            #
+            #   @return [Orb::Models::NewDimensionalPriceConfiguration, nil]
+            optional :dimensional_price_configuration,
+                     -> {
+                       Orb::NewDimensionalPriceConfiguration
+                     },
+                     nil?: true
+
+            # @!attribute external_price_id
+            #   An alias for the price.
+            #
+            #   @return [String, nil]
+            optional :external_price_id, String, nil?: true
+
+            # @!attribute fixed_price_quantity
+            #   If the Price represents a fixed cost, this represents the quantity of units
+            #   applied.
+            #
+            #   @return [Float, nil]
+            optional :fixed_price_quantity, Float, nil?: true
+
+            # @!attribute invoice_grouping_key
+            #   The property used to group this price on an invoice
+            #
+            #   @return [String, nil]
+            optional :invoice_grouping_key, String, nil?: true
+
+            # @!attribute invoicing_cycle_configuration
+            #   Within each billing cycle, specifies the cadence at which invoices are produced.
+            #   If unspecified, a single invoice is produced per billing cycle.
+            #
+            #   @return [Orb::Models::NewBillingCycleConfiguration, nil]
+            optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
+
+            # @!attribute license_type_id
+            #   The ID of the license type to associate with this price.
+            #
+            #   @return [String, nil]
+            optional :license_type_id, String, nil?: true
+
+            # @!attribute metadata
+            #   User-specified key/value pairs for the resource. Individual keys can be removed
+            #   by setting the value to `null`, and the entire metadata mapping can be cleared
+            #   by setting `metadata` to `null`.
+            #
+            #   @return [Hash{Symbol=>String, nil}, nil]
+            optional :metadata, Orb::Internal::Type::HashOf[String, nil?: true], nil?: true
+
+            # @!attribute reference_id
+            #   A transient ID that can be used to reference this price when adding adjustments
+            #   in the same API call.
+            #
+            #   @return [String, nil]
+            optional :reference_id, String, nil?: true
+
+            # @!method initialize(cadence:, cumulative_grouped_allocation_config:, item_id:, name:, billable_metric_id: nil, billed_in_advance: nil, billing_cycle_configuration: nil, conversion_rate: nil, conversion_rate_config: nil, currency: nil, dimensional_price_configuration: nil, external_price_id: nil, fixed_price_quantity: nil, invoice_grouping_key: nil, invoicing_cycle_configuration: nil, license_type_id: nil, metadata: nil, reference_id: nil, model_type: :cumulative_grouped_allocation)
+            #   Some parameter documentations has been truncated, see
+            #   {Orb::Models::PlanCreateParams::Price::Price::CumulativeGroupedAllocation} for
+            #   more details.
+            #
+            #   @param cadence [Symbol, Orb::Models::PlanCreateParams::Price::Price::CumulativeGroupedAllocation::Cadence] The cadence to bill for this price on.
+            #
+            #   @param cumulative_grouped_allocation_config [Orb::Models::PlanCreateParams::Price::Price::CumulativeGroupedAllocation::CumulativeGroupedAllocationConfig] Configuration for cumulative_grouped_allocation pricing
+            #
+            #   @param item_id [String] The id of the item the price will be associated with.
+            #
+            #   @param name [String] The name of the price.
+            #
+            #   @param billable_metric_id [String, nil] The id of the billable metric for the price. Only needed if the price is usage-b
+            #
+            #   @param billed_in_advance [Boolean, nil] If the Price represents a fixed cost, the price will be billed in-advance if thi
+            #
+            #   @param billing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] For custom cadence: specifies the duration of the billing period in days or mont
+            #
+            #   @param conversion_rate [Float, nil] The per unit conversion rate of the price currency to the invoicing currency.
+            #
+            #   @param conversion_rate_config [Orb::Models::UnitConversionRateConfig, Orb::Models::TieredConversionRateConfig, nil] The configuration for the rate of the price currency to the invoicing currency.
+            #
+            #   @param currency [String, nil] An ISO 4217 currency string, or custom pricing unit identifier, in which this pr
+            #
+            #   @param dimensional_price_configuration [Orb::Models::NewDimensionalPriceConfiguration, nil] For dimensional price: specifies a price group and dimension values
+            #
+            #   @param external_price_id [String, nil] An alias for the price.
+            #
+            #   @param fixed_price_quantity [Float, nil] If the Price represents a fixed cost, this represents the quantity of units appl
+            #
+            #   @param invoice_grouping_key [String, nil] The property used to group this price on an invoice
+            #
+            #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
+            #
+            #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+            #
+            #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
+            #
+            #   @param reference_id [String, nil] A transient ID that can be used to reference this price when adding adjustments
+            #
+            #   @param model_type [Symbol, :cumulative_grouped_allocation] The pricing model type
+
+            # The cadence to bill for this price on.
+            #
+            # @see Orb::Models::PlanCreateParams::Price::Price::CumulativeGroupedAllocation#cadence
+            module Cadence
+              extend Orb::Internal::Type::Enum
+
+              ANNUAL = :annual
+              SEMI_ANNUAL = :semi_annual
+              MONTHLY = :monthly
+              QUARTERLY = :quarterly
+              ONE_TIME = :one_time
+              CUSTOM = :custom
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # @see Orb::Models::PlanCreateParams::Price::Price::CumulativeGroupedAllocation#cumulative_grouped_allocation_config
+            class CumulativeGroupedAllocationConfig < Orb::Internal::Type::BaseModel
               # @!attribute cumulative_allocation
               #   The overall allocation across all groups
               #
               #   @return [String]
-              required :cumulative_allocation, String
+              required :cumulative_allocation, String
+
+              # @!attribute group_allocation
+              #   The allocation per individual group
+              #
+              #   @return [String]
+              required :group_allocation, String
+
+              # @!attribute grouping_key
+              #   The event property used to group usage before applying allocations
+              #
+              #   @return [String]
+              required :grouping_key, String
+
+              # @!attribute unit_amount
+              #   The amount to charge for each unit outside of the allocation
+              #
+              #   @return [String]
+              required :unit_amount, String
+
+              # @!method initialize(cumulative_allocation:, group_allocation:, grouping_key:, unit_amount:)
+              #   Configuration for cumulative_grouped_allocation pricing
+              #
+              #   @param cumulative_allocation [String] The overall allocation across all groups
+              #
+              #   @param group_allocation [String] The allocation per individual group
+              #
+              #   @param grouping_key [String] The event property used to group usage before applying allocations
+              #
+              #   @param unit_amount [String] The amount to charge for each unit outside of the allocation
+            end
+          end
+
+          class DailyCreditAllowance < Orb::Internal::Type::BaseModel
+            # @!attribute cadence
+            #   The cadence to bill for this price on.
+            #
+            #   @return [Symbol, Orb::Models::PlanCreateParams::Price::Price::DailyCreditAllowance::Cadence]
+            required :cadence, enum: -> { Orb::PlanCreateParams::Price::Price::DailyCreditAllowance::Cadence }
+
+            # @!attribute daily_credit_allowance_config
+            #   Configuration for daily_credit_allowance pricing
+            #
+            #   @return [Orb::Models::PlanCreateParams::Price::Price::DailyCreditAllowance::DailyCreditAllowanceConfig]
+            required :daily_credit_allowance_config,
+                     -> { Orb::PlanCreateParams::Price::Price::DailyCreditAllowance::DailyCreditAllowanceConfig }
+
+            # @!attribute item_id
+            #   The id of the item the price will be associated with.
+            #
+            #   @return [String]
+            required :item_id, String
+
+            # @!attribute model_type
+            #   The pricing model type
+            #
+            #   @return [Symbol, :daily_credit_allowance]
+            required :model_type, const: :daily_credit_allowance
+
+            # @!attribute name
+            #   The name of the price.
+            #
+            #   @return [String]
+            required :name, String
+
+            # @!attribute billable_metric_id
+            #   The id of the billable metric for the price. Only needed if the price is
+            #   usage-based.
+            #
+            #   @return [String, nil]
+            optional :billable_metric_id, String, nil?: true
+
+            # @!attribute billed_in_advance
+            #   If the Price represents a fixed cost, the price will be billed in-advance if
+            #   this is true, and in-arrears if this is false.
+            #
+            #   @return [Boolean, nil]
+            optional :billed_in_advance, Orb::Internal::Type::Boolean, nil?: true
+
+            # @!attribute billing_cycle_configuration
+            #   For custom cadence: specifies the duration of the billing period in days or
+            #   months.
+            #
+            #   @return [Orb::Models::NewBillingCycleConfiguration, nil]
+            optional :billing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
+
+            # @!attribute conversion_rate
+            #   The per unit conversion rate of the price currency to the invoicing currency.
+            #
+            #   @return [Float, nil]
+            optional :conversion_rate, Float, nil?: true
+
+            # @!attribute conversion_rate_config
+            #   The configuration for the rate of the price currency to the invoicing currency.
+            #
+            #   @return [Orb::Models::UnitConversionRateConfig, Orb::Models::TieredConversionRateConfig, nil]
+            optional :conversion_rate_config, union: -> { Orb::ConversionRateConfig }, nil?: true
+
+            # @!attribute currency
+            #   An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            #   price is billed.
+            #
+            #   @return [String, nil]
+            optional :currency, String, nil?: true
+
+            # @!attribute dimensional_price_configuration
+            #   For dimensional price: specifies a price group and dimension values
+            #
+            #   @return [Orb::Models::NewDimensionalPriceConfiguration, nil]
+            optional :dimensional_price_configuration,
+                     -> {
+                       Orb::NewDimensionalPriceConfiguration
+                     },
+                     nil?: true
+
+            # @!attribute external_price_id
+            #   An alias for the price.
+            #
+            #   @return [String, nil]
+            optional :external_price_id, String, nil?: true
+
+            # @!attribute fixed_price_quantity
+            #   If the Price represents a fixed cost, this represents the quantity of units
+            #   applied.
+            #
+            #   @return [Float, nil]
+            optional :fixed_price_quantity, Float, nil?: true
+
+            # @!attribute invoice_grouping_key
+            #   The property used to group this price on an invoice
+            #
+            #   @return [String, nil]
+            optional :invoice_grouping_key, String, nil?: true
+
+            # @!attribute invoicing_cycle_configuration
+            #   Within each billing cycle, specifies the cadence at which invoices are produced.
+            #   If unspecified, a single invoice is produced per billing cycle.
+            #
+            #   @return [Orb::Models::NewBillingCycleConfiguration, nil]
+            optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
+
+            # @!attribute license_type_id
+            #   The ID of the license type to associate with this price.
+            #
+            #   @return [String, nil]
+            optional :license_type_id, String, nil?: true
+
+            # @!attribute metadata
+            #   User-specified key/value pairs for the resource. Individual keys can be removed
+            #   by setting the value to `null`, and the entire metadata mapping can be cleared
+            #   by setting `metadata` to `null`.
+            #
+            #   @return [Hash{Symbol=>String, nil}, nil]
+            optional :metadata, Orb::Internal::Type::HashOf[String, nil?: true], nil?: true
+
+            # @!attribute reference_id
+            #   A transient ID that can be used to reference this price when adding adjustments
+            #   in the same API call.
+            #
+            #   @return [String, nil]
+            optional :reference_id, String, nil?: true
+
+            # @!method initialize(cadence:, daily_credit_allowance_config:, item_id:, name:, billable_metric_id: nil, billed_in_advance: nil, billing_cycle_configuration: nil, conversion_rate: nil, conversion_rate_config: nil, currency: nil, dimensional_price_configuration: nil, external_price_id: nil, fixed_price_quantity: nil, invoice_grouping_key: nil, invoicing_cycle_configuration: nil, license_type_id: nil, metadata: nil, reference_id: nil, model_type: :daily_credit_allowance)
+            #   Some parameter documentations has been truncated, see
+            #   {Orb::Models::PlanCreateParams::Price::Price::DailyCreditAllowance} for more
+            #   details.
+            #
+            #   @param cadence [Symbol, Orb::Models::PlanCreateParams::Price::Price::DailyCreditAllowance::Cadence] The cadence to bill for this price on.
+            #
+            #   @param daily_credit_allowance_config [Orb::Models::PlanCreateParams::Price::Price::DailyCreditAllowance::DailyCreditAllowanceConfig] Configuration for daily_credit_allowance pricing
+            #
+            #   @param item_id [String] The id of the item the price will be associated with.
+            #
+            #   @param name [String] The name of the price.
+            #
+            #   @param billable_metric_id [String, nil] The id of the billable metric for the price. Only needed if the price is usage-b
+            #
+            #   @param billed_in_advance [Boolean, nil] If the Price represents a fixed cost, the price will be billed in-advance if thi
+            #
+            #   @param billing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] For custom cadence: specifies the duration of the billing period in days or mont
+            #
+            #   @param conversion_rate [Float, nil] The per unit conversion rate of the price currency to the invoicing currency.
+            #
+            #   @param conversion_rate_config [Orb::Models::UnitConversionRateConfig, Orb::Models::TieredConversionRateConfig, nil] The configuration for the rate of the price currency to the invoicing currency.
+            #
+            #   @param currency [String, nil] An ISO 4217 currency string, or custom pricing unit identifier, in which this pr
+            #
+            #   @param dimensional_price_configuration [Orb::Models::NewDimensionalPriceConfiguration, nil] For dimensional price: specifies a price group and dimension values
+            #
+            #   @param external_price_id [String, nil] An alias for the price.
+            #
+            #   @param fixed_price_quantity [Float, nil] If the Price represents a fixed cost, this represents the quantity of units appl
+            #
+            #   @param invoice_grouping_key [String, nil] The property used to group this price on an invoice
+            #
+            #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
+            #
+            #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+            #
+            #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
+            #
+            #   @param reference_id [String, nil] A transient ID that can be used to reference this price when adding adjustments
+            #
+            #   @param model_type [Symbol, :daily_credit_allowance] The pricing model type
+
+            # The cadence to bill for this price on.
+            #
+            # @see Orb::Models::PlanCreateParams::Price::Price::DailyCreditAllowance#cadence
+            module Cadence
+              extend Orb::Internal::Type::Enum
+
+              ANNUAL = :annual
+              SEMI_ANNUAL = :semi_annual
+              MONTHLY = :monthly
+              QUARTERLY = :quarterly
+              ONE_TIME = :one_time
+              CUSTOM = :custom
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # @see Orb::Models::PlanCreateParams::Price::Price::DailyCreditAllowance#daily_credit_allowance_config
+            class DailyCreditAllowanceConfig < Orb::Internal::Type::BaseModel
+              # @!attribute daily_allowance
+              #   Credits granted per day. Lose-it-or-use-it; does not roll over.
+              #
+              #   @return [String]
+              required :daily_allowance, String
+
+              # @!attribute default_unit_amount
+              #   Default per-unit credit rate for any usage not bucketed into a specified
+              #   matrix_value
+              #
+              #   @return [String]
+              required :default_unit_amount, String
+
+              # @!attribute dimensions
+              #   One or two event property values to evaluate matrix groups by
+              #
+              #   @return [Array<String, nil>]
+              required :dimensions, Orb::Internal::Type::ArrayOf[String, nil?: true]
+
+              # @!attribute event_day_property
+              #   Event property whose value identifies the day bucket the event belongs to (e.g.
+              #   'event_day' set to an ISO date string in the customer's timezone). The allowance
+              #   resets per distinct value of this property.
+              #
+              #   @return [String]
+              required :event_day_property, String
+
+              # @!attribute matrix_values
+              #   Per-dimension credit rates
+              #
+              #   @return [Array<Orb::Models::PlanCreateParams::Price::Price::DailyCreditAllowance::DailyCreditAllowanceConfig::MatrixValue>]
+              required :matrix_values,
+                       -> { Orb::Internal::Type::ArrayOf[Orb::PlanCreateParams::Price::Price::DailyCreditAllowance::DailyCreditAllowanceConfig::MatrixValue] }
+
+              # @!method initialize(daily_allowance:, default_unit_amount:, dimensions:, event_day_property:, matrix_values:)
+              #   Some parameter documentations has been truncated, see
+              #   {Orb::Models::PlanCreateParams::Price::Price::DailyCreditAllowance::DailyCreditAllowanceConfig}
+              #   for more details.
+              #
+              #   Configuration for daily_credit_allowance pricing
+              #
+              #   @param daily_allowance [String] Credits granted per day. Lose-it-or-use-it; does not roll over.
+              #
+              #   @param default_unit_amount [String] Default per-unit credit rate for any usage not bucketed into a specified
+              #   matrix\_
+              #
+              #   @param dimensions [Array<String, nil>] One or two event property values to evaluate matrix groups by
+              #
+              #   @param event_day_property [String] Event property whose value identifies the day bucket the event belongs to (e.g.
+              #
+              #   @param matrix_values [Array<Orb::Models::PlanCreateParams::Price::Price::DailyCreditAllowance::DailyCreditAllowanceConfig::MatrixValue>] Per-dimension credit rates
+
+              class MatrixValue < Orb::Internal::Type::BaseModel
+                # @!attribute dimension_values
+                #   One or two matrix keys to filter usage to this value by. For example, ["model"]
+                #   could be used to apply a different credit rate to each AI model.
+                #
+                #   @return [Array<String, nil>]
+                required :dimension_values, Orb::Internal::Type::ArrayOf[String, nil?: true]
+
+                # @!attribute unit_amount
+                #   Credits charged per unit of usage matching the specified dimension_values
+                #
+                #   @return [String]
+                required :unit_amount, String
+
+                # @!method initialize(dimension_values:, unit_amount:)
+                #   Some parameter documentations has been truncated, see
+                #   {Orb::Models::PlanCreateParams::Price::Price::DailyCreditAllowance::DailyCreditAllowanceConfig::MatrixValue}
+                #   for more details.
+                #
+                #   Per-dimension credit price for the daily credit allowance model.
+                #
+                #   @param dimension_values [Array<String, nil>] One or two matrix keys to filter usage to this value by. For example, ["model"]
+                #
+                #   @param unit_amount [String] Credits charged per unit of usage matching the specified dimension_values
+              end
+            end
+          end
+
+          class MeteredAllowance < Orb::Internal::Type::BaseModel
+            # @!attribute cadence
+            #   The cadence to bill for this price on.
+            #
+            #   @return [Symbol, Orb::Models::PlanCreateParams::Price::Price::MeteredAllowance::Cadence]
+            required :cadence, enum: -> { Orb::PlanCreateParams::Price::Price::MeteredAllowance::Cadence }
+
+            # @!attribute item_id
+            #   The id of the item the price will be associated with.
+            #
+            #   @return [String]
+            required :item_id, String
+
+            # @!attribute metered_allowance_config
+            #   Configuration for metered_allowance pricing
+            #
+            #   @return [Orb::Models::PlanCreateParams::Price::Price::MeteredAllowance::MeteredAllowanceConfig]
+            required :metered_allowance_config,
+                     -> { Orb::PlanCreateParams::Price::Price::MeteredAllowance::MeteredAllowanceConfig }
+
+            # @!attribute model_type
+            #   The pricing model type
+            #
+            #   @return [Symbol, :metered_allowance]
+            required :model_type, const: :metered_allowance
+
+            # @!attribute name
+            #   The name of the price.
+            #
+            #   @return [String]
+            required :name, String
+
+            # @!attribute billable_metric_id
+            #   The id of the billable metric for the price. Only needed if the price is
+            #   usage-based.
+            #
+            #   @return [String, nil]
+            optional :billable_metric_id, String, nil?: true
+
+            # @!attribute billed_in_advance
+            #   If the Price represents a fixed cost, the price will be billed in-advance if
+            #   this is true, and in-arrears if this is false.
+            #
+            #   @return [Boolean, nil]
+            optional :billed_in_advance, Orb::Internal::Type::Boolean, nil?: true
+
+            # @!attribute billing_cycle_configuration
+            #   For custom cadence: specifies the duration of the billing period in days or
+            #   months.
+            #
+            #   @return [Orb::Models::NewBillingCycleConfiguration, nil]
+            optional :billing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
+
+            # @!attribute conversion_rate
+            #   The per unit conversion rate of the price currency to the invoicing currency.
+            #
+            #   @return [Float, nil]
+            optional :conversion_rate, Float, nil?: true
+
+            # @!attribute conversion_rate_config
+            #   The configuration for the rate of the price currency to the invoicing currency.
+            #
+            #   @return [Orb::Models::UnitConversionRateConfig, Orb::Models::TieredConversionRateConfig, nil]
+            optional :conversion_rate_config, union: -> { Orb::ConversionRateConfig }, nil?: true
+
+            # @!attribute currency
+            #   An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            #   price is billed.
+            #
+            #   @return [String, nil]
+            optional :currency, String, nil?: true
+
+            # @!attribute dimensional_price_configuration
+            #   For dimensional price: specifies a price group and dimension values
+            #
+            #   @return [Orb::Models::NewDimensionalPriceConfiguration, nil]
+            optional :dimensional_price_configuration,
+                     -> {
+                       Orb::NewDimensionalPriceConfiguration
+                     },
+                     nil?: true
+
+            # @!attribute external_price_id
+            #   An alias for the price.
+            #
+            #   @return [String, nil]
+            optional :external_price_id, String, nil?: true
+
+            # @!attribute fixed_price_quantity
+            #   If the Price represents a fixed cost, this represents the quantity of units
+            #   applied.
+            #
+            #   @return [Float, nil]
+            optional :fixed_price_quantity, Float, nil?: true
+
+            # @!attribute invoice_grouping_key
+            #   The property used to group this price on an invoice
+            #
+            #   @return [String, nil]
+            optional :invoice_grouping_key, String, nil?: true
+
+            # @!attribute invoicing_cycle_configuration
+            #   Within each billing cycle, specifies the cadence at which invoices are produced.
+            #   If unspecified, a single invoice is produced per billing cycle.
+            #
+            #   @return [Orb::Models::NewBillingCycleConfiguration, nil]
+            optional :invoicing_cycle_configuration, -> { Orb::NewBillingCycleConfiguration }, nil?: true
+
+            # @!attribute license_type_id
+            #   The ID of the license type to associate with this price.
+            #
+            #   @return [String, nil]
+            optional :license_type_id, String, nil?: true
+
+            # @!attribute metadata
+            #   User-specified key/value pairs for the resource. Individual keys can be removed
+            #   by setting the value to `null`, and the entire metadata mapping can be cleared
+            #   by setting `metadata` to `null`.
+            #
+            #   @return [Hash{Symbol=>String, nil}, nil]
+            optional :metadata, Orb::Internal::Type::HashOf[String, nil?: true], nil?: true
+
+            # @!attribute reference_id
+            #   A transient ID that can be used to reference this price when adding adjustments
+            #   in the same API call.
+            #
+            #   @return [String, nil]
+            optional :reference_id, String, nil?: true
+
+            # @!method initialize(cadence:, item_id:, metered_allowance_config:, name:, billable_metric_id: nil, billed_in_advance: nil, billing_cycle_configuration: nil, conversion_rate: nil, conversion_rate_config: nil, currency: nil, dimensional_price_configuration: nil, external_price_id: nil, fixed_price_quantity: nil, invoice_grouping_key: nil, invoicing_cycle_configuration: nil, license_type_id: nil, metadata: nil, reference_id: nil, model_type: :metered_allowance)
+            #   Some parameter documentations has been truncated, see
+            #   {Orb::Models::PlanCreateParams::Price::Price::MeteredAllowance} for more
+            #   details.
+            #
+            #   @param cadence [Symbol, Orb::Models::PlanCreateParams::Price::Price::MeteredAllowance::Cadence] The cadence to bill for this price on.
+            #
+            #   @param item_id [String] The id of the item the price will be associated with.
+            #
+            #   @param metered_allowance_config [Orb::Models::PlanCreateParams::Price::Price::MeteredAllowance::MeteredAllowanceConfig] Configuration for metered_allowance pricing
+            #
+            #   @param name [String] The name of the price.
+            #
+            #   @param billable_metric_id [String, nil] The id of the billable metric for the price. Only needed if the price is usage-b
+            #
+            #   @param billed_in_advance [Boolean, nil] If the Price represents a fixed cost, the price will be billed in-advance if thi
+            #
+            #   @param billing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] For custom cadence: specifies the duration of the billing period in days or mont
+            #
+            #   @param conversion_rate [Float, nil] The per unit conversion rate of the price currency to the invoicing currency.
+            #
+            #   @param conversion_rate_config [Orb::Models::UnitConversionRateConfig, Orb::Models::TieredConversionRateConfig, nil] The configuration for the rate of the price currency to the invoicing currency.
+            #
+            #   @param currency [String, nil] An ISO 4217 currency string, or custom pricing unit identifier, in which this pr
+            #
+            #   @param dimensional_price_configuration [Orb::Models::NewDimensionalPriceConfiguration, nil] For dimensional price: specifies a price group and dimension values
+            #
+            #   @param external_price_id [String, nil] An alias for the price.
+            #
+            #   @param fixed_price_quantity [Float, nil] If the Price represents a fixed cost, this represents the quantity of units appl
+            #
+            #   @param invoice_grouping_key [String, nil] The property used to group this price on an invoice
+            #
+            #   @param invoicing_cycle_configuration [Orb::Models::NewBillingCycleConfiguration, nil] Within each billing cycle, specifies the cadence at which invoices are produced.
+            #
+            #   @param license_type_id [String, nil] The ID of the license type to associate with this price.
+            #
+            #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
+            #
+            #   @param reference_id [String, nil] A transient ID that can be used to reference this price when adding adjustments
+            #
+            #   @param model_type [Symbol, :metered_allowance] The pricing model type
+
+            # The cadence to bill for this price on.
+            #
+            # @see Orb::Models::PlanCreateParams::Price::Price::MeteredAllowance#cadence
+            module Cadence
+              extend Orb::Internal::Type::Enum
+
+              ANNUAL = :annual
+              SEMI_ANNUAL = :semi_annual
+              MONTHLY = :monthly
+              QUARTERLY = :quarterly
+              ONE_TIME = :one_time
+              CUSTOM = :custom
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # @see Orb::Models::PlanCreateParams::Price::Price::MeteredAllowance#metered_allowance_config
+            class MeteredAllowanceConfig < Orb::Internal::Type::BaseModel
+              # @!attribute allowance_grouping_value
+              #   The grouping_key value whose summed quantity represents the allowance for this
+              #   period (e.g. 'storage_snapshot' emitting 3 × avg storage). Capped at consumption
+              #   — credit can never exceed actual usage.
+              #
+              #   @return [String]
+              required :allowance_grouping_value, String
 
-              # @!attribute group_allocation
-              #   The allocation per individual group
+              # @!attribute consumption_grouping_value
+              #   The grouping_key value whose summed quantity represents consumption (e.g.
+              #   'download'). Charged at unit_amount.
               #
               #   @return [String]
-              required :group_allocation, String
+              required :consumption_grouping_value, String
 
               # @!attribute grouping_key
-              #   The event property used to group usage before applying allocations
+              #   Event property used to partition the metric into consumption and allowance
+              #   quantities (e.g. 'event_name'). The metric is queried with this key and the two
+              #   values below select which partition is which.
               #
               #   @return [String]
               required :grouping_key, String
 
               # @!attribute unit_amount
-              #   The amount to charge for each unit outside of the allocation
+              #   Per-unit price applied to gross consumption and to the allowance credit.
               #
               #   @return [String]
               required :unit_amount, String
 
-              # @!method initialize(cumulative_allocation:, group_allocation:, grouping_key:, unit_amount:)
-              #   Configuration for cumulative_grouped_allocation pricing
+              # @!attribute allowance_display_name
+              #   Sub-line label for the credit row (e.g. 'Up to 3x free egress').
               #
-              #   @param cumulative_allocation [String] The overall allocation across all groups
+              #   @return [String, nil]
+              optional :allowance_display_name, String
+
+              # @!attribute consumption_display_name
+              #   Sub-line label for the gross consumption row (e.g. 'bytes gotten').
               #
-              #   @param group_allocation [String] The allocation per individual group
+              #   @return [String, nil]
+              optional :consumption_display_name, String
+
+              # @!method initialize(allowance_grouping_value:, consumption_grouping_value:, grouping_key:, unit_amount:, allowance_display_name: nil, consumption_display_name: nil)
+              #   Some parameter documentations has been truncated, see
+              #   {Orb::Models::PlanCreateParams::Price::Price::MeteredAllowance::MeteredAllowanceConfig}
+              #   for more details.
               #
-              #   @param grouping_key [String] The event property used to group usage before applying allocations
+              #   Configuration for metered_allowance pricing
               #
-              #   @param unit_amount [String] The amount to charge for each unit outside of the allocation
+              #   @param allowance_grouping_value [String] The grouping_key value whose summed quantity represents the allowance for this p
+              #
+              #   @param consumption_grouping_value [String] The grouping_key value whose summed quantity represents consumption (e.g. 'downl
+              #
+              #   @param grouping_key [String] Event property used to partition the metric into consumption and allowance quant
+              #
+              #   @param unit_amount [String] Per-unit price applied to gross consumption and to the allowance credit.
+              #
+              #   @param allowance_display_name [String] Sub-line label for the credit row (e.g. 'Up to 3x free egress').
+              #
+              #   @param consumption_display_name [String] Sub-line label for the gross consumption row (e.g. 'bytes gotten').
             end
           end
 
@@ -1220,9 +2307,7 @@ module Orb
             #   The configuration for the rate of the price currency to the invoicing currency.
             #
             #   @return [Orb::Models::UnitConversionRateConfig, Orb::Models::TieredConversionRateConfig, nil]
-            optional :conversion_rate_config,
-                     union: -> { Orb::PlanCreateParams::Price::Price::Percent::ConversionRateConfig },
-                     nil?: true
+            optional :conversion_rate_config, union: -> { Orb::ConversionRateConfig }, nil?: true
 
             # @!attribute currency
             #   An ISO 4217 currency string, or custom pricing unit identifier, in which this
@@ -1350,15 +2435,45 @@ module Orb
             # @see Orb::Models::PlanCreateParams::Price::Price::Percent#percent_config
             class PercentConfig < Orb::Internal::Type::BaseModel
               # @!attribute percent
-              #   What percent of the component subtotals to charge
+              #   Fraction of the component subtotals to charge (0 < percent <= 1).
               #
               #   @return [Float]
               required :percent, Float
 
-              # @!method initialize(percent:)
+              # @!attribute maximum_amount
+              #   Maximum amount to charge. If unset, the fee has no upper bound.
+              #
+              #   @return [String, nil]
+              optional :maximum_amount, String, nil?: true
+
+              # @!attribute minimum_amount
+              #   Minimum amount to charge. If unset, the fee is bounded below by 0.
+              #
+              #   @return [String, nil]
+              optional :minimum_amount, String, nil?: true
+
+              # @!attribute prorated
+              #   If true, the minimum_amount is prorated based on the service period. The
+              #   maximum_amount is an absolute cap (never prorated), and the percent applied to
+              #   upstream subtotals is never prorated either.
+              #
+              #   @return [Boolean, nil]
+              optional :prorated, Orb::Internal::Type::Boolean
+
+              # @!method initialize(percent:, maximum_amount: nil, minimum_amount: nil, prorated: nil)
+              #   Some parameter documentations has been truncated, see
+              #   {Orb::Models::PlanCreateParams::Price::Price::Percent::PercentConfig} for more
+              #   details.
+              #
               #   Configuration for percent pricing
               #
-              #   @param percent [Float] What percent of the component subtotals to charge
+              #   @param percent [Float] Fraction of the component subtotals to charge (0 < percent <= 1).
+              #
+              #   @param maximum_amount [String, nil] Maximum amount to charge. If unset, the fee has no upper bound.
+              #
+              #   @param minimum_amount [String, nil] Minimum amount to charge. If unset, the fee is bounded below by 0.
+              #
+              #   @param prorated [Boolean] If true, the minimum_amount is prorated based on the service period. The maximum
             end
           end
 
@@ -1424,9 +2539,7 @@ module Orb
             #   The configuration for the rate of the price currency to the invoicing currency.
             #
             #   @return [Orb::Models::UnitConversionRateConfig, Orb::Models::TieredConversionRateConfig, nil]
-            optional :conversion_rate_config,
-                     union: -> { Orb::PlanCreateParams::Price::Price::EventOutput::ConversionRateConfig },
-                     nil?: true
+            optional :conversion_rate_config, union: -> { Orb::ConversionRateConfig }, nil?: true
 
             # @!attribute currency
             #   An ISO 4217 currency string, or custom pricing unit identifier, in which this
@@ -1590,7 +2703,7 @@ module Orb
           end
 
           # @!method self.variants
-          #   @return [Array(Orb::Models::NewPlanUnitPrice, Orb::Models::NewPlanTieredPrice, Orb::Models::NewPlanBulkPrice, Orb::Models::PlanCreateParams::Price::Price::BulkWithFilters, Orb::Models::NewPlanPackagePrice, Orb::Models::NewPlanMatrixPrice, Orb::Models::NewPlanThresholdTotalAmountPrice, Orb::Models::NewPlanTieredPackagePrice, Orb::Models::NewPlanTieredWithMinimumPrice, Orb::Models::NewPlanGroupedTieredPrice, Orb::Models::NewPlanTieredPackageWithMinimumPrice, Orb::Models::NewPlanPackageWithAllocationPrice, Orb::Models::NewPlanUnitWithPercentPrice, Orb::Models::NewPlanMatrixWithAllocationPrice, Orb::Models::PlanCreateParams::Price::Price::TieredWithProration, Orb::Models::NewPlanUnitWithProrationPrice, Orb::Models::NewPlanGroupedAllocationPrice, Orb::Models::NewPlanBulkWithProrationPrice, Orb::Models::NewPlanGroupedWithProratedMinimumPrice, Orb::Models::NewPlanGroupedWithMeteredMinimumPrice, Orb::Models::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds, Orb::Models::NewPlanMatrixWithDisplayNamePrice, Orb::Models::NewPlanGroupedTieredPackagePrice, Orb::Models::NewPlanMaxGroupTieredPackagePrice, Orb::Models::NewPlanScalableMatrixWithUnitPricingPrice, Orb::Models::NewPlanScalableMatrixWithTieredPricingPrice, Orb::Models::NewPlanCumulativeGroupedBulkPrice, Orb::Models::PlanCreateParams::Price::Price::CumulativeGroupedAllocation, Orb::Models::NewPlanMinimumCompositePrice, Orb::Models::PlanCreateParams::Price::Price::Percent, Orb::Models::PlanCreateParams::Price::Price::EventOutput)]
+          #   @return [Array(Orb::Models::NewPlanUnitPrice, Orb::Models::NewPlanTieredPrice, Orb::Models::NewPlanBulkPrice, Orb::Models::PlanCreateParams::Price::Price::BulkWithFilters, Orb::Models::NewPlanPackagePrice, Orb::Models::NewPlanMatrixPrice, Orb::Models::NewPlanThresholdTotalAmountPrice, Orb::Models::NewPlanTieredPackagePrice, Orb::Models::NewPlanTieredWithMinimumPrice, Orb::Models::NewPlanGroupedTieredPrice, Orb::Models::NewPlanTieredPackageWithMinimumPrice, Orb::Models::NewPlanPackageWithAllocationPrice, Orb::Models::NewPlanUnitWithPercentPrice, Orb::Models::NewPlanMatrixWithAllocationPrice, Orb::Models::PlanCreateParams::Price::Price::MatrixWithThresholdDiscounts, Orb::Models::PlanCreateParams::Price::Price::TieredWithProration, Orb::Models::NewPlanUnitWithProrationPrice, Orb::Models::NewPlanGroupedAllocationPrice, Orb::Models::NewPlanBulkWithProrationPrice, Orb::Models::NewPlanGroupedWithProratedMinimumPrice, Orb::Models::NewPlanGroupedWithMeteredMinimumPrice, Orb::Models::PlanCreateParams::Price::Price::GroupedWithMinMaxThresholds, Orb::Models::NewPlanMatrixWithDisplayNamePrice, Orb::Models::NewPlanGroupedTieredPackagePrice, Orb::Models::NewPlanMaxGroupTieredPackagePrice, Orb::Models::NewPlanScalableMatrixWithUnitPricingPrice, Orb::Models::NewPlanScalableMatrixWithTieredPricingPrice, Orb::Models::NewPlanCumulativeGroupedBulkPrice, Orb::Models::PlanCreateParams::Price::Price::CumulativeGroupedAllocation, Orb::Models::PlanCreateParams::Price::Price::DailyCreditAllowance, Orb::Models::PlanCreateParams::Price::Price::MeteredAllowance, Orb::Models::NewPlanMinimumCompositePrice, Orb::Models::PlanCreateParams::Price::Price::Percent, Orb::Models::PlanCreateParams::Price::Price::EventOutput)]
         end
       end
 
@@ -1598,7 +2711,7 @@ module Orb
         # @!attribute adjustment
         #   The definition of a new adjustment to create and add to the plan.
         #
-        #   @return [Orb::Models::NewPercentageDiscount, Orb::Models::NewUsageDiscount, Orb::Models::NewAmountDiscount, Orb::Models::NewMinimum, Orb::Models::NewMaximum]
+        #   @return [Orb::Models::NewPercentageDiscount, Orb::Models::NewUsageDiscount, Orb::Models::NewAmountDiscount, Orb::Models::NewMinimum, Orb::Models::NewMaximum, Orb::Models::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount]
         required :adjustment, union: -> { Orb::PlanCreateParams::Adjustment::Adjustment }
 
         # @!attribute plan_phase_order
@@ -1608,7 +2721,7 @@ module Orb
         optional :plan_phase_order, Integer, nil?: true
 
         # @!method initialize(adjustment:, plan_phase_order: nil)
-        #   @param adjustment [Orb::Models::NewPercentageDiscount, Orb::Models::NewUsageDiscount, Orb::Models::NewAmountDiscount, Orb::Models::NewMinimum, Orb::Models::NewMaximum] The definition of a new adjustment to create and add to the plan.
+        #   @param adjustment [Orb::Models::NewPercentageDiscount, Orb::Models::NewUsageDiscount, Orb::Models::NewAmountDiscount, Orb::Models::NewMinimum, Orb::Models::NewMaximum, Orb::Models::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount] The definition of a new adjustment to create and add to the plan.
         #
         #   @param plan_phase_order [Integer, nil] The phase to add this adjustment to.
 
@@ -1630,8 +2743,215 @@ module Orb
 
           variant :maximum, -> { Orb::NewMaximum }
 
+          variant :tiered_percentage_discount,
+                  -> { Orb::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount }
+
+          class TieredPercentageDiscount < Orb::Internal::Type::BaseModel
+            # @!attribute adjustment_type
+            #
+            #   @return [Symbol, :tiered_percentage_discount]
+            required :adjustment_type, const: :tiered_percentage_discount
+
+            # @!attribute tiers
+            #
+            #   @return [Array<Orb::Models::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount::Tier>]
+            required :tiers,
+                     -> { Orb::Internal::Type::ArrayOf[Orb::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount::Tier] }
+
+            # @!attribute applies_to_all
+            #   If set, the adjustment will apply to every price on the subscription.
+            #
+            #   @return [Boolean, Orb::Models::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount::AppliesToAll, nil]
+            optional :applies_to_all,
+                     enum: -> {
+                       Orb::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount::AppliesToAll
+                     },
+                     nil?: true
+
+            # @!attribute applies_to_item_ids
+            #   The set of item IDs to which this adjustment applies.
+            #
+            #   @return [Array<String>, nil]
+            optional :applies_to_item_ids, Orb::Internal::Type::ArrayOf[String], nil?: true
+
+            # @!attribute applies_to_price_ids
+            #   The set of price IDs to which this adjustment applies.
+            #
+            #   @return [Array<String>, nil]
+            optional :applies_to_price_ids, Orb::Internal::Type::ArrayOf[String], nil?: true
+
+            # @!attribute currency
+            #   If set, only prices in the specified currency will have the adjustment applied.
+            #
+            #   @return [String, nil]
+            optional :currency, String, nil?: true
+
+            # @!attribute filters
+            #   A list of filters that determine which prices this adjustment will apply to.
+            #
+            #   @return [Array<Orb::Models::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount::Filter>, nil]
+            optional :filters,
+                     -> {
+                       Orb::Internal::Type::ArrayOf[Orb::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount::Filter]
+                     },
+                     nil?: true
+
+            # @!attribute is_invoice_level
+            #   When false, this adjustment will be applied to a single price. Otherwise, it
+            #   will be applied at the invoice level, possibly to multiple prices.
+            #
+            #   @return [Boolean, nil]
+            optional :is_invoice_level, Orb::Internal::Type::Boolean
+
+            # @!attribute price_type
+            #   If set, only prices of the specified type will have the adjustment applied.
+            #
+            #   @return [Symbol, Orb::Models::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount::PriceType, nil]
+            optional :price_type,
+                     enum: -> {
+                       Orb::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount::PriceType
+                     },
+                     nil?: true
+
+            # @!method initialize(tiers:, applies_to_all: nil, applies_to_item_ids: nil, applies_to_price_ids: nil, currency: nil, filters: nil, is_invoice_level: nil, price_type: nil, adjustment_type: :tiered_percentage_discount)
+            #   Some parameter documentations has been truncated, see
+            #   {Orb::Models::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount}
+            #   for more details.
+            #
+            #   @param tiers [Array<Orb::Models::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount::Tier>]
+            #
+            #   @param applies_to_all [Boolean, Orb::Models::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount::AppliesToAll, nil] If set, the adjustment will apply to every price on the subscription.
+            #
+            #   @param applies_to_item_ids [Array<String>, nil] The set of item IDs to which this adjustment applies.
+            #
+            #   @param applies_to_price_ids [Array<String>, nil] The set of price IDs to which this adjustment applies.
+            #
+            #   @param currency [String, nil] If set, only prices in the specified currency will have the adjustment applied.
+            #
+            #   @param filters [Array<Orb::Models::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount::Filter>, nil] A list of filters that determine which prices this adjustment will apply to.
+            #
+            #   @param is_invoice_level [Boolean] When false, this adjustment will be applied to a single price. Otherwise, it wil
+            #
+            #   @param price_type [Symbol, Orb::Models::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount::PriceType, nil] If set, only prices of the specified type will have the adjustment applied.
+            #
+            #   @param adjustment_type [Symbol, :tiered_percentage_discount]
+
+            class Tier < Orb::Internal::Type::BaseModel
+              # @!attribute lower_bound
+              #   Exclusive lower bound of cumulative spend for this tier.
+              #
+              #   @return [Float]
+              required :lower_bound, Float
+
+              # @!attribute percentage
+              #   The percentage (0-1) discounted from spend in this tier.
+              #
+              #   @return [Float]
+              required :percentage, Float
+
+              # @!attribute upper_bound
+              #   Inclusive upper bound of cumulative spend; null for the final open-ended tier.
+              #
+              #   @return [Float, nil]
+              optional :upper_bound, Float, nil?: true
+
+              # @!method initialize(lower_bound:, percentage:, upper_bound: nil)
+              #   @param lower_bound [Float] Exclusive lower bound of cumulative spend for this tier.
+              #
+              #   @param percentage [Float] The percentage (0-1) discounted from spend in this tier.
+              #
+              #   @param upper_bound [Float, nil] Inclusive upper bound of cumulative spend; null for the final open-ended tier.
+            end
+
+            # If set, the adjustment will apply to every price on the subscription.
+            #
+            # @see Orb::Models::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount#applies_to_all
+            module AppliesToAll
+              extend Orb::Internal::Type::Enum
+
+              TRUE = true
+
+              # @!method self.values
+              #   @return [Array<Boolean>]
+            end
+
+            class Filter < Orb::Internal::Type::BaseModel
+              # @!attribute field
+              #   The property of the price to filter on.
+              #
+              #   @return [Symbol, Orb::Models::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount::Filter::Field]
+              required :field,
+                       enum: -> { Orb::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount::Filter::Field }
+
+              # @!attribute operator
+              #   Should prices that match the filter be included or excluded.
+              #
+              #   @return [Symbol, Orb::Models::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount::Filter::Operator]
+              required :operator,
+                       enum: -> { Orb::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount::Filter::Operator }
+
+              # @!attribute values
+              #   The IDs or values that match this filter.
+              #
+              #   @return [Array<String>]
+              required :values, Orb::Internal::Type::ArrayOf[String]
+
+              # @!method initialize(field:, operator:, values:)
+              #   @param field [Symbol, Orb::Models::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount::Filter::Field] The property of the price to filter on.
+              #
+              #   @param operator [Symbol, Orb::Models::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount::Filter::Operator] Should prices that match the filter be included or excluded.
+              #
+              #   @param values [Array<String>] The IDs or values that match this filter.
+
+              # The property of the price to filter on.
+              #
+              # @see Orb::Models::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount::Filter#field
+              module Field
+                extend Orb::Internal::Type::Enum
+
+                PRICE_ID = :price_id
+                ITEM_ID = :item_id
+                PRICE_TYPE = :price_type
+                CURRENCY = :currency
+                PRICING_UNIT_ID = :pricing_unit_id
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+
+              # Should prices that match the filter be included or excluded.
+              #
+              # @see Orb::Models::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount::Filter#operator
+              module Operator
+                extend Orb::Internal::Type::Enum
+
+                INCLUDES = :includes
+                EXCLUDES = :excludes
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+
+            # If set, only prices of the specified type will have the adjustment applied.
+            #
+            # @see Orb::Models::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount#price_type
+            module PriceType
+              extend Orb::Internal::Type::Enum
+
+              USAGE = :usage
+              FIXED_IN_ADVANCE = :fixed_in_advance
+              FIXED_IN_ARREARS = :fixed_in_arrears
+              FIXED = :fixed
+              IN_ARREARS = :in_arrears
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+
           # @!method self.variants
-          #   @return [Array(Orb::Models::NewPercentageDiscount, Orb::Models::NewUsageDiscount, Orb::Models::NewAmountDiscount, Orb::Models::NewMinimum, Orb::Models::NewMaximum)]
+          #   @return [Array(Orb::Models::NewPercentageDiscount, Orb::Models::NewUsageDiscount, Orb::Models::NewAmountDiscount, Orb::Models::NewMinimum, Orb::Models::NewMaximum, Orb::Models::PlanCreateParams::Adjustment::Adjustment::TieredPercentageDiscount)]
         end
       end