orb-billing 4.54.0 → 4.56.0

package/src/resources/subscriptions.ts

@@ -1228,11 +1228,11 @@ export namespace Subscription {
     id: string;
 
     adjustment:
-      | AdjustmentInterval.AmountDiscountAdjustment
-      | AdjustmentInterval.PercentageDiscountAdjustment
-      | AdjustmentInterval.UsageDiscountAdjustment
-      | AdjustmentInterval.MinimumAdjustment
-      | AdjustmentInterval.MaximumAdjustment;
+      | AdjustmentInterval.PlanPhaseUsageDiscountAdjustment
+      | AdjustmentInterval.PlanPhaseAmountDiscountAdjustment
+      | AdjustmentInterval.PlanPhasePercentageDiscountAdjustment
+      | AdjustmentInterval.PlanPhaseMinimumAdjustment
+      | AdjustmentInterval.PlanPhaseMaximumAdjustment;
 
     /**
      * The price interval IDs that this adjustment applies to.
@@ -1251,16 +1251,10 @@ export namespace Subscription {
   }
 
   export namespace AdjustmentInterval {
-    export interface AmountDiscountAdjustment {
+    export interface PlanPhaseUsageDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'amount_discount';
-
-      /**
-       * The amount by which to discount the prices this adjustment applies to in a given
-       * billing period.
-       */
-      amount_discount: string;
+      adjustment_type: 'usage_discount';
 
       /**
        * The price IDs that this adjustment applies to.
@@ -1282,12 +1276,24 @@ export namespace Subscription {
        * The reason for the adjustment.
        */
       reason: string | null;
+
+      /**
+       * The number of usage units by which to discount the price this adjustment applies
+       * to in a given billing period.
+       */
+      usage_discount: number;
     }
 
-    export interface PercentageDiscountAdjustment {
+    export interface PlanPhaseAmountDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'percentage_discount';
+      adjustment_type: 'amount_discount';
+
+      /**
+       * The amount by which to discount the prices this adjustment applies to in a given
+       * billing period.
+       */
+      amount_discount: string;
 
       /**
        * The price IDs that this adjustment applies to.
@@ -1300,12 +1306,6 @@ export namespace Subscription {
        */
       is_invoice_level: boolean;
 
-      /**
-       * The percentage (as a value between 0 and 1) by which to discount the price
-       * intervals this adjustment applies to in a given billing period.
-       */
-      percentage_discount: number;
-
       /**
        * The plan phase in which this adjustment is active.
        */
@@ -1317,10 +1317,10 @@ export namespace Subscription {
       reason: string | null;
     }
 
-    export interface UsageDiscountAdjustment {
+    export interface PlanPhasePercentageDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'usage_discount';
+      adjustment_type: 'percentage_discount';
 
       /**
        * The price IDs that this adjustment applies to.
@@ -1333,6 +1333,12 @@ export namespace Subscription {
        */
       is_invoice_level: boolean;
 
+      /**
+       * The percentage (as a value between 0 and 1) by which to discount the price
+       * intervals this adjustment applies to in a given billing period.
+       */
+      percentage_discount: number;
+
       /**
        * The plan phase in which this adjustment is active.
        */
@@ -1342,15 +1348,9 @@ export namespace Subscription {
        * The reason for the adjustment.
        */
       reason: string | null;
-
-      /**
-       * The number of usage units by which to discount the price this adjustment applies
-       * to in a given billing period.
-       */
-      usage_discount: number;
     }
 
-    export interface MinimumAdjustment {
+    export interface PlanPhaseMinimumAdjustment {
       id: string;
 
       adjustment_type: 'minimum';
@@ -1388,7 +1388,7 @@ export namespace Subscription {
       reason: string | null;
     }
 
-    export interface MaximumAdjustment {
+    export interface PlanPhaseMaximumAdjustment {
       id: string;
 
       adjustment_type: 'maximum';
@@ -1914,11 +1914,11 @@ export namespace SubscriptionCreateResponse {
     id: string;
 
     adjustment:
-      | AdjustmentInterval.AmountDiscountAdjustment
-      | AdjustmentInterval.PercentageDiscountAdjustment
-      | AdjustmentInterval.UsageDiscountAdjustment
-      | AdjustmentInterval.MinimumAdjustment
-      | AdjustmentInterval.MaximumAdjustment;
+      | AdjustmentInterval.PlanPhaseUsageDiscountAdjustment
+      | AdjustmentInterval.PlanPhaseAmountDiscountAdjustment
+      | AdjustmentInterval.PlanPhasePercentageDiscountAdjustment
+      | AdjustmentInterval.PlanPhaseMinimumAdjustment
+      | AdjustmentInterval.PlanPhaseMaximumAdjustment;
 
     /**
      * The price interval IDs that this adjustment applies to.
@@ -1937,16 +1937,10 @@ export namespace SubscriptionCreateResponse {
   }
 
   export namespace AdjustmentInterval {
-    export interface AmountDiscountAdjustment {
+    export interface PlanPhaseUsageDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'amount_discount';
-
-      /**
-       * The amount by which to discount the prices this adjustment applies to in a given
-       * billing period.
-       */
-      amount_discount: string;
+      adjustment_type: 'usage_discount';
 
       /**
        * The price IDs that this adjustment applies to.
@@ -1968,12 +1962,24 @@ export namespace SubscriptionCreateResponse {
        * The reason for the adjustment.
        */
       reason: string | null;
+
+      /**
+       * The number of usage units by which to discount the price this adjustment applies
+       * to in a given billing period.
+       */
+      usage_discount: number;
     }
 
-    export interface PercentageDiscountAdjustment {
+    export interface PlanPhaseAmountDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'percentage_discount';
+      adjustment_type: 'amount_discount';
+
+      /**
+       * The amount by which to discount the prices this adjustment applies to in a given
+       * billing period.
+       */
+      amount_discount: string;
 
       /**
        * The price IDs that this adjustment applies to.
@@ -1986,12 +1992,6 @@ export namespace SubscriptionCreateResponse {
        */
       is_invoice_level: boolean;
 
-      /**
-       * The percentage (as a value between 0 and 1) by which to discount the price
-       * intervals this adjustment applies to in a given billing period.
-       */
-      percentage_discount: number;
-
       /**
        * The plan phase in which this adjustment is active.
        */
@@ -2003,10 +2003,10 @@ export namespace SubscriptionCreateResponse {
       reason: string | null;
     }
 
-    export interface UsageDiscountAdjustment {
+    export interface PlanPhasePercentageDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'usage_discount';
+      adjustment_type: 'percentage_discount';
 
       /**
        * The price IDs that this adjustment applies to.
@@ -2019,6 +2019,12 @@ export namespace SubscriptionCreateResponse {
        */
       is_invoice_level: boolean;
 
+      /**
+       * The percentage (as a value between 0 and 1) by which to discount the price
+       * intervals this adjustment applies to in a given billing period.
+       */
+      percentage_discount: number;
+
       /**
        * The plan phase in which this adjustment is active.
        */
@@ -2028,15 +2034,9 @@ export namespace SubscriptionCreateResponse {
        * The reason for the adjustment.
        */
       reason: string | null;
-
-      /**
-       * The number of usage units by which to discount the price this adjustment applies
-       * to in a given billing period.
-       */
-      usage_discount: number;
     }
 
-    export interface MinimumAdjustment {
+    export interface PlanPhaseMinimumAdjustment {
       id: string;
 
       adjustment_type: 'minimum';
@@ -2074,7 +2074,7 @@ export namespace SubscriptionCreateResponse {
       reason: string | null;
     }
 
-    export interface MaximumAdjustment {
+    export interface PlanPhaseMaximumAdjustment {
       id: string;
 
       adjustment_type: 'maximum';
@@ -2518,11 +2518,11 @@ export namespace SubscriptionCancelResponse {
     id: string;
 
     adjustment:
-      | AdjustmentInterval.AmountDiscountAdjustment
-      | AdjustmentInterval.PercentageDiscountAdjustment
-      | AdjustmentInterval.UsageDiscountAdjustment
-      | AdjustmentInterval.MinimumAdjustment
-      | AdjustmentInterval.MaximumAdjustment;
+      | AdjustmentInterval.PlanPhaseUsageDiscountAdjustment
+      | AdjustmentInterval.PlanPhaseAmountDiscountAdjustment
+      | AdjustmentInterval.PlanPhasePercentageDiscountAdjustment
+      | AdjustmentInterval.PlanPhaseMinimumAdjustment
+      | AdjustmentInterval.PlanPhaseMaximumAdjustment;
 
     /**
      * The price interval IDs that this adjustment applies to.
@@ -2541,16 +2541,10 @@ export namespace SubscriptionCancelResponse {
   }
 
   export namespace AdjustmentInterval {
-    export interface AmountDiscountAdjustment {
+    export interface PlanPhaseUsageDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'amount_discount';
-
-      /**
-       * The amount by which to discount the prices this adjustment applies to in a given
-       * billing period.
-       */
-      amount_discount: string;
+      adjustment_type: 'usage_discount';
 
       /**
        * The price IDs that this adjustment applies to.
@@ -2572,12 +2566,24 @@ export namespace SubscriptionCancelResponse {
        * The reason for the adjustment.
        */
       reason: string | null;
+
+      /**
+       * The number of usage units by which to discount the price this adjustment applies
+       * to in a given billing period.
+       */
+      usage_discount: number;
     }
 
-    export interface PercentageDiscountAdjustment {
+    export interface PlanPhaseAmountDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'percentage_discount';
+      adjustment_type: 'amount_discount';
+
+      /**
+       * The amount by which to discount the prices this adjustment applies to in a given
+       * billing period.
+       */
+      amount_discount: string;
 
       /**
        * The price IDs that this adjustment applies to.
@@ -2590,12 +2596,6 @@ export namespace SubscriptionCancelResponse {
        */
       is_invoice_level: boolean;
 
-      /**
-       * The percentage (as a value between 0 and 1) by which to discount the price
-       * intervals this adjustment applies to in a given billing period.
-       */
-      percentage_discount: number;
-
       /**
        * The plan phase in which this adjustment is active.
        */
@@ -2607,10 +2607,10 @@ export namespace SubscriptionCancelResponse {
       reason: string | null;
     }
 
-    export interface UsageDiscountAdjustment {
+    export interface PlanPhasePercentageDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'usage_discount';
+      adjustment_type: 'percentage_discount';
 
       /**
        * The price IDs that this adjustment applies to.
@@ -2623,6 +2623,12 @@ export namespace SubscriptionCancelResponse {
        */
       is_invoice_level: boolean;
 
+      /**
+       * The percentage (as a value between 0 and 1) by which to discount the price
+       * intervals this adjustment applies to in a given billing period.
+       */
+      percentage_discount: number;
+
       /**
        * The plan phase in which this adjustment is active.
        */
@@ -2632,15 +2638,9 @@ export namespace SubscriptionCancelResponse {
        * The reason for the adjustment.
        */
       reason: string | null;
-
-      /**
-       * The number of usage units by which to discount the price this adjustment applies
-       * to in a given billing period.
-       */
-      usage_discount: number;
     }
 
-    export interface MinimumAdjustment {
+    export interface PlanPhaseMinimumAdjustment {
       id: string;
 
       adjustment_type: 'minimum';
@@ -2678,7 +2678,7 @@ export namespace SubscriptionCancelResponse {
       reason: string | null;
     }
 
-    export interface MaximumAdjustment {
+    export interface PlanPhaseMaximumAdjustment {
       id: string;
 
       adjustment_type: 'maximum';
@@ -3204,11 +3204,11 @@ export namespace SubscriptionPriceIntervalsResponse {
     id: string;
 
     adjustment:
-      | AdjustmentInterval.AmountDiscountAdjustment
-      | AdjustmentInterval.PercentageDiscountAdjustment
-      | AdjustmentInterval.UsageDiscountAdjustment
-      | AdjustmentInterval.MinimumAdjustment
-      | AdjustmentInterval.MaximumAdjustment;
+      | AdjustmentInterval.PlanPhaseUsageDiscountAdjustment
+      | AdjustmentInterval.PlanPhaseAmountDiscountAdjustment
+      | AdjustmentInterval.PlanPhasePercentageDiscountAdjustment
+      | AdjustmentInterval.PlanPhaseMinimumAdjustment
+      | AdjustmentInterval.PlanPhaseMaximumAdjustment;
 
     /**
      * The price interval IDs that this adjustment applies to.
@@ -3227,16 +3227,10 @@ export namespace SubscriptionPriceIntervalsResponse {
   }
 
   export namespace AdjustmentInterval {
-    export interface AmountDiscountAdjustment {
+    export interface PlanPhaseUsageDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'amount_discount';
-
-      /**
-       * The amount by which to discount the prices this adjustment applies to in a given
-       * billing period.
-       */
-      amount_discount: string;
+      adjustment_type: 'usage_discount';
 
       /**
        * The price IDs that this adjustment applies to.
@@ -3258,12 +3252,24 @@ export namespace SubscriptionPriceIntervalsResponse {
        * The reason for the adjustment.
        */
       reason: string | null;
+
+      /**
+       * The number of usage units by which to discount the price this adjustment applies
+       * to in a given billing period.
+       */
+      usage_discount: number;
     }
 
-    export interface PercentageDiscountAdjustment {
+    export interface PlanPhaseAmountDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'percentage_discount';
+      adjustment_type: 'amount_discount';
+
+      /**
+       * The amount by which to discount the prices this adjustment applies to in a given
+       * billing period.
+       */
+      amount_discount: string;
 
       /**
        * The price IDs that this adjustment applies to.
@@ -3276,12 +3282,6 @@ export namespace SubscriptionPriceIntervalsResponse {
        */
       is_invoice_level: boolean;
 
-      /**
-       * The percentage (as a value between 0 and 1) by which to discount the price
-       * intervals this adjustment applies to in a given billing period.
-       */
-      percentage_discount: number;
-
       /**
        * The plan phase in which this adjustment is active.
        */
@@ -3293,10 +3293,10 @@ export namespace SubscriptionPriceIntervalsResponse {
       reason: string | null;
     }
 
-    export interface UsageDiscountAdjustment {
+    export interface PlanPhasePercentageDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'usage_discount';
+      adjustment_type: 'percentage_discount';
 
       /**
        * The price IDs that this adjustment applies to.
@@ -3309,6 +3309,12 @@ export namespace SubscriptionPriceIntervalsResponse {
        */
       is_invoice_level: boolean;
 
+      /**
+       * The percentage (as a value between 0 and 1) by which to discount the price
+       * intervals this adjustment applies to in a given billing period.
+       */
+      percentage_discount: number;
+
       /**
        * The plan phase in which this adjustment is active.
        */
@@ -3318,15 +3324,9 @@ export namespace SubscriptionPriceIntervalsResponse {
        * The reason for the adjustment.
        */
       reason: string | null;
-
-      /**
-       * The number of usage units by which to discount the price this adjustment applies
-       * to in a given billing period.
-       */
-      usage_discount: number;
     }
 
-    export interface MinimumAdjustment {
+    export interface PlanPhaseMinimumAdjustment {
       id: string;
 
       adjustment_type: 'minimum';
@@ -3364,7 +3364,7 @@ export namespace SubscriptionPriceIntervalsResponse {
       reason: string | null;
     }
 
-    export interface MaximumAdjustment {
+    export interface PlanPhaseMaximumAdjustment {
       id: string;
 
       adjustment_type: 'maximum';
@@ -3808,11 +3808,11 @@ export namespace SubscriptionSchedulePlanChangeResponse {
     id: string;
 
     adjustment:
-      | AdjustmentInterval.AmountDiscountAdjustment
-      | AdjustmentInterval.PercentageDiscountAdjustment
-      | AdjustmentInterval.UsageDiscountAdjustment
-      | AdjustmentInterval.MinimumAdjustment
-      | AdjustmentInterval.MaximumAdjustment;
+      | AdjustmentInterval.PlanPhaseUsageDiscountAdjustment
+      | AdjustmentInterval.PlanPhaseAmountDiscountAdjustment
+      | AdjustmentInterval.PlanPhasePercentageDiscountAdjustment
+      | AdjustmentInterval.PlanPhaseMinimumAdjustment
+      | AdjustmentInterval.PlanPhaseMaximumAdjustment;
 
     /**
      * The price interval IDs that this adjustment applies to.
@@ -3831,16 +3831,10 @@ export namespace SubscriptionSchedulePlanChangeResponse {
   }
 
   export namespace AdjustmentInterval {
-    export interface AmountDiscountAdjustment {
+    export interface PlanPhaseUsageDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'amount_discount';
-
-      /**
-       * The amount by which to discount the prices this adjustment applies to in a given
-       * billing period.
-       */
-      amount_discount: string;
+      adjustment_type: 'usage_discount';
 
       /**
        * The price IDs that this adjustment applies to.
@@ -3862,12 +3856,24 @@ export namespace SubscriptionSchedulePlanChangeResponse {
        * The reason for the adjustment.
        */
       reason: string | null;
+
+      /**
+       * The number of usage units by which to discount the price this adjustment applies
+       * to in a given billing period.
+       */
+      usage_discount: number;
     }
 
-    export interface PercentageDiscountAdjustment {
+    export interface PlanPhaseAmountDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'percentage_discount';
+      adjustment_type: 'amount_discount';
+
+      /**
+       * The amount by which to discount the prices this adjustment applies to in a given
+       * billing period.
+       */
+      amount_discount: string;
 
       /**
        * The price IDs that this adjustment applies to.
@@ -3880,12 +3886,6 @@ export namespace SubscriptionSchedulePlanChangeResponse {
        */
       is_invoice_level: boolean;
 
-      /**
-       * The percentage (as a value between 0 and 1) by which to discount the price
-       * intervals this adjustment applies to in a given billing period.
-       */
-      percentage_discount: number;
-
       /**
        * The plan phase in which this adjustment is active.
        */
@@ -3897,10 +3897,10 @@ export namespace SubscriptionSchedulePlanChangeResponse {
       reason: string | null;
     }
 
-    export interface UsageDiscountAdjustment {
+    export interface PlanPhasePercentageDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'usage_discount';
+      adjustment_type: 'percentage_discount';
 
       /**
        * The price IDs that this adjustment applies to.
@@ -3913,6 +3913,12 @@ export namespace SubscriptionSchedulePlanChangeResponse {
        */
       is_invoice_level: boolean;
 
+      /**
+       * The percentage (as a value between 0 and 1) by which to discount the price
+       * intervals this adjustment applies to in a given billing period.
+       */
+      percentage_discount: number;
+
       /**
        * The plan phase in which this adjustment is active.
        */
@@ -3922,15 +3928,9 @@ export namespace SubscriptionSchedulePlanChangeResponse {
        * The reason for the adjustment.
        */
       reason: string | null;
-
-      /**
-       * The number of usage units by which to discount the price this adjustment applies
-       * to in a given billing period.
-       */
-      usage_discount: number;
     }
 
-    export interface MinimumAdjustment {
+    export interface PlanPhaseMinimumAdjustment {
       id: string;
 
       adjustment_type: 'minimum';
@@ -3968,7 +3968,7 @@ export namespace SubscriptionSchedulePlanChangeResponse {
       reason: string | null;
     }
 
-    export interface MaximumAdjustment {
+    export interface PlanPhaseMaximumAdjustment {
       id: string;
 
       adjustment_type: 'maximum';
@@ -4412,11 +4412,11 @@ export namespace SubscriptionTriggerPhaseResponse {
     id: string;
 
     adjustment:
-      | AdjustmentInterval.AmountDiscountAdjustment
-      | AdjustmentInterval.PercentageDiscountAdjustment
-      | AdjustmentInterval.UsageDiscountAdjustment
-      | AdjustmentInterval.MinimumAdjustment
-      | AdjustmentInterval.MaximumAdjustment;
+      | AdjustmentInterval.PlanPhaseUsageDiscountAdjustment
+      | AdjustmentInterval.PlanPhaseAmountDiscountAdjustment
+      | AdjustmentInterval.PlanPhasePercentageDiscountAdjustment
+      | AdjustmentInterval.PlanPhaseMinimumAdjustment
+      | AdjustmentInterval.PlanPhaseMaximumAdjustment;
 
     /**
      * The price interval IDs that this adjustment applies to.
@@ -4435,16 +4435,10 @@ export namespace SubscriptionTriggerPhaseResponse {
   }
 
   export namespace AdjustmentInterval {
-    export interface AmountDiscountAdjustment {
+    export interface PlanPhaseUsageDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'amount_discount';
-
-      /**
-       * The amount by which to discount the prices this adjustment applies to in a given
-       * billing period.
-       */
-      amount_discount: string;
+      adjustment_type: 'usage_discount';
 
       /**
        * The price IDs that this adjustment applies to.
@@ -4466,12 +4460,24 @@ export namespace SubscriptionTriggerPhaseResponse {
        * The reason for the adjustment.
        */
       reason: string | null;
+
+      /**
+       * The number of usage units by which to discount the price this adjustment applies
+       * to in a given billing period.
+       */
+      usage_discount: number;
     }
 
-    export interface PercentageDiscountAdjustment {
+    export interface PlanPhaseAmountDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'percentage_discount';
+      adjustment_type: 'amount_discount';
+
+      /**
+       * The amount by which to discount the prices this adjustment applies to in a given
+       * billing period.
+       */
+      amount_discount: string;
 
       /**
        * The price IDs that this adjustment applies to.
@@ -4484,12 +4490,6 @@ export namespace SubscriptionTriggerPhaseResponse {
        */
       is_invoice_level: boolean;
 
-      /**
-       * The percentage (as a value between 0 and 1) by which to discount the price
-       * intervals this adjustment applies to in a given billing period.
-       */
-      percentage_discount: number;
-
       /**
        * The plan phase in which this adjustment is active.
        */
@@ -4501,10 +4501,10 @@ export namespace SubscriptionTriggerPhaseResponse {
       reason: string | null;
     }
 
-    export interface UsageDiscountAdjustment {
+    export interface PlanPhasePercentageDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'usage_discount';
+      adjustment_type: 'percentage_discount';
 
       /**
        * The price IDs that this adjustment applies to.
@@ -4517,6 +4517,12 @@ export namespace SubscriptionTriggerPhaseResponse {
        */
       is_invoice_level: boolean;
 
+      /**
+       * The percentage (as a value between 0 and 1) by which to discount the price
+       * intervals this adjustment applies to in a given billing period.
+       */
+      percentage_discount: number;
+
       /**
        * The plan phase in which this adjustment is active.
        */
@@ -4526,15 +4532,9 @@ export namespace SubscriptionTriggerPhaseResponse {
        * The reason for the adjustment.
        */
       reason: string | null;
-
-      /**
-       * The number of usage units by which to discount the price this adjustment applies
-       * to in a given billing period.
-       */
-      usage_discount: number;
     }
 
-    export interface MinimumAdjustment {
+    export interface PlanPhaseMinimumAdjustment {
       id: string;
 
       adjustment_type: 'minimum';
@@ -4572,7 +4572,7 @@ export namespace SubscriptionTriggerPhaseResponse {
       reason: string | null;
     }
 
-    export interface MaximumAdjustment {
+    export interface PlanPhaseMaximumAdjustment {
       id: string;
 
       adjustment_type: 'maximum';
@@ -5016,11 +5016,11 @@ export namespace SubscriptionUnscheduleCancellationResponse {
     id: string;
 
     adjustment:
-      | AdjustmentInterval.AmountDiscountAdjustment
-      | AdjustmentInterval.PercentageDiscountAdjustment
-      | AdjustmentInterval.UsageDiscountAdjustment
-      | AdjustmentInterval.MinimumAdjustment
-      | AdjustmentInterval.MaximumAdjustment;
+      | AdjustmentInterval.PlanPhaseUsageDiscountAdjustment
+      | AdjustmentInterval.PlanPhaseAmountDiscountAdjustment
+      | AdjustmentInterval.PlanPhasePercentageDiscountAdjustment
+      | AdjustmentInterval.PlanPhaseMinimumAdjustment
+      | AdjustmentInterval.PlanPhaseMaximumAdjustment;
 
     /**
      * The price interval IDs that this adjustment applies to.
@@ -5039,16 +5039,10 @@ export namespace SubscriptionUnscheduleCancellationResponse {
   }
 
   export namespace AdjustmentInterval {
-    export interface AmountDiscountAdjustment {
+    export interface PlanPhaseUsageDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'amount_discount';
-
-      /**
-       * The amount by which to discount the prices this adjustment applies to in a given
-       * billing period.
-       */
-      amount_discount: string;
+      adjustment_type: 'usage_discount';
 
       /**
        * The price IDs that this adjustment applies to.
@@ -5070,12 +5064,24 @@ export namespace SubscriptionUnscheduleCancellationResponse {
        * The reason for the adjustment.
        */
       reason: string | null;
+
+      /**
+       * The number of usage units by which to discount the price this adjustment applies
+       * to in a given billing period.
+       */
+      usage_discount: number;
     }
 
-    export interface PercentageDiscountAdjustment {
+    export interface PlanPhaseAmountDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'percentage_discount';
+      adjustment_type: 'amount_discount';
+
+      /**
+       * The amount by which to discount the prices this adjustment applies to in a given
+       * billing period.
+       */
+      amount_discount: string;
 
       /**
        * The price IDs that this adjustment applies to.
@@ -5088,12 +5094,6 @@ export namespace SubscriptionUnscheduleCancellationResponse {
        */
       is_invoice_level: boolean;
 
-      /**
-       * The percentage (as a value between 0 and 1) by which to discount the price
-       * intervals this adjustment applies to in a given billing period.
-       */
-      percentage_discount: number;
-
       /**
        * The plan phase in which this adjustment is active.
        */
@@ -5105,10 +5105,10 @@ export namespace SubscriptionUnscheduleCancellationResponse {
       reason: string | null;
     }
 
-    export interface UsageDiscountAdjustment {
+    export interface PlanPhasePercentageDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'usage_discount';
+      adjustment_type: 'percentage_discount';
 
       /**
        * The price IDs that this adjustment applies to.
@@ -5121,6 +5121,12 @@ export namespace SubscriptionUnscheduleCancellationResponse {
        */
       is_invoice_level: boolean;
 
+      /**
+       * The percentage (as a value between 0 and 1) by which to discount the price
+       * intervals this adjustment applies to in a given billing period.
+       */
+      percentage_discount: number;
+
       /**
        * The plan phase in which this adjustment is active.
        */
@@ -5130,15 +5136,9 @@ export namespace SubscriptionUnscheduleCancellationResponse {
        * The reason for the adjustment.
        */
       reason: string | null;
-
-      /**
-       * The number of usage units by which to discount the price this adjustment applies
-       * to in a given billing period.
-       */
-      usage_discount: number;
     }
 
-    export interface MinimumAdjustment {
+    export interface PlanPhaseMinimumAdjustment {
       id: string;
 
       adjustment_type: 'minimum';
@@ -5176,7 +5176,7 @@ export namespace SubscriptionUnscheduleCancellationResponse {
       reason: string | null;
     }
 
-    export interface MaximumAdjustment {
+    export interface PlanPhaseMaximumAdjustment {
       id: string;
 
       adjustment_type: 'maximum';
@@ -5620,11 +5620,11 @@ export namespace SubscriptionUnscheduleFixedFeeQuantityUpdatesResponse {
     id: string;
 
     adjustment:
-      | AdjustmentInterval.AmountDiscountAdjustment
-      | AdjustmentInterval.PercentageDiscountAdjustment
-      | AdjustmentInterval.UsageDiscountAdjustment
-      | AdjustmentInterval.MinimumAdjustment
-      | AdjustmentInterval.MaximumAdjustment;
+      | AdjustmentInterval.PlanPhaseUsageDiscountAdjustment
+      | AdjustmentInterval.PlanPhaseAmountDiscountAdjustment
+      | AdjustmentInterval.PlanPhasePercentageDiscountAdjustment
+      | AdjustmentInterval.PlanPhaseMinimumAdjustment
+      | AdjustmentInterval.PlanPhaseMaximumAdjustment;
 
     /**
      * The price interval IDs that this adjustment applies to.
@@ -5643,16 +5643,10 @@ export namespace SubscriptionUnscheduleFixedFeeQuantityUpdatesResponse {
   }
 
   export namespace AdjustmentInterval {
-    export interface AmountDiscountAdjustment {
+    export interface PlanPhaseUsageDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'amount_discount';
-
-      /**
-       * The amount by which to discount the prices this adjustment applies to in a given
-       * billing period.
-       */
-      amount_discount: string;
+      adjustment_type: 'usage_discount';
 
       /**
        * The price IDs that this adjustment applies to.
@@ -5674,12 +5668,24 @@ export namespace SubscriptionUnscheduleFixedFeeQuantityUpdatesResponse {
        * The reason for the adjustment.
        */
       reason: string | null;
+
+      /**
+       * The number of usage units by which to discount the price this adjustment applies
+       * to in a given billing period.
+       */
+      usage_discount: number;
     }
 
-    export interface PercentageDiscountAdjustment {
+    export interface PlanPhaseAmountDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'percentage_discount';
+      adjustment_type: 'amount_discount';
+
+      /**
+       * The amount by which to discount the prices this adjustment applies to in a given
+       * billing period.
+       */
+      amount_discount: string;
 
       /**
        * The price IDs that this adjustment applies to.
@@ -5692,12 +5698,6 @@ export namespace SubscriptionUnscheduleFixedFeeQuantityUpdatesResponse {
        */
       is_invoice_level: boolean;
 
-      /**
-       * The percentage (as a value between 0 and 1) by which to discount the price
-       * intervals this adjustment applies to in a given billing period.
-       */
-      percentage_discount: number;
-
       /**
        * The plan phase in which this adjustment is active.
        */
@@ -5709,10 +5709,10 @@ export namespace SubscriptionUnscheduleFixedFeeQuantityUpdatesResponse {
       reason: string | null;
     }
 
-    export interface UsageDiscountAdjustment {
+    export interface PlanPhasePercentageDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'usage_discount';
+      adjustment_type: 'percentage_discount';
 
       /**
        * The price IDs that this adjustment applies to.
@@ -5726,23 +5726,23 @@ export namespace SubscriptionUnscheduleFixedFeeQuantityUpdatesResponse {
       is_invoice_level: boolean;
 
       /**
-       * The plan phase in which this adjustment is active.
+       * The percentage (as a value between 0 and 1) by which to discount the price
+       * intervals this adjustment applies to in a given billing period.
        */
-      plan_phase_order: number | null;
+      percentage_discount: number;
 
       /**
-       * The reason for the adjustment.
+       * The plan phase in which this adjustment is active.
        */
-      reason: string | null;
+      plan_phase_order: number | null;
 
       /**
-       * The number of usage units by which to discount the price this adjustment applies
-       * to in a given billing period.
+       * The reason for the adjustment.
        */
-      usage_discount: number;
+      reason: string | null;
     }
 
-    export interface MinimumAdjustment {
+    export interface PlanPhaseMinimumAdjustment {
       id: string;
 
       adjustment_type: 'minimum';
@@ -5780,7 +5780,7 @@ export namespace SubscriptionUnscheduleFixedFeeQuantityUpdatesResponse {
       reason: string | null;
     }
 
-    export interface MaximumAdjustment {
+    export interface PlanPhaseMaximumAdjustment {
       id: string;
 
       adjustment_type: 'maximum';
@@ -6224,11 +6224,11 @@ export namespace SubscriptionUnschedulePendingPlanChangesResponse {
     id: string;
 
     adjustment:
-      | AdjustmentInterval.AmountDiscountAdjustment
-      | AdjustmentInterval.PercentageDiscountAdjustment
-      | AdjustmentInterval.UsageDiscountAdjustment
-      | AdjustmentInterval.MinimumAdjustment
-      | AdjustmentInterval.MaximumAdjustment;
+      | AdjustmentInterval.PlanPhaseUsageDiscountAdjustment
+      | AdjustmentInterval.PlanPhaseAmountDiscountAdjustment
+      | AdjustmentInterval.PlanPhasePercentageDiscountAdjustment
+      | AdjustmentInterval.PlanPhaseMinimumAdjustment
+      | AdjustmentInterval.PlanPhaseMaximumAdjustment;
 
     /**
      * The price interval IDs that this adjustment applies to.
@@ -6247,16 +6247,10 @@ export namespace SubscriptionUnschedulePendingPlanChangesResponse {
   }
 
   export namespace AdjustmentInterval {
-    export interface AmountDiscountAdjustment {
+    export interface PlanPhaseUsageDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'amount_discount';
-
-      /**
-       * The amount by which to discount the prices this adjustment applies to in a given
-       * billing period.
-       */
-      amount_discount: string;
+      adjustment_type: 'usage_discount';
 
       /**
        * The price IDs that this adjustment applies to.
@@ -6278,12 +6272,24 @@ export namespace SubscriptionUnschedulePendingPlanChangesResponse {
        * The reason for the adjustment.
        */
       reason: string | null;
+
+      /**
+       * The number of usage units by which to discount the price this adjustment applies
+       * to in a given billing period.
+       */
+      usage_discount: number;
     }
 
-    export interface PercentageDiscountAdjustment {
+    export interface PlanPhaseAmountDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'percentage_discount';
+      adjustment_type: 'amount_discount';
+
+      /**
+       * The amount by which to discount the prices this adjustment applies to in a given
+       * billing period.
+       */
+      amount_discount: string;
 
       /**
        * The price IDs that this adjustment applies to.
@@ -6296,12 +6302,6 @@ export namespace SubscriptionUnschedulePendingPlanChangesResponse {
        */
       is_invoice_level: boolean;
 
-      /**
-       * The percentage (as a value between 0 and 1) by which to discount the price
-       * intervals this adjustment applies to in a given billing period.
-       */
-      percentage_discount: number;
-
       /**
        * The plan phase in which this adjustment is active.
        */
@@ -6313,10 +6313,10 @@ export namespace SubscriptionUnschedulePendingPlanChangesResponse {
       reason: string | null;
     }
 
-    export interface UsageDiscountAdjustment {
+    export interface PlanPhasePercentageDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'usage_discount';
+      adjustment_type: 'percentage_discount';
 
       /**
        * The price IDs that this adjustment applies to.
@@ -6329,6 +6329,12 @@ export namespace SubscriptionUnschedulePendingPlanChangesResponse {
        */
       is_invoice_level: boolean;
 
+      /**
+       * The percentage (as a value between 0 and 1) by which to discount the price
+       * intervals this adjustment applies to in a given billing period.
+       */
+      percentage_discount: number;
+
       /**
        * The plan phase in which this adjustment is active.
        */
@@ -6338,15 +6344,9 @@ export namespace SubscriptionUnschedulePendingPlanChangesResponse {
        * The reason for the adjustment.
        */
       reason: string | null;
-
-      /**
-       * The number of usage units by which to discount the price this adjustment applies
-       * to in a given billing period.
-       */
-      usage_discount: number;
     }
 
-    export interface MinimumAdjustment {
+    export interface PlanPhaseMinimumAdjustment {
       id: string;
 
       adjustment_type: 'minimum';
@@ -6384,7 +6384,7 @@ export namespace SubscriptionUnschedulePendingPlanChangesResponse {
       reason: string | null;
     }
 
-    export interface MaximumAdjustment {
+    export interface PlanPhaseMaximumAdjustment {
       id: string;
 
       adjustment_type: 'maximum';
@@ -6828,11 +6828,11 @@ export namespace SubscriptionUpdateFixedFeeQuantityResponse {
     id: string;
 
     adjustment:
-      | AdjustmentInterval.AmountDiscountAdjustment
-      | AdjustmentInterval.PercentageDiscountAdjustment
-      | AdjustmentInterval.UsageDiscountAdjustment
-      | AdjustmentInterval.MinimumAdjustment
-      | AdjustmentInterval.MaximumAdjustment;
+      | AdjustmentInterval.PlanPhaseUsageDiscountAdjustment
+      | AdjustmentInterval.PlanPhaseAmountDiscountAdjustment
+      | AdjustmentInterval.PlanPhasePercentageDiscountAdjustment
+      | AdjustmentInterval.PlanPhaseMinimumAdjustment
+      | AdjustmentInterval.PlanPhaseMaximumAdjustment;
 
     /**
      * The price interval IDs that this adjustment applies to.
@@ -6851,16 +6851,10 @@ export namespace SubscriptionUpdateFixedFeeQuantityResponse {
   }
 
   export namespace AdjustmentInterval {
-    export interface AmountDiscountAdjustment {
+    export interface PlanPhaseUsageDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'amount_discount';
-
-      /**
-       * The amount by which to discount the prices this adjustment applies to in a given
-       * billing period.
-       */
-      amount_discount: string;
+      adjustment_type: 'usage_discount';
 
       /**
        * The price IDs that this adjustment applies to.
@@ -6882,12 +6876,24 @@ export namespace SubscriptionUpdateFixedFeeQuantityResponse {
        * The reason for the adjustment.
        */
       reason: string | null;
+
+      /**
+       * The number of usage units by which to discount the price this adjustment applies
+       * to in a given billing period.
+       */
+      usage_discount: number;
     }
 
-    export interface PercentageDiscountAdjustment {
+    export interface PlanPhaseAmountDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'percentage_discount';
+      adjustment_type: 'amount_discount';
+
+      /**
+       * The amount by which to discount the prices this adjustment applies to in a given
+       * billing period.
+       */
+      amount_discount: string;
 
       /**
        * The price IDs that this adjustment applies to.
@@ -6900,12 +6906,6 @@ export namespace SubscriptionUpdateFixedFeeQuantityResponse {
        */
       is_invoice_level: boolean;
 
-      /**
-       * The percentage (as a value between 0 and 1) by which to discount the price
-       * intervals this adjustment applies to in a given billing period.
-       */
-      percentage_discount: number;
-
       /**
        * The plan phase in which this adjustment is active.
        */
@@ -6917,10 +6917,10 @@ export namespace SubscriptionUpdateFixedFeeQuantityResponse {
       reason: string | null;
     }
 
-    export interface UsageDiscountAdjustment {
+    export interface PlanPhasePercentageDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'usage_discount';
+      adjustment_type: 'percentage_discount';
 
       /**
        * The price IDs that this adjustment applies to.
@@ -6933,6 +6933,12 @@ export namespace SubscriptionUpdateFixedFeeQuantityResponse {
        */
       is_invoice_level: boolean;
 
+      /**
+       * The percentage (as a value between 0 and 1) by which to discount the price
+       * intervals this adjustment applies to in a given billing period.
+       */
+      percentage_discount: number;
+
       /**
        * The plan phase in which this adjustment is active.
        */
@@ -6942,15 +6948,9 @@ export namespace SubscriptionUpdateFixedFeeQuantityResponse {
        * The reason for the adjustment.
        */
       reason: string | null;
-
-      /**
-       * The number of usage units by which to discount the price this adjustment applies
-       * to in a given billing period.
-       */
-      usage_discount: number;
     }
 
-    export interface MinimumAdjustment {
+    export interface PlanPhaseMinimumAdjustment {
       id: string;
 
       adjustment_type: 'minimum';
@@ -6988,7 +6988,7 @@ export namespace SubscriptionUpdateFixedFeeQuantityResponse {
       reason: string | null;
     }
 
-    export interface MaximumAdjustment {
+    export interface PlanPhaseMaximumAdjustment {
       id: string;
 
       adjustment_type: 'maximum';
@@ -7432,11 +7432,11 @@ export namespace SubscriptionUpdateTrialResponse {
     id: string;
 
     adjustment:
-      | AdjustmentInterval.AmountDiscountAdjustment
-      | AdjustmentInterval.PercentageDiscountAdjustment
-      | AdjustmentInterval.UsageDiscountAdjustment
-      | AdjustmentInterval.MinimumAdjustment
-      | AdjustmentInterval.MaximumAdjustment;
+      | AdjustmentInterval.PlanPhaseUsageDiscountAdjustment
+      | AdjustmentInterval.PlanPhaseAmountDiscountAdjustment
+      | AdjustmentInterval.PlanPhasePercentageDiscountAdjustment
+      | AdjustmentInterval.PlanPhaseMinimumAdjustment
+      | AdjustmentInterval.PlanPhaseMaximumAdjustment;
 
     /**
      * The price interval IDs that this adjustment applies to.
@@ -7455,16 +7455,10 @@ export namespace SubscriptionUpdateTrialResponse {
   }
 
   export namespace AdjustmentInterval {
-    export interface AmountDiscountAdjustment {
+    export interface PlanPhaseUsageDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'amount_discount';
-
-      /**
-       * The amount by which to discount the prices this adjustment applies to in a given
-       * billing period.
-       */
-      amount_discount: string;
+      adjustment_type: 'usage_discount';
 
       /**
        * The price IDs that this adjustment applies to.
@@ -7486,12 +7480,24 @@ export namespace SubscriptionUpdateTrialResponse {
        * The reason for the adjustment.
        */
       reason: string | null;
+
+      /**
+       * The number of usage units by which to discount the price this adjustment applies
+       * to in a given billing period.
+       */
+      usage_discount: number;
     }
 
-    export interface PercentageDiscountAdjustment {
+    export interface PlanPhaseAmountDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'percentage_discount';
+      adjustment_type: 'amount_discount';
+
+      /**
+       * The amount by which to discount the prices this adjustment applies to in a given
+       * billing period.
+       */
+      amount_discount: string;
 
       /**
        * The price IDs that this adjustment applies to.
@@ -7504,12 +7510,6 @@ export namespace SubscriptionUpdateTrialResponse {
        */
       is_invoice_level: boolean;
 
-      /**
-       * The percentage (as a value between 0 and 1) by which to discount the price
-       * intervals this adjustment applies to in a given billing period.
-       */
-      percentage_discount: number;
-
       /**
        * The plan phase in which this adjustment is active.
        */
@@ -7521,10 +7521,10 @@ export namespace SubscriptionUpdateTrialResponse {
       reason: string | null;
     }
 
-    export interface UsageDiscountAdjustment {
+    export interface PlanPhasePercentageDiscountAdjustment {
       id: string;
 
-      adjustment_type: 'usage_discount';
+      adjustment_type: 'percentage_discount';
 
       /**
        * The price IDs that this adjustment applies to.
@@ -7537,6 +7537,12 @@ export namespace SubscriptionUpdateTrialResponse {
        */
       is_invoice_level: boolean;
 
+      /**
+       * The percentage (as a value between 0 and 1) by which to discount the price
+       * intervals this adjustment applies to in a given billing period.
+       */
+      percentage_discount: number;
+
       /**
        * The plan phase in which this adjustment is active.
        */
@@ -7546,15 +7552,9 @@ export namespace SubscriptionUpdateTrialResponse {
        * The reason for the adjustment.
        */
       reason: string | null;
-
-      /**
-       * The number of usage units by which to discount the price this adjustment applies
-       * to in a given billing period.
-       */
-      usage_discount: number;
     }
 
-    export interface MinimumAdjustment {
+    export interface PlanPhaseMinimumAdjustment {
       id: string;
 
       adjustment_type: 'minimum';
@@ -7592,7 +7592,7 @@ export namespace SubscriptionUpdateTrialResponse {
       reason: string | null;
     }
 
-    export interface MaximumAdjustment {
+    export interface PlanPhaseMaximumAdjustment {
       id: string;
 
       adjustment_type: 'maximum';
@@ -8046,8 +8046,7 @@ export namespace SubscriptionCreateParams {
 
     /**
      * The end date of the adjustment interval. This is the date that the adjustment
-     * will stop affecting prices on the subscription. If null, the adjustment will
-     * start when the phase or subscription starts.
+     * will stop affecting prices on the subscription.
      */
     end_date?: string | null;
 
@@ -8157,6 +8156,11 @@ export namespace SubscriptionCreateParams {
   }
 
   export interface AddPrice {
+    /**
+     * The definition of a new allocation price to create and add to the subscription.
+     */
+    allocation_price?: AddPrice.AllocationPrice | null;
+
     /**
      * @deprecated [DEPRECATED] Use add_adjustments instead. The subscription's
      * discounts for this price.
@@ -8230,6 +8234,33 @@ export namespace SubscriptionCreateParams {
   }
 
   export namespace AddPrice {
+    /**
+     * The definition of a new allocation price to create and add to the subscription.
+     */
+    export interface AllocationPrice {
+      /**
+       * An amount of the currency to allocate to the customer at the specified cadence.
+       */
+      amount: string;
+
+      /**
+       * The cadence at which to allocate the amount to the customer.
+       */
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
+
+      /**
+       * An ISO 4217 currency string or a custom pricing unit identifier in which to bill
+       * this price.
+       */
+      currency: string;
+
+      /**
+       * Whether the allocated amount should expire at the end of the cadence or roll
+       * over to the next period.
+       */
+      expires_at_end_of_cadence: boolean;
+    }
+
     export interface Discount {
       discount_type: 'percentage' | 'usage' | 'amount';
 
@@ -10722,6 +10753,11 @@ export namespace SubscriptionCreateParams {
      */
     replaces_price_id: string;
 
+    /**
+     * The definition of a new allocation price to create and add to the subscription.
+     */
+    allocation_price?: ReplacePrice.AllocationPrice | null;
+
     /**
      * @deprecated [DEPRECATED] Use add_adjustments instead. The subscription's
      * discounts for the replacement price.
@@ -10781,6 +10817,33 @@ export namespace SubscriptionCreateParams {
   }
 
   export namespace ReplacePrice {
+    /**
+     * The definition of a new allocation price to create and add to the subscription.
+     */
+    export interface AllocationPrice {
+      /**
+       * An amount of the currency to allocate to the customer at the specified cadence.
+       */
+      amount: string;
+
+      /**
+       * The cadence at which to allocate the amount to the customer.
+       */
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
+
+      /**
+       * An ISO 4217 currency string or a custom pricing unit identifier in which to bill
+       * this price.
+       */
+      currency: string;
+
+      /**
+       * Whether the allocated amount should expire at the end of the cadence or roll
+       * over to the next period.
+       */
+      expires_at_end_of_cadence: boolean;
+    }
+
     export interface Discount {
       discount_type: 'percentage' | 'usage' | 'amount';
 
@@ -17018,8 +17081,7 @@ export namespace SubscriptionSchedulePlanChangeParams {
 
     /**
      * The end date of the adjustment interval. This is the date that the adjustment
-     * will stop affecting prices on the subscription. If null, the adjustment will
-     * start when the phase or subscription starts.
+     * will stop affecting prices on the subscription.
      */
     end_date?: string | null;
 
@@ -17129,6 +17191,11 @@ export namespace SubscriptionSchedulePlanChangeParams {
   }
 
   export interface AddPrice {
+    /**
+     * The definition of a new allocation price to create and add to the subscription.
+     */
+    allocation_price?: AddPrice.AllocationPrice | null;
+
     /**
      * @deprecated [DEPRECATED] Use add_adjustments instead. The subscription's
      * discounts for this price.
@@ -17202,6 +17269,33 @@ export namespace SubscriptionSchedulePlanChangeParams {
   }
 
   export namespace AddPrice {
+    /**
+     * The definition of a new allocation price to create and add to the subscription.
+     */
+    export interface AllocationPrice {
+      /**
+       * An amount of the currency to allocate to the customer at the specified cadence.
+       */
+      amount: string;
+
+      /**
+       * The cadence at which to allocate the amount to the customer.
+       */
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
+
+      /**
+       * An ISO 4217 currency string or a custom pricing unit identifier in which to bill
+       * this price.
+       */
+      currency: string;
+
+      /**
+       * Whether the allocated amount should expire at the end of the cadence or roll
+       * over to the next period.
+       */
+      expires_at_end_of_cadence: boolean;
+    }
+
     export interface Discount {
       discount_type: 'percentage' | 'usage' | 'amount';
 
@@ -19694,6 +19788,11 @@ export namespace SubscriptionSchedulePlanChangeParams {
      */
     replaces_price_id: string;
 
+    /**
+     * The definition of a new allocation price to create and add to the subscription.
+     */
+    allocation_price?: ReplacePrice.AllocationPrice | null;
+
     /**
      * @deprecated [DEPRECATED] Use add_adjustments instead. The subscription's
      * discounts for the replacement price.
@@ -19753,6 +19852,33 @@ export namespace SubscriptionSchedulePlanChangeParams {
   }
 
   export namespace ReplacePrice {
+    /**
+     * The definition of a new allocation price to create and add to the subscription.
+     */
+    export interface AllocationPrice {
+      /**
+       * An amount of the currency to allocate to the customer at the specified cadence.
+       */
+      amount: string;
+
+      /**
+       * The cadence at which to allocate the amount to the customer.
+       */
+      cadence: 'one_time' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual' | 'custom';
+
+      /**
+       * An ISO 4217 currency string or a custom pricing unit identifier in which to bill
+       * this price.
+       */
+      currency: string;
+
+      /**
+       * Whether the allocated amount should expire at the end of the cadence or roll
+       * over to the next period.
+       */
+      expires_at_end_of_cadence: boolean;
+    }
+
     export interface Discount {
       discount_type: 'percentage' | 'usage' | 'amount';