@metronome/sdk 3.6.0 → 3.8.0

package/resources/shared.d.mts

@@ -80,6 +80,11 @@ export interface Commit {
      */
     balance?: number;
     contract?: Commit.Contract;
+    /**
+     * The actor who created this commit. Omitted for system-generated commits such as
+     * recurring commits, rollover commits, and threshold commits.
+     */
+    created_by?: string;
     /**
      * Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
      */
@@ -132,6 +137,10 @@ export interface Commit {
      * specifiers to contribute to a commit's or credit's drawdown.
      */
     specifiers?: Array<CommitSpecifier>;
+    /**
+     * Optional attributes controlling how this commit interacts with spend trackers.
+     */
+    spend_tracker_attributes?: Commit.SpendTrackerAttributes;
     /**
      * The subscription configuration for this commit, if it was generated from a
      * recurring commit with a subscription attached.
@@ -256,6 +265,16 @@ export declare namespace Commit {
         commit_id: string;
         contract_id: string;
     }
+    /**
+     * Optional attributes controlling how this commit interacts with spend trackers.
+     */
+    interface SpendTrackerAttributes {
+        /**
+         * If true, this commit is included in spend trackers with discounted set to
+         * DISCOUNTED_ONLY
+         */
+        counts_as_discounted: boolean;
+    }
     /**
      * The subscription configuration for this commit, if it was generated from a
      * recurring commit with a subscription attached.
@@ -383,6 +402,10 @@ export interface Contract {
      */
     scheduled_charges_on_usage_invoices?: 'ALL';
     spend_threshold_configuration?: SpendThresholdConfiguration;
+    /**
+     * Spend trackers attached to this contract.
+     */
+    spend_trackers?: Array<Contract.SpendTracker>;
     /**
      * List of subscriptions on the contract.
      */
@@ -456,6 +479,28 @@ export declare namespace Contract {
             [key: string]: unknown;
         };
     }
+    interface SpendTracker {
+        /**
+         * Human-readable identifier, unique per contract.
+         */
+        alias: string;
+        applicable_spend_specifiers: Array<SpendTracker.ApplicableSpendSpecifier>;
+        credit_type_id: string;
+        reset_frequency: 'BILLING_PERIOD';
+        accumulated_spend?: SpendTracker.AccumulatedSpend;
+    }
+    namespace SpendTracker {
+        interface ApplicableSpendSpecifier {
+            sources: Array<'THRESHOLD_RECHARGE' | 'MANUAL'>;
+            spend_type: 'COMMIT_PURCHASE';
+            discounted?: 'ANY' | 'DISCOUNTED_ONLY' | 'UNDISCOUNTED_ONLY';
+        }
+        interface AccumulatedSpend {
+            amount: number;
+            period_ending_before: string;
+            period_starting_at: string;
+        }
+    }
 }
 export interface ContractV2 {
     id: string;
@@ -538,6 +583,10 @@ export interface ContractV2 {
      */
     scheduled_charges_on_usage_invoices?: 'ALL';
     spend_threshold_configuration?: SpendThresholdConfigurationV2;
+    /**
+     * Spend trackers attached to this contract.
+     */
+    spend_trackers?: Array<ContractV2.SpendTracker>;
     /**
      * List of subscriptions on the contract.
      */
@@ -582,6 +631,11 @@ export declare namespace ContractV2 {
          */
         balance?: number;
         contract?: Commit.Contract;
+        /**
+         * The actor who created this commit. Omitted for system-generated commits such as
+         * recurring commits, rollover commits, and threshold commits.
+         */
+        created_by?: string;
         /**
          * Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
          */
@@ -633,6 +687,10 @@ export declare namespace ContractV2 {
          * specifiers to contribute to a commit's or credit's drawdown.
          */
         specifiers?: Array<Shared.CommitSpecifier>;
+        /**
+         * Optional attributes controlling how this commit interacts with spend trackers.
+         */
+        spend_tracker_attributes?: Commit.SpendTrackerAttributes;
         /**
          * Attach a subscription to the recurring commit/credit.
          */
@@ -749,6 +807,16 @@ export declare namespace ContractV2 {
             commit_id: string;
             contract_id: string;
         }
+        /**
+         * Optional attributes controlling how this commit interacts with spend trackers.
+         */
+        interface SpendTrackerAttributes {
+            /**
+             * If true, this commit is included in spend trackers with discounted set to
+             * DISCOUNTED_ONLY
+             */
+            counts_as_discounted: boolean;
+        }
     }
     interface Override {
         id: string;
@@ -769,6 +837,7 @@ export declare namespace ContractV2 {
     }
     namespace Override {
         interface OverrideSpecifier {
+            any_commit_or_credit_ids?: Array<string>;
             billing_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
             commit_ids?: Array<string>;
             presentation_group_values?: {
@@ -872,6 +941,11 @@ export declare namespace ContractV2 {
          *   start date
          */
         created_at?: string;
+        /**
+         * The actor who created this credit. Omitted for system-generated credits such as
+         * recurring credits.
+         */
+        created_by?: string;
         /**
          * Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
          */
@@ -1133,6 +1207,10 @@ export declare namespace ContractV2 {
          * the default is FIRST_AND_LAST (i.e. prorate both the first and last commits).
          */
         proration?: 'NONE' | 'FIRST' | 'LAST' | 'FIRST_AND_LAST';
+        /**
+         * Rounding configuration for prorated recurring commit amounts.
+         */
+        proration_rounding?: RecurringCommit.ProrationRounding | null;
         /**
          * The frequency at which the recurring commits will be created. If not provided: -
          * The commits will be created on the usage invoice frequency. If provided: - The
@@ -1140,7 +1218,7 @@ export declare namespace ContractV2 {
          * be created aligned with the recurring commit's starting_at rather than the usage
          * invoice dates.
          */
-        recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
+        recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY' | 'DAILY';
         /**
          * Will be passed down to the individual commits. This controls how much of an
          * individual unexpired commit will roll over upon contract transition. Must be
@@ -1189,6 +1267,33 @@ export declare namespace ContractV2 {
             quantity: number;
             unit_price: number;
         }
+        /**
+         * Rounding configuration for prorated recurring commit amounts.
+         */
+        interface ProrationRounding {
+            access?: ProrationRounding.Access;
+            invoice?: ProrationRounding.Invoice;
+        }
+        namespace ProrationRounding {
+            interface Access {
+                /**
+                 * Number of decimal places to round to. Applied directly to the stored monetary
+                 * representation. Negative values round to powers of 10 (e.g., -2 rounds to
+                 * nearest 100 in the stored unit).
+                 */
+                decimal_places: number;
+                rounding_method: 'HALF_UP' | 'FLOOR' | 'CEILING';
+            }
+            interface Invoice {
+                /**
+                 * Number of decimal places to round to. Applied directly to the stored monetary
+                 * representation. Negative values round to powers of 10 (e.g., -2 rounds to
+                 * nearest 100 in the stored unit).
+                 */
+                decimal_places: number;
+                rounding_method: 'HALF_UP' | 'FLOOR' | 'CEILING';
+            }
+        }
     }
     interface RecurringCredit {
         id: string;
@@ -1247,6 +1352,10 @@ export declare namespace ContractV2 {
          * the default is FIRST_AND_LAST (i.e. prorate both the first and last commits).
          */
         proration?: 'NONE' | 'FIRST' | 'LAST' | 'FIRST_AND_LAST';
+        /**
+         * Rounding configuration for prorated recurring credit amounts.
+         */
+        proration_rounding?: RecurringCredit.ProrationRounding | null;
         /**
          * The frequency at which the recurring commits will be created. If not provided: -
          * The commits will be created on the usage invoice frequency. If provided: - The
@@ -1254,7 +1363,7 @@ export declare namespace ContractV2 {
          * be created aligned with the recurring commit's starting_at rather than the usage
          * invoice dates.
          */
-        recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
+        recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY' | 'DAILY';
         /**
          * Will be passed down to the individual commits. This controls how much of an
          * individual unexpired commit will roll over upon contract transition. Must be
@@ -1295,6 +1404,23 @@ export declare namespace ContractV2 {
         interface Contract {
             id: string;
         }
+        /**
+         * Rounding configuration for prorated recurring credit amounts.
+         */
+        interface ProrationRounding {
+            access?: ProrationRounding.Access;
+        }
+        namespace ProrationRounding {
+            interface Access {
+                /**
+                 * Number of decimal places to round to. Applied directly to the stored monetary
+                 * representation. Negative values round to powers of 10 (e.g., -2 rounds to
+                 * nearest 100 in the stored unit).
+                 */
+                decimal_places: number;
+                rounding_method: 'HALF_UP' | 'FLOOR' | 'CEILING';
+            }
+        }
     }
     interface ResellerRoyalty {
         reseller_type: 'AWS' | 'AWS_PRO_SERVICE' | 'GCP' | 'GCP_PRO_SERVICE';
@@ -1317,6 +1443,28 @@ export declare namespace ContractV2 {
             reseller_contract_value?: number;
         }
     }
+    interface SpendTracker {
+        /**
+         * Human-readable identifier, unique per contract.
+         */
+        alias: string;
+        applicable_spend_specifiers: Array<SpendTracker.ApplicableSpendSpecifier>;
+        credit_type_id: string;
+        reset_frequency: 'BILLING_PERIOD';
+        accumulated_spend?: SpendTracker.AccumulatedSpend;
+    }
+    namespace SpendTracker {
+        interface ApplicableSpendSpecifier {
+            sources: Array<'THRESHOLD_RECHARGE' | 'MANUAL'>;
+            spend_type: 'COMMIT_PURCHASE';
+            discounted?: 'ANY' | 'DISCOUNTED_ONLY' | 'UNDISCOUNTED_ONLY';
+        }
+        interface AccumulatedSpend {
+            amount: number;
+            period_ending_before: string;
+            period_starting_at: string;
+        }
+    }
     interface Subscription {
         /**
          * Previous, current, and next billing periods for the subscription.
@@ -1344,6 +1492,7 @@ export declare namespace ContractV2 {
         starting_at: string;
         subscription_rate: Subscription.SubscriptionRate;
         id?: string;
+        billing_cycle_config?: Subscription.BillingCycleConfig;
         /**
          * Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
          */
@@ -1382,6 +1531,18 @@ export declare namespace ContractV2 {
         interface Proration {
             invoice_behavior: 'BILL_IMMEDIATELY' | 'BILL_ON_NEXT_COLLECTION_DATE';
             is_prorated: boolean;
+            rounding?: Proration.Rounding;
+        }
+        namespace Proration {
+            interface Rounding {
+                /**
+                 * Number of decimal places to round to. Applied directly to the stored monetary
+                 * representation. Negative values round to powers of 10 (e.g., -2 rounds to
+                 * nearest 100 in the stored unit).
+                 */
+                decimal_places: number;
+                rounding_method: 'HALF_UP' | 'FLOOR' | 'CEILING';
+            }
         }
         interface QuantitySchedule {
             quantity: number;
@@ -1398,6 +1559,17 @@ export declare namespace ContractV2 {
                 name: string;
             }
         }
+        interface BillingCycleConfig {
+            /**
+             * The date this subscription's billing cycle is anchored to.
+             */
+            anchor_date: string;
+            /**
+             * Controls whether this subscription consolidates onto usage invoices or gets its
+             * own scheduled invoice.
+             */
+            invoice_placement: 'ON_SCHEDULED_INVOICE' | 'ON_USAGE_INVOICE';
+        }
         interface SeatConfig {
             /**
              * The property name, sent on usage events, that identifies the seat ID associated
@@ -1462,6 +1634,10 @@ export interface ContractWithoutAmendments {
      */
     scheduled_charges_on_usage_invoices?: 'ALL';
     spend_threshold_configuration?: SpendThresholdConfiguration;
+    /**
+     * Spend trackers attached to this contract.
+     */
+    spend_trackers?: Array<ContractWithoutAmendments.SpendTracker>;
     /**
      * This field's availability is dependent on your client's configuration.
      */
@@ -1542,6 +1718,10 @@ export declare namespace ContractWithoutAmendments {
          * the default is FIRST_AND_LAST (i.e. prorate both the first and last commits).
          */
         proration?: 'NONE' | 'FIRST' | 'LAST' | 'FIRST_AND_LAST';
+        /**
+         * Rounding configuration for prorated recurring commit amounts.
+         */
+        proration_rounding?: RecurringCommit.ProrationRounding | null;
         /**
          * The frequency at which the recurring commits will be created. If not provided: -
          * The commits will be created on the usage invoice frequency. If provided: - The
@@ -1549,7 +1729,7 @@ export declare namespace ContractWithoutAmendments {
          * be created aligned with the recurring commit's starting_at rather than the usage
          * invoice dates.
          */
-        recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
+        recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY' | 'DAILY';
         /**
          * Will be passed down to the individual commits. This controls how much of an
          * individual unexpired commit will roll over upon contract transition. Must be
@@ -1598,6 +1778,35 @@ export declare namespace ContractWithoutAmendments {
             quantity: number;
             unit_price: number;
         }
+        /**
+         * Rounding configuration for prorated recurring commit amounts.
+         */
+        interface ProrationRounding {
+            access?: ProrationRounding.Access;
+            invoice?: ProrationRounding.Invoice;
+        }
+        namespace ProrationRounding {
+            interface Access {
+                /**
+                 * Number of decimal places to round to. Applied directly to the stored monetary
+                 * representation. Negative values round to powers of 10 (e.g., -2 rounds to
+                 * nearest 100 in the stored unit. For USD, this means rounding to the nearest
+                 * dollar).
+                 */
+                decimal_places: number;
+                rounding_method: 'HALF_UP' | 'FLOOR' | 'CEILING';
+            }
+            interface Invoice {
+                /**
+                 * Number of decimal places to round to. Applied directly to the stored monetary
+                 * representation. Negative values round to powers of 10 (e.g., -2 rounds to
+                 * nearest 100 in the stored unit. For USD, this means rounding to the nearest
+                 * dollar).
+                 */
+                decimal_places: number;
+                rounding_method: 'HALF_UP' | 'FLOOR' | 'CEILING';
+            }
+        }
     }
     interface RecurringCredit {
         id: string;
@@ -1656,6 +1865,10 @@ export declare namespace ContractWithoutAmendments {
          * the default is FIRST_AND_LAST (i.e. prorate both the first and last commits).
          */
         proration?: 'NONE' | 'FIRST' | 'LAST' | 'FIRST_AND_LAST';
+        /**
+         * Rounding configuration for prorated recurring credit amounts.
+         */
+        proration_rounding?: RecurringCredit.ProrationRounding | null;
         /**
          * The frequency at which the recurring commits will be created. If not provided: -
          * The commits will be created on the usage invoice frequency. If provided: - The
@@ -1663,7 +1876,7 @@ export declare namespace ContractWithoutAmendments {
          * be created aligned with the recurring commit's starting_at rather than the usage
          * invoice dates.
          */
-        recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
+        recurrence_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY' | 'DAILY';
         /**
          * Will be passed down to the individual commits. This controls how much of an
          * individual unexpired commit will roll over upon contract transition. Must be
@@ -1704,6 +1917,24 @@ export declare namespace ContractWithoutAmendments {
         interface Contract {
             id: string;
         }
+        /**
+         * Rounding configuration for prorated recurring credit amounts.
+         */
+        interface ProrationRounding {
+            access?: ProrationRounding.Access;
+        }
+        namespace ProrationRounding {
+            interface Access {
+                /**
+                 * Number of decimal places to round to. Applied directly to the stored monetary
+                 * representation. Negative values round to powers of 10 (e.g., -2 rounds to
+                 * nearest 100 in the stored unit. For USD, this means rounding to the nearest
+                 * dollar).
+                 */
+                decimal_places: number;
+                rounding_method: 'HALF_UP' | 'FLOOR' | 'CEILING';
+            }
+        }
     }
     interface ResellerRoyalty {
         fraction: number;
@@ -1720,6 +1951,28 @@ export declare namespace ContractWithoutAmendments {
         gcp_offer_id?: string;
         reseller_contract_value?: number;
     }
+    interface SpendTracker {
+        /**
+         * Human-readable identifier, unique per contract.
+         */
+        alias: string;
+        applicable_spend_specifiers: Array<SpendTracker.ApplicableSpendSpecifier>;
+        credit_type_id: string;
+        reset_frequency: 'BILLING_PERIOD';
+        accumulated_spend?: SpendTracker.AccumulatedSpend;
+    }
+    namespace SpendTracker {
+        interface ApplicableSpendSpecifier {
+            sources: Array<'THRESHOLD_RECHARGE' | 'MANUAL'>;
+            spend_type: 'COMMIT_PURCHASE';
+            discounted?: 'ANY' | 'DISCOUNTED_ONLY' | 'UNDISCOUNTED_ONLY';
+        }
+        interface AccumulatedSpend {
+            amount: number;
+            period_ending_before: string;
+            period_starting_at: string;
+        }
+    }
     interface UsageFilter {
         current: Shared.BaseUsageFilter | null;
         initial: Shared.BaseUsageFilter;
@@ -1756,6 +2009,11 @@ export interface Credit {
      */
     balance?: number;
     contract?: Credit.Contract;
+    /**
+     * The actor who created this credit. Omitted for system-generated credits such as
+     * recurring credits.
+     */
+    created_by?: string;
     /**
      * Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
      */
@@ -2055,6 +2313,7 @@ export interface Override {
 }
 export declare namespace Override {
     interface OverrideSpecifier {
+        any_commit_or_credit_ids?: Array<string>;
         billing_frequency?: 'MONTHLY' | 'QUARTERLY' | 'ANNUAL' | 'WEEKLY';
         commit_ids?: Array<string>;
         presentation_group_values?: {
@@ -2241,6 +2500,11 @@ export interface PrepaidBalanceThresholdConfiguration {
      */
     custom_credit_type_id?: string;
     discount_configuration?: PrepaidBalanceThresholdConfiguration.DiscountConfiguration;
+    /**
+     * Determines which balances are excluded from remaining balance calculation for
+     * threshold billing.
+     */
+    threshold_balance_specifiers?: Array<PrepaidBalanceThresholdConfiguration.ThresholdBalanceSpecifier>;
 }
 export declare namespace PrepaidBalanceThresholdConfiguration {
     interface Commit extends Shared.BaseThresholdCommit {
@@ -2271,6 +2535,50 @@ export declare namespace PrepaidBalanceThresholdConfiguration {
          * (a 15% discount).
          */
         payment_fraction: number;
+        /**
+         * If provided, the discount stops applying once the spend tracker has accumulated
+         * this much spend in the billing period.
+         */
+        cap?: DiscountConfiguration.Cap;
+    }
+    namespace DiscountConfiguration {
+        /**
+         * If provided, the discount stops applying once the spend tracker has accumulated
+         * this much spend in the billing period.
+         */
+        interface Cap {
+            /**
+             * Accumulated spend ceiling above which the discount stops applying.
+             */
+            amount: number;
+            /**
+             * Alias of the spend tracker this cap is measured against.
+             */
+            spend_tracker_alias: string;
+        }
+    }
+    interface ThresholdBalanceSpecifier {
+        /**
+         * If any of the exclude specifier is met, the balance is not considered when
+         * evaluating threshold billing
+         */
+        exclude: Array<ThresholdBalanceSpecifier.Exclude>;
+    }
+    namespace ThresholdBalanceSpecifier {
+        interface Exclude {
+            /**
+             * If provided, balances with all the custom fields will not be considered when
+             * evaluating threshold billing
+             */
+            custom_field_filters: Array<Exclude.CustomFieldFilter>;
+        }
+        namespace Exclude {
+            interface CustomFieldFilter {
+                entity: 'Commit' | 'ContractCredit' | 'ContractCreditOrCommit';
+                key: string;
+                value: string;
+            }
+        }
     }
 }
 export interface PrepaidBalanceThresholdConfigurationV2 {
@@ -2297,6 +2605,11 @@ export interface PrepaidBalanceThresholdConfigurationV2 {
      */
     custom_credit_type_id?: string;
     discount_configuration?: PrepaidBalanceThresholdConfigurationV2.DiscountConfiguration;
+    /**
+     * Determines which balances are excluded from remaining balance calculation for
+     * threshold billing.
+     */
+    threshold_balance_specifiers?: Array<PrepaidBalanceThresholdConfigurationV2.ThresholdBalanceSpecifier>;
 }
 export declare namespace PrepaidBalanceThresholdConfigurationV2 {
     interface Commit extends Shared.BaseThresholdCommit {
@@ -2329,6 +2642,42 @@ export declare namespace PrepaidBalanceThresholdConfigurationV2 {
          * (a 15% discount).
          */
         payment_fraction: number;
+        /**
+         * If provided, the discount stops applying once the spend tracker has accumulated
+         * this much spend in the billing period.
+         */
+        cap?: DiscountConfiguration.Cap;
+    }
+    namespace DiscountConfiguration {
+        /**
+         * If provided, the discount stops applying once the spend tracker has accumulated
+         * this much spend in the billing period.
+         */
+        interface Cap {
+            /**
+             * Accumulated spend ceiling above which the discount stops applying.
+             */
+            amount: number;
+            /**
+             * Alias of the spend tracker this cap is measured against.
+             */
+            spend_tracker_alias: string;
+        }
+    }
+    interface ThresholdBalanceSpecifier {
+        exclude: Array<ThresholdBalanceSpecifier.Exclude>;
+    }
+    namespace ThresholdBalanceSpecifier {
+        interface Exclude {
+            custom_field_filters: Array<Exclude.CustomFieldFilter>;
+        }
+        namespace Exclude {
+            interface CustomFieldFilter {
+                entity: 'Commit' | 'ContractCredit' | 'ContractCreditOrCommit';
+                key: string;
+                value: string;
+            }
+        }
     }
 }
 export interface PropertyFilter {
@@ -2517,6 +2866,27 @@ export declare namespace SpendThresholdConfiguration {
          * (a 15% discount).
          */
         payment_fraction: number;
+        /**
+         * If provided, the discount stops applying once the spend tracker has accumulated
+         * this much spend in the billing period.
+         */
+        cap?: DiscountConfiguration.Cap;
+    }
+    namespace DiscountConfiguration {
+        /**
+         * If provided, the discount stops applying once the spend tracker has accumulated
+         * this much spend in the billing period.
+         */
+        interface Cap {
+            /**
+             * Accumulated spend ceiling above which the discount stops applying.
+             */
+            amount: number;
+            /**
+             * Alias of the spend tracker this cap is measured against.
+             */
+            spend_tracker_alias: string;
+        }
     }
 }
 export interface SpendThresholdConfigurationV2 {
@@ -2543,6 +2913,27 @@ export declare namespace SpendThresholdConfigurationV2 {
          * (a 15% discount).
          */
         payment_fraction: number;
+        /**
+         * If provided, the discount stops applying once the spend tracker has accumulated
+         * this much spend in the billing period.
+         */
+        cap?: DiscountConfiguration.Cap;
+    }
+    namespace DiscountConfiguration {
+        /**
+         * If provided, the discount stops applying once the spend tracker has accumulated
+         * this much spend in the billing period.
+         */
+        interface Cap {
+            /**
+             * Accumulated spend ceiling above which the discount stops applying.
+             */
+            amount: number;
+            /**
+             * Alias of the spend tracker this cap is measured against.
+             */
+            spend_tracker_alias: string;
+        }
     }
 }
 export interface Subscription {
@@ -2572,6 +2963,7 @@ export interface Subscription {
     starting_at: string;
     subscription_rate: Subscription.SubscriptionRate;
     id?: string;
+    billing_cycle_config?: Subscription.BillingCycleConfig;
     /**
      * Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
      */
@@ -2610,6 +3002,19 @@ export declare namespace Subscription {
     interface Proration {
         invoice_behavior: 'BILL_IMMEDIATELY' | 'BILL_ON_NEXT_COLLECTION_DATE';
         is_prorated: boolean;
+        rounding?: Proration.Rounding;
+    }
+    namespace Proration {
+        interface Rounding {
+            /**
+             * Number of decimal places to round to. Applied directly to the stored monetary
+             * representation. Negative values round to powers of 10 (e.g., -2 rounds to
+             * nearest 100 in the stored unit. For USD, this means rounding to the nearest
+             * dollar).
+             */
+            decimal_places: number;
+            rounding_method: 'HALF_UP' | 'FLOOR' | 'CEILING';
+        }
     }
     interface QuantitySchedule {
         quantity: number;
@@ -2626,6 +3031,17 @@ export declare namespace Subscription {
             name: string;
         }
     }
+    interface BillingCycleConfig {
+        /**
+         * The date this subscription's billing cycle is anchored to.
+         */
+        anchor_date: string;
+        /**
+         * Controls whether this subscription consolidates onto usage invoices or gets its
+         * own scheduled invoice.
+         */
+        invoice_placement: 'ON_SCHEDULED_INVOICE' | 'ON_USAGE_INVOICE';
+    }
     interface SeatConfig {
         /**
          * The property name, sent on usage events, that identifies the seat ID associated