orb-billing 4.8.0 → 4.11.0

package/src/resources/plans/plans.ts

@@ -383,6 +383,12 @@ export namespace PlanCreateParams {
      */
     billed_in_advance?: boolean | null;
 
+    /**
+     * For custom cadence: specifies the duration of the billing period in days or
+     * months.
+     */
+    billing_cycle_configuration?: NewPlanUnitPrice.BillingCycleConfiguration | null;
+
     /**
      * The per unit conversion rate of the price currency to the invoicing currency.
      */
@@ -410,6 +416,12 @@ export namespace PlanCreateParams {
      */
     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?: NewPlanUnitPrice.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
@@ -425,6 +437,38 @@ export namespace PlanCreateParams {
        */
       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 NewPlanPackagePrice {
@@ -459,6 +503,12 @@ export namespace PlanCreateParams {
      */
     billed_in_advance?: boolean | null;
 
+    /**
+     * For custom cadence: specifies the duration of the billing period in days or
+     * months.
+     */
+    billing_cycle_configuration?: NewPlanPackagePrice.BillingCycleConfiguration | null;
+
     /**
      * The per unit conversion rate of the price currency to the invoicing currency.
      */
@@ -486,6 +536,12 @@ export namespace PlanCreateParams {
      */
     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?: NewPlanPackagePrice.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
@@ -507,6 +563,38 @@ export namespace PlanCreateParams {
        */
       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 NewPlanMatrixPrice {
@@ -541,6 +629,12 @@ export namespace PlanCreateParams {
      */
     billed_in_advance?: boolean | null;
 
+    /**
+     * For custom cadence: specifies the duration of the billing period in days or
+     * months.
+     */
+    billing_cycle_configuration?: NewPlanMatrixPrice.BillingCycleConfiguration | null;
+
     /**
      * The per unit conversion rate of the price currency to the invoicing currency.
      */
@@ -568,6 +662,12 @@ export namespace PlanCreateParams {
      */
     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?: NewPlanMatrixPrice.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
@@ -609,6 +709,38 @@ export namespace PlanCreateParams {
         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 NewPlanTieredPrice {
@@ -643,6 +775,12 @@ export namespace PlanCreateParams {
      */
     billed_in_advance?: boolean | null;
 
+    /**
+     * For custom cadence: specifies the duration of the billing period in days or
+     * months.
+     */
+    billing_cycle_configuration?: NewPlanTieredPrice.BillingCycleConfiguration | null;
+
     /**
      * The per unit conversion rate of the price currency to the invoicing currency.
      */
@@ -670,6 +808,12 @@ export namespace PlanCreateParams {
      */
     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?: NewPlanTieredPrice.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
@@ -704,6 +848,38 @@ export namespace PlanCreateParams {
         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 NewPlanTieredBpsPrice {
@@ -738,6 +914,12 @@ export namespace PlanCreateParams {
      */
     billed_in_advance?: boolean | null;
 
+    /**
+     * For custom cadence: specifies the duration of the billing period in days or
+     * months.
+     */
+    billing_cycle_configuration?: NewPlanTieredBpsPrice.BillingCycleConfiguration | null;
+
     /**
      * The per unit conversion rate of the price currency to the invoicing currency.
      */
@@ -765,6 +947,12 @@ export namespace PlanCreateParams {
      */
     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?: NewPlanTieredBpsPrice.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
@@ -805,6 +993,38 @@ export namespace PlanCreateParams {
         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 NewPlanBpsPrice {
@@ -839,6 +1059,12 @@ export namespace PlanCreateParams {
      */
     billed_in_advance?: boolean | null;
 
+    /**
+     * For custom cadence: specifies the duration of the billing period in days or
+     * months.
+     */
+    billing_cycle_configuration?: NewPlanBpsPrice.BillingCycleConfiguration | null;
+
     /**
      * The per unit conversion rate of the price currency to the invoicing currency.
      */
@@ -866,6 +1092,12 @@ export namespace PlanCreateParams {
      */
     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?: NewPlanBpsPrice.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
@@ -886,6 +1118,38 @@ export namespace PlanCreateParams {
        */
       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 NewPlanBulkBpsPrice {
@@ -920,6 +1184,12 @@ export namespace PlanCreateParams {
      */
     billed_in_advance?: boolean | null;
 
+    /**
+     * For custom cadence: specifies the duration of the billing period in days or
+     * months.
+     */
+    billing_cycle_configuration?: NewPlanBulkBpsPrice.BillingCycleConfiguration | null;
+
     /**
      * The per unit conversion rate of the price currency to the invoicing currency.
      */
@@ -947,6 +1217,12 @@ export namespace PlanCreateParams {
      */
     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?: NewPlanBulkBpsPrice.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
@@ -982,6 +1258,38 @@ export namespace PlanCreateParams {
         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 NewPlanBulkPrice {
@@ -1016,6 +1324,12 @@ export namespace PlanCreateParams {
      */
     billed_in_advance?: boolean | null;
 
+    /**
+     * For custom cadence: specifies the duration of the billing period in days or
+     * months.
+     */
+    billing_cycle_configuration?: NewPlanBulkPrice.BillingCycleConfiguration | null;
+
     /**
      * The per unit conversion rate of the price currency to the invoicing currency.
      */
@@ -1043,6 +1357,12 @@ export namespace PlanCreateParams {
      */
     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?: NewPlanBulkPrice.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
@@ -1072,6 +1392,38 @@ export namespace PlanCreateParams {
         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 NewPlanThresholdTotalAmountPrice {
@@ -1106,6 +1458,12 @@ export namespace PlanCreateParams {
      */
     billed_in_advance?: boolean | null;
 
+    /**
+     * For custom cadence: specifies the duration of the billing period in days or
+     * months.
+     */
+    billing_cycle_configuration?: NewPlanThresholdTotalAmountPrice.BillingCycleConfiguration | null;
+
     /**
      * The per unit conversion rate of the price currency to the invoicing currency.
      */
@@ -1133,6 +1491,12 @@ export namespace PlanCreateParams {
      */
     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?: NewPlanThresholdTotalAmountPrice.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
@@ -1141,6 +1505,40 @@ export namespace PlanCreateParams {
     metadata?: Record<string, string | null> | null;
   }
 
+  export namespace NewPlanThresholdTotalAmountPrice {
+    /**
+     * 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 NewPlanTieredPackagePrice {
     /**
      * The cadence to bill for this price on.
@@ -1173,6 +1571,12 @@ export namespace PlanCreateParams {
      */
     billed_in_advance?: boolean | null;
 
+    /**
+     * For custom cadence: specifies the duration of the billing period in days or
+     * months.
+     */
+    billing_cycle_configuration?: NewPlanTieredPackagePrice.BillingCycleConfiguration | null;
+
     /**
      * The per unit conversion rate of the price currency to the invoicing currency.
      */
@@ -1200,6 +1604,12 @@ export namespace PlanCreateParams {
      */
     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?: NewPlanTieredPackagePrice.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
@@ -1208,6 +1618,40 @@ export namespace PlanCreateParams {
     metadata?: Record<string, string | null> | null;
   }
 
+  export namespace NewPlanTieredPackagePrice {
+    /**
+     * 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 NewPlanTieredWithMinimumPrice {
     /**
      * The cadence to bill for this price on.
@@ -1240,6 +1684,12 @@ export namespace PlanCreateParams {
      */
     billed_in_advance?: boolean | null;
 
+    /**
+     * For custom cadence: specifies the duration of the billing period in days or
+     * months.
+     */
+    billing_cycle_configuration?: NewPlanTieredWithMinimumPrice.BillingCycleConfiguration | null;
+
     /**
      * The per unit conversion rate of the price currency to the invoicing currency.
      */
@@ -1267,6 +1717,12 @@ export namespace PlanCreateParams {
      */
     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?: NewPlanTieredWithMinimumPrice.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
@@ -1275,6 +1731,40 @@ export namespace PlanCreateParams {
     metadata?: Record<string, string | null> | null;
   }
 
+  export namespace NewPlanTieredWithMinimumPrice {
+    /**
+     * 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 NewPlanUnitWithPercentPrice {
     /**
      * The cadence to bill for this price on.
@@ -1307,6 +1797,12 @@ export namespace PlanCreateParams {
      */
     billed_in_advance?: boolean | null;
 
+    /**
+     * For custom cadence: specifies the duration of the billing period in days or
+     * months.
+     */
+    billing_cycle_configuration?: NewPlanUnitWithPercentPrice.BillingCycleConfiguration | null;
+
     /**
      * The per unit conversion rate of the price currency to the invoicing currency.
      */
@@ -1334,6 +1830,12 @@ export namespace PlanCreateParams {
      */
     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?: NewPlanUnitWithPercentPrice.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
@@ -1342,6 +1844,40 @@ export namespace PlanCreateParams {
     metadata?: Record<string, string | null> | null;
   }
 
+  export namespace NewPlanUnitWithPercentPrice {
+    /**
+     * 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 NewPlanPackageWithAllocationPrice {
     /**
      * The cadence to bill for this price on.
@@ -1374,6 +1910,12 @@ export namespace PlanCreateParams {
      */
     billed_in_advance?: boolean | null;
 
+    /**
+     * For custom cadence: specifies the duration of the billing period in days or
+     * months.
+     */
+    billing_cycle_configuration?: NewPlanPackageWithAllocationPrice.BillingCycleConfiguration | null;
+
     /**
      * The per unit conversion rate of the price currency to the invoicing currency.
      */
@@ -1401,6 +1943,12 @@ export namespace PlanCreateParams {
      */
     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?: NewPlanPackageWithAllocationPrice.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
@@ -1409,6 +1957,40 @@ export namespace PlanCreateParams {
     metadata?: Record<string, string | null> | null;
   }
 
+  export namespace NewPlanPackageWithAllocationPrice {
+    /**
+     * 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 NewPlanTierWithProrationPrice {
     /**
      * The cadence to bill for this price on.
@@ -1441,6 +2023,12 @@ export namespace PlanCreateParams {
      */
     billed_in_advance?: boolean | null;
 
+    /**
+     * For custom cadence: specifies the duration of the billing period in days or
+     * months.
+     */
+    billing_cycle_configuration?: NewPlanTierWithProrationPrice.BillingCycleConfiguration | null;
+
     /**
      * The per unit conversion rate of the price currency to the invoicing currency.
      */
@@ -1468,6 +2056,12 @@ export namespace PlanCreateParams {
      */
     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?: NewPlanTierWithProrationPrice.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
@@ -1476,6 +2070,40 @@ export namespace PlanCreateParams {
     metadata?: Record<string, string | null> | null;
   }
 
+  export namespace NewPlanTierWithProrationPrice {
+    /**
+     * 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 NewPlanUnitWithProrationPrice {
     /**
      * The cadence to bill for this price on.
@@ -1508,6 +2136,12 @@ export namespace PlanCreateParams {
      */
     billed_in_advance?: boolean | null;
 
+    /**
+     * For custom cadence: specifies the duration of the billing period in days or
+     * months.
+     */
+    billing_cycle_configuration?: NewPlanUnitWithProrationPrice.BillingCycleConfiguration | null;
+
     /**
      * The per unit conversion rate of the price currency to the invoicing currency.
      */
@@ -1535,6 +2169,12 @@ export namespace PlanCreateParams {
      */
     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?: NewPlanUnitWithProrationPrice.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
@@ -1543,6 +2183,40 @@ export namespace PlanCreateParams {
     metadata?: Record<string, string | null> | null;
   }
 
+  export namespace NewPlanUnitWithProrationPrice {
+    /**
+     * 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 NewPlanGroupedAllocationPrice {
     /**
      * The cadence to bill for this price on.
@@ -1575,6 +2249,12 @@ export namespace PlanCreateParams {
      */
     billed_in_advance?: boolean | null;
 
+    /**
+     * For custom cadence: specifies the duration of the billing period in days or
+     * months.
+     */
+    billing_cycle_configuration?: NewPlanGroupedAllocationPrice.BillingCycleConfiguration | null;
+
     /**
      * The per unit conversion rate of the price currency to the invoicing currency.
      */
@@ -1602,6 +2282,12 @@ export namespace PlanCreateParams {
      */
     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?: NewPlanGroupedAllocationPrice.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
@@ -1610,6 +2296,40 @@ export namespace PlanCreateParams {
     metadata?: Record<string, string | null> | null;
   }
 
+  export namespace NewPlanGroupedAllocationPrice {
+    /**
+     * 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 NewPlanBulkWithProrationPrice {
     bulk_with_proration_config: Record<string, unknown>;
 
@@ -1642,6 +2362,12 @@ export namespace PlanCreateParams {
      */
     billed_in_advance?: boolean | null;
 
+    /**
+     * For custom cadence: specifies the duration of the billing period in days or
+     * months.
+     */
+    billing_cycle_configuration?: NewPlanBulkWithProrationPrice.BillingCycleConfiguration | null;
+
     /**
      * The per unit conversion rate of the price currency to the invoicing currency.
      */
@@ -1669,6 +2395,12 @@ export namespace PlanCreateParams {
      */
     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?: NewPlanBulkWithProrationPrice.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
@@ -1676,6 +2408,40 @@ export namespace PlanCreateParams {
      */
     metadata?: Record<string, string | null> | null;
   }
+
+  export namespace NewPlanBulkWithProrationPrice {
+    /**
+     * 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 PlanUpdateParams {