orb-billing 5.48.0 → 5.75.1

package/src/resources/shared.ts

@@ -24,6 +24,7 @@ export interface AdjustmentInterval {
     | PlanPhaseUsageDiscountAdjustment
     | PlanPhaseAmountDiscountAdjustment
     | PlanPhasePercentageDiscountAdjustment
+    | AdjustmentInterval.PlanPhaseTieredPercentageDiscountAdjustment
     | PlanPhaseMinimumAdjustment
     | PlanPhaseMaximumAdjustment;
 
@@ -43,6 +44,97 @@ export interface AdjustmentInterval {
   start_date: string;
 }
 
+export namespace AdjustmentInterval {
+  export interface PlanPhaseTieredPercentageDiscountAdjustment {
+    id: string;
+
+    adjustment_type: 'tiered_percentage_discount';
+
+    /**
+     * @deprecated The price IDs that this adjustment applies to.
+     */
+    applies_to_price_ids: Array<string>;
+
+    /**
+     * The filters that determine which prices to apply this adjustment to.
+     */
+    filters: Array<PlanPhaseTieredPercentageDiscountAdjustment.Filter>;
+
+    /**
+     * True for adjustments that apply to an entire invoice, false for adjustments that
+     * apply to only one price.
+     */
+    is_invoice_level: boolean;
+
+    /**
+     * The plan phase in which this adjustment is active.
+     */
+    plan_phase_order: number | null;
+
+    /**
+     * The reason for the adjustment.
+     */
+    reason: string | null;
+
+    /**
+     * The adjustment id this adjustment replaces. This adjustment will take the place
+     * of the replaced adjustment in plan version migrations.
+     */
+    replaces_adjustment_id: string | null;
+
+    /**
+     * 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.
+     */
+    tiers: Array<PlanPhaseTieredPercentageDiscountAdjustment.Tier>;
+  }
+
+  export namespace PlanPhaseTieredPercentageDiscountAdjustment {
+    export interface Filter {
+      /**
+       * The property of the price to filter on.
+       */
+      field: 'price_id' | 'item_id' | 'price_type' | 'currency' | 'pricing_unit_id';
+
+      /**
+       * Should prices that match the filter be included or excluded.
+       */
+      operator: 'includes' | 'excludes';
+
+      /**
+       * The IDs or values that match this filter.
+       */
+      values: Array<string>;
+    }
+
+    /**
+     * 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.
+     */
+    export interface Tier {
+      /**
+       * Exclusive lower bound of cumulative spend for this tier.
+       */
+      lower_bound: number;
+
+      /**
+       * The percentage (between 0 and 1) discounted from spend that falls within this
+       * tier.
+       */
+      percentage: number;
+
+      /**
+       * Inclusive upper bound of cumulative spend for this tier; null for the final
+       * open-ended tier.
+       */
+      upper_bound?: number | null;
+    }
+  }
+}
+
 export interface AggregatedCost {
   per_price_costs: Array<PerPriceCost>;
 
@@ -354,11 +446,13 @@ export namespace ChangedSubscriptionResources {
      * | 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                                                                                     |
@@ -370,6 +464,7 @@ export namespace ChangedSubscriptionResources {
      * | 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ō_)                                                       |
@@ -400,6 +495,7 @@ export namespace ChangedSubscriptionResources {
      * | 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                                                                                     |
@@ -421,6 +517,7 @@ export namespace ChangedSubscriptionResources {
      * | 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                                                                                  |
@@ -468,8 +565,8 @@ export namespace ChangedSubscriptionResources {
     eligible_to_issue_at: string | null;
 
     /**
-     * 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: string | null;
 
@@ -727,6 +824,7 @@ export namespace ChangedSubscriptionResources {
         | Shared.MonetaryUsageDiscountAdjustment
         | Shared.MonetaryAmountDiscountAdjustment
         | Shared.MonetaryPercentageDiscountAdjustment
+        | LineItem.MonetaryTieredPercentageDiscountAdjustment
         | Shared.MonetaryMinimumAdjustment
         | Shared.MonetaryMaximumAdjustment
       >;
@@ -816,6 +914,97 @@ export namespace ChangedSubscriptionResources {
       usage_customer_ids: Array<string> | null;
     }
 
+    export namespace LineItem {
+      export interface MonetaryTieredPercentageDiscountAdjustment {
+        id: string;
+
+        adjustment_type: 'tiered_percentage_discount';
+
+        /**
+         * The value applied by an adjustment.
+         */
+        amount: string;
+
+        /**
+         * @deprecated The price IDs that this adjustment applies to.
+         */
+        applies_to_price_ids: Array<string>;
+
+        /**
+         * The filters that determine which prices to apply this adjustment to.
+         */
+        filters: Array<MonetaryTieredPercentageDiscountAdjustment.Filter>;
+
+        /**
+         * True for adjustments that apply to an entire invoice, false for adjustments that
+         * apply to only one price.
+         */
+        is_invoice_level: boolean;
+
+        /**
+         * The reason for the adjustment.
+         */
+        reason: string | null;
+
+        /**
+         * The adjustment id this adjustment replaces. This adjustment will take the place
+         * of the replaced adjustment in plan version migrations.
+         */
+        replaces_adjustment_id: string | null;
+
+        /**
+         * 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.
+         */
+        tiers: Array<MonetaryTieredPercentageDiscountAdjustment.Tier>;
+      }
+
+      export namespace MonetaryTieredPercentageDiscountAdjustment {
+        export interface Filter {
+          /**
+           * The property of the price to filter on.
+           */
+          field: 'price_id' | 'item_id' | 'price_type' | 'currency' | 'pricing_unit_id';
+
+          /**
+           * Should prices that match the filter be included or excluded.
+           */
+          operator: 'includes' | 'excludes';
+
+          /**
+           * The IDs or values that match this filter.
+           */
+          values: Array<string>;
+        }
+
+        /**
+         * 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.
+         */
+        export interface Tier {
+          /**
+           * Exclusive lower bound of cumulative spend for this tier.
+           */
+          lower_bound: number;
+
+          /**
+           * The percentage (between 0 and 1) discounted from spend that falls within this
+           * tier.
+           */
+          percentage: number;
+
+          /**
+           * Inclusive upper bound of cumulative spend for this tier; null for the final
+           * open-ended tier.
+           */
+          upper_bound?: number | null;
+        }
+      }
+    }
+
     export interface PaymentAttempt {
       /**
        * The ID of the payment attempt.
@@ -835,7 +1024,7 @@ export namespace ChangedSubscriptionResources {
       /**
        * The payment provider that attempted to collect the payment.
        */
-      payment_provider: 'stripe' | null;
+      payment_provider: 'stripe' | 'adyen' | null;
 
       /**
        * The ID of the payment attempt in the payment provider.
@@ -1164,11 +1353,13 @@ export interface CustomerMinified {
  * | 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                                                                                     |
@@ -1180,6 +1371,7 @@ export interface CustomerMinified {
  * | 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ō_)                                                       |
@@ -1210,6 +1402,7 @@ export interface CustomerMinified {
  * | 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                                                                                     |
@@ -1231,6 +1424,7 @@ export interface CustomerMinified {
  * | 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                                                                                  |
@@ -1286,9 +1480,9 @@ export interface CustomerTaxID {
     | 'CO'
     | 'CR'
     | 'CV'
-    | 'DE'
     | 'CY'
     | 'CZ'
+    | 'DE'
     | 'DK'
     | 'DO'
     | 'EC'
@@ -1298,9 +1492,11 @@ export interface CustomerTaxID {
     | 'ET'
     | 'EU'
     | 'FI'
+    | 'FO'
     | 'FR'
     | 'GB'
     | 'GE'
+    | 'GI'
     | 'GN'
     | 'GR'
     | 'HK'
@@ -1320,6 +1516,7 @@ export interface CustomerTaxID {
     | 'KZ'
     | 'LA'
     | 'LI'
+    | 'LK'
     | 'LT'
     | 'LU'
     | 'LV'
@@ -1341,6 +1538,7 @@ export interface CustomerTaxID {
     | 'PH'
     | 'PL'
     | 'PT'
+    | 'PY'
     | 'RO'
     | 'RS'
     | 'RU'
@@ -1414,8 +1612,10 @@ export interface CustomerTaxID {
     | 'es_cif'
     | 'et_tin'
     | 'eu_oss_vat'
+    | 'fo_vat'
     | 'gb_vat'
     | 'ge_vat'
+    | 'gi_tin'
     | 'gn_nif'
     | 'hk_br'
     | 'hr_oib'
@@ -1424,6 +1624,7 @@ export interface CustomerTaxID {
     | 'il_vat'
     | 'in_gst'
     | 'is_vat'
+    | 'it_cf'
     | 'jp_cn'
     | 'jp_rn'
     | 'jp_trn'
@@ -1435,6 +1636,7 @@ export interface CustomerTaxID {
     | 'la_tin'
     | 'li_uid'
     | 'li_vat'
+    | 'lk_vat'
     | 'ma_vat'
     | 'md_vat'
     | 'me_pib'
@@ -1453,6 +1655,7 @@ export interface CustomerTaxID {
     | 'pe_ruc'
     | 'ph_tin'
     | 'pl_nip'
+    | 'py_ruc'
     | 'ro_tin'
     | 'rs_pib'
     | 'ru_inn'
@@ -1490,7 +1693,82 @@ export interface DimensionalPriceConfiguration {
   dimensional_price_group_id: string;
 }
 
-export type Discount = PercentageDiscount | TrialDiscount | UsageDiscount | AmountDiscount;
+export type Discount =
+  | PercentageDiscount
+  | TrialDiscount
+  | UsageDiscount
+  | AmountDiscount
+  | Discount.TieredPercentageDiscount;
+
+export namespace Discount {
+  export interface TieredPercentageDiscount {
+    discount_type: 'tiered_percentage';
+
+    /**
+     * Only available if discount_type is `tiered_percentage`. The ordered, contiguous
+     * bands of cumulative eligible spend, each discounted at its own percentage
+     * (progressive fill-a-tier).
+     */
+    tiers: Array<TieredPercentageDiscount.Tier>;
+
+    /**
+     * List of price_ids that this discount applies to. For plan/plan phase discounts,
+     * this can be a subset of prices.
+     */
+    applies_to_price_ids?: Array<string> | null;
+
+    /**
+     * The filters that determine which prices to apply this discount to.
+     */
+    filters?: Array<TieredPercentageDiscount.Filter> | null;
+
+    reason?: string | null;
+  }
+
+  export namespace TieredPercentageDiscount {
+    /**
+     * 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.
+     */
+    export interface Tier {
+      /**
+       * Exclusive lower bound of cumulative spend for this tier.
+       */
+      lower_bound: number;
+
+      /**
+       * The percentage (between 0 and 1) discounted from spend that falls within this
+       * tier.
+       */
+      percentage: number;
+
+      /**
+       * Inclusive upper bound of cumulative spend for this tier; null for the final
+       * open-ended tier.
+       */
+      upper_bound?: number | null;
+    }
+
+    export interface Filter {
+      /**
+       * The property of the price to filter on.
+       */
+      field: 'price_id' | 'item_id' | 'price_type' | 'currency' | 'pricing_unit_id';
+
+      /**
+       * Should prices that match the filter be included or excluded.
+       */
+      operator: 'includes' | 'excludes';
+
+      /**
+       * The IDs or values that match this filter.
+       */
+      values: Array<string>;
+    }
+  }
+}
 
 export interface FixedFeeQuantityScheduleEntry {
   end_date: string | null;
@@ -1607,11 +1885,13 @@ export interface Invoice {
    * | 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                                                                                     |
@@ -1623,6 +1903,7 @@ export interface Invoice {
    * | 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ō_)                                                       |
@@ -1653,6 +1934,7 @@ export interface Invoice {
    * | 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                                                                                     |
@@ -1674,6 +1956,7 @@ export interface Invoice {
    * | 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                                                                                  |
@@ -1721,8 +2004,8 @@ export interface Invoice {
   eligible_to_issue_at: string | null;
 
   /**
-   * 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: string | null;
 
@@ -1975,6 +2258,7 @@ export namespace Invoice {
       | Shared.MonetaryUsageDiscountAdjustment
       | Shared.MonetaryAmountDiscountAdjustment
       | Shared.MonetaryPercentageDiscountAdjustment
+      | LineItem.MonetaryTieredPercentageDiscountAdjustment
       | Shared.MonetaryMinimumAdjustment
       | Shared.MonetaryMaximumAdjustment
     >;
@@ -2064,6 +2348,97 @@ export namespace Invoice {
     usage_customer_ids: Array<string> | null;
   }
 
+  export namespace LineItem {
+    export interface MonetaryTieredPercentageDiscountAdjustment {
+      id: string;
+
+      adjustment_type: 'tiered_percentage_discount';
+
+      /**
+       * The value applied by an adjustment.
+       */
+      amount: string;
+
+      /**
+       * @deprecated The price IDs that this adjustment applies to.
+       */
+      applies_to_price_ids: Array<string>;
+
+      /**
+       * The filters that determine which prices to apply this adjustment to.
+       */
+      filters: Array<MonetaryTieredPercentageDiscountAdjustment.Filter>;
+
+      /**
+       * True for adjustments that apply to an entire invoice, false for adjustments that
+       * apply to only one price.
+       */
+      is_invoice_level: boolean;
+
+      /**
+       * The reason for the adjustment.
+       */
+      reason: string | null;
+
+      /**
+       * The adjustment id this adjustment replaces. This adjustment will take the place
+       * of the replaced adjustment in plan version migrations.
+       */
+      replaces_adjustment_id: string | null;
+
+      /**
+       * 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.
+       */
+      tiers: Array<MonetaryTieredPercentageDiscountAdjustment.Tier>;
+    }
+
+    export namespace MonetaryTieredPercentageDiscountAdjustment {
+      export interface Filter {
+        /**
+         * The property of the price to filter on.
+         */
+        field: 'price_id' | 'item_id' | 'price_type' | 'currency' | 'pricing_unit_id';
+
+        /**
+         * Should prices that match the filter be included or excluded.
+         */
+        operator: 'includes' | 'excludes';
+
+        /**
+         * The IDs or values that match this filter.
+         */
+        values: Array<string>;
+      }
+
+      /**
+       * 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.
+       */
+      export interface Tier {
+        /**
+         * Exclusive lower bound of cumulative spend for this tier.
+         */
+        lower_bound: number;
+
+        /**
+         * The percentage (between 0 and 1) discounted from spend that falls within this
+         * tier.
+         */
+        percentage: number;
+
+        /**
+         * Inclusive upper bound of cumulative spend for this tier; null for the final
+         * open-ended tier.
+         */
+        upper_bound?: number | null;
+      }
+    }
+  }
+
   export interface PaymentAttempt {
     /**
      * The ID of the payment attempt.
@@ -2083,7 +2458,7 @@ export namespace Invoice {
     /**
      * The payment provider that attempted to collect the payment.
      */
-    payment_provider: 'stripe' | null;
+    payment_provider: 'stripe' | 'adyen' | null;
 
     /**
      * The ID of the payment attempt in the payment provider.
@@ -2103,7 +2478,81 @@ export namespace Invoice {
   }
 }
 
-export type InvoiceLevelDiscount = PercentageDiscount | AmountDiscount | TrialDiscount;
+export type InvoiceLevelDiscount =
+  | PercentageDiscount
+  | AmountDiscount
+  | TrialDiscount
+  | InvoiceLevelDiscount.TieredPercentageDiscount;
+
+export namespace InvoiceLevelDiscount {
+  export interface TieredPercentageDiscount {
+    discount_type: 'tiered_percentage';
+
+    /**
+     * Only available if discount_type is `tiered_percentage`. The ordered, contiguous
+     * bands of cumulative eligible spend, each discounted at its own percentage
+     * (progressive fill-a-tier).
+     */
+    tiers: Array<TieredPercentageDiscount.Tier>;
+
+    /**
+     * List of price_ids that this discount applies to. For plan/plan phase discounts,
+     * this can be a subset of prices.
+     */
+    applies_to_price_ids?: Array<string> | null;
+
+    /**
+     * The filters that determine which prices to apply this discount to.
+     */
+    filters?: Array<TieredPercentageDiscount.Filter> | null;
+
+    reason?: string | null;
+  }
+
+  export namespace TieredPercentageDiscount {
+    /**
+     * 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.
+     */
+    export interface Tier {
+      /**
+       * Exclusive lower bound of cumulative spend for this tier.
+       */
+      lower_bound: number;
+
+      /**
+       * The percentage (between 0 and 1) discounted from spend that falls within this
+       * tier.
+       */
+      percentage: number;
+
+      /**
+       * Inclusive upper bound of cumulative spend for this tier; null for the final
+       * open-ended tier.
+       */
+      upper_bound?: number | null;
+    }
+
+    export interface Filter {
+      /**
+       * The property of the price to filter on.
+       */
+      field: 'price_id' | 'item_id' | 'price_type' | 'currency' | 'pricing_unit_id';
+
+      /**
+       * Should prices that match the filter be included or excluded.
+       */
+      operator: 'includes' | 'excludes';
+
+      /**
+       * The IDs or values that match this filter.
+       */
+      values: Array<string>;
+    }
+  }
+}
 
 export interface InvoiceTiny {
   /**
@@ -2762,6 +3211,13 @@ export interface NewAllocationPrice {
    */
   license_type_id?: string | null;
 
+  /**
+   * 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?: { [key: string]: string | null } | null;
+
   /**
    * 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
@@ -10076,6 +10532,7 @@ export type Price =
   | Price.PackageWithAllocationPrice
   | Price.UnitWithPercentPrice
   | Price.MatrixWithAllocationPrice
+  | Price.MatrixWithThresholdDiscountsPrice
   | Price.TieredWithProrationPrice
   | Price.UnitWithProrationPrice
   | Price.GroupedAllocationPrice
@@ -10090,6 +10547,8 @@ export type Price =
   | Price.ScalableMatrixWithTieredPricingPrice
   | Price.CumulativeGroupedBulkPrice
   | Price.CumulativeGroupedAllocationPrice
+  | Price.DailyCreditAllowancePrice
+  | Price.MeteredAllowancePrice
   | Price.MinimumCompositePrice
   | Price.PercentCompositePrice
   | Price.EventOutputPrice;
@@ -10127,6 +10586,8 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -10269,6 +10730,8 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -10416,6 +10879,8 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -10558,6 +11023,8 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -10742,6 +11209,8 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -10884,6 +11353,8 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -11026,6 +11497,8 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -11198,6 +11671,8 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -11369,6 +11844,8 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -11553,6 +12030,8 @@ export namespace Price {
      */
     grouped_tiered_config: GroupedTieredPrice.GroupedTieredConfig;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -11720,6 +12199,8 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -11888,6 +12369,8 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -12041,6 +12524,8 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -12198,6 +12683,8 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -12308,7 +12795,7 @@ export namespace Price {
     }
   }
 
-  export interface TieredWithProrationPrice {
+  export interface MatrixWithThresholdDiscountsPrice {
     id: string;
 
     billable_metric: Shared.BillableMetricTiny | null;
@@ -12319,7 +12806,7 @@ export namespace Price {
 
     cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
-    composite_price_filters: Array<TieredWithProrationPrice.CompositePriceFilter> | null;
+    composite_price_filters: Array<MatrixWithThresholdDiscountsPrice.CompositePriceFilter> | null;
 
     conversion_rate: number | null;
 
@@ -12340,6 +12827,213 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
+    invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
+    item: Shared.ItemSlim;
+
+    /**
+     * Configuration for matrix_with_threshold_discounts pricing
+     */
+    matrix_with_threshold_discounts_config: MatrixWithThresholdDiscountsPrice.MatrixWithThresholdDiscountsConfig;
+
+    /**
+     * @deprecated
+     */
+    maximum: Shared.Maximum | null;
+
+    /**
+     * @deprecated
+     */
+    maximum_amount: string | null;
+
+    /**
+     * User specified key-value pairs for the resource. If not present, this defaults
+     * to an empty dictionary. 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: { [key: string]: string };
+
+    /**
+     * @deprecated
+     */
+    minimum: Shared.Minimum | null;
+
+    /**
+     * @deprecated
+     */
+    minimum_amount: string | null;
+
+    /**
+     * The pricing model type
+     */
+    model_type: 'matrix_with_threshold_discounts';
+
+    name: string;
+
+    plan_phase_order: number | null;
+
+    price_type: 'usage_price' | 'fixed_price' | 'composite_price';
+
+    /**
+     * The price id this price replaces. This price will take the place of the replaced
+     * price in plan version migrations.
+     */
+    replaces_price_id: string | null;
+
+    dimensional_price_configuration?: Shared.DimensionalPriceConfiguration | null;
+
+    /**
+     * The LicenseType resource represents a type of license that can be assigned to
+     * users. License types are used during billing by grouping metrics on the
+     * configured grouping key.
+     */
+    license_type?: MatrixWithThresholdDiscountsPrice.LicenseType | null;
+  }
+
+  export namespace MatrixWithThresholdDiscountsPrice {
+    export interface CompositePriceFilter {
+      /**
+       * The property of the price to filter on.
+       */
+      field: 'price_id' | 'item_id' | 'price_type' | 'currency' | 'pricing_unit_id';
+
+      /**
+       * Should prices that match the filter be included or excluded.
+       */
+      operator: 'includes' | 'excludes';
+
+      /**
+       * The IDs or values that match this filter.
+       */
+      values: Array<string>;
+    }
+
+    /**
+     * Configuration for matrix_with_threshold_discounts pricing
+     */
+    export interface MatrixWithThresholdDiscountsConfig {
+      /**
+       * Unit price used for usage that does not match any defined matrix cell.
+       */
+      default_unit_amount: string;
+
+      /**
+       * First matrix dimension key.
+       */
+      first_dimension: string;
+
+      /**
+       * Per-cell unit prices.
+       */
+      matrix_values: Array<MatrixWithThresholdDiscountsConfig.MatrixValue>;
+
+      /**
+       * Optional second matrix dimension key.
+       */
+      second_dimension?: string | null;
+
+      threshold_discount_groups?: Array<MatrixWithThresholdDiscountsConfig.ThresholdDiscountGroup>;
+    }
+
+    export namespace MatrixWithThresholdDiscountsConfig {
+      export interface MatrixValue {
+        first_dimension_value: string;
+
+        unit_amount: string;
+
+        second_dimension_value?: string | null;
+      }
+
+      export interface ThresholdDiscountGroup {
+        /**
+         * Discount rate applied to spend above the threshold.
+         */
+        above_threshold_discount_percentage: string;
+
+        /**
+         * Discount rate applied to spend at or below the threshold. Set to 0 for no
+         * baseline discount.
+         */
+        below_threshold_discount_percentage: string;
+
+        /**
+         * Semicolon-separated list of matrix cell coordinates targeted by this group. Each
+         * coordinate is `first,second` when the matrix has two dimensions, or just `first`
+         * for a single-dimension matrix. Example: `blue,circle;green,triangle`.
+         */
+        cell_coordinates: string;
+
+        threshold_amount: string;
+
+        description?: string | null;
+      }
+    }
+
+    /**
+     * The LicenseType resource represents a type of license that can be assigned to
+     * users. License types are used during billing by grouping metrics on the
+     * configured grouping key.
+     */
+    export interface LicenseType {
+      /**
+       * The Orb-assigned unique identifier for the license type.
+       */
+      id: string;
+
+      /**
+       * The key used for grouping licenses of this type. This is typically a user
+       * identifier field.
+       */
+      grouping_key: string;
+
+      /**
+       * The name of the license type.
+       */
+      name: string;
+    }
+  }
+
+  export interface TieredWithProrationPrice {
+    id: string;
+
+    billable_metric: Shared.BillableMetricTiny | null;
+
+    billing_cycle_configuration: Shared.BillingCycleConfiguration;
+
+    billing_mode: 'in_advance' | 'in_arrear';
+
+    cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
+
+    composite_price_filters: Array<TieredWithProrationPrice.CompositePriceFilter> | null;
+
+    conversion_rate: number | null;
+
+    conversion_rate_config: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+
+    created_at: string;
+
+    credit_allocation: Shared.Allocation | null;
+
+    currency: string;
+
+    /**
+     * @deprecated
+     */
+    discount: Shared.Discount | null;
+
+    external_price_id: string | null;
+
+    fixed_price_quantity: number | null;
+
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -12510,6 +13204,8 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -12667,6 +13363,8 @@ export namespace Price {
      */
     grouped_allocation_config: GroupedAllocationPrice.GroupedAllocationConfig;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -12829,6 +13527,8 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -12998,6 +13698,8 @@ export namespace Price {
      */
     grouped_with_prorated_minimum_config: GroupedWithProratedMinimumPrice.GroupedWithProratedMinimumConfig;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -13160,6 +13862,8 @@ export namespace Price {
      */
     grouped_with_metered_minimum_config: GroupedWithMeteredMinimumPrice.GroupedWithMeteredMinimumConfig;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -13362,6 +14066,8 @@ export namespace Price {
      */
     grouped_with_min_max_thresholds_config: GroupedWithMinMaxThresholdsPrice.GroupedWithMinMaxThresholdsConfig;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -13524,6 +14230,8 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -13708,6 +14416,8 @@ export namespace Price {
      */
     grouped_tiered_package_config: GroupedTieredPackagePrice.GroupedTieredPackageConfig;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -13877,6 +14587,8 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -14050,6 +14762,8 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -14240,6 +14954,8 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -14431,6 +15147,8 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -14607,6 +15325,8 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -14737,7 +15457,7 @@ export namespace Price {
     }
   }
 
-  export interface MinimumCompositePrice {
+  export interface DailyCreditAllowancePrice {
     id: string;
 
     billable_metric: Shared.BillableMetricTiny | null;
@@ -14748,7 +15468,7 @@ export namespace Price {
 
     cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
-    composite_price_filters: Array<MinimumCompositePrice.CompositePriceFilter> | null;
+    composite_price_filters: Array<DailyCreditAllowancePrice.CompositePriceFilter> | null;
 
     conversion_rate: number | null;
 
@@ -14760,6 +15480,11 @@ export namespace Price {
 
     currency: string;
 
+    /**
+     * Configuration for daily_credit_allowance pricing
+     */
+    daily_credit_allowance_config: DailyCreditAllowancePrice.DailyCreditAllowanceConfig;
+
     /**
      * @deprecated
      */
@@ -14769,6 +15494,8 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -14805,15 +15532,10 @@ export namespace Price {
      */
     minimum_amount: string | null;
 
-    /**
-     * Configuration for minimum_composite pricing
-     */
-    minimum_composite_config: MinimumCompositePrice.MinimumCompositeConfig;
-
     /**
      * The pricing model type
      */
-    model_type: 'minimum_composite';
+    model_type: 'daily_credit_allowance';
 
     name: string;
 
@@ -14834,10 +15556,10 @@ export namespace Price {
      * users. License types are used during billing by grouping metrics on the
      * configured grouping key.
      */
-    license_type?: MinimumCompositePrice.LicenseType | null;
+    license_type?: DailyCreditAllowancePrice.LicenseType | null;
   }
 
-  export namespace MinimumCompositePrice {
+  export namespace DailyCreditAllowancePrice {
     export interface CompositePriceFilter {
       /**
        * The property of the price to filter on.
@@ -14856,18 +15578,54 @@ export namespace Price {
     }
 
     /**
-     * Configuration for minimum_composite pricing
+     * Configuration for daily_credit_allowance pricing
      */
-    export interface MinimumCompositeConfig {
+    export interface DailyCreditAllowanceConfig {
       /**
-       * The minimum amount to apply
+       * Credits granted per day. Lose-it-or-use-it; does not roll over.
        */
-      minimum_amount: string;
+      daily_allowance: string;
 
       /**
-       * If true, subtotals from this price are prorated based on the service period
+       * Default per-unit credit rate for any usage not bucketed into a specified
+       * matrix_value
        */
-      prorated?: boolean;
+      default_unit_amount: string;
+
+      /**
+       * One or two event property values to evaluate matrix groups by
+       */
+      dimensions: Array<string | null>;
+
+      /**
+       * Event property whose value identifies the day bucket the event belongs to (e.g.
+       * 'event_day' set to an ISO date string in the customer's timezone). The allowance
+       * resets per distinct value of this property.
+       */
+      event_day_property: string;
+
+      /**
+       * Per-dimension credit rates
+       */
+      matrix_values: Array<DailyCreditAllowanceConfig.MatrixValue>;
+    }
+
+    export namespace DailyCreditAllowanceConfig {
+      /**
+       * Per-dimension credit price for the daily credit allowance model.
+       */
+      export interface MatrixValue {
+        /**
+         * One or two matrix keys to filter usage to this value by. For example, ["model"]
+         * could be used to apply a different credit rate to each AI model.
+         */
+        dimension_values: Array<string | null>;
+
+        /**
+         * Credits charged per unit of usage matching the specified dimension_values
+         */
+        unit_amount: string;
+      }
     }
 
     /**
@@ -14894,7 +15652,7 @@ export namespace Price {
     }
   }
 
-  export interface PercentCompositePrice {
+  export interface MeteredAllowancePrice {
     id: string;
 
     billable_metric: Shared.BillableMetricTiny | null;
@@ -14905,7 +15663,7 @@ export namespace Price {
 
     cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
 
-    composite_price_filters: Array<PercentCompositePrice.CompositePriceFilter> | null;
+    composite_price_filters: Array<MeteredAllowancePrice.CompositePriceFilter> | null;
 
     conversion_rate: number | null;
 
@@ -14926,6 +15684,8 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**
@@ -14952,6 +15712,11 @@ export namespace Price {
      */
     metadata: { [key: string]: string };
 
+    /**
+     * Configuration for metered_allowance pricing
+     */
+    metered_allowance_config: MeteredAllowancePrice.MeteredAllowanceConfig;
+
     /**
      * @deprecated
      */
@@ -14965,15 +15730,10 @@ export namespace Price {
     /**
      * The pricing model type
      */
-    model_type: 'percent';
+    model_type: 'metered_allowance';
 
     name: string;
 
-    /**
-     * Configuration for percent pricing
-     */
-    percent_config: PercentCompositePrice.PercentConfig;
-
     plan_phase_order: number | null;
 
     price_type: 'usage_price' | 'fixed_price' | 'composite_price';
@@ -14991,10 +15751,10 @@ export namespace Price {
      * users. License types are used during billing by grouping metrics on the
      * configured grouping key.
      */
-    license_type?: PercentCompositePrice.LicenseType | null;
+    license_type?: MeteredAllowancePrice.LicenseType | null;
   }
 
-  export namespace PercentCompositePrice {
+  export namespace MeteredAllowancePrice {
     export interface CompositePriceFilter {
       /**
        * The property of the price to filter on.
@@ -15013,25 +15773,385 @@ export namespace Price {
     }
 
     /**
-     * Configuration for percent pricing
+     * Configuration for metered_allowance pricing
      */
-    export interface PercentConfig {
+    export interface MeteredAllowanceConfig {
       /**
-       * What percent of the component subtotals to charge
+       * The grouping_key value whose summed quantity represents the allowance for this
+       * period (e.g. 'storage_snapshot' emitting 3 × avg storage). Capped at consumption
+       * — credit can never exceed actual usage.
        */
-      percent: number;
-    }
+      allowance_grouping_value: string;
 
-    /**
-     * The LicenseType resource represents a type of license that can be assigned to
-     * users. License types are used during billing by grouping metrics on the
-     * configured grouping key.
-     */
-    export interface LicenseType {
       /**
-       * The Orb-assigned unique identifier for the license type.
+       * The grouping_key value whose summed quantity represents consumption (e.g.
+       * 'download'). Charged at unit_amount.
        */
-      id: string;
+      consumption_grouping_value: string;
+
+      /**
+       * Event property used to partition the metric into consumption and allowance
+       * quantities (e.g. 'event_name'). The metric is queried with this key and the two
+       * values below select which partition is which.
+       */
+      grouping_key: string;
+
+      /**
+       * Per-unit price applied to gross consumption and to the allowance credit.
+       */
+      unit_amount: string;
+
+      /**
+       * Sub-line label for the credit row (e.g. 'Up to 3x free egress').
+       */
+      allowance_display_name?: string;
+
+      /**
+       * Sub-line label for the gross consumption row (e.g. 'bytes gotten').
+       */
+      consumption_display_name?: string;
+    }
+
+    /**
+     * The LicenseType resource represents a type of license that can be assigned to
+     * users. License types are used during billing by grouping metrics on the
+     * configured grouping key.
+     */
+    export interface LicenseType {
+      /**
+       * The Orb-assigned unique identifier for the license type.
+       */
+      id: string;
+
+      /**
+       * The key used for grouping licenses of this type. This is typically a user
+       * identifier field.
+       */
+      grouping_key: string;
+
+      /**
+       * The name of the license type.
+       */
+      name: string;
+    }
+  }
+
+  export interface MinimumCompositePrice {
+    id: string;
+
+    billable_metric: Shared.BillableMetricTiny | null;
+
+    billing_cycle_configuration: Shared.BillingCycleConfiguration;
+
+    billing_mode: 'in_advance' | 'in_arrear';
+
+    cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
+
+    composite_price_filters: Array<MinimumCompositePrice.CompositePriceFilter> | null;
+
+    conversion_rate: number | null;
+
+    conversion_rate_config: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+
+    created_at: string;
+
+    credit_allocation: Shared.Allocation | null;
+
+    currency: string;
+
+    /**
+     * @deprecated
+     */
+    discount: Shared.Discount | null;
+
+    external_price_id: string | null;
+
+    fixed_price_quantity: number | null;
+
+    invoice_grouping_key: string | null;
+
+    invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
+    item: Shared.ItemSlim;
+
+    /**
+     * @deprecated
+     */
+    maximum: Shared.Maximum | null;
+
+    /**
+     * @deprecated
+     */
+    maximum_amount: string | null;
+
+    /**
+     * User specified key-value pairs for the resource. If not present, this defaults
+     * to an empty dictionary. 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: { [key: string]: string };
+
+    /**
+     * @deprecated
+     */
+    minimum: Shared.Minimum | null;
+
+    /**
+     * @deprecated
+     */
+    minimum_amount: string | null;
+
+    /**
+     * Configuration for minimum_composite pricing
+     */
+    minimum_composite_config: MinimumCompositePrice.MinimumCompositeConfig;
+
+    /**
+     * The pricing model type
+     */
+    model_type: 'minimum_composite';
+
+    name: string;
+
+    plan_phase_order: number | null;
+
+    price_type: 'usage_price' | 'fixed_price' | 'composite_price';
+
+    /**
+     * The price id this price replaces. This price will take the place of the replaced
+     * price in plan version migrations.
+     */
+    replaces_price_id: string | null;
+
+    dimensional_price_configuration?: Shared.DimensionalPriceConfiguration | null;
+
+    /**
+     * The LicenseType resource represents a type of license that can be assigned to
+     * users. License types are used during billing by grouping metrics on the
+     * configured grouping key.
+     */
+    license_type?: MinimumCompositePrice.LicenseType | null;
+  }
+
+  export namespace MinimumCompositePrice {
+    export interface CompositePriceFilter {
+      /**
+       * The property of the price to filter on.
+       */
+      field: 'price_id' | 'item_id' | 'price_type' | 'currency' | 'pricing_unit_id';
+
+      /**
+       * Should prices that match the filter be included or excluded.
+       */
+      operator: 'includes' | 'excludes';
+
+      /**
+       * The IDs or values that match this filter.
+       */
+      values: Array<string>;
+    }
+
+    /**
+     * Configuration for minimum_composite pricing
+     */
+    export interface MinimumCompositeConfig {
+      /**
+       * The minimum amount to apply
+       */
+      minimum_amount: string;
+
+      /**
+       * If true, subtotals from this price are prorated based on the service period
+       */
+      prorated?: boolean;
+    }
+
+    /**
+     * The LicenseType resource represents a type of license that can be assigned to
+     * users. License types are used during billing by grouping metrics on the
+     * configured grouping key.
+     */
+    export interface LicenseType {
+      /**
+       * The Orb-assigned unique identifier for the license type.
+       */
+      id: string;
+
+      /**
+       * The key used for grouping licenses of this type. This is typically a user
+       * identifier field.
+       */
+      grouping_key: string;
+
+      /**
+       * The name of the license type.
+       */
+      name: string;
+    }
+  }
+
+  export interface PercentCompositePrice {
+    id: string;
+
+    billable_metric: Shared.BillableMetricTiny | null;
+
+    billing_cycle_configuration: Shared.BillingCycleConfiguration;
+
+    billing_mode: 'in_advance' | 'in_arrear';
+
+    cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
+
+    composite_price_filters: Array<PercentCompositePrice.CompositePriceFilter> | null;
+
+    conversion_rate: number | null;
+
+    conversion_rate_config: Shared.UnitConversionRateConfig | Shared.TieredConversionRateConfig | null;
+
+    created_at: string;
+
+    credit_allocation: Shared.Allocation | null;
+
+    currency: string;
+
+    /**
+     * @deprecated
+     */
+    discount: Shared.Discount | null;
+
+    external_price_id: string | null;
+
+    fixed_price_quantity: number | null;
+
+    invoice_grouping_key: string | null;
+
+    invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
+
+    /**
+     * A minimal representation of an Item containing only the essential identifying
+     * information.
+     */
+    item: Shared.ItemSlim;
+
+    /**
+     * @deprecated
+     */
+    maximum: Shared.Maximum | null;
+
+    /**
+     * @deprecated
+     */
+    maximum_amount: string | null;
+
+    /**
+     * User specified key-value pairs for the resource. If not present, this defaults
+     * to an empty dictionary. 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: { [key: string]: string };
+
+    /**
+     * @deprecated
+     */
+    minimum: Shared.Minimum | null;
+
+    /**
+     * @deprecated
+     */
+    minimum_amount: string | null;
+
+    /**
+     * The pricing model type
+     */
+    model_type: 'percent';
+
+    name: string;
+
+    /**
+     * Configuration for percent pricing
+     */
+    percent_config: PercentCompositePrice.PercentConfig;
+
+    plan_phase_order: number | null;
+
+    price_type: 'usage_price' | 'fixed_price' | 'composite_price';
+
+    /**
+     * The price id this price replaces. This price will take the place of the replaced
+     * price in plan version migrations.
+     */
+    replaces_price_id: string | null;
+
+    dimensional_price_configuration?: Shared.DimensionalPriceConfiguration | null;
+
+    /**
+     * The LicenseType resource represents a type of license that can be assigned to
+     * users. License types are used during billing by grouping metrics on the
+     * configured grouping key.
+     */
+    license_type?: PercentCompositePrice.LicenseType | null;
+  }
+
+  export namespace PercentCompositePrice {
+    export interface CompositePriceFilter {
+      /**
+       * The property of the price to filter on.
+       */
+      field: 'price_id' | 'item_id' | 'price_type' | 'currency' | 'pricing_unit_id';
+
+      /**
+       * Should prices that match the filter be included or excluded.
+       */
+      operator: 'includes' | 'excludes';
+
+      /**
+       * The IDs or values that match this filter.
+       */
+      values: Array<string>;
+    }
+
+    /**
+     * Configuration for percent pricing
+     */
+    export interface PercentConfig {
+      /**
+       * Fraction of the component subtotals to charge (0 < percent <= 1).
+       */
+      percent: number;
+
+      /**
+       * Maximum amount to charge. If unset, the fee has no upper bound.
+       */
+      maximum_amount?: string | null;
+
+      /**
+       * Minimum amount to charge. If unset, the fee is bounded below by 0.
+       */
+      minimum_amount?: string | null;
+
+      /**
+       * If true, the minimum_amount is prorated based on the service period. The
+       * maximum_amount is an absolute cap (never prorated), and the percent applied to
+       * upstream subtotals is never prorated either.
+       */
+      prorated?: boolean;
+    }
+
+    /**
+     * The LicenseType resource represents a type of license that can be assigned to
+     * users. License types are used during billing by grouping metrics on the
+     * configured grouping key.
+     */
+    export interface LicenseType {
+      /**
+       * The Orb-assigned unique identifier for the license type.
+       */
+      id: string;
 
       /**
        * The key used for grouping licenses of this type. This is typically a user
@@ -15083,6 +16203,8 @@ export namespace Price {
 
     fixed_price_quantity: number | null;
 
+    invoice_grouping_key: string | null;
+
     invoicing_cycle_configuration: Shared.BillingCycleConfiguration | null;
 
     /**