orb-billing 1.23.0 → 1.25.0

data/rbi/orb/models/changed_subscription_resources.rbi

@@ -874,9 +874,9 @@ module Orb
           # If Orb has ever attempted payment auto-collection for this invoice, this field
           # will reflect when that attempt occurred. In conjunction with `next_attempt_at`,
           # this can be used to tell whether the invoice is currently in dunning (that is,
-          # `previously_attempted_at` is non-null, and `next_attempt_time` is non-null), or
-          # if dunning has been exhausted (`previously_attempted_at` is non-null, but
-          # `next_attempt_time` is null).
+          # `previously_attempted_at` is non-null, and `next_attempt_at` is non-null), or if
+          # dunning has been exhausted (`previously_attempted_at` is non-null, but
+          # `next_attempt_at` is null).
           sig { returns(T.nilable(Time)) }
           attr_accessor :previously_attempted_at
 
@@ -900,9 +900,9 @@ module Orb
             # If Orb has ever attempted payment auto-collection for this invoice, this field
             # will reflect when that attempt occurred. In conjunction with `next_attempt_at`,
             # this can be used to tell whether the invoice is currently in dunning (that is,
-            # `previously_attempted_at` is non-null, and `next_attempt_time` is non-null), or
-            # if dunning has been exhausted (`previously_attempted_at` is non-null, but
-            # `next_attempt_time` is null).
+            # `previously_attempted_at` is non-null, and `next_attempt_at` is non-null), or if
+            # dunning has been exhausted (`previously_attempted_at` is non-null, but
+            # `next_attempt_at` is null).
             previously_attempted_at:
           )
           end
@@ -1406,6 +1406,7 @@ module Orb
                   Orb::Price::TieredPackage::OrHash,
                   Orb::Price::TieredWithMinimum::OrHash,
                   Orb::Price::GroupedTiered::OrHash,
+                  Orb::Price::GroupedTieredMatrix::OrHash,
                   Orb::Price::TieredPackageWithMinimum::OrHash,
                   Orb::Price::PackageWithAllocation::OrHash,
                   Orb::Price::UnitWithPercent::OrHash,

data/rbi/orb/models/invoice.rbi

@@ -732,9 +732,9 @@ module Orb
         # If Orb has ever attempted payment auto-collection for this invoice, this field
         # will reflect when that attempt occurred. In conjunction with `next_attempt_at`,
         # this can be used to tell whether the invoice is currently in dunning (that is,
-        # `previously_attempted_at` is non-null, and `next_attempt_time` is non-null), or
-        # if dunning has been exhausted (`previously_attempted_at` is non-null, but
-        # `next_attempt_time` is null).
+        # `previously_attempted_at` is non-null, and `next_attempt_at` is non-null), or if
+        # dunning has been exhausted (`previously_attempted_at` is non-null, but
+        # `next_attempt_at` is null).
         sig { returns(T.nilable(Time)) }
         attr_accessor :previously_attempted_at
 
@@ -758,9 +758,9 @@ module Orb
           # If Orb has ever attempted payment auto-collection for this invoice, this field
           # will reflect when that attempt occurred. In conjunction with `next_attempt_at`,
           # this can be used to tell whether the invoice is currently in dunning (that is,
-          # `previously_attempted_at` is non-null, and `next_attempt_time` is non-null), or
-          # if dunning has been exhausted (`previously_attempted_at` is non-null, but
-          # `next_attempt_time` is null).
+          # `previously_attempted_at` is non-null, and `next_attempt_at` is non-null), or if
+          # dunning has been exhausted (`previously_attempted_at` is non-null, but
+          # `next_attempt_at` is null).
           previously_attempted_at:
         )
         end
@@ -1211,6 +1211,7 @@ module Orb
                 Orb::Price::TieredPackage::OrHash,
                 Orb::Price::TieredWithMinimum::OrHash,
                 Orb::Price::GroupedTiered::OrHash,
+                Orb::Price::GroupedTieredMatrix::OrHash,
                 Orb::Price::TieredPackageWithMinimum::OrHash,
                 Orb::Price::PackageWithAllocation::OrHash,
                 Orb::Price::UnitWithPercent::OrHash,

data/rbi/orb/models/invoice_fetch_upcoming_response.rbi

@@ -784,9 +784,9 @@ module Orb
         # If Orb has ever attempted payment auto-collection for this invoice, this field
         # will reflect when that attempt occurred. In conjunction with `next_attempt_at`,
         # this can be used to tell whether the invoice is currently in dunning (that is,
-        # `previously_attempted_at` is non-null, and `next_attempt_time` is non-null), or
-        # if dunning has been exhausted (`previously_attempted_at` is non-null, but
-        # `next_attempt_time` is null).
+        # `previously_attempted_at` is non-null, and `next_attempt_at` is non-null), or if
+        # dunning has been exhausted (`previously_attempted_at` is non-null, but
+        # `next_attempt_at` is null).
         sig { returns(T.nilable(Time)) }
         attr_accessor :previously_attempted_at
 
@@ -810,9 +810,9 @@ module Orb
           # If Orb has ever attempted payment auto-collection for this invoice, this field
           # will reflect when that attempt occurred. In conjunction with `next_attempt_at`,
           # this can be used to tell whether the invoice is currently in dunning (that is,
-          # `previously_attempted_at` is non-null, and `next_attempt_time` is non-null), or
-          # if dunning has been exhausted (`previously_attempted_at` is non-null, but
-          # `next_attempt_time` is null).
+          # `previously_attempted_at` is non-null, and `next_attempt_at` is non-null), or if
+          # dunning has been exhausted (`previously_attempted_at` is non-null, but
+          # `next_attempt_at` is null).
           previously_attempted_at:
         )
         end
@@ -1314,6 +1314,7 @@ module Orb
                 Orb::Price::TieredPackage::OrHash,
                 Orb::Price::TieredWithMinimum::OrHash,
                 Orb::Price::GroupedTiered::OrHash,
+                Orb::Price::GroupedTieredMatrix::OrHash,
                 Orb::Price::TieredPackageWithMinimum::OrHash,
                 Orb::Price::PackageWithAllocation::OrHash,
                 Orb::Price::UnitWithPercent::OrHash,

data/rbi/orb/models/invoice_issue_summary_response.rbi

@@ -707,9 +707,9 @@ module Orb
         # If Orb has ever attempted payment auto-collection for this invoice, this field
         # will reflect when that attempt occurred. In conjunction with `next_attempt_at`,
         # this can be used to tell whether the invoice is currently in dunning (that is,
-        # `previously_attempted_at` is non-null, and `next_attempt_time` is non-null), or
-        # if dunning has been exhausted (`previously_attempted_at` is non-null, but
-        # `next_attempt_time` is null).
+        # `previously_attempted_at` is non-null, and `next_attempt_at` is non-null), or if
+        # dunning has been exhausted (`previously_attempted_at` is non-null, but
+        # `next_attempt_at` is null).
         sig { returns(T.nilable(Time)) }
         attr_accessor :previously_attempted_at
 
@@ -733,9 +733,9 @@ module Orb
           # If Orb has ever attempted payment auto-collection for this invoice, this field
           # will reflect when that attempt occurred. In conjunction with `next_attempt_at`,
           # this can be used to tell whether the invoice is currently in dunning (that is,
-          # `previously_attempted_at` is non-null, and `next_attempt_time` is non-null), or
-          # if dunning has been exhausted (`previously_attempted_at` is non-null, but
-          # `next_attempt_time` is null).
+          # `previously_attempted_at` is non-null, and `next_attempt_at` is non-null), or if
+          # dunning has been exhausted (`previously_attempted_at` is non-null, but
+          # `next_attempt_at` is null).
           previously_attempted_at:
         )
         end

data/rbi/orb/models/invoice_line_item_create_response.rbi

@@ -142,6 +142,7 @@ module Orb
               Orb::Price::TieredPackage::OrHash,
               Orb::Price::TieredWithMinimum::OrHash,
               Orb::Price::GroupedTiered::OrHash,
+              Orb::Price::GroupedTieredMatrix::OrHash,
               Orb::Price::TieredPackageWithMinimum::OrHash,
               Orb::Price::PackageWithAllocation::OrHash,
               Orb::Price::UnitWithPercent::OrHash,

data/rbi/orb/models/invoice_list_summary_response.rbi

@@ -702,9 +702,9 @@ module Orb
         # If Orb has ever attempted payment auto-collection for this invoice, this field
         # will reflect when that attempt occurred. In conjunction with `next_attempt_at`,
         # this can be used to tell whether the invoice is currently in dunning (that is,
-        # `previously_attempted_at` is non-null, and `next_attempt_time` is non-null), or
-        # if dunning has been exhausted (`previously_attempted_at` is non-null, but
-        # `next_attempt_time` is null).
+        # `previously_attempted_at` is non-null, and `next_attempt_at` is non-null), or if
+        # dunning has been exhausted (`previously_attempted_at` is non-null, but
+        # `next_attempt_at` is null).
         sig { returns(T.nilable(Time)) }
         attr_accessor :previously_attempted_at
 
@@ -728,9 +728,9 @@ module Orb
           # If Orb has ever attempted payment auto-collection for this invoice, this field
           # will reflect when that attempt occurred. In conjunction with `next_attempt_at`,
           # this can be used to tell whether the invoice is currently in dunning (that is,
-          # `previously_attempted_at` is non-null, and `next_attempt_time` is non-null), or
-          # if dunning has been exhausted (`previously_attempted_at` is non-null, but
-          # `next_attempt_time` is null).
+          # `previously_attempted_at` is non-null, and `next_attempt_at` is non-null), or if
+          # dunning has been exhausted (`previously_attempted_at` is non-null, but
+          # `next_attempt_at` is null).
           previously_attempted_at:
         )
         end

data/rbi/orb/models/per_price_cost.rbi

@@ -39,6 +39,7 @@ module Orb
               Orb::Price::TieredPackage::OrHash,
               Orb::Price::TieredWithMinimum::OrHash,
               Orb::Price::GroupedTiered::OrHash,
+              Orb::Price::GroupedTieredMatrix::OrHash,
               Orb::Price::TieredPackageWithMinimum::OrHash,
               Orb::Price::PackageWithAllocation::OrHash,
               Orb::Price::UnitWithPercent::OrHash,

data/rbi/orb/models/plan.rbi

@@ -175,6 +175,7 @@ module Orb
                 Orb::Price::TieredPackage::OrHash,
                 Orb::Price::TieredWithMinimum::OrHash,
                 Orb::Price::GroupedTiered::OrHash,
+                Orb::Price::GroupedTieredMatrix::OrHash,
                 Orb::Price::TieredPackageWithMinimum::OrHash,
                 Orb::Price::PackageWithAllocation::OrHash,
                 Orb::Price::UnitWithPercent::OrHash,

data/rbi/orb/models/plan_create_params.rbi

@@ -190,6 +190,7 @@ module Orb
                 Orb::NewPlanTieredPackagePrice,
                 Orb::NewPlanTieredWithMinimumPrice,
                 Orb::NewPlanGroupedTieredPrice,
+                Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix,
                 Orb::NewPlanTieredPackageWithMinimumPrice,
                 Orb::NewPlanPackageWithAllocationPrice,
                 Orb::NewPlanUnitWithPercentPrice,
@@ -241,6 +242,7 @@ module Orb
                   Orb::NewPlanTieredPackagePrice::OrHash,
                   Orb::NewPlanTieredWithMinimumPrice::OrHash,
                   Orb::NewPlanGroupedTieredPrice::OrHash,
+                  Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix::OrHash,
                   Orb::NewPlanTieredPackageWithMinimumPrice::OrHash,
                   Orb::NewPlanPackageWithAllocationPrice::OrHash,
                   Orb::NewPlanUnitWithPercentPrice::OrHash,
@@ -301,6 +303,7 @@ module Orb
                     Orb::NewPlanTieredPackagePrice,
                     Orb::NewPlanTieredWithMinimumPrice,
                     Orb::NewPlanGroupedTieredPrice,
+                    Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix,
                     Orb::NewPlanTieredPackageWithMinimumPrice,
                     Orb::NewPlanPackageWithAllocationPrice,
                     Orb::NewPlanUnitWithPercentPrice,
@@ -774,6 +777,7 @@ module Orb
                 Orb::NewPlanTieredPackagePrice,
                 Orb::NewPlanTieredWithMinimumPrice,
                 Orb::NewPlanGroupedTieredPrice,
+                Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix,
                 Orb::NewPlanTieredPackageWithMinimumPrice,
                 Orb::NewPlanPackageWithAllocationPrice,
                 Orb::NewPlanUnitWithPercentPrice,
@@ -1273,6 +1277,445 @@ module Orb
             end
           end
 
+          class GroupedTieredMatrix < Orb::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix,
+                  Orb::Internal::AnyHash
+                )
+              end
+
+            # The cadence to bill for this price on.
+            sig do
+              returns(
+                Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix::Cadence::OrSymbol
+              )
+            end
+            attr_accessor :cadence
+
+            # Configuration for grouped_tiered_matrix pricing
+            sig do
+              returns(
+                Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix::GroupedTieredMatrixConfig
+              )
+            end
+            attr_reader :grouped_tiered_matrix_config
+
+            sig do
+              params(
+                grouped_tiered_matrix_config:
+                  Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix::GroupedTieredMatrixConfig::OrHash
+              ).void
+            end
+            attr_writer :grouped_tiered_matrix_config
+
+            # The id of the item the price will be associated with.
+            sig { returns(String) }
+            attr_accessor :item_id
+
+            # The pricing model type
+            sig { returns(Symbol) }
+            attr_accessor :model_type
+
+            # The name of the price.
+            sig { returns(String) }
+            attr_accessor :name
+
+            # The id of the billable metric for the price. Only needed if the price is
+            # usage-based.
+            sig { returns(T.nilable(String)) }
+            attr_accessor :billable_metric_id
+
+            # 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.
+            sig { returns(T.nilable(T::Boolean)) }
+            attr_accessor :billed_in_advance
+
+            # For custom cadence: specifies the duration of the billing period in days or
+            # months.
+            sig { returns(T.nilable(Orb::NewBillingCycleConfiguration)) }
+            attr_reader :billing_cycle_configuration
+
+            sig do
+              params(
+                billing_cycle_configuration:
+                  T.nilable(Orb::NewBillingCycleConfiguration::OrHash)
+              ).void
+            end
+            attr_writer :billing_cycle_configuration
+
+            # The per unit conversion rate of the price currency to the invoicing currency.
+            sig { returns(T.nilable(Float)) }
+            attr_accessor :conversion_rate
+
+            # The configuration for the rate of the price currency to the invoicing currency.
+            sig do
+              returns(
+                T.nilable(
+                  T.any(
+                    Orb::UnitConversionRateConfig,
+                    Orb::TieredConversionRateConfig
+                  )
+                )
+              )
+            end
+            attr_accessor :conversion_rate_config
+
+            # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+            # price is billed.
+            sig { returns(T.nilable(String)) }
+            attr_accessor :currency
+
+            # For dimensional price: specifies a price group and dimension values
+            sig { returns(T.nilable(Orb::NewDimensionalPriceConfiguration)) }
+            attr_reader :dimensional_price_configuration
+
+            sig do
+              params(
+                dimensional_price_configuration:
+                  T.nilable(Orb::NewDimensionalPriceConfiguration::OrHash)
+              ).void
+            end
+            attr_writer :dimensional_price_configuration
+
+            # An alias for the price.
+            sig { returns(T.nilable(String)) }
+            attr_accessor :external_price_id
+
+            # If the Price represents a fixed cost, this represents the quantity of units
+            # applied.
+            sig { returns(T.nilable(Float)) }
+            attr_accessor :fixed_price_quantity
+
+            # The property used to group this price on an invoice
+            sig { returns(T.nilable(String)) }
+            attr_accessor :invoice_grouping_key
+
+            # Within each billing cycle, specifies the cadence at which invoices are produced.
+            # If unspecified, a single invoice is produced per billing cycle.
+            sig { returns(T.nilable(Orb::NewBillingCycleConfiguration)) }
+            attr_reader :invoicing_cycle_configuration
+
+            sig do
+              params(
+                invoicing_cycle_configuration:
+                  T.nilable(Orb::NewBillingCycleConfiguration::OrHash)
+              ).void
+            end
+            attr_writer :invoicing_cycle_configuration
+
+            # The ID of the license type to associate with this price.
+            sig { returns(T.nilable(String)) }
+            attr_accessor :license_type_id
+
+            # 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`.
+            sig { returns(T.nilable(T::Hash[Symbol, T.nilable(String)])) }
+            attr_accessor :metadata
+
+            # A transient ID that can be used to reference this price when adding adjustments
+            # in the same API call.
+            sig { returns(T.nilable(String)) }
+            attr_accessor :reference_id
+
+            sig do
+              params(
+                cadence:
+                  Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix::Cadence::OrSymbol,
+                grouped_tiered_matrix_config:
+                  Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix::GroupedTieredMatrixConfig::OrHash,
+                item_id: String,
+                name: String,
+                billable_metric_id: T.nilable(String),
+                billed_in_advance: T.nilable(T::Boolean),
+                billing_cycle_configuration:
+                  T.nilable(Orb::NewBillingCycleConfiguration::OrHash),
+                conversion_rate: T.nilable(Float),
+                conversion_rate_config:
+                  T.nilable(
+                    T.any(
+                      Orb::UnitConversionRateConfig::OrHash,
+                      Orb::TieredConversionRateConfig::OrHash
+                    )
+                  ),
+                currency: T.nilable(String),
+                dimensional_price_configuration:
+                  T.nilable(Orb::NewDimensionalPriceConfiguration::OrHash),
+                external_price_id: T.nilable(String),
+                fixed_price_quantity: T.nilable(Float),
+                invoice_grouping_key: T.nilable(String),
+                invoicing_cycle_configuration:
+                  T.nilable(Orb::NewBillingCycleConfiguration::OrHash),
+                license_type_id: T.nilable(String),
+                metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+                reference_id: T.nilable(String),
+                model_type: Symbol
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # The cadence to bill for this price on.
+              cadence:,
+              # Configuration for grouped_tiered_matrix pricing
+              grouped_tiered_matrix_config:,
+              # The id of the item the price will be associated with.
+              item_id:,
+              # The name of the price.
+              name:,
+              # The id of the billable metric for the price. Only needed if the price is
+              # usage-based.
+              billable_metric_id: nil,
+              # 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.
+              billed_in_advance: nil,
+              # For custom cadence: specifies the duration of the billing period in days or
+              # months.
+              billing_cycle_configuration: nil,
+              # The per unit conversion rate of the price currency to the invoicing currency.
+              conversion_rate: nil,
+              # The configuration for the rate of the price currency to the invoicing currency.
+              conversion_rate_config: nil,
+              # An ISO 4217 currency string, or custom pricing unit identifier, in which this
+              # price is billed.
+              currency: nil,
+              # For dimensional price: specifies a price group and dimension values
+              dimensional_price_configuration: nil,
+              # An alias for the price.
+              external_price_id: nil,
+              # If the Price represents a fixed cost, this represents the quantity of units
+              # applied.
+              fixed_price_quantity: nil,
+              # The property used to group this price on an invoice
+              invoice_grouping_key: nil,
+              # Within each billing cycle, specifies the cadence at which invoices are produced.
+              # If unspecified, a single invoice is produced per billing cycle.
+              invoicing_cycle_configuration: nil,
+              # The ID of the license type to associate with this price.
+              license_type_id: nil,
+              # 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`.
+              metadata: nil,
+              # A transient ID that can be used to reference this price when adding adjustments
+              # in the same API call.
+              reference_id: nil,
+              # The pricing model type
+              model_type: :grouped_tiered_matrix
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  cadence:
+                    Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix::Cadence::OrSymbol,
+                  grouped_tiered_matrix_config:
+                    Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix::GroupedTieredMatrixConfig,
+                  item_id: String,
+                  model_type: Symbol,
+                  name: String,
+                  billable_metric_id: T.nilable(String),
+                  billed_in_advance: T.nilable(T::Boolean),
+                  billing_cycle_configuration:
+                    T.nilable(Orb::NewBillingCycleConfiguration),
+                  conversion_rate: T.nilable(Float),
+                  conversion_rate_config:
+                    T.nilable(
+                      T.any(
+                        Orb::UnitConversionRateConfig,
+                        Orb::TieredConversionRateConfig
+                      )
+                    ),
+                  currency: T.nilable(String),
+                  dimensional_price_configuration:
+                    T.nilable(Orb::NewDimensionalPriceConfiguration),
+                  external_price_id: T.nilable(String),
+                  fixed_price_quantity: T.nilable(Float),
+                  invoice_grouping_key: T.nilable(String),
+                  invoicing_cycle_configuration:
+                    T.nilable(Orb::NewBillingCycleConfiguration),
+                  license_type_id: T.nilable(String),
+                  metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+                  reference_id: T.nilable(String)
+                }
+              )
+            end
+            def to_hash
+            end
+
+            # The cadence to bill for this price on.
+            module Cadence
+              extend Orb::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix::Cadence
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              ANNUAL =
+                T.let(
+                  :annual,
+                  Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix::Cadence::TaggedSymbol
+                )
+              SEMI_ANNUAL =
+                T.let(
+                  :semi_annual,
+                  Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix::Cadence::TaggedSymbol
+                )
+              MONTHLY =
+                T.let(
+                  :monthly,
+                  Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix::Cadence::TaggedSymbol
+                )
+              QUARTERLY =
+                T.let(
+                  :quarterly,
+                  Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix::Cadence::TaggedSymbol
+                )
+              ONE_TIME =
+                T.let(
+                  :one_time,
+                  Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix::Cadence::TaggedSymbol
+                )
+              CUSTOM =
+                T.let(
+                  :custom,
+                  Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix::Cadence::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix::Cadence::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+
+            class GroupedTieredMatrixConfig < Orb::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix::GroupedTieredMatrixConfig,
+                    Orb::Internal::AnyHash
+                  )
+                end
+
+              # Per unit rate for usage whose dimension value has no configured tiers
+              sig { returns(String) }
+              attr_accessor :default_unit_amount
+
+              # The billable metric property used to group usage before tiering
+              sig { returns(String) }
+              attr_accessor :dimension
+
+              # Graduated tiers keyed by dimension value; usage for a value is tiered only
+              # against its own rows
+              sig do
+                returns(
+                  T::Array[
+                    Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix::GroupedTieredMatrixConfig::Tier
+                  ]
+                )
+              end
+              attr_accessor :tiers
+
+              # Configuration for grouped_tiered_matrix pricing
+              sig do
+                params(
+                  default_unit_amount: String,
+                  dimension: String,
+                  tiers:
+                    T::Array[
+                      Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix::GroupedTieredMatrixConfig::Tier::OrHash
+                    ]
+                ).returns(T.attached_class)
+              end
+              def self.new(
+                # Per unit rate for usage whose dimension value has no configured tiers
+                default_unit_amount:,
+                # The billable metric property used to group usage before tiering
+                dimension:,
+                # Graduated tiers keyed by dimension value; usage for a value is tiered only
+                # against its own rows
+                tiers:
+              )
+              end
+
+              sig do
+                override.returns(
+                  {
+                    default_unit_amount: String,
+                    dimension: String,
+                    tiers:
+                      T::Array[
+                        Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix::GroupedTieredMatrixConfig::Tier
+                      ]
+                  }
+                )
+              end
+              def to_hash
+              end
+
+              class Tier < Orb::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      Orb::PlanCreateParams::Price::Price::GroupedTieredMatrix::GroupedTieredMatrixConfig::Tier,
+                      Orb::Internal::AnyHash
+                    )
+                  end
+
+                # The dimension value this tier applies to
+                sig { returns(String) }
+                attr_accessor :dimension_value
+
+                sig { returns(String) }
+                attr_accessor :tier_lower_bound
+
+                # Per unit amount
+                sig { returns(String) }
+                attr_accessor :unit_amount
+
+                # Configuration for a single tier scoped to a dimension value
+                sig do
+                  params(
+                    dimension_value: String,
+                    tier_lower_bound: String,
+                    unit_amount: String
+                  ).returns(T.attached_class)
+                end
+                def self.new(
+                  # The dimension value this tier applies to
+                  dimension_value:,
+                  tier_lower_bound:,
+                  # Per unit amount
+                  unit_amount:
+                )
+                end
+
+                sig do
+                  override.returns(
+                    {
+                      dimension_value: String,
+                      tier_lower_bound: String,
+                      unit_amount: String
+                    }
+                  )
+                end
+                def to_hash
+                end
+              end
+            end
+          end
+
           class MatrixWithThresholdDiscounts < Orb::Internal::Type::BaseModel
             OrHash =
               T.type_alias do

data/rbi/orb/models/plan_version.rbi

@@ -54,6 +54,7 @@ module Orb
                 Orb::Price::TieredPackage::OrHash,
                 Orb::Price::TieredWithMinimum::OrHash,
                 Orb::Price::GroupedTiered::OrHash,
+                Orb::Price::GroupedTieredMatrix::OrHash,
                 Orb::Price::TieredPackageWithMinimum::OrHash,
                 Orb::Price::PackageWithAllocation::OrHash,
                 Orb::Price::UnitWithPercent::OrHash,