orb-billing 4.10.0 → 4.12.0

package/src/resources/subscriptions.ts

@@ -1100,6 +1100,8 @@ export interface Subscription {
    */
   auto_collection: boolean | null;
 
+  billing_cycle_anchor_configuration: Subscription.BillingCycleAnchorConfiguration;
+
   /**
    * The day of the month on which the billing cycle is anchored. If the maximum
    * number of days in a month is greater than this value, the last day of the month
@@ -1356,6 +1358,29 @@ export namespace Subscription {
     }
   }
 
+  export interface BillingCycleAnchorConfiguration {
+    /**
+     * The day of the month on which the billing cycle is anchored. If the maximum
+     * number of days in a month is greater than this value, the last day of the month
+     * is the billing cycle day (e.g. billing_cycle_day=31 for April means the billing
+     * period begins on the 30th.
+     */
+    day: number;
+
+    /**
+     * The month on which the billing cycle is anchored (e.g. a quarterly price
+     * anchored in February would have cycles starting February, May, August, and
+     * November).
+     */
+    month?: number | null;
+
+    /**
+     * The year on which the billing cycle is anchored (e.g. a 2 year billing cycle
+     * anchored on 2021 would have cycles starting on 2021, 2023, 2025, etc.).
+     */
+    year?: number | null;
+  }
+
   export interface AmountDiscountInterval {
     /**
      * Only available if discount_type is `amount`.
@@ -2207,6 +2232,8 @@ export interface SubscriptionCreateParams {
 
   aws_region?: string | null;
 
+  billing_cycle_anchor_configuration?: SubscriptionCreateParams.BillingCycleAnchorConfiguration | null;
+
   coupon_redemption_code?: string | null;
 
   credits_overage_rate?: number | null;
@@ -2267,12 +2294,37 @@ export interface SubscriptionCreateParams {
     | SubscriptionCreateParams.OverrideTieredWithMinimumPrice
     | SubscriptionCreateParams.OverridePackageWithAllocationPrice
     | SubscriptionCreateParams.OverrideUnitWithPercentPrice
+    | SubscriptionCreateParams.OverrideGroupedAllocationPrice
+    | SubscriptionCreateParams.OverrideBulkWithProrationPrice
   > | null;
 
   start_date?: string | null;
 }
 
 export namespace SubscriptionCreateParams {
+  export interface BillingCycleAnchorConfiguration {
+    /**
+     * The day of the month on which the billing cycle is anchored. If the maximum
+     * number of days in a month is greater than this value, the last day of the month
+     * is the billing cycle day (e.g. billing_cycle_day=31 for April means the billing
+     * period begins on the 30th.
+     */
+    day: number;
+
+    /**
+     * The month on which the billing cycle is anchored (e.g. a quarterly price
+     * anchored in February would have cycles starting February, May, August, and
+     * November).
+     */
+    month?: number | null;
+
+    /**
+     * The year on which the billing cycle is anchored (e.g. a 2 year billing cycle
+     * anchored on 2021 would have cycles starting on 2021, 2023, 2025, etc.).
+     */
+    year?: number | null;
+  }
+
   export interface OverrideUnitPrice {
     id: string;
 
@@ -3431,6 +3483,158 @@ export namespace SubscriptionCreateParams {
       usage_discount?: number | null;
     }
   }
+
+  export interface OverrideGroupedAllocationPrice {
+    id: string;
+
+    grouped_allocation_config: Record<string, unknown>;
+
+    model_type: 'grouped_allocation';
+
+    /**
+     * The per unit conversion rate of the price currency to the invoicing currency.
+     */
+    conversion_rate?: number | null;
+
+    /**
+     * The currency of the price. If not provided, the currency of the plan will be
+     * used.
+     */
+    currency?: string | null;
+
+    /**
+     * The subscription's override discount for the plan.
+     */
+    discount?: OverrideGroupedAllocationPrice.Discount | null;
+
+    /**
+     * The starting quantity of the price, if the price is a fixed price.
+     */
+    fixed_price_quantity?: number | null;
+
+    /**
+     * The subscription's override maximum amount for the plan.
+     */
+    maximum_amount?: string | null;
+
+    /**
+     * The subscription's override minimum amount for the plan.
+     */
+    minimum_amount?: string | null;
+  }
+
+  export namespace OverrideGroupedAllocationPrice {
+    /**
+     * The subscription's override discount for the plan.
+     */
+    export interface Discount {
+      discount_type: 'percentage' | 'trial' | 'usage' | 'amount';
+
+      /**
+       * Only available if discount_type is `amount`.
+       */
+      amount_discount?: string | null;
+
+      /**
+       * 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;
+
+      /**
+       * Only available if discount_type is `percentage`. This is a number between 0
+       * and 1.
+       */
+      percentage_discount?: number | null;
+
+      /**
+       * Only available if discount_type is `trial`
+       */
+      trial_amount_discount?: string | null;
+
+      /**
+       * Only available if discount_type is `usage`. Number of usage units that this
+       * discount is for
+       */
+      usage_discount?: number | null;
+    }
+  }
+
+  export interface OverrideBulkWithProrationPrice {
+    id: string;
+
+    bulk_with_proration_config: Record<string, unknown>;
+
+    model_type: 'bulk_with_proration';
+
+    /**
+     * The per unit conversion rate of the price currency to the invoicing currency.
+     */
+    conversion_rate?: number | null;
+
+    /**
+     * The currency of the price. If not provided, the currency of the plan will be
+     * used.
+     */
+    currency?: string | null;
+
+    /**
+     * The subscription's override discount for the plan.
+     */
+    discount?: OverrideBulkWithProrationPrice.Discount | null;
+
+    /**
+     * The starting quantity of the price, if the price is a fixed price.
+     */
+    fixed_price_quantity?: number | null;
+
+    /**
+     * The subscription's override maximum amount for the plan.
+     */
+    maximum_amount?: string | null;
+
+    /**
+     * The subscription's override minimum amount for the plan.
+     */
+    minimum_amount?: string | null;
+  }
+
+  export namespace OverrideBulkWithProrationPrice {
+    /**
+     * The subscription's override discount for the plan.
+     */
+    export interface Discount {
+      discount_type: 'percentage' | 'trial' | 'usage' | 'amount';
+
+      /**
+       * Only available if discount_type is `amount`.
+       */
+      amount_discount?: string | null;
+
+      /**
+       * 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;
+
+      /**
+       * Only available if discount_type is `percentage`. This is a number between 0
+       * and 1.
+       */
+      percentage_discount?: number | null;
+
+      /**
+       * Only available if discount_type is `trial`
+       */
+      trial_amount_discount?: string | null;
+
+      /**
+       * Only available if discount_type is `usage`. Number of usage units that this
+       * discount is for
+       */
+      usage_discount?: number | null;
+    }
+  }
 }
 
 export interface SubscriptionUpdateParams {
@@ -3789,6 +3993,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       billed_in_advance?: boolean | null;
 
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      billing_cycle_configuration?: NewFloatingUnitPrice.BillingCycleConfiguration | null;
+
       /**
        * The per unit conversion rate of the price currency to the invoicing currency.
        */
@@ -3810,6 +4020,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       invoice_grouping_key?: string | null;
 
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      invoicing_cycle_configuration?: NewFloatingUnitPrice.InvoicingCycleConfiguration | 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
@@ -3825,6 +4041,38 @@ export namespace SubscriptionPriceIntervalsParams {
          */
         unit_amount: string;
       }
+
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      export interface BillingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      export interface InvoicingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
     }
 
     export interface NewFloatingPackagePrice {
@@ -3864,6 +4112,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       billed_in_advance?: boolean | null;
 
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      billing_cycle_configuration?: NewFloatingPackagePrice.BillingCycleConfiguration | null;
+
       /**
        * The per unit conversion rate of the price currency to the invoicing currency.
        */
@@ -3885,6 +4139,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       invoice_grouping_key?: string | null;
 
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      invoicing_cycle_configuration?: NewFloatingPackagePrice.InvoicingCycleConfiguration | 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
@@ -3906,6 +4166,38 @@ export namespace SubscriptionPriceIntervalsParams {
          */
         package_size: number;
       }
+
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      export interface BillingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      export interface InvoicingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
     }
 
     export interface NewFloatingMatrixPrice {
@@ -3945,6 +4237,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       billed_in_advance?: boolean | null;
 
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      billing_cycle_configuration?: NewFloatingMatrixPrice.BillingCycleConfiguration | null;
+
       /**
        * The per unit conversion rate of the price currency to the invoicing currency.
        */
@@ -3966,6 +4264,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       invoice_grouping_key?: string | null;
 
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      invoicing_cycle_configuration?: NewFloatingMatrixPrice.InvoicingCycleConfiguration | 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
@@ -4007,6 +4311,38 @@ export namespace SubscriptionPriceIntervalsParams {
           unit_amount: string;
         }
       }
+
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      export interface BillingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      export interface InvoicingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
     }
 
     export interface NewFloatingMatrixWithAllocationPrice {
@@ -4046,6 +4382,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       billed_in_advance?: boolean | null;
 
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      billing_cycle_configuration?: NewFloatingMatrixWithAllocationPrice.BillingCycleConfiguration | null;
+
       /**
        * The per unit conversion rate of the price currency to the invoicing currency.
        */
@@ -4067,6 +4409,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       invoice_grouping_key?: string | null;
 
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      invoicing_cycle_configuration?: NewFloatingMatrixWithAllocationPrice.InvoicingCycleConfiguration | 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
@@ -4113,21 +4461,53 @@ export namespace SubscriptionPriceIntervalsParams {
           unit_amount: string;
         }
       }
-    }
 
-    export interface NewFloatingTieredPrice {
       /**
-       * The cadence to bill for this price on.
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
        */
-      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+      export interface BillingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
 
-      /**
-       * An ISO 4217 currency string for which this price is billed in.
-       */
-      currency: string;
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
 
       /**
-       * The id of the item the plan will be associated with.
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      export interface InvoicingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+    }
+
+    export interface NewFloatingTieredPrice {
+      /**
+       * The cadence to bill for this price on.
+       */
+      cadence: 'annual' | 'semi_annual' | 'monthly' | 'quarterly' | 'one_time' | 'custom';
+
+      /**
+       * An ISO 4217 currency string for which this price is billed in.
+       */
+      currency: string;
+
+      /**
+       * The id of the item the plan will be associated with.
        */
       item_id: string;
 
@@ -4152,6 +4532,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       billed_in_advance?: boolean | null;
 
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      billing_cycle_configuration?: NewFloatingTieredPrice.BillingCycleConfiguration | null;
+
       /**
        * The per unit conversion rate of the price currency to the invoicing currency.
        */
@@ -4173,6 +4559,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       invoice_grouping_key?: string | null;
 
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      invoicing_cycle_configuration?: NewFloatingTieredPrice.InvoicingCycleConfiguration | 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
@@ -4207,6 +4599,38 @@ export namespace SubscriptionPriceIntervalsParams {
           last_unit?: number | null;
         }
       }
+
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      export interface BillingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      export interface InvoicingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
     }
 
     export interface NewFloatingTieredBpsPrice {
@@ -4246,6 +4670,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       billed_in_advance?: boolean | null;
 
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      billing_cycle_configuration?: NewFloatingTieredBpsPrice.BillingCycleConfiguration | null;
+
       /**
        * The per unit conversion rate of the price currency to the invoicing currency.
        */
@@ -4267,6 +4697,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       invoice_grouping_key?: string | null;
 
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      invoicing_cycle_configuration?: NewFloatingTieredBpsPrice.InvoicingCycleConfiguration | 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
@@ -4307,6 +4743,38 @@ export namespace SubscriptionPriceIntervalsParams {
           per_unit_maximum?: string | null;
         }
       }
+
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      export interface BillingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      export interface InvoicingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
     }
 
     export interface NewFloatingBpsPrice {
@@ -4346,6 +4814,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       billed_in_advance?: boolean | null;
 
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      billing_cycle_configuration?: NewFloatingBpsPrice.BillingCycleConfiguration | null;
+
       /**
        * The per unit conversion rate of the price currency to the invoicing currency.
        */
@@ -4367,6 +4841,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       invoice_grouping_key?: string | null;
 
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      invoicing_cycle_configuration?: NewFloatingBpsPrice.InvoicingCycleConfiguration | 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
@@ -4387,6 +4867,38 @@ export namespace SubscriptionPriceIntervalsParams {
          */
         per_unit_maximum?: string | null;
       }
+
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      export interface BillingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      export interface InvoicingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
     }
 
     export interface NewFloatingBulkBpsPrice {
@@ -4426,6 +4938,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       billed_in_advance?: boolean | null;
 
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      billing_cycle_configuration?: NewFloatingBulkBpsPrice.BillingCycleConfiguration | null;
+
       /**
        * The per unit conversion rate of the price currency to the invoicing currency.
        */
@@ -4447,6 +4965,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       invoice_grouping_key?: string | null;
 
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      invoicing_cycle_configuration?: NewFloatingBulkBpsPrice.InvoicingCycleConfiguration | 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
@@ -4482,6 +5006,38 @@ export namespace SubscriptionPriceIntervalsParams {
           per_unit_maximum?: string | null;
         }
       }
+
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      export interface BillingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      export interface InvoicingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
     }
 
     export interface NewFloatingBulkPrice {
@@ -4521,6 +5077,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       billed_in_advance?: boolean | null;
 
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      billing_cycle_configuration?: NewFloatingBulkPrice.BillingCycleConfiguration | null;
+
       /**
        * The per unit conversion rate of the price currency to the invoicing currency.
        */
@@ -4542,6 +5104,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       invoice_grouping_key?: string | null;
 
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      invoicing_cycle_configuration?: NewFloatingBulkPrice.InvoicingCycleConfiguration | 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
@@ -4571,6 +5139,38 @@ export namespace SubscriptionPriceIntervalsParams {
           maximum_units?: number | null;
         }
       }
+
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      export interface BillingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      export interface InvoicingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
     }
 
     export interface NewFloatingThresholdTotalAmountPrice {
@@ -4610,6 +5210,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       billed_in_advance?: boolean | null;
 
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      billing_cycle_configuration?: NewFloatingThresholdTotalAmountPrice.BillingCycleConfiguration | null;
+
       /**
        * The per unit conversion rate of the price currency to the invoicing currency.
        */
@@ -4631,6 +5237,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       invoice_grouping_key?: string | null;
 
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      invoicing_cycle_configuration?: NewFloatingThresholdTotalAmountPrice.InvoicingCycleConfiguration | 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
@@ -4639,6 +5251,40 @@ export namespace SubscriptionPriceIntervalsParams {
       metadata?: Record<string, string | null> | null;
     }
 
+    export namespace NewFloatingThresholdTotalAmountPrice {
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      export interface BillingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      export interface InvoicingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+    }
+
     export interface NewFloatingTieredPackagePrice {
       /**
        * The cadence to bill for this price on.
@@ -4676,6 +5322,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       billed_in_advance?: boolean | null;
 
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      billing_cycle_configuration?: NewFloatingTieredPackagePrice.BillingCycleConfiguration | null;
+
       /**
        * The per unit conversion rate of the price currency to the invoicing currency.
        */
@@ -4697,6 +5349,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       invoice_grouping_key?: string | null;
 
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      invoicing_cycle_configuration?: NewFloatingTieredPackagePrice.InvoicingCycleConfiguration | 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
@@ -4705,6 +5363,40 @@ export namespace SubscriptionPriceIntervalsParams {
       metadata?: Record<string, string | null> | null;
     }
 
+    export namespace NewFloatingTieredPackagePrice {
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      export interface BillingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      export interface InvoicingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+    }
+
     export interface NewFloatingGroupedTieredPrice {
       /**
        * The cadence to bill for this price on.
@@ -4742,6 +5434,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       billed_in_advance?: boolean | null;
 
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      billing_cycle_configuration?: NewFloatingGroupedTieredPrice.BillingCycleConfiguration | null;
+
       /**
        * The per unit conversion rate of the price currency to the invoicing currency.
        */
@@ -4763,6 +5461,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       invoice_grouping_key?: string | null;
 
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      invoicing_cycle_configuration?: NewFloatingGroupedTieredPrice.InvoicingCycleConfiguration | 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
@@ -4771,6 +5475,40 @@ export namespace SubscriptionPriceIntervalsParams {
       metadata?: Record<string, string | null> | null;
     }
 
+    export namespace NewFloatingGroupedTieredPrice {
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      export interface BillingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      export interface InvoicingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+    }
+
     export interface NewFloatingTieredWithMinimumPrice {
       /**
        * The cadence to bill for this price on.
@@ -4808,6 +5546,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       billed_in_advance?: boolean | null;
 
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      billing_cycle_configuration?: NewFloatingTieredWithMinimumPrice.BillingCycleConfiguration | null;
+
       /**
        * The per unit conversion rate of the price currency to the invoicing currency.
        */
@@ -4829,6 +5573,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       invoice_grouping_key?: string | null;
 
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      invoicing_cycle_configuration?: NewFloatingTieredWithMinimumPrice.InvoicingCycleConfiguration | 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
@@ -4837,6 +5587,40 @@ export namespace SubscriptionPriceIntervalsParams {
       metadata?: Record<string, string | null> | null;
     }
 
+    export namespace NewFloatingTieredWithMinimumPrice {
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      export interface BillingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      export interface InvoicingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+    }
+
     export interface NewFloatingPackageWithAllocationPrice {
       /**
        * The cadence to bill for this price on.
@@ -4874,6 +5658,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       billed_in_advance?: boolean | null;
 
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      billing_cycle_configuration?: NewFloatingPackageWithAllocationPrice.BillingCycleConfiguration | null;
+
       /**
        * The per unit conversion rate of the price currency to the invoicing currency.
        */
@@ -4895,6 +5685,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       invoice_grouping_key?: string | null;
 
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      invoicing_cycle_configuration?: NewFloatingPackageWithAllocationPrice.InvoicingCycleConfiguration | 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
@@ -4903,6 +5699,40 @@ export namespace SubscriptionPriceIntervalsParams {
       metadata?: Record<string, string | null> | null;
     }
 
+    export namespace NewFloatingPackageWithAllocationPrice {
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      export interface BillingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      export interface InvoicingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+    }
+
     export interface NewFloatingTieredPackageWithMinimumPrice {
       /**
        * The cadence to bill for this price on.
@@ -4940,6 +5770,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       billed_in_advance?: boolean | null;
 
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      billing_cycle_configuration?: NewFloatingTieredPackageWithMinimumPrice.BillingCycleConfiguration | null;
+
       /**
        * The per unit conversion rate of the price currency to the invoicing currency.
        */
@@ -4961,6 +5797,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       invoice_grouping_key?: string | null;
 
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      invoicing_cycle_configuration?: NewFloatingTieredPackageWithMinimumPrice.InvoicingCycleConfiguration | 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
@@ -4969,6 +5811,40 @@ export namespace SubscriptionPriceIntervalsParams {
       metadata?: Record<string, string | null> | null;
     }
 
+    export namespace NewFloatingTieredPackageWithMinimumPrice {
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      export interface BillingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      export interface InvoicingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+    }
+
     export interface NewFloatingUnitWithPercentPrice {
       /**
        * The cadence to bill for this price on.
@@ -5006,6 +5882,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       billed_in_advance?: boolean | null;
 
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      billing_cycle_configuration?: NewFloatingUnitWithPercentPrice.BillingCycleConfiguration | null;
+
       /**
        * The per unit conversion rate of the price currency to the invoicing currency.
        */
@@ -5023,16 +5905,56 @@ export namespace SubscriptionPriceIntervalsParams {
       fixed_price_quantity?: number | null;
 
       /**
-       * The property used to group this price on an invoice
+       * The property used to group this price on an invoice
+       */
+      invoice_grouping_key?: string | null;
+
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      invoicing_cycle_configuration?: NewFloatingUnitWithPercentPrice.InvoicingCycleConfiguration | 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?: Record<string, string | null> | null;
+    }
+
+    export namespace NewFloatingUnitWithPercentPrice {
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      export interface BillingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
        */
-      invoice_grouping_key?: string | null;
+      export interface InvoicingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
 
-      /**
-       * 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?: Record<string, string | null> | null;
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
     }
 
     export interface NewFloatingTieredWithProrationPrice {
@@ -5072,6 +5994,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       billed_in_advance?: boolean | null;
 
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      billing_cycle_configuration?: NewFloatingTieredWithProrationPrice.BillingCycleConfiguration | null;
+
       /**
        * The per unit conversion rate of the price currency to the invoicing currency.
        */
@@ -5093,6 +6021,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       invoice_grouping_key?: string | null;
 
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      invoicing_cycle_configuration?: NewFloatingTieredWithProrationPrice.InvoicingCycleConfiguration | 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
@@ -5101,6 +6035,40 @@ export namespace SubscriptionPriceIntervalsParams {
       metadata?: Record<string, string | null> | null;
     }
 
+    export namespace NewFloatingTieredWithProrationPrice {
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      export interface BillingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      export interface InvoicingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+    }
+
     export interface NewFloatingUnitWithProrationPrice {
       /**
        * The cadence to bill for this price on.
@@ -5138,6 +6106,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       billed_in_advance?: boolean | null;
 
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      billing_cycle_configuration?: NewFloatingUnitWithProrationPrice.BillingCycleConfiguration | null;
+
       /**
        * The per unit conversion rate of the price currency to the invoicing currency.
        */
@@ -5159,6 +6133,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       invoice_grouping_key?: string | null;
 
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      invoicing_cycle_configuration?: NewFloatingUnitWithProrationPrice.InvoicingCycleConfiguration | 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
@@ -5167,6 +6147,40 @@ export namespace SubscriptionPriceIntervalsParams {
       metadata?: Record<string, string | null> | null;
     }
 
+    export namespace NewFloatingUnitWithProrationPrice {
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      export interface BillingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      export interface InvoicingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+    }
+
     export interface NewFloatingGroupedAllocationPrice {
       /**
        * The cadence to bill for this price on.
@@ -5204,6 +6218,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       billed_in_advance?: boolean | null;
 
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      billing_cycle_configuration?: NewFloatingGroupedAllocationPrice.BillingCycleConfiguration | null;
+
       /**
        * The per unit conversion rate of the price currency to the invoicing currency.
        */
@@ -5225,6 +6245,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       invoice_grouping_key?: string | null;
 
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      invoicing_cycle_configuration?: NewFloatingGroupedAllocationPrice.InvoicingCycleConfiguration | 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
@@ -5233,6 +6259,40 @@ export namespace SubscriptionPriceIntervalsParams {
       metadata?: Record<string, string | null> | null;
     }
 
+    export namespace NewFloatingGroupedAllocationPrice {
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      export interface BillingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      export interface InvoicingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+    }
+
     export interface NewFloatingBulkWithProrationPrice {
       bulk_with_proration_config: Record<string, unknown>;
 
@@ -5270,6 +6330,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       billed_in_advance?: boolean | null;
 
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      billing_cycle_configuration?: NewFloatingBulkWithProrationPrice.BillingCycleConfiguration | null;
+
       /**
        * The per unit conversion rate of the price currency to the invoicing currency.
        */
@@ -5291,6 +6357,12 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       invoice_grouping_key?: string | null;
 
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      invoicing_cycle_configuration?: NewFloatingBulkWithProrationPrice.InvoicingCycleConfiguration | 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
@@ -5298,6 +6370,40 @@ export namespace SubscriptionPriceIntervalsParams {
        */
       metadata?: Record<string, string | null> | null;
     }
+
+    export namespace NewFloatingBulkWithProrationPrice {
+      /**
+       * For custom cadence: specifies the duration of the billing period in days or
+       * months.
+       */
+      export interface BillingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+
+      /**
+       * Within each billing cycle, specifies the cadence at which invoices are produced.
+       * If unspecified, a single invoice is produced per billing cycle.
+       */
+      export interface InvoicingCycleConfiguration {
+        /**
+         * The duration of the billing period.
+         */
+        duration: number;
+
+        /**
+         * The unit of billing period duration.
+         */
+        duration_unit: 'day' | 'month';
+      }
+    }
   }
 
   export interface AddAdjustment {
@@ -5515,6 +6621,8 @@ export interface SubscriptionSchedulePlanChangeParams {
     | SubscriptionSchedulePlanChangeParams.OverrideTieredWithMinimumPrice
     | SubscriptionSchedulePlanChangeParams.OverridePackageWithAllocationPrice
     | SubscriptionSchedulePlanChangeParams.OverrideUnitWithPercentPrice
+    | SubscriptionSchedulePlanChangeParams.OverrideGroupedAllocationPrice
+    | SubscriptionSchedulePlanChangeParams.OverrideBulkWithProrationPrice
   > | null;
 }
 
@@ -6677,6 +7785,158 @@ export namespace SubscriptionSchedulePlanChangeParams {
       usage_discount?: number | null;
     }
   }
+
+  export interface OverrideGroupedAllocationPrice {
+    id: string;
+
+    grouped_allocation_config: Record<string, unknown>;
+
+    model_type: 'grouped_allocation';
+
+    /**
+     * The per unit conversion rate of the price currency to the invoicing currency.
+     */
+    conversion_rate?: number | null;
+
+    /**
+     * The currency of the price. If not provided, the currency of the plan will be
+     * used.
+     */
+    currency?: string | null;
+
+    /**
+     * The subscription's override discount for the plan.
+     */
+    discount?: OverrideGroupedAllocationPrice.Discount | null;
+
+    /**
+     * The starting quantity of the price, if the price is a fixed price.
+     */
+    fixed_price_quantity?: number | null;
+
+    /**
+     * The subscription's override maximum amount for the plan.
+     */
+    maximum_amount?: string | null;
+
+    /**
+     * The subscription's override minimum amount for the plan.
+     */
+    minimum_amount?: string | null;
+  }
+
+  export namespace OverrideGroupedAllocationPrice {
+    /**
+     * The subscription's override discount for the plan.
+     */
+    export interface Discount {
+      discount_type: 'percentage' | 'trial' | 'usage' | 'amount';
+
+      /**
+       * Only available if discount_type is `amount`.
+       */
+      amount_discount?: string | null;
+
+      /**
+       * 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;
+
+      /**
+       * Only available if discount_type is `percentage`. This is a number between 0
+       * and 1.
+       */
+      percentage_discount?: number | null;
+
+      /**
+       * Only available if discount_type is `trial`
+       */
+      trial_amount_discount?: string | null;
+
+      /**
+       * Only available if discount_type is `usage`. Number of usage units that this
+       * discount is for
+       */
+      usage_discount?: number | null;
+    }
+  }
+
+  export interface OverrideBulkWithProrationPrice {
+    id: string;
+
+    bulk_with_proration_config: Record<string, unknown>;
+
+    model_type: 'bulk_with_proration';
+
+    /**
+     * The per unit conversion rate of the price currency to the invoicing currency.
+     */
+    conversion_rate?: number | null;
+
+    /**
+     * The currency of the price. If not provided, the currency of the plan will be
+     * used.
+     */
+    currency?: string | null;
+
+    /**
+     * The subscription's override discount for the plan.
+     */
+    discount?: OverrideBulkWithProrationPrice.Discount | null;
+
+    /**
+     * The starting quantity of the price, if the price is a fixed price.
+     */
+    fixed_price_quantity?: number | null;
+
+    /**
+     * The subscription's override maximum amount for the plan.
+     */
+    maximum_amount?: string | null;
+
+    /**
+     * The subscription's override minimum amount for the plan.
+     */
+    minimum_amount?: string | null;
+  }
+
+  export namespace OverrideBulkWithProrationPrice {
+    /**
+     * The subscription's override discount for the plan.
+     */
+    export interface Discount {
+      discount_type: 'percentage' | 'trial' | 'usage' | 'amount';
+
+      /**
+       * Only available if discount_type is `amount`.
+       */
+      amount_discount?: string | null;
+
+      /**
+       * 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;
+
+      /**
+       * Only available if discount_type is `percentage`. This is a number between 0
+       * and 1.
+       */
+      percentage_discount?: number | null;
+
+      /**
+       * Only available if discount_type is `trial`
+       */
+      trial_amount_discount?: string | null;
+
+      /**
+       * Only available if discount_type is `usage`. Number of usage units that this
+       * discount is for
+       */
+      usage_discount?: number | null;
+    }
+  }
 }
 
 export interface SubscriptionTriggerPhaseParams {