orb-billing 1.14.0 → 1.15.0

data/rbi/orb/models/invoice_list_summary_response.rbi

@@ -119,11 +119,13 @@ module Orb
       # | Estonia                | `eu_vat`     | European VAT Number                                                                                     |
       # | Ethiopia               | `et_tin`     | Ethiopia Tax Identification Number                                                                      |
       # | European Union         | `eu_oss_vat` | European One Stop Shop VAT Number for non-Union scheme                                                  |
+      # | Faroe Islands          | `fo_vat`     | Faroe Islands VAT Number                                                                                |
       # | Finland                | `eu_vat`     | European VAT Number                                                                                     |
       # | France                 | `eu_vat`     | European VAT Number                                                                                     |
       # | Georgia                | `ge_vat`     | Georgian VAT                                                                                            |
       # | Germany                | `de_stn`     | German Tax Number (Steuernummer)                                                                        |
       # | Germany                | `eu_vat`     | European VAT Number                                                                                     |
+      # | Gibraltar              | `gi_tin`     | Gibraltar Tax Identification Number                                                                     |
       # | Greece                 | `eu_vat`     | European VAT Number                                                                                     |
       # | Guinea                 | `gn_nif`     | Guinea Tax Identification Number (Número de Identificação Fiscal)                                       |
       # | Hong Kong              | `hk_br`      | Hong Kong BR Number                                                                                     |
@@ -135,6 +137,7 @@ module Orb
       # | Ireland                | `eu_vat`     | European VAT Number                                                                                     |
       # | Israel                 | `il_vat`     | Israel VAT                                                                                              |
       # | Italy                  | `eu_vat`     | European VAT Number                                                                                     |
+      # | Italy                  | `it_cf`      | Italian Codice Fiscale Number                                                                           |
       # | Japan                  | `jp_cn`      | Japanese Corporate Number (_Hōjin Bangō_)                                                               |
       # | Japan                  | `jp_rn`      | Japanese Registered Foreign Businesses' Registration Number (_Tōroku Kokugai Jigyōsha no Tōroku Bangō_) |
       # | Japan                  | `jp_trn`     | Japanese Tax Registration Number (_Tōroku Bangō_)                                                       |
@@ -165,6 +168,7 @@ module Orb
       # | Norway                 | `no_vat`     | Norwegian VAT Number                                                                                    |
       # | Norway                 | `no_voec`    | Norwegian VAT on e-commerce Number                                                                      |
       # | Oman                   | `om_vat`     | Omani VAT Number                                                                                        |
+      # | Paraguay               | `py_ruc`     | Paraguayan RUC Number                                                                                   |
       # | Peru                   | `pe_ruc`     | Peruvian RUC Number                                                                                     |
       # | Philippines            | `ph_tin`     | Philippines Tax Identification Number                                                                   |
       # | Poland                 | `eu_vat`     | European VAT Number                                                                                     |
@@ -186,6 +190,7 @@ module Orb
       # | South Korea            | `kr_brn`     | Korean BRN                                                                                              |
       # | Spain                  | `es_cif`     | Spanish NIF Number (previously Spanish CIF Number)                                                      |
       # | Spain                  | `eu_vat`     | European VAT Number                                                                                     |
+      # | Sri Lanka              | `lk_vat`     | Sri Lanka VAT Number                                                                                    |
       # | Suriname               | `sr_fin`     | Suriname FIN Number                                                                                     |
       # | Sweden                 | `eu_vat`     | European VAT Number                                                                                     |
       # | Switzerland            | `ch_uid`     | Switzerland UID Number                                                                                  |
@@ -226,8 +231,8 @@ module Orb
       sig { returns(T.nilable(Time)) }
       attr_accessor :eligible_to_issue_at
 
-      # A URL for the customer-facing invoice portal. This URL expires 30 days after the
-      # invoice's due date, or 60 days after being re-generated through the UI.
+      # A URL for the customer-facing invoice portal. This URL expires 60 days after the
+      # link is generated, or 30 days after the invoice's due date — whichever is later.
       sig { returns(T.nilable(String)) }
       attr_accessor :hosted_invoice_url
 
@@ -462,11 +467,13 @@ module Orb
         # | Estonia                | `eu_vat`     | European VAT Number                                                                                     |
         # | Ethiopia               | `et_tin`     | Ethiopia Tax Identification Number                                                                      |
         # | European Union         | `eu_oss_vat` | European One Stop Shop VAT Number for non-Union scheme                                                  |
+        # | Faroe Islands          | `fo_vat`     | Faroe Islands VAT Number                                                                                |
         # | Finland                | `eu_vat`     | European VAT Number                                                                                     |
         # | France                 | `eu_vat`     | European VAT Number                                                                                     |
         # | Georgia                | `ge_vat`     | Georgian VAT                                                                                            |
         # | Germany                | `de_stn`     | German Tax Number (Steuernummer)                                                                        |
         # | Germany                | `eu_vat`     | European VAT Number                                                                                     |
+        # | Gibraltar              | `gi_tin`     | Gibraltar Tax Identification Number                                                                     |
         # | Greece                 | `eu_vat`     | European VAT Number                                                                                     |
         # | Guinea                 | `gn_nif`     | Guinea Tax Identification Number (Número de Identificação Fiscal)                                       |
         # | Hong Kong              | `hk_br`      | Hong Kong BR Number                                                                                     |
@@ -478,6 +485,7 @@ module Orb
         # | Ireland                | `eu_vat`     | European VAT Number                                                                                     |
         # | Israel                 | `il_vat`     | Israel VAT                                                                                              |
         # | Italy                  | `eu_vat`     | European VAT Number                                                                                     |
+        # | Italy                  | `it_cf`      | Italian Codice Fiscale Number                                                                           |
         # | Japan                  | `jp_cn`      | Japanese Corporate Number (_Hōjin Bangō_)                                                               |
         # | Japan                  | `jp_rn`      | Japanese Registered Foreign Businesses' Registration Number (_Tōroku Kokugai Jigyōsha no Tōroku Bangō_) |
         # | Japan                  | `jp_trn`     | Japanese Tax Registration Number (_Tōroku Bangō_)                                                       |
@@ -508,6 +516,7 @@ module Orb
         # | Norway                 | `no_vat`     | Norwegian VAT Number                                                                                    |
         # | Norway                 | `no_voec`    | Norwegian VAT on e-commerce Number                                                                      |
         # | Oman                   | `om_vat`     | Omani VAT Number                                                                                        |
+        # | Paraguay               | `py_ruc`     | Paraguayan RUC Number                                                                                   |
         # | Peru                   | `pe_ruc`     | Peruvian RUC Number                                                                                     |
         # | Philippines            | `ph_tin`     | Philippines Tax Identification Number                                                                   |
         # | Poland                 | `eu_vat`     | European VAT Number                                                                                     |
@@ -529,6 +538,7 @@ module Orb
         # | South Korea            | `kr_brn`     | Korean BRN                                                                                              |
         # | Spain                  | `es_cif`     | Spanish NIF Number (previously Spanish CIF Number)                                                      |
         # | Spain                  | `eu_vat`     | European VAT Number                                                                                     |
+        # | Sri Lanka              | `lk_vat`     | Sri Lanka VAT Number                                                                                    |
         # | Suriname               | `sr_fin`     | Suriname FIN Number                                                                                     |
         # | Sweden                 | `eu_vat`     | European VAT Number                                                                                     |
         # | Switzerland            | `ch_uid`     | Switzerland UID Number                                                                                  |
@@ -558,8 +568,8 @@ module Orb
         # will be eligible to be issued, otherwise it will be `null`. If `auto-issue` is
         # true, the invoice will automatically begin issuing at this time.
         eligible_to_issue_at:,
-        # A URL for the customer-facing invoice portal. This URL expires 30 days after the
-        # invoice's due date, or 60 days after being re-generated through the UI.
+        # A URL for the customer-facing invoice portal. This URL expires 60 days after the
+        # link is generated, or 30 days after the invoice's due date — whichever is later.
         hosted_invoice_url:,
         # The scheduled date of the invoice
         invoice_date:,
@@ -1196,6 +1206,11 @@ module Orb
               :stripe,
               Orb::Models::InvoiceListSummaryResponse::PaymentAttempt::PaymentProvider::TaggedSymbol
             )
+          ADYEN =
+            T.let(
+              :adyen,
+              Orb::Models::InvoiceListSummaryResponse::PaymentAttempt::PaymentProvider::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/orb/models/licenses/external_license_get_usage_params.rbi

@@ -37,7 +37,7 @@ module Orb
 
         # How to group the results. Valid values: 'license', 'day'. Can be combined (e.g.,
         # 'license,day').
-        sig { returns(T.nilable(T::Array[String])) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :group_by
 
         # Maximum number of rows in the response data (default 20, max 100).
@@ -59,7 +59,7 @@ module Orb
             subscription_id: String,
             cursor: T.nilable(String),
             end_date: T.nilable(Date),
-            group_by: T.nilable(T::Array[String]),
+            group_by: T.nilable(String),
             limit: Integer,
             start_date: T.nilable(Date),
             request_options: Orb::RequestOptions::OrHash
@@ -96,7 +96,7 @@ module Orb
               subscription_id: String,
               cursor: T.nilable(String),
               end_date: T.nilable(Date),
-              group_by: T.nilable(T::Array[String]),
+              group_by: T.nilable(String),
               limit: Integer,
               start_date: T.nilable(Date),
               request_options: Orb::RequestOptions

data/rbi/orb/models/licenses/usage_get_all_usage_params.rbi

@@ -31,7 +31,7 @@ module Orb
 
         # How to group the results. Valid values: 'license', 'day'. Can be combined (e.g.,
         # 'license,day').
-        sig { returns(T.nilable(T::Array[String])) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :group_by
 
         # Maximum number of rows in the response data (default 20, max 100).
@@ -52,7 +52,7 @@ module Orb
             subscription_id: String,
             cursor: T.nilable(String),
             end_date: T.nilable(Date),
-            group_by: T.nilable(T::Array[String]),
+            group_by: T.nilable(String),
             limit: Integer,
             start_date: T.nilable(Date),
             request_options: Orb::RequestOptions::OrHash
@@ -87,7 +87,7 @@ module Orb
               subscription_id: String,
               cursor: T.nilable(String),
               end_date: T.nilable(Date),
-              group_by: T.nilable(T::Array[String]),
+              group_by: T.nilable(String),
               limit: Integer,
               start_date: T.nilable(Date),
               request_options: Orb::RequestOptions

data/rbi/orb/models/licenses/usage_get_usage_params.rbi

@@ -26,7 +26,7 @@ module Orb
 
         # How to group the results. Valid values: 'license', 'day'. Can be combined (e.g.,
         # 'license,day').
-        sig { returns(T.nilable(T::Array[String])) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :group_by
 
         # Maximum number of rows in the response data (default 20, max 100).
@@ -46,7 +46,7 @@ module Orb
             license_id: String,
             cursor: T.nilable(String),
             end_date: T.nilable(Date),
-            group_by: T.nilable(T::Array[String]),
+            group_by: T.nilable(String),
             limit: Integer,
             start_date: T.nilable(Date),
             request_options: Orb::RequestOptions::OrHash
@@ -77,7 +77,7 @@ module Orb
               license_id: String,
               cursor: T.nilable(String),
               end_date: T.nilable(Date),
-              group_by: T.nilable(T::Array[String]),
+              group_by: T.nilable(String),
               limit: Integer,
               start_date: T.nilable(Date),
               request_options: Orb::RequestOptions

data/rbi/orb/models/mutated_subscription.rbi

@@ -25,6 +25,13 @@ module Orb
       sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :auto_collection
 
+      # Determines whether invoices for this subscription will be automatically issued.
+      # This resolves the effective setting for the subscription: a subscription-level
+      # override if set, otherwise the customer-level setting, otherwise the
+      # account-level default.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_accessor :auto_issuance
+
       sig { returns(Orb::BillingCycleAnchorConfiguration) }
       attr_reader :billing_cycle_anchor_configuration
 
@@ -199,6 +206,7 @@ module Orb
           active_plan_phase_order: T.nilable(Integer),
           adjustment_intervals: T::Array[Orb::AdjustmentInterval::OrHash],
           auto_collection: T.nilable(T::Boolean),
+          auto_issuance: T.nilable(T::Boolean),
           billing_cycle_anchor_configuration:
             Orb::BillingCycleAnchorConfiguration::OrHash,
           billing_cycle_day: Integer,
@@ -212,7 +220,8 @@ module Orb
               T.any(
                 Orb::AmountDiscountInterval::OrHash,
                 Orb::PercentageDiscountInterval::OrHash,
-                Orb::UsageDiscountInterval::OrHash
+                Orb::UsageDiscountInterval::OrHash,
+                Orb::MutatedSubscription::DiscountInterval::TieredPercentage::OrHash
               )
             ],
           end_date: T.nilable(Time),
@@ -248,6 +257,11 @@ module Orb
         # charged with the saved payment method on the due date. This property defaults to
         # the plan's behavior. If null, defaults to the customer's setting.
         auto_collection:,
+        # Determines whether invoices for this subscription will be automatically issued.
+        # This resolves the effective setting for the subscription: a subscription-level
+        # override if set, otherwise the customer-level setting, otherwise the
+        # account-level default.
+        auto_issuance:,
         billing_cycle_anchor_configuration:,
         # The day of the month on which the billing cycle is anchored. If the maximum
         # number of days in a month is greater than this value, the last day of the month
@@ -338,6 +352,7 @@ module Orb
             active_plan_phase_order: T.nilable(Integer),
             adjustment_intervals: T::Array[Orb::AdjustmentInterval],
             auto_collection: T.nilable(T::Boolean),
+            auto_issuance: T.nilable(T::Boolean),
             billing_cycle_anchor_configuration:
               Orb::BillingCycleAnchorConfiguration,
             billing_cycle_day: Integer,
@@ -380,9 +395,316 @@ module Orb
             T.any(
               Orb::AmountDiscountInterval,
               Orb::PercentageDiscountInterval,
-              Orb::UsageDiscountInterval
+              Orb::UsageDiscountInterval,
+              Orb::MutatedSubscription::DiscountInterval::TieredPercentage
+            )
+          end
+
+        class TieredPercentage < Orb::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Orb::MutatedSubscription::DiscountInterval::TieredPercentage,
+                Orb::Internal::AnyHash
+              )
+            end
+
+          # The price interval ids that this discount interval applies to.
+          sig { returns(T::Array[String]) }
+          attr_accessor :applies_to_price_interval_ids
+
+          sig { returns(Symbol) }
+          attr_accessor :discount_type
+
+          # The end date of the discount interval.
+          sig { returns(T.nilable(Time)) }
+          attr_accessor :end_date
+
+          # The filters that determine which prices this discount interval applies to.
+          sig do
+            returns(
+              T::Array[
+                Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Filter
+              ]
+            )
+          end
+          attr_accessor :filters
+
+          # The start date of the discount interval.
+          sig { returns(Time) }
+          attr_accessor :start_date
+
+          # Only available if discount_type is `tiered_percentage`. The ordered, contiguous
+          # bands of cumulative eligible spend, each discounted at its own percentage.
+          sig do
+            returns(
+              T::Array[
+                Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Tier
+              ]
+            )
+          end
+          attr_accessor :tiers
+
+          sig do
+            params(
+              applies_to_price_interval_ids: T::Array[String],
+              end_date: T.nilable(Time),
+              filters:
+                T::Array[
+                  Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Filter::OrHash
+                ],
+              start_date: Time,
+              tiers:
+                T::Array[
+                  Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Tier::OrHash
+                ],
+              discount_type: Symbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The price interval ids that this discount interval applies to.
+            applies_to_price_interval_ids:,
+            # The end date of the discount interval.
+            end_date:,
+            # The filters that determine which prices this discount interval applies to.
+            filters:,
+            # The start date of the discount interval.
+            start_date:,
+            # Only available if discount_type is `tiered_percentage`. The ordered, contiguous
+            # bands of cumulative eligible spend, each discounted at its own percentage.
+            tiers:,
+            discount_type: :tiered_percentage
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                applies_to_price_interval_ids: T::Array[String],
+                discount_type: Symbol,
+                end_date: T.nilable(Time),
+                filters:
+                  T::Array[
+                    Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Filter
+                  ],
+                start_date: Time,
+                tiers:
+                  T::Array[
+                    Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Tier
+                  ]
+              }
+            )
+          end
+          def to_hash
+          end
+
+          class Filter < Orb::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Filter,
+                  Orb::Internal::AnyHash
+                )
+              end
+
+            # The property of the price to filter on.
+            sig do
+              returns(
+                Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Filter::Field::TaggedSymbol
+              )
+            end
+            attr_accessor :field
+
+            # Should prices that match the filter be included or excluded.
+            sig do
+              returns(
+                Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Filter::Operator::TaggedSymbol
+              )
+            end
+            attr_accessor :operator
+
+            # The IDs or values that match this filter.
+            sig { returns(T::Array[String]) }
+            attr_accessor :values
+
+            sig do
+              params(
+                field:
+                  Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Filter::Field::OrSymbol,
+                operator:
+                  Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Filter::Operator::OrSymbol,
+                values: T::Array[String]
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # The property of the price to filter on.
+              field:,
+              # Should prices that match the filter be included or excluded.
+              operator:,
+              # The IDs or values that match this filter.
+              values:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  field:
+                    Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Filter::Field::TaggedSymbol,
+                  operator:
+                    Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Filter::Operator::TaggedSymbol,
+                  values: T::Array[String]
+                }
+              )
+            end
+            def to_hash
+            end
+
+            # The property of the price to filter on.
+            module Field
+              extend Orb::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Filter::Field
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              PRICE_ID =
+                T.let(
+                  :price_id,
+                  Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Filter::Field::TaggedSymbol
+                )
+              ITEM_ID =
+                T.let(
+                  :item_id,
+                  Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Filter::Field::TaggedSymbol
+                )
+              PRICE_TYPE =
+                T.let(
+                  :price_type,
+                  Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Filter::Field::TaggedSymbol
+                )
+              CURRENCY =
+                T.let(
+                  :currency,
+                  Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Filter::Field::TaggedSymbol
+                )
+              PRICING_UNIT_ID =
+                T.let(
+                  :pricing_unit_id,
+                  Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Filter::Field::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Filter::Field::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+
+            # Should prices that match the filter be included or excluded.
+            module Operator
+              extend Orb::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Filter::Operator
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              INCLUDES =
+                T.let(
+                  :includes,
+                  Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Filter::Operator::TaggedSymbol
+                )
+              EXCLUDES =
+                T.let(
+                  :excludes,
+                  Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Filter::Operator::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Filter::Operator::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+          end
+
+          class Tier < Orb::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Orb::MutatedSubscription::DiscountInterval::TieredPercentage::Tier,
+                  Orb::Internal::AnyHash
+                )
+              end
+
+            # Exclusive lower bound of cumulative spend for this tier.
+            sig { returns(Float) }
+            attr_accessor :lower_bound
+
+            # The percentage (between 0 and 1) discounted from spend that falls within this
+            # tier.
+            sig { returns(Float) }
+            attr_accessor :percentage
+
+            # Inclusive upper bound of cumulative spend for this tier; null for the final
+            # open-ended tier.
+            sig { returns(T.nilable(Float)) }
+            attr_accessor :upper_bound
+
+            # One band of a tiered percentage discount. Bounds are denominated in the
+            # discount's currency. `lower_bound` is the exclusive start of the band and
+            # `upper_bound` is the inclusive end; `upper_bound` is null only for the
+            # open-ended final tier.
+            sig do
+              params(
+                lower_bound: Float,
+                percentage: Float,
+                upper_bound: T.nilable(Float)
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # Exclusive lower bound of cumulative spend for this tier.
+              lower_bound:,
+              # The percentage (between 0 and 1) discounted from spend that falls within this
+              # tier.
+              percentage:,
+              # Inclusive upper bound of cumulative spend for this tier; null for the final
+              # open-ended tier.
+              upper_bound: nil
             )
+            end
+
+            sig do
+              override.returns(
+                {
+                  lower_bound: Float,
+                  percentage: Float,
+                  upper_bound: T.nilable(Float)
+                }
+              )
+            end
+            def to_hash
+            end
           end
+        end
 
         sig do
           override.returns(

data/rbi/orb/models/new_allocation_price.rbi

@@ -47,6 +47,12 @@ module Orb
       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
+
       # The (per-unit) cost basis of each created block. If non-zero, a customer will be
       # invoiced according to the quantity and per unit cost basis specified for the
       # allocation each cadence.
@@ -66,6 +72,7 @@ module Orb
           filters: T.nilable(T::Array[Orb::NewAllocationPrice::Filter::OrHash]),
           item_id: T.nilable(String),
           license_type_id: T.nilable(String),
+          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
           per_unit_cost_basis: String
         ).returns(T.attached_class)
       end
@@ -90,6 +97,10 @@ module Orb
         item_id: nil,
         # The license type ID to associate the price with license allocation.
         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,
         # The (per-unit) cost basis of each created block. If non-zero, a customer will be
         # invoiced according to the quantity and per unit cost basis specified for the
         # allocation each cadence.
@@ -108,6 +119,7 @@ module Orb
             filters: T.nilable(T::Array[Orb::NewAllocationPrice::Filter]),
             item_id: T.nilable(String),
             license_type_id: T.nilable(String),
+            metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
             per_unit_cost_basis: String
           }
         )

data/rbi/orb/models/per_price_cost.rbi

@@ -43,6 +43,7 @@ module Orb
               Orb::Price::PackageWithAllocation::OrHash,
               Orb::Price::UnitWithPercent::OrHash,
               Orb::Price::MatrixWithAllocation::OrHash,
+              Orb::Price::MatrixWithThresholdDiscounts::OrHash,
               Orb::Price::TieredWithProration::OrHash,
               Orb::Price::UnitWithProration::OrHash,
               Orb::Price::GroupedAllocation::OrHash,
@@ -57,6 +58,8 @@ module Orb
               Orb::Price::ScalableMatrixWithTieredPricing::OrHash,
               Orb::Price::CumulativeGroupedBulk::OrHash,
               Orb::Price::CumulativeGroupedAllocation::OrHash,
+              Orb::Price::DailyCreditAllowance::OrHash,
+              Orb::Price::MeteredAllowance::OrHash,
               Orb::Price::MinimumComposite::OrHash,
               Orb::Price::Percent::OrHash,
               Orb::Price::EventOutput::OrHash