orb-billing 1.13.0 → 1.15.0

data/lib/orb/models/beta_fetch_plan_version_params.rb

@@ -12,8 +12,14 @@ module Orb
       #   @return [String]
       required :plan_id, String
 
-      # @!method initialize(plan_id:, request_options: {})
+      # @!attribute version
+      #
+      #   @return [String]
+      required :version, String
+
+      # @!method initialize(plan_id:, version:, request_options: {})
       #   @param plan_id [String]
+      #   @param version [String]
       #   @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/orb/models/beta_set_default_plan_version_params.rb

@@ -7,13 +7,20 @@ module Orb
       extend Orb::Internal::Type::RequestParameters::Converter
       include Orb::Internal::Type::RequestParameters
 
+      # @!attribute plan_id
+      #
+      #   @return [String]
+      required :plan_id, String
+
       # @!attribute version
       #   Plan version to set as the default.
       #
       #   @return [Integer]
       required :version, Integer
 
-      # @!method initialize(version:, request_options: {})
+      # @!method initialize(plan_id:, version:, request_options: {})
+      #   @param plan_id [String]
+      #
       #   @param version [Integer] Plan version to set as the default.
       #
       #   @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}]

data/lib/orb/models/changed_subscription_resources.rb

@@ -148,11 +148,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                                                                                     |
@@ -164,6 +166,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ō_)                                                       |
@@ -194,6 +197,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                                                                                     |
@@ -215,6 +219,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                                                                                  |
@@ -252,7 +257,7 @@ module Orb
 
         # @!attribute discounts
         #
-        #   @return [Array<Orb::Models::PercentageDiscount, Orb::Models::AmountDiscount, Orb::Models::TrialDiscount>]
+        #   @return [Array<Orb::Models::PercentageDiscount, Orb::Models::AmountDiscount, Orb::Models::TrialDiscount, Orb::Models::InvoiceLevelDiscount::TieredPercentage>]
         required :discounts, -> { Orb::Internal::Type::ArrayOf[union: Orb::InvoiceLevelDiscount] }
 
         # @!attribute due_date
@@ -271,8 +276,8 @@ module Orb
         required :eligible_to_issue_at, Time, nil?: true
 
         # @!attribute hosted_invoice_url
-        #   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.
         #
         #   @return [String, nil]
         required :hosted_invoice_url, String, nil?: true
@@ -475,13 +480,13 @@ module Orb
         #
         #   @param discount [Object] This field is deprecated in favor of `discounts`. If a `discounts` list is provi
         #
-        #   @param discounts [Array<Orb::Models::PercentageDiscount, Orb::Models::AmountDiscount, Orb::Models::TrialDiscount>]
+        #   @param discounts [Array<Orb::Models::PercentageDiscount, Orb::Models::AmountDiscount, Orb::Models::TrialDiscount, Orb::Models::InvoiceLevelDiscount::TieredPercentage>]
         #
         #   @param due_date [Time, nil] When the invoice payment is due. The due date is null if the invoice is not yet
         #
         #   @param eligible_to_issue_at [Time, nil] If the invoice has a status of `draft`, this will be the time that the invoice w
         #
-        #   @param hosted_invoice_url [String, nil] A URL for the customer-facing invoice portal. This URL expires 30 days after the
+        #   @param hosted_invoice_url [String, nil] A URL for the customer-facing invoice portal. This URL expires 60 days after the
         #
         #   @param invoice_date [Time] The scheduled date of the invoice
         #
@@ -791,7 +796,7 @@ module Orb
           #   invoice calculations (ie. usage discounts -> amount discounts -> percentage
           #   discounts -> minimums -> maximums).
           #
-          #   @return [Array<Orb::Models::MonetaryUsageDiscountAdjustment, Orb::Models::MonetaryAmountDiscountAdjustment, Orb::Models::MonetaryPercentageDiscountAdjustment, Orb::Models::MonetaryMinimumAdjustment, Orb::Models::MonetaryMaximumAdjustment>]
+          #   @return [Array<Orb::Models::MonetaryUsageDiscountAdjustment, Orb::Models::MonetaryAmountDiscountAdjustment, Orb::Models::MonetaryPercentageDiscountAdjustment, Orb::Models::ChangedSubscriptionResources::CreatedInvoice::LineItem::Adjustment::TieredPercentageDiscount, Orb::Models::MonetaryMinimumAdjustment, Orb::Models::MonetaryMaximumAdjustment>]
           required :adjustments,
                    -> { Orb::Internal::Type::ArrayOf[union: Orb::ChangedSubscriptionResources::CreatedInvoice::LineItem::Adjustment] }
 
@@ -852,7 +857,7 @@ module Orb
           #   For more on the types of prices, see
           #   [the core concepts documentation](/core-concepts#plan-and-price)
           #
-          #   @return [Orb::Models::Price::Unit, Orb::Models::Price::Tiered, Orb::Models::Price::Bulk, Orb::Models::Price::BulkWithFilters, Orb::Models::Price::Package, Orb::Models::Price::Matrix, Orb::Models::Price::ThresholdTotalAmount, Orb::Models::Price::TieredPackage, Orb::Models::Price::TieredWithMinimum, Orb::Models::Price::GroupedTiered, Orb::Models::Price::TieredPackageWithMinimum, Orb::Models::Price::PackageWithAllocation, Orb::Models::Price::UnitWithPercent, Orb::Models::Price::MatrixWithAllocation, Orb::Models::Price::TieredWithProration, Orb::Models::Price::UnitWithProration, Orb::Models::Price::GroupedAllocation, Orb::Models::Price::BulkWithProration, Orb::Models::Price::GroupedWithProratedMinimum, Orb::Models::Price::GroupedWithMeteredMinimum, Orb::Models::Price::GroupedWithMinMaxThresholds, Orb::Models::Price::MatrixWithDisplayName, Orb::Models::Price::GroupedTieredPackage, Orb::Models::Price::MaxGroupTieredPackage, Orb::Models::Price::ScalableMatrixWithUnitPricing, Orb::Models::Price::ScalableMatrixWithTieredPricing, Orb::Models::Price::CumulativeGroupedBulk, Orb::Models::Price::CumulativeGroupedAllocation, Orb::Models::Price::MinimumComposite, Orb::Models::Price::Percent, Orb::Models::Price::EventOutput]
+          #   @return [Orb::Models::Price::Unit, Orb::Models::Price::Tiered, Orb::Models::Price::Bulk, Orb::Models::Price::BulkWithFilters, Orb::Models::Price::Package, Orb::Models::Price::Matrix, Orb::Models::Price::ThresholdTotalAmount, Orb::Models::Price::TieredPackage, Orb::Models::Price::TieredWithMinimum, Orb::Models::Price::GroupedTiered, Orb::Models::Price::TieredPackageWithMinimum, Orb::Models::Price::PackageWithAllocation, Orb::Models::Price::UnitWithPercent, Orb::Models::Price::MatrixWithAllocation, Orb::Models::Price::MatrixWithThresholdDiscounts, Orb::Models::Price::TieredWithProration, Orb::Models::Price::UnitWithProration, Orb::Models::Price::GroupedAllocation, Orb::Models::Price::BulkWithProration, Orb::Models::Price::GroupedWithProratedMinimum, Orb::Models::Price::GroupedWithMeteredMinimum, Orb::Models::Price::GroupedWithMinMaxThresholds, Orb::Models::Price::MatrixWithDisplayName, Orb::Models::Price::GroupedTieredPackage, Orb::Models::Price::MaxGroupTieredPackage, Orb::Models::Price::ScalableMatrixWithUnitPricing, Orb::Models::Price::ScalableMatrixWithTieredPricing, Orb::Models::Price::CumulativeGroupedBulk, Orb::Models::Price::CumulativeGroupedAllocation, Orb::Models::Price::DailyCreditAllowance, Orb::Models::Price::MeteredAllowance, Orb::Models::Price::MinimumComposite, Orb::Models::Price::Percent, Orb::Models::Price::EventOutput]
           required :price, union: -> { Orb::Price }
 
           # @!attribute quantity
@@ -903,7 +908,7 @@ module Orb
           #
           #   @param adjusted_subtotal [String] The line amount after any adjustments and before overage conversion, credits and
           #
-          #   @param adjustments [Array<Orb::Models::MonetaryUsageDiscountAdjustment, Orb::Models::MonetaryAmountDiscountAdjustment, Orb::Models::MonetaryPercentageDiscountAdjustment, Orb::Models::MonetaryMinimumAdjustment, Orb::Models::MonetaryMaximumAdjustment>] All adjustments applied to the line item in the order they were applied based on
+          #   @param adjustments [Array<Orb::Models::MonetaryUsageDiscountAdjustment, Orb::Models::MonetaryAmountDiscountAdjustment, Orb::Models::MonetaryPercentageDiscountAdjustment, Orb::Models::ChangedSubscriptionResources::CreatedInvoice::LineItem::Adjustment::TieredPercentageDiscount, Orb::Models::MonetaryMinimumAdjustment, Orb::Models::MonetaryMaximumAdjustment>] All adjustments applied to the line item in the order they were applied based on
           #
           #   @param amount [String] The final amount for a line item after all adjustments and pre paid credits have
           #
@@ -919,7 +924,7 @@ module Orb
           #
           #   @param partially_invoiced_amount [String] Any amount applied from a partial invoice
           #
-          #   @param price [Orb::Models::Price::Unit, Orb::Models::Price::Tiered, Orb::Models::Price::Bulk, Orb::Models::Price::BulkWithFilters, Orb::Models::Price::Package, Orb::Models::Price::Matrix, Orb::Models::Price::ThresholdTotalAmount, Orb::Models::Price::TieredPackage, Orb::Models::Price::TieredWithMinimum, Orb::Models::Price::GroupedTiered, Orb::Models::Price::TieredPackageWithMinimum, Orb::Models::Price::PackageWithAllocation, Orb::Models::Price::UnitWithPercent, Orb::Models::Price::MatrixWithAllocation, Orb::Models::Price::TieredWithProration, Orb::Models::Price::UnitWithProration, Orb::Models::Price::GroupedAllocation, Orb::Models::Price::BulkWithProration, Orb::Models::Price::GroupedWithProratedMinimum, Orb::Models::Price::GroupedWithMeteredMinimum, Orb::Models::Price::GroupedWithMinMaxThresholds, Orb::Models::Price::MatrixWithDisplayName, Orb::Models::Price::GroupedTieredPackage, Orb::Models::Price::MaxGroupTieredPackage, Orb::Models::Price::ScalableMatrixWithUnitPricing, Orb::Models::Price::ScalableMatrixWithTieredPricing, Orb::Models::Price::CumulativeGroupedBulk, Orb::Models::Price::CumulativeGroupedAllocation, Orb::Models::Price::MinimumComposite, Orb::Models::Price::Percent, Orb::Models::Price::EventOutput] The Price resource represents a price that can be billed on a subscription, resu
+          #   @param price [Orb::Models::Price::Unit, Orb::Models::Price::Tiered, Orb::Models::Price::Bulk, Orb::Models::Price::BulkWithFilters, Orb::Models::Price::Package, Orb::Models::Price::Matrix, Orb::Models::Price::ThresholdTotalAmount, Orb::Models::Price::TieredPackage, Orb::Models::Price::TieredWithMinimum, Orb::Models::Price::GroupedTiered, Orb::Models::Price::TieredPackageWithMinimum, Orb::Models::Price::PackageWithAllocation, Orb::Models::Price::UnitWithPercent, Orb::Models::Price::MatrixWithAllocation, Orb::Models::Price::MatrixWithThresholdDiscounts, Orb::Models::Price::TieredWithProration, Orb::Models::Price::UnitWithProration, Orb::Models::Price::GroupedAllocation, Orb::Models::Price::BulkWithProration, Orb::Models::Price::GroupedWithProratedMinimum, Orb::Models::Price::GroupedWithMeteredMinimum, Orb::Models::Price::GroupedWithMinMaxThresholds, Orb::Models::Price::MatrixWithDisplayName, Orb::Models::Price::GroupedTieredPackage, Orb::Models::Price::MaxGroupTieredPackage, Orb::Models::Price::ScalableMatrixWithUnitPricing, Orb::Models::Price::ScalableMatrixWithTieredPricing, Orb::Models::Price::CumulativeGroupedBulk, Orb::Models::Price::CumulativeGroupedAllocation, Orb::Models::Price::DailyCreditAllowance, Orb::Models::Price::MeteredAllowance, Orb::Models::Price::MinimumComposite, Orb::Models::Price::Percent, Orb::Models::Price::EventOutput] The Price resource represents a price that can be billed on a subscription, resu
           #
           #   @param quantity [Float] Either the fixed fee quantity or the usage during the service period.
           #
@@ -944,12 +949,196 @@ module Orb
 
             variant :percentage_discount, -> { Orb::MonetaryPercentageDiscountAdjustment }
 
+            variant :tiered_percentage_discount,
+                    -> { Orb::ChangedSubscriptionResources::CreatedInvoice::LineItem::Adjustment::TieredPercentageDiscount }
+
             variant :minimum, -> { Orb::MonetaryMinimumAdjustment }
 
             variant :maximum, -> { Orb::MonetaryMaximumAdjustment }
 
+            class TieredPercentageDiscount < Orb::Internal::Type::BaseModel
+              # @!attribute id
+              #
+              #   @return [String]
+              required :id, String
+
+              # @!attribute adjustment_type
+              #
+              #   @return [Symbol, :tiered_percentage_discount]
+              required :adjustment_type, const: :tiered_percentage_discount
+
+              # @!attribute amount
+              #   The value applied by an adjustment.
+              #
+              #   @return [String]
+              required :amount, String
+
+              # @!attribute applies_to_price_ids
+              #   @deprecated
+              #
+              #   The price IDs that this adjustment applies to.
+              #
+              #   @return [Array<String>]
+              required :applies_to_price_ids, Orb::Internal::Type::ArrayOf[String]
+
+              # @!attribute filters
+              #   The filters that determine which prices to apply this adjustment to.
+              #
+              #   @return [Array<Orb::Models::ChangedSubscriptionResources::CreatedInvoice::LineItem::Adjustment::TieredPercentageDiscount::Filter>]
+              required :filters,
+                       -> { Orb::Internal::Type::ArrayOf[Orb::ChangedSubscriptionResources::CreatedInvoice::LineItem::Adjustment::TieredPercentageDiscount::Filter] }
+
+              # @!attribute is_invoice_level
+              #   True for adjustments that apply to an entire invoice, false for adjustments that
+              #   apply to only one price.
+              #
+              #   @return [Boolean]
+              required :is_invoice_level, Orb::Internal::Type::Boolean
+
+              # @!attribute reason
+              #   The reason for the adjustment.
+              #
+              #   @return [String, nil]
+              required :reason, String, nil?: true
+
+              # @!attribute replaces_adjustment_id
+              #   The adjustment id this adjustment replaces. This adjustment will take the place
+              #   of the replaced adjustment in plan version migrations.
+              #
+              #   @return [String, nil]
+              required :replaces_adjustment_id, String, nil?: true
+
+              # @!attribute tiers
+              #   The ordered, contiguous bands of cumulative eligible spend, each discounted at
+              #   its own percentage (progressive fill-a-tier), applied to the prices this
+              #   adjustment covers in a given billing period.
+              #
+              #   @return [Array<Orb::Models::ChangedSubscriptionResources::CreatedInvoice::LineItem::Adjustment::TieredPercentageDiscount::Tier>]
+              required :tiers,
+                       -> { Orb::Internal::Type::ArrayOf[Orb::ChangedSubscriptionResources::CreatedInvoice::LineItem::Adjustment::TieredPercentageDiscount::Tier] }
+
+              # @!method initialize(id:, amount:, applies_to_price_ids:, filters:, is_invoice_level:, reason:, replaces_adjustment_id:, tiers:, adjustment_type: :tiered_percentage_discount)
+              #   Some parameter documentations has been truncated, see
+              #   {Orb::Models::ChangedSubscriptionResources::CreatedInvoice::LineItem::Adjustment::TieredPercentageDiscount}
+              #   for more details.
+              #
+              #   @param id [String]
+              #
+              #   @param amount [String] The value applied by an adjustment.
+              #
+              #   @param applies_to_price_ids [Array<String>] The price IDs that this adjustment applies to.
+              #
+              #   @param filters [Array<Orb::Models::ChangedSubscriptionResources::CreatedInvoice::LineItem::Adjustment::TieredPercentageDiscount::Filter>] The filters that determine which prices to apply this adjustment to.
+              #
+              #   @param is_invoice_level [Boolean] True for adjustments that apply to an entire invoice, false for adjustments that
+              #
+              #   @param reason [String, nil] The reason for the adjustment.
+              #
+              #   @param replaces_adjustment_id [String, nil] The adjustment id this adjustment replaces. This adjustment will take the place
+              #
+              #   @param tiers [Array<Orb::Models::ChangedSubscriptionResources::CreatedInvoice::LineItem::Adjustment::TieredPercentageDiscount::Tier>] The ordered, contiguous bands of cumulative eligible spend, each discounted at i
+              #
+              #   @param adjustment_type [Symbol, :tiered_percentage_discount]
+
+              class Filter < Orb::Internal::Type::BaseModel
+                # @!attribute field
+                #   The property of the price to filter on.
+                #
+                #   @return [Symbol, Orb::Models::ChangedSubscriptionResources::CreatedInvoice::LineItem::Adjustment::TieredPercentageDiscount::Filter::Field]
+                required :field,
+                         enum: -> { Orb::ChangedSubscriptionResources::CreatedInvoice::LineItem::Adjustment::TieredPercentageDiscount::Filter::Field }
+
+                # @!attribute operator
+                #   Should prices that match the filter be included or excluded.
+                #
+                #   @return [Symbol, Orb::Models::ChangedSubscriptionResources::CreatedInvoice::LineItem::Adjustment::TieredPercentageDiscount::Filter::Operator]
+                required :operator,
+                         enum: -> { Orb::ChangedSubscriptionResources::CreatedInvoice::LineItem::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::ChangedSubscriptionResources::CreatedInvoice::LineItem::Adjustment::TieredPercentageDiscount::Filter::Field] The property of the price to filter on.
+                #
+                #   @param operator [Symbol, Orb::Models::ChangedSubscriptionResources::CreatedInvoice::LineItem::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::ChangedSubscriptionResources::CreatedInvoice::LineItem::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::ChangedSubscriptionResources::CreatedInvoice::LineItem::Adjustment::TieredPercentageDiscount::Filter#operator
+                module Operator
+                  extend Orb::Internal::Type::Enum
+
+                  INCLUDES = :includes
+                  EXCLUDES = :excludes
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
+              end
+
+              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 (between 0 and 1) discounted from spend that falls within this
+                #   tier.
+                #
+                #   @return [Float]
+                required :percentage, Float
+
+                # @!attribute upper_bound
+                #   Inclusive upper bound of cumulative spend for this tier; null for the final
+                #   open-ended tier.
+                #
+                #   @return [Float, nil]
+                optional :upper_bound, Float, nil?: true
+
+                # @!method initialize(lower_bound:, percentage:, upper_bound: nil)
+                #   Some parameter documentations has been truncated, see
+                #   {Orb::Models::ChangedSubscriptionResources::CreatedInvoice::LineItem::Adjustment::TieredPercentageDiscount::Tier}
+                #   for more details.
+                #
+                #   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.
+                #
+                #   @param lower_bound [Float] Exclusive lower bound of cumulative spend for this tier.
+                #
+                #   @param percentage [Float] The percentage (between 0 and 1) discounted from spend that falls within this ti
+                #
+                #   @param upper_bound [Float, nil] Inclusive upper bound of cumulative spend for this tier; null for the final open
+              end
+            end
+
             # @!method self.variants
-            #   @return [Array(Orb::Models::MonetaryUsageDiscountAdjustment, Orb::Models::MonetaryAmountDiscountAdjustment, Orb::Models::MonetaryPercentageDiscountAdjustment, Orb::Models::MonetaryMinimumAdjustment, Orb::Models::MonetaryMaximumAdjustment)]
+            #   @return [Array(Orb::Models::MonetaryUsageDiscountAdjustment, Orb::Models::MonetaryAmountDiscountAdjustment, Orb::Models::MonetaryPercentageDiscountAdjustment, Orb::Models::ChangedSubscriptionResources::CreatedInvoice::LineItem::Adjustment::TieredPercentageDiscount, Orb::Models::MonetaryMinimumAdjustment, Orb::Models::MonetaryMaximumAdjustment)]
           end
 
           module SubLineItem
@@ -1042,6 +1231,7 @@ module Orb
             extend Orb::Internal::Type::Enum
 
             STRIPE = :stripe
+            ADYEN = :adyen
 
             # @!method self.values
             #   @return [Array<Symbol>]

data/lib/orb/models/conversion_rate_config.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Orb
+  module Models
+    module ConversionRateConfig
+      extend Orb::Internal::Type::Union
+
+      discriminator :conversion_rate_type
+
+      variant :unit, -> { Orb::UnitConversionRateConfig }
+
+      variant :tiered, -> { Orb::TieredConversionRateConfig }
+
+      # @!method self.variants
+      #   @return [Array(Orb::Models::UnitConversionRateConfig, Orb::Models::TieredConversionRateConfig)]
+    end
+  end
+end

data/lib/orb/models/coupon_archive_params.rb

@@ -7,7 +7,13 @@ module Orb
       extend Orb::Internal::Type::RequestParameters::Converter
       include Orb::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute coupon_id
+      #
+      #   @return [String]
+      required :coupon_id, String
+
+      # @!method initialize(coupon_id:, request_options: {})
+      #   @param coupon_id [String]
       #   @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/orb/models/coupon_fetch_params.rb

@@ -7,7 +7,13 @@ module Orb
       extend Orb::Internal::Type::RequestParameters::Converter
       include Orb::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute coupon_id
+      #
+      #   @return [String]
+      required :coupon_id, String
+
+      # @!method initialize(coupon_id:, request_options: {})
+      #   @param coupon_id [String]
       #   @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/orb/models/coupons/subscription_list_params.rb

@@ -8,6 +8,11 @@ module Orb
         extend Orb::Internal::Type::RequestParameters::Converter
         include Orb::Internal::Type::RequestParameters
 
+        # @!attribute coupon_id
+        #
+        #   @return [String]
+        required :coupon_id, String
+
         # @!attribute cursor
         #   Cursor for pagination. This can be populated by the `next_cursor` value returned
         #   from the initial request.
@@ -21,10 +26,12 @@ module Orb
         #   @return [Integer, nil]
         optional :limit, Integer
 
-        # @!method initialize(cursor: nil, limit: nil, request_options: {})
+        # @!method initialize(coupon_id:, cursor: nil, limit: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Orb::Models::Coupons::SubscriptionListParams} for more details.
         #
+        #   @param coupon_id [String]
+        #
         #   @param cursor [String, nil] Cursor for pagination. This can be populated by the `next_cursor` value returned
         #
         #   @param limit [Integer] The number of items to fetch. Defaults to 20.

data/lib/orb/models/credit_block_delete_params.rb

@@ -7,7 +7,13 @@ module Orb
       extend Orb::Internal::Type::RequestParameters::Converter
       include Orb::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute block_id
+      #
+      #   @return [String]
+      required :block_id, String
+
+      # @!method initialize(block_id:, request_options: {})
+      #   @param block_id [String]
       #   @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/orb/models/credit_block_list_invoices_params.rb

@@ -7,7 +7,13 @@ module Orb
       extend Orb::Internal::Type::RequestParameters::Converter
       include Orb::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute block_id
+      #
+      #   @return [String]
+      required :block_id, String
+
+      # @!method initialize(block_id:, request_options: {})
+      #   @param block_id [String]
       #   @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/orb/models/credit_block_list_invoices_response.rb

@@ -33,6 +33,16 @@ module Orb
         #   @return [Float]
         required :balance, Float
 
+        # @!attribute credit_block_source
+        #   How this credit block was created: `allocation` (a subscription's recurring
+        #   credit allocation), `top_up` (an automatic balance-threshold top-up), or
+        #   `manual` (a manual credit ledger increment, including credits voided or expired
+        #   off another block).
+        #
+        #   @return [Symbol, Orb::Models::CreditBlockListInvoicesResponse::Block::CreditBlockSource]
+        required :credit_block_source,
+                 enum: -> { Orb::Models::CreditBlockListInvoicesResponse::Block::CreditBlockSource }
+
         # @!attribute effective_date
         #
         #   @return [Time, nil]
@@ -73,7 +83,16 @@ module Orb
         #   @return [Symbol, Orb::Models::CreditBlockListInvoicesResponse::Block::Status]
         required :status, enum: -> { Orb::Models::CreditBlockListInvoicesResponse::Block::Status }
 
-        # @!method initialize(id:, balance:, effective_date:, expiry_date:, filters:, maximum_initial_balance:, metadata:, per_unit_cost_basis:, status:)
+        # @!attribute credit_allocation
+        #   The credit allocation that funded a block. Extends the allocation resource
+        #   serialized on prices with the catalog-item attribution of the funding price.
+        #
+        #   @return [Orb::Models::CreditBlockListInvoicesResponse::Block::CreditAllocation, nil]
+        optional :credit_allocation,
+                 -> { Orb::Models::CreditBlockListInvoicesResponse::Block::CreditAllocation },
+                 nil?: true
+
+        # @!method initialize(id:, balance:, credit_block_source:, effective_date:, expiry_date:, filters:, maximum_initial_balance:, metadata:, per_unit_cost_basis:, status:, credit_allocation: nil)
         #   Some parameter documentations has been truncated, see
         #   {Orb::Models::CreditBlockListInvoicesResponse::Block} for more details.
         #
@@ -83,6 +102,8 @@ module Orb
         #
         #   @param balance [Float]
         #
+        #   @param credit_block_source [Symbol, Orb::Models::CreditBlockListInvoicesResponse::Block::CreditBlockSource] How this credit block was created: `allocation` (a subscription's recurring cred
+        #
         #   @param effective_date [Time, nil]
         #
         #   @param expiry_date [Time, nil]
@@ -96,6 +117,25 @@ module Orb
         #   @param per_unit_cost_basis [String, nil]
         #
         #   @param status [Symbol, Orb::Models::CreditBlockListInvoicesResponse::Block::Status]
+        #
+        #   @param credit_allocation [Orb::Models::CreditBlockListInvoicesResponse::Block::CreditAllocation, nil] The credit allocation that funded a block. Extends the allocation resource
+
+        # How this credit block was created: `allocation` (a subscription's recurring
+        # credit allocation), `top_up` (an automatic balance-threshold top-up), or
+        # `manual` (a manual credit ledger increment, including credits voided or expired
+        # off another block).
+        #
+        # @see Orb::Models::CreditBlockListInvoicesResponse::Block#credit_block_source
+        module CreditBlockSource
+          extend Orb::Internal::Type::Enum
+
+          ALLOCATION = :allocation
+          TOP_UP = :top_up
+          MANUAL = :manual
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
 
         class Filter < Orb::Internal::Type::BaseModel
           # @!attribute field
@@ -163,6 +203,120 @@ module Orb
           # @!method self.values
           #   @return [Array<Symbol>]
         end
+
+        # @see Orb::Models::CreditBlockListInvoicesResponse::Block#credit_allocation
+        class CreditAllocation < Orb::Internal::Type::BaseModel
+          # @!attribute allows_rollover
+          #
+          #   @return [Boolean]
+          required :allows_rollover, Orb::Internal::Type::Boolean
+
+          # @!attribute currency
+          #
+          #   @return [String]
+          required :currency, String
+
+          # @!attribute custom_expiration
+          #
+          #   @return [Orb::Models::CustomExpiration, nil]
+          required :custom_expiration, -> { Orb::CustomExpiration }, nil?: true
+
+          # @!attribute item_id
+          #   The ID of the catalog item this block was allocated from, derived from the
+          #   allocation's price.
+          #
+          #   @return [String]
+          required :item_id, String
+
+          # @!attribute filters
+          #
+          #   @return [Array<Orb::Models::CreditBlockListInvoicesResponse::Block::CreditAllocation::Filter>, nil]
+          optional :filters,
+                   -> { Orb::Internal::Type::ArrayOf[Orb::Models::CreditBlockListInvoicesResponse::Block::CreditAllocation::Filter] }
+
+          # @!attribute license_type_id
+          #
+          #   @return [String, nil]
+          optional :license_type_id, String, nil?: true
+
+          # @!method initialize(allows_rollover:, currency:, custom_expiration:, item_id:, filters: nil, license_type_id: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Orb::Models::CreditBlockListInvoicesResponse::Block::CreditAllocation} for more
+          #   details.
+          #
+          #   The credit allocation that funded a block. Extends the allocation resource
+          #   serialized on prices with the catalog-item attribution of the funding price.
+          #
+          #   @param allows_rollover [Boolean]
+          #
+          #   @param currency [String]
+          #
+          #   @param custom_expiration [Orb::Models::CustomExpiration, nil]
+          #
+          #   @param item_id [String] The ID of the catalog item this block was allocated from, derived from the alloc
+          #
+          #   @param filters [Array<Orb::Models::CreditBlockListInvoicesResponse::Block::CreditAllocation::Filter>]
+          #
+          #   @param license_type_id [String, nil]
+
+          class Filter < Orb::Internal::Type::BaseModel
+            # @!attribute field
+            #   The property of the price to filter on.
+            #
+            #   @return [Symbol, Orb::Models::CreditBlockListInvoicesResponse::Block::CreditAllocation::Filter::Field]
+            required :field,
+                     enum: -> { Orb::Models::CreditBlockListInvoicesResponse::Block::CreditAllocation::Filter::Field }
+
+            # @!attribute operator
+            #   Should prices that match the filter be included or excluded.
+            #
+            #   @return [Symbol, Orb::Models::CreditBlockListInvoicesResponse::Block::CreditAllocation::Filter::Operator]
+            required :operator,
+                     enum: -> { Orb::Models::CreditBlockListInvoicesResponse::Block::CreditAllocation::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::CreditBlockListInvoicesResponse::Block::CreditAllocation::Filter::Field] The property of the price to filter on.
+            #
+            #   @param operator [Symbol, Orb::Models::CreditBlockListInvoicesResponse::Block::CreditAllocation::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::CreditBlockListInvoicesResponse::Block::CreditAllocation::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::CreditBlockListInvoicesResponse::Block::CreditAllocation::Filter#operator
+            module Operator
+              extend Orb::Internal::Type::Enum
+
+              INCLUDES = :includes
+              EXCLUDES = :excludes
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+        end
       end
 
       class Invoice < Orb::Internal::Type::BaseModel