orb-billing 4.10.0 → 4.12.0

package/resources/subscriptions.d.ts

@@ -920,6 +920,7 @@ export interface Subscription {
      * the plan's behavior. If null, defaults to the customer's setting.
      */
     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
@@ -1121,6 +1122,26 @@ export declare namespace Subscription {
             reason: string | null;
         }
     }
+    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;
+    }
     interface AmountDiscountInterval {
         /**
          * Only available if discount_type is `amount`.
@@ -1878,6 +1899,7 @@ export interface SubscriptionCreateParams {
     align_billing_with_subscription_start_date?: boolean;
     auto_collection?: boolean | null;
     aws_region?: string | null;
+    billing_cycle_anchor_configuration?: SubscriptionCreateParams.BillingCycleAnchorConfiguration | null;
     coupon_redemption_code?: string | null;
     credits_overage_rate?: number | null;
     customer_id?: string | null;
@@ -1909,10 +1931,30 @@ export interface SubscriptionCreateParams {
     /**
      * Optionally provide a list of overrides for prices on the plan
      */
-    price_overrides?: Array<SubscriptionCreateParams.OverrideUnitPrice | SubscriptionCreateParams.OverridePackagePrice | SubscriptionCreateParams.OverrideMatrixPrice | SubscriptionCreateParams.OverrideTieredPrice | SubscriptionCreateParams.OverrideTieredBpsPrice | SubscriptionCreateParams.OverrideBpsPrice | SubscriptionCreateParams.OverrideBulkBpsPrice | SubscriptionCreateParams.OverrideBulkPrice | SubscriptionCreateParams.OverrideThresholdTotalAmountPrice | SubscriptionCreateParams.OverrideTieredPackagePrice | SubscriptionCreateParams.OverrideTieredWithMinimumPrice | SubscriptionCreateParams.OverridePackageWithAllocationPrice | SubscriptionCreateParams.OverrideUnitWithPercentPrice> | null;
+    price_overrides?: Array<SubscriptionCreateParams.OverrideUnitPrice | SubscriptionCreateParams.OverridePackagePrice | SubscriptionCreateParams.OverrideMatrixPrice | SubscriptionCreateParams.OverrideTieredPrice | SubscriptionCreateParams.OverrideTieredBpsPrice | SubscriptionCreateParams.OverrideBpsPrice | SubscriptionCreateParams.OverrideBulkBpsPrice | SubscriptionCreateParams.OverrideBulkPrice | SubscriptionCreateParams.OverrideThresholdTotalAmountPrice | SubscriptionCreateParams.OverrideTieredPackagePrice | SubscriptionCreateParams.OverrideTieredWithMinimumPrice | SubscriptionCreateParams.OverridePackageWithAllocationPrice | SubscriptionCreateParams.OverrideUnitWithPercentPrice | SubscriptionCreateParams.OverrideGroupedAllocationPrice | SubscriptionCreateParams.OverrideBulkWithProrationPrice> | null;
     start_date?: string | null;
 }
 export declare namespace SubscriptionCreateParams {
+    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;
+    }
     interface OverrideUnitPrice {
         id: string;
         model_type: 'unit';
@@ -2851,6 +2893,128 @@ export declare namespace SubscriptionCreateParams {
             usage_discount?: number | null;
         }
     }
+    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;
+    }
+    namespace OverrideGroupedAllocationPrice {
+        /**
+         * The subscription's override discount for the plan.
+         */
+        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;
+        }
+    }
+    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;
+    }
+    namespace OverrideBulkWithProrationPrice {
+        /**
+         * The subscription's override discount for the plan.
+         */
+        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 {
     /**
@@ -3117,6 +3281,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * this is true, and in-arrears if this is false.
              */
             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.
              */
@@ -3134,6 +3303,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * 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?: 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
@@ -3148,6 +3322,34 @@ export declare namespace SubscriptionPriceIntervalsParams {
                  */
                 unit_amount: string;
             }
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            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.
+             */
+            interface InvoicingCycleConfiguration {
+                /**
+                 * The duration of the billing period.
+                 */
+                duration: number;
+                /**
+                 * The unit of billing period duration.
+                 */
+                duration_unit: 'day' | 'month';
+            }
         }
         interface NewFloatingPackagePrice {
             /**
@@ -3178,6 +3380,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * this is true, and in-arrears if this is false.
              */
             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.
              */
@@ -3195,6 +3402,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * 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?: 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
@@ -3214,6 +3426,34 @@ export declare namespace SubscriptionPriceIntervalsParams {
                  */
                 package_size: number;
             }
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            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.
+             */
+            interface InvoicingCycleConfiguration {
+                /**
+                 * The duration of the billing period.
+                 */
+                duration: number;
+                /**
+                 * The unit of billing period duration.
+                 */
+                duration_unit: 'day' | 'month';
+            }
         }
         interface NewFloatingMatrixPrice {
             /**
@@ -3244,6 +3484,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * this is true, and in-arrears if this is false.
              */
             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.
              */
@@ -3261,6 +3506,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * 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?: 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
@@ -3297,6 +3547,34 @@ export declare namespace SubscriptionPriceIntervalsParams {
                     unit_amount: string;
                 }
             }
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            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.
+             */
+            interface InvoicingCycleConfiguration {
+                /**
+                 * The duration of the billing period.
+                 */
+                duration: number;
+                /**
+                 * The unit of billing period duration.
+                 */
+                duration_unit: 'day' | 'month';
+            }
         }
         interface NewFloatingMatrixWithAllocationPrice {
             /**
@@ -3327,6 +3605,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * this is true, and in-arrears if this is false.
              */
             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.
              */
@@ -3344,6 +3627,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * 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?: 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
@@ -3384,6 +3672,34 @@ export declare namespace SubscriptionPriceIntervalsParams {
                     unit_amount: string;
                 }
             }
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            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.
+             */
+            interface InvoicingCycleConfiguration {
+                /**
+                 * The duration of the billing period.
+                 */
+                duration: number;
+                /**
+                 * The unit of billing period duration.
+                 */
+                duration_unit: 'day' | 'month';
+            }
         }
         interface NewFloatingTieredPrice {
             /**
@@ -3414,6 +3730,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * this is true, and in-arrears if this is false.
              */
             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.
              */
@@ -3431,6 +3752,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * 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?: 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
@@ -3461,6 +3787,34 @@ export declare namespace SubscriptionPriceIntervalsParams {
                     last_unit?: number | null;
                 }
             }
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            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.
+             */
+            interface InvoicingCycleConfiguration {
+                /**
+                 * The duration of the billing period.
+                 */
+                duration: number;
+                /**
+                 * The unit of billing period duration.
+                 */
+                duration_unit: 'day' | 'month';
+            }
         }
         interface NewFloatingTieredBpsPrice {
             /**
@@ -3491,6 +3845,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * this is true, and in-arrears if this is false.
              */
             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.
              */
@@ -3508,6 +3867,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * 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?: 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
@@ -3543,6 +3907,34 @@ export declare namespace SubscriptionPriceIntervalsParams {
                     per_unit_maximum?: string | null;
                 }
             }
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            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.
+             */
+            interface InvoicingCycleConfiguration {
+                /**
+                 * The duration of the billing period.
+                 */
+                duration: number;
+                /**
+                 * The unit of billing period duration.
+                 */
+                duration_unit: 'day' | 'month';
+            }
         }
         interface NewFloatingBpsPrice {
             bps_config: NewFloatingBpsPrice.BpsConfig;
@@ -3573,6 +3965,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * this is true, and in-arrears if this is false.
              */
             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.
              */
@@ -3590,6 +3987,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * 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?: 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
@@ -3608,6 +4010,34 @@ export declare namespace SubscriptionPriceIntervalsParams {
                  */
                 per_unit_maximum?: string | null;
             }
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            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.
+             */
+            interface InvoicingCycleConfiguration {
+                /**
+                 * The duration of the billing period.
+                 */
+                duration: number;
+                /**
+                 * The unit of billing period duration.
+                 */
+                duration_unit: 'day' | 'month';
+            }
         }
         interface NewFloatingBulkBpsPrice {
             bulk_bps_config: NewFloatingBulkBpsPrice.BulkBpsConfig;
@@ -3638,6 +4068,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * this is true, and in-arrears if this is false.
              */
             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.
              */
@@ -3655,6 +4090,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * 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?: 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
@@ -3686,6 +4126,34 @@ export declare namespace SubscriptionPriceIntervalsParams {
                     per_unit_maximum?: string | null;
                 }
             }
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            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.
+             */
+            interface InvoicingCycleConfiguration {
+                /**
+                 * The duration of the billing period.
+                 */
+                duration: number;
+                /**
+                 * The unit of billing period duration.
+                 */
+                duration_unit: 'day' | 'month';
+            }
         }
         interface NewFloatingBulkPrice {
             bulk_config: NewFloatingBulkPrice.BulkConfig;
@@ -3716,6 +4184,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * this is true, and in-arrears if this is false.
              */
             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.
              */
@@ -3733,6 +4206,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * 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?: 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
@@ -3759,6 +4237,34 @@ export declare namespace SubscriptionPriceIntervalsParams {
                     maximum_units?: number | null;
                 }
             }
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            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.
+             */
+            interface InvoicingCycleConfiguration {
+                /**
+                 * The duration of the billing period.
+                 */
+                duration: number;
+                /**
+                 * The unit of billing period duration.
+                 */
+                duration_unit: 'day' | 'month';
+            }
         }
         interface NewFloatingThresholdTotalAmountPrice {
             /**
@@ -3789,6 +4295,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * this is true, and in-arrears if this is false.
              */
             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.
              */
@@ -3806,6 +4317,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * 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?: 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
@@ -3813,6 +4329,36 @@ export declare namespace SubscriptionPriceIntervalsParams {
              */
             metadata?: Record<string, string | null> | null;
         }
+        namespace NewFloatingThresholdTotalAmountPrice {
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            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.
+             */
+            interface InvoicingCycleConfiguration {
+                /**
+                 * The duration of the billing period.
+                 */
+                duration: number;
+                /**
+                 * The unit of billing period duration.
+                 */
+                duration_unit: 'day' | 'month';
+            }
+        }
         interface NewFloatingTieredPackagePrice {
             /**
              * The cadence to bill for this price on.
@@ -3842,6 +4388,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * this is true, and in-arrears if this is false.
              */
             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.
              */
@@ -3859,6 +4410,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * 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?: 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
@@ -3866,6 +4422,36 @@ export declare namespace SubscriptionPriceIntervalsParams {
              */
             metadata?: Record<string, string | null> | null;
         }
+        namespace NewFloatingTieredPackagePrice {
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            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.
+             */
+            interface InvoicingCycleConfiguration {
+                /**
+                 * The duration of the billing period.
+                 */
+                duration: number;
+                /**
+                 * The unit of billing period duration.
+                 */
+                duration_unit: 'day' | 'month';
+            }
+        }
         interface NewFloatingGroupedTieredPrice {
             /**
              * The cadence to bill for this price on.
@@ -3895,6 +4481,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * this is true, and in-arrears if this is false.
              */
             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.
              */
@@ -3912,6 +4503,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * 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?: 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
@@ -3919,6 +4515,36 @@ export declare namespace SubscriptionPriceIntervalsParams {
              */
             metadata?: Record<string, string | null> | null;
         }
+        namespace NewFloatingGroupedTieredPrice {
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            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.
+             */
+            interface InvoicingCycleConfiguration {
+                /**
+                 * The duration of the billing period.
+                 */
+                duration: number;
+                /**
+                 * The unit of billing period duration.
+                 */
+                duration_unit: 'day' | 'month';
+            }
+        }
         interface NewFloatingTieredWithMinimumPrice {
             /**
              * The cadence to bill for this price on.
@@ -3948,6 +4574,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * this is true, and in-arrears if this is false.
              */
             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.
              */
@@ -3965,6 +4596,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * 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?: 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
@@ -3972,6 +4608,36 @@ export declare namespace SubscriptionPriceIntervalsParams {
              */
             metadata?: Record<string, string | null> | null;
         }
+        namespace NewFloatingTieredWithMinimumPrice {
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            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.
+             */
+            interface InvoicingCycleConfiguration {
+                /**
+                 * The duration of the billing period.
+                 */
+                duration: number;
+                /**
+                 * The unit of billing period duration.
+                 */
+                duration_unit: 'day' | 'month';
+            }
+        }
         interface NewFloatingPackageWithAllocationPrice {
             /**
              * The cadence to bill for this price on.
@@ -4001,6 +4667,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * this is true, and in-arrears if this is false.
              */
             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.
              */
@@ -4018,6 +4689,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * 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?: 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
@@ -4025,6 +4701,36 @@ export declare namespace SubscriptionPriceIntervalsParams {
              */
             metadata?: Record<string, string | null> | null;
         }
+        namespace NewFloatingPackageWithAllocationPrice {
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            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.
+             */
+            interface InvoicingCycleConfiguration {
+                /**
+                 * The duration of the billing period.
+                 */
+                duration: number;
+                /**
+                 * The unit of billing period duration.
+                 */
+                duration_unit: 'day' | 'month';
+            }
+        }
         interface NewFloatingTieredPackageWithMinimumPrice {
             /**
              * The cadence to bill for this price on.
@@ -4054,6 +4760,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * this is true, and in-arrears if this is false.
              */
             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.
              */
@@ -4071,6 +4782,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * 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?: 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
@@ -4078,6 +4794,36 @@ export declare namespace SubscriptionPriceIntervalsParams {
              */
             metadata?: Record<string, string | null> | null;
         }
+        namespace NewFloatingTieredPackageWithMinimumPrice {
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            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.
+             */
+            interface InvoicingCycleConfiguration {
+                /**
+                 * The duration of the billing period.
+                 */
+                duration: number;
+                /**
+                 * The unit of billing period duration.
+                 */
+                duration_unit: 'day' | 'month';
+            }
+        }
         interface NewFloatingUnitWithPercentPrice {
             /**
              * The cadence to bill for this price on.
@@ -4107,6 +4853,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * this is true, and in-arrears if this is false.
              */
             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.
              */
@@ -4124,6 +4875,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * 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
@@ -4131,6 +4887,36 @@ export declare namespace SubscriptionPriceIntervalsParams {
              */
             metadata?: Record<string, string | null> | null;
         }
+        namespace NewFloatingUnitWithPercentPrice {
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            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.
+             */
+            interface InvoicingCycleConfiguration {
+                /**
+                 * The duration of the billing period.
+                 */
+                duration: number;
+                /**
+                 * The unit of billing period duration.
+                 */
+                duration_unit: 'day' | 'month';
+            }
+        }
         interface NewFloatingTieredWithProrationPrice {
             /**
              * The cadence to bill for this price on.
@@ -4160,6 +4946,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * this is true, and in-arrears if this is false.
              */
             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.
              */
@@ -4177,6 +4968,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * 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?: 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
@@ -4184,6 +4980,36 @@ export declare namespace SubscriptionPriceIntervalsParams {
              */
             metadata?: Record<string, string | null> | null;
         }
+        namespace NewFloatingTieredWithProrationPrice {
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            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.
+             */
+            interface InvoicingCycleConfiguration {
+                /**
+                 * The duration of the billing period.
+                 */
+                duration: number;
+                /**
+                 * The unit of billing period duration.
+                 */
+                duration_unit: 'day' | 'month';
+            }
+        }
         interface NewFloatingUnitWithProrationPrice {
             /**
              * The cadence to bill for this price on.
@@ -4213,6 +5039,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * this is true, and in-arrears if this is false.
              */
             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.
              */
@@ -4230,6 +5061,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * 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?: 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
@@ -4237,6 +5073,36 @@ export declare namespace SubscriptionPriceIntervalsParams {
              */
             metadata?: Record<string, string | null> | null;
         }
+        namespace NewFloatingUnitWithProrationPrice {
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            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.
+             */
+            interface InvoicingCycleConfiguration {
+                /**
+                 * The duration of the billing period.
+                 */
+                duration: number;
+                /**
+                 * The unit of billing period duration.
+                 */
+                duration_unit: 'day' | 'month';
+            }
+        }
         interface NewFloatingGroupedAllocationPrice {
             /**
              * The cadence to bill for this price on.
@@ -4266,6 +5132,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * this is true, and in-arrears if this is false.
              */
             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.
              */
@@ -4283,6 +5154,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * 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?: 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
@@ -4290,6 +5166,36 @@ export declare namespace SubscriptionPriceIntervalsParams {
              */
             metadata?: Record<string, string | null> | null;
         }
+        namespace NewFloatingGroupedAllocationPrice {
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            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.
+             */
+            interface InvoicingCycleConfiguration {
+                /**
+                 * The duration of the billing period.
+                 */
+                duration: number;
+                /**
+                 * The unit of billing period duration.
+                 */
+                duration_unit: 'day' | 'month';
+            }
+        }
         interface NewFloatingBulkWithProrationPrice {
             bulk_with_proration_config: Record<string, unknown>;
             /**
@@ -4319,6 +5225,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * this is true, and in-arrears if this is false.
              */
             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.
              */
@@ -4336,6 +5247,11 @@ export declare namespace SubscriptionPriceIntervalsParams {
              * 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?: 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
@@ -4343,6 +5259,36 @@ export declare namespace SubscriptionPriceIntervalsParams {
              */
             metadata?: Record<string, string | null> | null;
         }
+        namespace NewFloatingBulkWithProrationPrice {
+            /**
+             * For custom cadence: specifies the duration of the billing period in days or
+             * months.
+             */
+            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.
+             */
+            interface InvoicingCycleConfiguration {
+                /**
+                 * The duration of the billing period.
+                 */
+                duration: number;
+                /**
+                 * The unit of billing period duration.
+                 */
+                duration_unit: 'day' | 'month';
+            }
+        }
     }
     interface AddAdjustment {
         /**
@@ -4504,7 +5450,7 @@ export interface SubscriptionSchedulePlanChangeParams {
     /**
      * Optionally provide a list of overrides for prices on the plan
      */
-    price_overrides?: Array<SubscriptionSchedulePlanChangeParams.OverrideUnitPrice | SubscriptionSchedulePlanChangeParams.OverridePackagePrice | SubscriptionSchedulePlanChangeParams.OverrideMatrixPrice | SubscriptionSchedulePlanChangeParams.OverrideTieredPrice | SubscriptionSchedulePlanChangeParams.OverrideTieredBpsPrice | SubscriptionSchedulePlanChangeParams.OverrideBpsPrice | SubscriptionSchedulePlanChangeParams.OverrideBulkBpsPrice | SubscriptionSchedulePlanChangeParams.OverrideBulkPrice | SubscriptionSchedulePlanChangeParams.OverrideThresholdTotalAmountPrice | SubscriptionSchedulePlanChangeParams.OverrideTieredPackagePrice | SubscriptionSchedulePlanChangeParams.OverrideTieredWithMinimumPrice | SubscriptionSchedulePlanChangeParams.OverridePackageWithAllocationPrice | SubscriptionSchedulePlanChangeParams.OverrideUnitWithPercentPrice> | null;
+    price_overrides?: Array<SubscriptionSchedulePlanChangeParams.OverrideUnitPrice | SubscriptionSchedulePlanChangeParams.OverridePackagePrice | SubscriptionSchedulePlanChangeParams.OverrideMatrixPrice | SubscriptionSchedulePlanChangeParams.OverrideTieredPrice | SubscriptionSchedulePlanChangeParams.OverrideTieredBpsPrice | SubscriptionSchedulePlanChangeParams.OverrideBpsPrice | SubscriptionSchedulePlanChangeParams.OverrideBulkBpsPrice | SubscriptionSchedulePlanChangeParams.OverrideBulkPrice | SubscriptionSchedulePlanChangeParams.OverrideThresholdTotalAmountPrice | SubscriptionSchedulePlanChangeParams.OverrideTieredPackagePrice | SubscriptionSchedulePlanChangeParams.OverrideTieredWithMinimumPrice | SubscriptionSchedulePlanChangeParams.OverridePackageWithAllocationPrice | SubscriptionSchedulePlanChangeParams.OverrideUnitWithPercentPrice | SubscriptionSchedulePlanChangeParams.OverrideGroupedAllocationPrice | SubscriptionSchedulePlanChangeParams.OverrideBulkWithProrationPrice> | null;
 }
 export declare namespace SubscriptionSchedulePlanChangeParams {
     interface OverrideUnitPrice {
@@ -5445,6 +6391,128 @@ export declare namespace SubscriptionSchedulePlanChangeParams {
             usage_discount?: number | null;
         }
     }
+    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;
+    }
+    namespace OverrideGroupedAllocationPrice {
+        /**
+         * The subscription's override discount for the plan.
+         */
+        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;
+        }
+    }
+    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;
+    }
+    namespace OverrideBulkWithProrationPrice {
+        /**
+         * The subscription's override discount for the plan.
+         */
+        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 {
     /**