@stigg/typescript 0.1.0-alpha.2 → 0.1.0-alpha.4

package/src/resources/v1/subscriptions/subscriptions.ts

@@ -2,11 +2,7 @@
 
 import { APIResource } from '../../../core/resource';
 import * as FutureUpdateAPI from './future-update';
-import {
-  FutureUpdate,
-  FutureUpdateCancelPendingPaymentResponse,
-  FutureUpdateCancelScheduleResponse,
-} from './future-update';
+import { CancelSubscription, FutureUpdate } from './future-update';
 import { APIPromise } from '../../../core/api-promise';
 import { MyCursorIDPage, type MyCursorIDPageParams, PagePromise } from '../../../core/pagination';
 import { RequestOptions } from '../../../internal/request-options';
@@ -16,21 +12,21 @@ export class Subscriptions extends APIResource {
   futureUpdate: FutureUpdateAPI.FutureUpdate = new FutureUpdateAPI.FutureUpdate(this._client);
 
   /**
-   * Create a new Subscription
+   * Get a single subscription by ID
    */
-  create(body: SubscriptionCreateParams, options?: RequestOptions): APIPromise<SubscriptionCreateResponse> {
-    return this._client.post('/api/v1/subscriptions', { body, ...options });
+  retrieve(id: string, options?: RequestOptions): APIPromise<Subscription> {
+    return this._client.get(path`/api/v1/subscriptions/${id}`, options);
   }
 
   /**
-   * Get a single Subscription by id
+   * Update a subscription
    */
-  retrieve(id: string, options?: RequestOptions): APIPromise<SubscriptionRetrieveResponse> {
-    return this._client.get(path`/api/v1/subscriptions/${id}`, options);
+  update(id: string, body: SubscriptionUpdateParams, options?: RequestOptions): APIPromise<Subscription> {
+    return this._client.patch(path`/api/v1/subscriptions/${id}`, { body, ...options });
   }
 
   /**
-   * Get a list of Subscriptions
+   * Get a list of subscriptions
    */
   list(
     query: SubscriptionListParams | null | undefined = {},
@@ -43,29 +39,35 @@ export class Subscriptions extends APIResource {
   }
 
   /**
-   * Perform delegate on a Subscription
+   * Cancel subscription
    */
-  delegate(
-    id: string,
-    body: SubscriptionDelegateParams,
-    options?: RequestOptions,
-  ): APIPromise<SubscriptionDelegateResponse> {
+  cancel(id: string, body: SubscriptionCancelParams, options?: RequestOptions): APIPromise<Subscription> {
+    return this._client.post(path`/api/v1/subscriptions/${id}/cancel`, { body, ...options });
+  }
+
+  /**
+   * Delegate subscription payment to customer
+   */
+  delegate(id: string, body: SubscriptionDelegateParams, options?: RequestOptions): APIPromise<Subscription> {
     return this._client.post(path`/api/v1/subscriptions/${id}/delegate`, { body, ...options });
   }
 
   /**
-   * Perform migrate to latest plan version on a Subscription
+   * Bulk import subscriptions
    */
-  migrate(
-    id: string,
-    body: SubscriptionMigrateParams,
-    options?: RequestOptions,
-  ): APIPromise<SubscriptionMigrateResponse> {
+  import(body: SubscriptionImportParams, options?: RequestOptions): APIPromise<SubscriptionImportResponse> {
+    return this._client.post('/api/v1/subscriptions/import', { body, ...options });
+  }
+
+  /**
+   * Migrate subscription to latest plan version
+   */
+  migrate(id: string, body: SubscriptionMigrateParams, options?: RequestOptions): APIPromise<Subscription> {
     return this._client.post(path`/api/v1/subscriptions/${id}/migrate`, { body, ...options });
   }
 
   /**
-   * Create a new Subscription Preview
+   * Preview subscription
    */
   preview(
     body: SubscriptionPreviewParams,
@@ -75,175 +77,39 @@ export class Subscriptions extends APIResource {
   }
 
   /**
-   * Perform transfer to resource on a Subscription
+   * Provision subscription
    */
-  transfer(
-    id: string,
-    body: SubscriptionTransferParams,
+  provision(
+    body: SubscriptionProvisionParams,
     options?: RequestOptions,
-  ): APIPromise<SubscriptionTransferResponse> {
+  ): APIPromise<SubscriptionProvisionResponse> {
+    return this._client.post('/api/v1/subscriptions', { body, ...options });
+  }
+
+  /**
+   * Transfer subscription to resource
+   */
+  transfer(id: string, body: SubscriptionTransferParams, options?: RequestOptions): APIPromise<Subscription> {
     return this._client.post(path`/api/v1/subscriptions/${id}/transfer`, { body, ...options });
   }
 }
 
 export type SubscriptionListResponsesMyCursorIDPage = MyCursorIDPage<SubscriptionListResponse>;
 
-export interface SubscriptionCreateResponse {
-  data: SubscriptionCreateResponse.Data;
-}
-
-export namespace SubscriptionCreateResponse {
-  export interface Data {
-    /**
-     * Unique identifier for the provisioned subscription
-     */
-    id: string;
-
-    /**
-     * Provision status: SUCCESS or PAYMENT_REQUIRED
-     */
-    status: 'SUCCESS' | 'PAYMENT_REQUIRED';
-
-    /**
-     * Checkout billing ID when payment is required
-     */
-    checkoutBillingId?: string | null;
-
-    /**
-     * URL to complete payment when PAYMENT_REQUIRED
-     */
-    checkoutUrl?: string | null;
-
-    /**
-     * Whether the subscription is scheduled for future activation
-     */
-    isScheduled?: boolean;
-
-    subscription?: Data.Subscription;
-  }
-
-  export namespace Data {
-    export interface Subscription {
-      /**
-       * Subscription ID
-       */
-      id: string;
-
-      /**
-       * Billing ID
-       */
-      billingId: string | null;
-
-      /**
-       * Created at
-       */
-      createdAt: string;
-
-      /**
-       * Customer ID
-       */
-      customerId: string;
-
-      /**
-       * Payment collection
-       */
-      paymentCollection: 'NOT_REQUIRED' | 'PROCESSING' | 'FAILED' | 'ACTION_REQUIRED';
-
-      /**
-       * Plan ID
-       */
-      planId: string;
-
-      /**
-       * Pricing type
-       */
-      pricingType: 'FREE' | 'PAID' | 'CUSTOM';
-
-      /**
-       * Subscription start date
-       */
-      startDate: string;
-
-      /**
-       * Subscription status
-       */
-      status: 'PAYMENT_PENDING' | 'ACTIVE' | 'EXPIRED' | 'IN_TRIAL' | 'CANCELED' | 'NOT_STARTED';
-
-      /**
-       * Subscription cancellation date
-       */
-      cancellationDate?: string | null;
-
-      /**
-       * Subscription cancel reason
-       */
-      cancelReason?:
-        | 'UPGRADE_OR_DOWNGRADE'
-        | 'CANCELLED_BY_BILLING'
-        | 'EXPIRED'
-        | 'DETACH_BILLING'
-        | 'TRIAL_ENDED'
-        | 'Immediate'
-        | 'TRIAL_CONVERTED'
-        | 'PENDING_PAYMENT_EXPIRED'
-        | 'ScheduledCancellation'
-        | 'CustomerArchived'
-        | 'AutoCancellationRule'
-        | null;
-
-      /**
-       * End of the current billing period
-       */
-      currentBillingPeriodEnd?: string | null;
-
-      /**
-       * Start of the current billing period
-       */
-      currentBillingPeriodStart?: string | null;
-
-      /**
-       * Subscription effective end date
-       */
-      effectiveEndDate?: string | null;
-
-      /**
-       * Subscription end date
-       */
-      endDate?: string | null;
-
-      /**
-       * Additional metadata for the subscription
-       */
-      metadata?: { [key: string]: string };
-
-      /**
-       * Paying customer ID for delegated billing
-       */
-      payingCustomerId?: string | null;
-
-      /**
-       * The method used to collect payments for a subscription
-       */
-      paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
-
-      /**
-       * Resource ID
-       */
-      resourceId?: string | null;
-
-      /**
-       * Subscription trial end date
-       */
-      trialEndDate?: string | null;
-    }
-  }
-}
-
-export interface SubscriptionRetrieveResponse {
-  data: SubscriptionRetrieveResponse.Data;
+/**
+ * Response object
+ */
+export interface Subscription {
+  /**
+   * Customer subscription to a plan
+   */
+  data: Subscription.Data;
 }
 
-export namespace SubscriptionRetrieveResponse {
+export namespace Subscription {
+  /**
+   * Customer subscription to a plan
+   */
   export interface Data {
     /**
      * Subscription ID
@@ -347,6 +213,8 @@ export namespace SubscriptionRetrieveResponse {
      */
     paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
 
+    prices?: Array<Data.Price>;
+
     /**
      * Resource ID
      */
@@ -357,8 +225,32 @@ export namespace SubscriptionRetrieveResponse {
      */
     trialEndDate?: string | null;
   }
+
+  export namespace Data {
+    export interface Price {
+      /**
+       * Price ID
+       */
+      id: string;
+
+      /**
+       * Creation timestamp
+       */
+      createdAt: string;
+
+      /**
+       * Last update timestamp
+       */
+      updatedAt: string;
+
+      [k: string]: unknown;
+    }
+  }
 }
 
+/**
+ * Customer subscription to a plan
+ */
 export interface SubscriptionListResponse {
   /**
    * Subscription ID
@@ -462,6 +354,8 @@ export interface SubscriptionListResponse {
    */
   paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
 
+  prices?: Array<SubscriptionListResponse.Price>;
+
   /**
    * Resource ID
    */
@@ -473,287 +367,144 @@ export interface SubscriptionListResponse {
   trialEndDate?: string | null;
 }
 
-export interface SubscriptionDelegateResponse {
-  data: SubscriptionDelegateResponse.Data;
-}
-
-export namespace SubscriptionDelegateResponse {
-  export interface Data {
+export namespace SubscriptionListResponse {
+  export interface Price {
     /**
-     * Subscription ID
+     * Price ID
      */
     id: string;
 
     /**
-     * Billing ID
-     */
-    billingId: string | null;
-
-    /**
-     * Created at
+     * Creation timestamp
      */
     createdAt: string;
 
     /**
-     * Customer ID
+     * Last update timestamp
      */
-    customerId: string;
+    updatedAt: string;
 
-    /**
-     * Payment collection
-     */
-    paymentCollection: 'NOT_REQUIRED' | 'PROCESSING' | 'FAILED' | 'ACTION_REQUIRED';
+    [k: string]: unknown;
+  }
+}
+
+/**
+ * Response object
+ */
+export interface SubscriptionImportResponse {
+  data: SubscriptionImportResponse.Data;
+}
 
+export namespace SubscriptionImportResponse {
+  export interface Data {
     /**
-     * Plan ID
+     * Unique identifier for the import task
      */
-    planId: string;
+    taskId: string;
+  }
+}
+
+/**
+ * Response object
+ */
+export interface SubscriptionPreviewResponse {
+  /**
+   * Pricing preview with invoices
+   */
+  data: SubscriptionPreviewResponse.Data;
+}
 
+export namespace SubscriptionPreviewResponse {
+  /**
+   * Pricing preview with invoices
+   */
+  export interface Data {
     /**
-     * Pricing type
+     * Invoice due immediately
      */
-    pricingType: 'FREE' | 'PAID' | 'CUSTOM';
+    immediateInvoice: Data.ImmediateInvoice;
 
     /**
-     * Subscription start date
+     * Billing period range
      */
-    startDate: string;
+    billingPeriodRange?: Data.BillingPeriodRange;
 
     /**
-     * Subscription status
+     * Free items included
      */
-    status: 'PAYMENT_PENDING' | 'ACTIVE' | 'EXPIRED' | 'IN_TRIAL' | 'CANCELED' | 'NOT_STARTED';
+    freeItems?: Array<Data.FreeItem>;
 
     /**
-     * Subscription cancellation date
+     * Whether updates are scheduled
      */
-    cancellationDate?: string | null;
+    hasScheduledUpdates?: boolean;
 
     /**
-     * Subscription cancel reason
+     * Whether this is a downgrade
      */
-    cancelReason?:
-      | 'UPGRADE_OR_DOWNGRADE'
-      | 'CANCELLED_BY_BILLING'
-      | 'EXPIRED'
-      | 'DETACH_BILLING'
-      | 'TRIAL_ENDED'
-      | 'Immediate'
-      | 'TRIAL_CONVERTED'
-      | 'PENDING_PAYMENT_EXPIRED'
-      | 'ScheduledCancellation'
-      | 'CustomerArchived'
-      | 'AutoCancellationRule'
-      | null;
+    isPlanDowngrade?: boolean;
 
     /**
-     * End of the current billing period
+     * Recurring invoice preview
      */
-    currentBillingPeriodEnd?: string | null;
+    recurringInvoice?: Data.RecurringInvoice;
+  }
 
+  export namespace Data {
     /**
-     * Start of the current billing period
+     * Invoice due immediately
      */
-    currentBillingPeriodStart?: string | null;
-
-    /**
-     * Subscription effective end date
-     */
-    effectiveEndDate?: string | null;
-
-    /**
-     * Subscription end date
-     */
-    endDate?: string | null;
-
-    /**
-     * Additional metadata for the subscription
-     */
-    metadata?: { [key: string]: string };
-
-    /**
-     * Paying customer ID for delegated billing
-     */
-    payingCustomerId?: string | null;
-
-    /**
-     * The method used to collect payments for a subscription
-     */
-    paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
-
-    /**
-     * Resource ID
-     */
-    resourceId?: string | null;
-
-    /**
-     * Subscription trial end date
-     */
-    trialEndDate?: string | null;
-  }
-}
-
-export interface SubscriptionMigrateResponse {
-  data: SubscriptionMigrateResponse.Data;
-}
-
-export namespace SubscriptionMigrateResponse {
-  export interface Data {
-    /**
-     * Subscription ID
-     */
-    id: string;
-
-    /**
-     * Billing ID
-     */
-    billingId: string | null;
-
-    /**
-     * Created at
-     */
-    createdAt: string;
-
-    /**
-     * Customer ID
-     */
-    customerId: string;
-
-    /**
-     * Payment collection
-     */
-    paymentCollection: 'NOT_REQUIRED' | 'PROCESSING' | 'FAILED' | 'ACTION_REQUIRED';
-
-    /**
-     * Plan ID
-     */
-    planId: string;
-
-    /**
-     * Pricing type
-     */
-    pricingType: 'FREE' | 'PAID' | 'CUSTOM';
-
-    /**
-     * Subscription start date
-     */
-    startDate: string;
-
-    /**
-     * Subscription status
-     */
-    status: 'PAYMENT_PENDING' | 'ACTIVE' | 'EXPIRED' | 'IN_TRIAL' | 'CANCELED' | 'NOT_STARTED';
-
-    /**
-     * Subscription cancellation date
-     */
-    cancellationDate?: string | null;
-
-    /**
-     * Subscription cancel reason
-     */
-    cancelReason?:
-      | 'UPGRADE_OR_DOWNGRADE'
-      | 'CANCELLED_BY_BILLING'
-      | 'EXPIRED'
-      | 'DETACH_BILLING'
-      | 'TRIAL_ENDED'
-      | 'Immediate'
-      | 'TRIAL_CONVERTED'
-      | 'PENDING_PAYMENT_EXPIRED'
-      | 'ScheduledCancellation'
-      | 'CustomerArchived'
-      | 'AutoCancellationRule'
-      | null;
-
-    /**
-     * End of the current billing period
-     */
-    currentBillingPeriodEnd?: string | null;
-
-    /**
-     * Start of the current billing period
-     */
-    currentBillingPeriodStart?: string | null;
-
-    /**
-     * Subscription effective end date
-     */
-    effectiveEndDate?: string | null;
-
-    /**
-     * Subscription end date
-     */
-    endDate?: string | null;
-
-    /**
-     * Additional metadata for the subscription
-     */
-    metadata?: { [key: string]: string };
-
-    /**
-     * Paying customer ID for delegated billing
-     */
-    payingCustomerId?: string | null;
-
-    /**
-     * The method used to collect payments for a subscription
-     */
-    paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
-
-    /**
-     * Resource ID
-     */
-    resourceId?: string | null;
-
-    /**
-     * Subscription trial end date
-     */
-    trialEndDate?: string | null;
-  }
-}
-
-export interface SubscriptionPreviewResponse {
-  data: SubscriptionPreviewResponse.Data;
-}
-
-export namespace SubscriptionPreviewResponse {
-  export interface Data {
-    immediateInvoice: Data.ImmediateInvoice;
-
-    billingPeriodRange?: Data.BillingPeriodRange;
-
-    freeItems?: Array<Data.FreeItem>;
-
-    hasScheduledUpdates?: boolean;
-
-    isPlanDowngrade?: boolean;
-
-    recurringInvoice?: Data.RecurringInvoice;
-  }
-
-  export namespace Data {
     export interface ImmediateInvoice {
+      /**
+       * Subtotal before discounts
+       */
       subTotal: number;
 
+      /**
+       * Invoice total
+       */
       total: number;
 
+      /**
+       * Billing period covered
+       */
       billingPeriodRange?: ImmediateInvoice.BillingPeriodRange;
 
+      /**
+       * Currency code
+       */
       currency?: string | null;
 
+      /**
+       * Total discount amount
+       */
       discount?: number;
 
+      /**
+       * Discount breakdown
+       */
       discountDetails?: ImmediateInvoice.DiscountDetails;
 
+      /**
+       * Applied discounts
+       */
       discounts?: Array<ImmediateInvoice.Discount>;
 
+      /**
+       * Line items
+       */
       lines?: Array<ImmediateInvoice.Line>;
 
+      /**
+       * Tax amount
+       */
       tax?: number;
     }
 
     export namespace ImmediateInvoice {
+      /**
+       * Billing period covered
+       */
       export interface BillingPeriodRange {
         /**
          * Billing period end date
@@ -766,35 +517,80 @@ export namespace SubscriptionPreviewResponse {
         start: string;
       }
 
+      /**
+       * Discount breakdown
+       */
       export interface DiscountDetails {
+        /**
+         * Promo code used
+         */
         code?: string;
 
+        /**
+         * Fixed discount amount
+         */
         fixedAmount?: number;
 
+        /**
+         * Percentage discount
+         */
         percentage?: number;
       }
 
+      /**
+       * Applied discount amount
+       */
       export interface Discount {
+        /**
+         * Discount amount
+         */
         amount: number;
 
+        /**
+         * Currency code
+         */
         currency: string;
 
+        /**
+         * Discount description
+         */
         description: string;
       }
 
+      /**
+       * Invoice line item
+       */
       export interface Line {
+        /**
+         * Currency code
+         */
         currency: string;
 
+        /**
+         * Line item description
+         */
         description: string;
 
+        /**
+         * Line subtotal
+         */
         subTotal: number;
 
+        /**
+         * Price per unit
+         */
         unitPrice: number;
 
+        /**
+         * Quantity
+         */
         quantity?: number;
       }
     }
 
+    /**
+     * Billing period range
+     */
     export interface BillingPeriodRange {
       /**
        * Billing period end date
@@ -807,33 +603,75 @@ export namespace SubscriptionPreviewResponse {
       start?: string;
     }
 
+    /**
+     * Free item in subscription
+     */
     export interface FreeItem {
+      /**
+       * Addon ID
+       */
       addonId: string;
 
+      /**
+       * Quantity
+       */
       quantity: number;
     }
 
+    /**
+     * Recurring invoice preview
+     */
     export interface RecurringInvoice {
+      /**
+       * Subtotal before discounts
+       */
       subTotal: number;
 
+      /**
+       * Invoice total
+       */
       total: number;
 
+      /**
+       * Billing period covered
+       */
       billingPeriodRange?: RecurringInvoice.BillingPeriodRange;
 
+      /**
+       * Currency code
+       */
       currency?: string | null;
 
+      /**
+       * Total discount amount
+       */
       discount?: number;
 
+      /**
+       * Discount breakdown
+       */
       discountDetails?: RecurringInvoice.DiscountDetails;
 
+      /**
+       * Applied discounts
+       */
       discounts?: Array<RecurringInvoice.Discount>;
 
+      /**
+       * Line items
+       */
       lines?: Array<RecurringInvoice.Line>;
 
+      /**
+       * Tax amount
+       */
       tax?: number;
     }
 
     export namespace RecurringInvoice {
+      /**
+       * Billing period covered
+       */
       export interface BillingPeriodRange {
         /**
          * Billing period end date
@@ -846,201 +684,2343 @@ export namespace SubscriptionPreviewResponse {
         start: string;
       }
 
+      /**
+       * Discount breakdown
+       */
       export interface DiscountDetails {
-        code?: string;
+        /**
+         * Promo code used
+         */
+        code?: string;
 
+        /**
+         * Fixed discount amount
+         */
         fixedAmount?: number;
 
+        /**
+         * Percentage discount
+         */
         percentage?: number;
       }
 
+      /**
+       * Applied discount amount
+       */
       export interface Discount {
+        /**
+         * Discount amount
+         */
         amount: number;
 
+        /**
+         * Currency code
+         */
         currency: string;
 
+        /**
+         * Discount description
+         */
         description: string;
       }
 
+      /**
+       * Invoice line item
+       */
       export interface Line {
+        /**
+         * Currency code
+         */
         currency: string;
 
+        /**
+         * Line item description
+         */
         description: string;
 
+        /**
+         * Line subtotal
+         */
         subTotal: number;
 
+        /**
+         * Price per unit
+         */
         unitPrice: number;
 
+        /**
+         * Quantity
+         */
         quantity?: number;
       }
     }
   }
-}
-
-export interface SubscriptionTransferResponse {
-  data: SubscriptionTransferResponse.Data;
-}
+}
+
+/**
+ * Response object
+ */
+export interface SubscriptionProvisionResponse {
+  /**
+   * Provisioning result with status and subscription or checkout URL.
+   */
+  data: SubscriptionProvisionResponse.Data;
+}
+
+export namespace SubscriptionProvisionResponse {
+  /**
+   * Provisioning result with status and subscription or checkout URL.
+   */
+  export interface Data {
+    /**
+     * Unique identifier for the provisioned subscription
+     */
+    id: string;
+
+    entitlements: Array<Data.Entitlement>;
+
+    /**
+     * Provision status: SUCCESS or PAYMENT_REQUIRED
+     */
+    status: 'SUCCESS' | 'PAYMENT_REQUIRED';
+
+    /**
+     * Checkout billing ID when payment is required
+     */
+    checkoutBillingId?: string | null;
+
+    /**
+     * URL to complete payment when PAYMENT_REQUIRED
+     */
+    checkoutUrl?: string | null;
+
+    /**
+     * Whether the subscription is scheduled for future activation
+     */
+    isScheduled?: boolean;
+
+    /**
+     * Created subscription (when status is SUCCESS)
+     */
+    subscription?: Data.Subscription;
+  }
+
+  export namespace Data {
+    export interface Entitlement {
+      accessDeniedReason?: string | null;
+
+      currentUsage?: number;
+
+      /**
+       * entitlement updated at
+       */
+      entitlementUpdatedAt?: string | null;
+
+      feature?: Entitlement.Feature | null;
+
+      hasUnlimitedUsage?: boolean | null;
+
+      isGranted?: boolean;
+
+      resetPeriod?: 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | null;
+
+      usageLimit?: number | null;
+
+      /**
+       * usage period anchor
+       */
+      usagePeriodAnchor?: string | null;
+
+      /**
+       * usage period end
+       */
+      usagePeriodEnd?: string | null;
+
+      /**
+       * usage period start
+       */
+      usagePeriodStart?: string | null;
+    }
+
+    export namespace Entitlement {
+      export interface Feature {
+        /**
+         * Feature ID
+         */
+        refId: string;
+      }
+    }
+
+    /**
+     * Created subscription (when status is SUCCESS)
+     */
+    export interface Subscription {
+      /**
+       * Subscription ID
+       */
+      id: string;
+
+      /**
+       * Billing ID
+       */
+      billingId: string | null;
+
+      /**
+       * Created at
+       */
+      createdAt: string;
+
+      /**
+       * Customer ID
+       */
+      customerId: string;
+
+      /**
+       * Payment collection
+       */
+      paymentCollection: 'NOT_REQUIRED' | 'PROCESSING' | 'FAILED' | 'ACTION_REQUIRED';
+
+      /**
+       * Plan ID
+       */
+      planId: string;
+
+      /**
+       * Pricing type
+       */
+      pricingType: 'FREE' | 'PAID' | 'CUSTOM';
+
+      /**
+       * Subscription start date
+       */
+      startDate: string;
+
+      /**
+       * Subscription status
+       */
+      status: 'PAYMENT_PENDING' | 'ACTIVE' | 'EXPIRED' | 'IN_TRIAL' | 'CANCELED' | 'NOT_STARTED';
+
+      /**
+       * Subscription cancellation date
+       */
+      cancellationDate?: string | null;
+
+      /**
+       * Subscription cancel reason
+       */
+      cancelReason?:
+        | 'UPGRADE_OR_DOWNGRADE'
+        | 'CANCELLED_BY_BILLING'
+        | 'EXPIRED'
+        | 'DETACH_BILLING'
+        | 'TRIAL_ENDED'
+        | 'Immediate'
+        | 'TRIAL_CONVERTED'
+        | 'PENDING_PAYMENT_EXPIRED'
+        | 'ScheduledCancellation'
+        | 'CustomerArchived'
+        | 'AutoCancellationRule'
+        | null;
+
+      /**
+       * End of the current billing period
+       */
+      currentBillingPeriodEnd?: string | null;
+
+      /**
+       * Start of the current billing period
+       */
+      currentBillingPeriodStart?: string | null;
+
+      /**
+       * Subscription effective end date
+       */
+      effectiveEndDate?: string | null;
+
+      /**
+       * Subscription end date
+       */
+      endDate?: string | null;
+
+      /**
+       * Additional metadata for the subscription
+       */
+      metadata?: { [key: string]: string };
+
+      /**
+       * Paying customer ID for delegated billing
+       */
+      payingCustomerId?: string | null;
+
+      /**
+       * The method used to collect payments for a subscription
+       */
+      paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
+
+      prices?: Array<Subscription.Price>;
+
+      /**
+       * Resource ID
+       */
+      resourceId?: string | null;
+
+      /**
+       * Subscription trial end date
+       */
+      trialEndDate?: string | null;
+    }
+
+    export namespace Subscription {
+      export interface Price {
+        /**
+         * Addon identifier for the price override
+         */
+        addonId?: string | null;
+
+        /**
+         * Whether this is a base charge override
+         */
+        baseCharge?: boolean;
+
+        /**
+         * Block size for pricing
+         */
+        blockSize?: number;
+
+        /**
+         * Feature identifier for the price override
+         */
+        featureId?: string | null;
+
+        /**
+         * Override price amount
+         */
+        price?: Price.Price;
+
+        /**
+         * Pricing tiers configuration
+         */
+        tiers?: Array<Price.Tier>;
+      }
+
+      export namespace Price {
+        /**
+         * Override price amount
+         */
+        export interface Price {
+          /**
+           * The price amount
+           */
+          amount?: number;
+
+          /**
+           * The billing country code of the price
+           */
+          billingCountryCode?: string | null;
+
+          /**
+           * The price currency
+           */
+          currency?:
+            | 'usd'
+            | 'aed'
+            | 'all'
+            | 'amd'
+            | 'ang'
+            | 'aud'
+            | 'awg'
+            | 'azn'
+            | 'bam'
+            | 'bbd'
+            | 'bdt'
+            | 'bgn'
+            | 'bif'
+            | 'bmd'
+            | 'bnd'
+            | 'bsd'
+            | 'bwp'
+            | 'byn'
+            | 'bzd'
+            | 'brl'
+            | 'cad'
+            | 'cdf'
+            | 'chf'
+            | 'cny'
+            | 'czk'
+            | 'dkk'
+            | 'dop'
+            | 'dzd'
+            | 'egp'
+            | 'etb'
+            | 'eur'
+            | 'fjd'
+            | 'gbp'
+            | 'gel'
+            | 'gip'
+            | 'gmd'
+            | 'gyd'
+            | 'hkd'
+            | 'hrk'
+            | 'htg'
+            | 'idr'
+            | 'ils'
+            | 'inr'
+            | 'isk'
+            | 'jmd'
+            | 'jpy'
+            | 'kes'
+            | 'kgs'
+            | 'khr'
+            | 'kmf'
+            | 'krw'
+            | 'kyd'
+            | 'kzt'
+            | 'lbp'
+            | 'lkr'
+            | 'lrd'
+            | 'lsl'
+            | 'mad'
+            | 'mdl'
+            | 'mga'
+            | 'mkd'
+            | 'mmk'
+            | 'mnt'
+            | 'mop'
+            | 'mro'
+            | 'mvr'
+            | 'mwk'
+            | 'mxn'
+            | 'myr'
+            | 'mzn'
+            | 'nad'
+            | 'ngn'
+            | 'nok'
+            | 'npr'
+            | 'nzd'
+            | 'pgk'
+            | 'php'
+            | 'pkr'
+            | 'pln'
+            | 'qar'
+            | 'ron'
+            | 'rsd'
+            | 'rub'
+            | 'rwf'
+            | 'sar'
+            | 'sbd'
+            | 'scr'
+            | 'sek'
+            | 'sgd'
+            | 'sle'
+            | 'sll'
+            | 'sos'
+            | 'szl'
+            | 'thb'
+            | 'tjs'
+            | 'top'
+            | 'try'
+            | 'ttd'
+            | 'tzs'
+            | 'uah'
+            | 'uzs'
+            | 'vnd'
+            | 'vuv'
+            | 'wst'
+            | 'xaf'
+            | 'xcd'
+            | 'yer'
+            | 'zar'
+            | 'zmw'
+            | 'clp'
+            | 'djf'
+            | 'gnf'
+            | 'ugx'
+            | 'pyg'
+            | 'xof'
+            | 'xpf';
+        }
+
+        export interface Tier {
+          /**
+           * The flat fee price of the price tier
+           */
+          flatPrice?: Tier.FlatPrice;
+
+          /**
+           * The unit price of the price tier
+           */
+          unitPrice?: Tier.UnitPrice;
+
+          /**
+           * The up to quantity of the price tier
+           */
+          upTo?: number;
+        }
+
+        export namespace Tier {
+          /**
+           * The flat fee price of the price tier
+           */
+          export interface FlatPrice {
+            /**
+             * The price amount
+             */
+            amount?: number;
+
+            /**
+             * The billing country code of the price
+             */
+            billingCountryCode?: string | null;
+
+            /**
+             * The price currency
+             */
+            currency?:
+              | 'usd'
+              | 'aed'
+              | 'all'
+              | 'amd'
+              | 'ang'
+              | 'aud'
+              | 'awg'
+              | 'azn'
+              | 'bam'
+              | 'bbd'
+              | 'bdt'
+              | 'bgn'
+              | 'bif'
+              | 'bmd'
+              | 'bnd'
+              | 'bsd'
+              | 'bwp'
+              | 'byn'
+              | 'bzd'
+              | 'brl'
+              | 'cad'
+              | 'cdf'
+              | 'chf'
+              | 'cny'
+              | 'czk'
+              | 'dkk'
+              | 'dop'
+              | 'dzd'
+              | 'egp'
+              | 'etb'
+              | 'eur'
+              | 'fjd'
+              | 'gbp'
+              | 'gel'
+              | 'gip'
+              | 'gmd'
+              | 'gyd'
+              | 'hkd'
+              | 'hrk'
+              | 'htg'
+              | 'idr'
+              | 'ils'
+              | 'inr'
+              | 'isk'
+              | 'jmd'
+              | 'jpy'
+              | 'kes'
+              | 'kgs'
+              | 'khr'
+              | 'kmf'
+              | 'krw'
+              | 'kyd'
+              | 'kzt'
+              | 'lbp'
+              | 'lkr'
+              | 'lrd'
+              | 'lsl'
+              | 'mad'
+              | 'mdl'
+              | 'mga'
+              | 'mkd'
+              | 'mmk'
+              | 'mnt'
+              | 'mop'
+              | 'mro'
+              | 'mvr'
+              | 'mwk'
+              | 'mxn'
+              | 'myr'
+              | 'mzn'
+              | 'nad'
+              | 'ngn'
+              | 'nok'
+              | 'npr'
+              | 'nzd'
+              | 'pgk'
+              | 'php'
+              | 'pkr'
+              | 'pln'
+              | 'qar'
+              | 'ron'
+              | 'rsd'
+              | 'rub'
+              | 'rwf'
+              | 'sar'
+              | 'sbd'
+              | 'scr'
+              | 'sek'
+              | 'sgd'
+              | 'sle'
+              | 'sll'
+              | 'sos'
+              | 'szl'
+              | 'thb'
+              | 'tjs'
+              | 'top'
+              | 'try'
+              | 'ttd'
+              | 'tzs'
+              | 'uah'
+              | 'uzs'
+              | 'vnd'
+              | 'vuv'
+              | 'wst'
+              | 'xaf'
+              | 'xcd'
+              | 'yer'
+              | 'zar'
+              | 'zmw'
+              | 'clp'
+              | 'djf'
+              | 'gnf'
+              | 'ugx'
+              | 'pyg'
+              | 'xof'
+              | 'xpf';
+          }
+
+          /**
+           * The unit price of the price tier
+           */
+          export interface UnitPrice {
+            /**
+             * The price amount
+             */
+            amount?: number;
+
+            /**
+             * The billing country code of the price
+             */
+            billingCountryCode?: string | null;
+
+            /**
+             * The price currency
+             */
+            currency?:
+              | 'usd'
+              | 'aed'
+              | 'all'
+              | 'amd'
+              | 'ang'
+              | 'aud'
+              | 'awg'
+              | 'azn'
+              | 'bam'
+              | 'bbd'
+              | 'bdt'
+              | 'bgn'
+              | 'bif'
+              | 'bmd'
+              | 'bnd'
+              | 'bsd'
+              | 'bwp'
+              | 'byn'
+              | 'bzd'
+              | 'brl'
+              | 'cad'
+              | 'cdf'
+              | 'chf'
+              | 'cny'
+              | 'czk'
+              | 'dkk'
+              | 'dop'
+              | 'dzd'
+              | 'egp'
+              | 'etb'
+              | 'eur'
+              | 'fjd'
+              | 'gbp'
+              | 'gel'
+              | 'gip'
+              | 'gmd'
+              | 'gyd'
+              | 'hkd'
+              | 'hrk'
+              | 'htg'
+              | 'idr'
+              | 'ils'
+              | 'inr'
+              | 'isk'
+              | 'jmd'
+              | 'jpy'
+              | 'kes'
+              | 'kgs'
+              | 'khr'
+              | 'kmf'
+              | 'krw'
+              | 'kyd'
+              | 'kzt'
+              | 'lbp'
+              | 'lkr'
+              | 'lrd'
+              | 'lsl'
+              | 'mad'
+              | 'mdl'
+              | 'mga'
+              | 'mkd'
+              | 'mmk'
+              | 'mnt'
+              | 'mop'
+              | 'mro'
+              | 'mvr'
+              | 'mwk'
+              | 'mxn'
+              | 'myr'
+              | 'mzn'
+              | 'nad'
+              | 'ngn'
+              | 'nok'
+              | 'npr'
+              | 'nzd'
+              | 'pgk'
+              | 'php'
+              | 'pkr'
+              | 'pln'
+              | 'qar'
+              | 'ron'
+              | 'rsd'
+              | 'rub'
+              | 'rwf'
+              | 'sar'
+              | 'sbd'
+              | 'scr'
+              | 'sek'
+              | 'sgd'
+              | 'sle'
+              | 'sll'
+              | 'sos'
+              | 'szl'
+              | 'thb'
+              | 'tjs'
+              | 'top'
+              | 'try'
+              | 'ttd'
+              | 'tzs'
+              | 'uah'
+              | 'uzs'
+              | 'vnd'
+              | 'vuv'
+              | 'wst'
+              | 'xaf'
+              | 'xcd'
+              | 'yer'
+              | 'zar'
+              | 'zmw'
+              | 'clp'
+              | 'djf'
+              | 'gnf'
+              | 'ugx'
+              | 'pyg'
+              | 'xof'
+              | 'xpf';
+          }
+        }
+      }
+    }
+  }
+}
+
+export interface SubscriptionUpdateParams {
+  addons?: Array<SubscriptionUpdateParams.Addon>;
+
+  appliedCoupon?: SubscriptionUpdateParams.AppliedCoupon;
+
+  awaitPaymentConfirmation?: boolean;
+
+  billingInformation?: SubscriptionUpdateParams.BillingInformation;
+
+  billingPeriod?: 'MONTHLY' | 'ANNUALLY';
+
+  budget?: SubscriptionUpdateParams.Budget | null;
+
+  charges?: Array<SubscriptionUpdateParams.Charge>;
+
+  /**
+   * Additional metadata for the subscription
+   */
+  metadata?: { [key: string]: string };
+
+  minimumSpend?: SubscriptionUpdateParams.MinimumSpend | null;
+
+  priceOverrides?: Array<SubscriptionUpdateParams.PriceOverride>;
+
+  promotionCode?: string;
+
+  scheduleStrategy?: 'END_OF_BILLING_PERIOD' | 'END_OF_BILLING_MONTH' | 'IMMEDIATE';
+
+  subscriptionEntitlements?: Array<SubscriptionUpdateParams.SubscriptionEntitlement>;
+
+  /**
+   * Subscription trial end date
+   */
+  trialEndDate?: string;
+}
+
+export namespace SubscriptionUpdateParams {
+  export interface Addon {
+    /**
+     * Addon ID
+     */
+    addonId: string;
+
+    quantity: number;
+  }
+
+  export interface AppliedCoupon {
+    billingCouponId?: string;
+
+    configuration?: AppliedCoupon.Configuration;
+
+    couponId?: string;
+
+    discount?: AppliedCoupon.Discount;
+
+    promotionCode?: string | null;
+  }
+
+  export namespace AppliedCoupon {
+    export interface Configuration {
+      /**
+       * Coupon start date
+       */
+      startDate?: string;
+    }
+
+    export interface Discount {
+      amountsOff?: Array<Discount.AmountsOff> | null;
+
+      description?: string;
+
+      durationInMonths?: number;
+
+      name?: string;
+
+      percentOff?: number;
+    }
+
+    export namespace Discount {
+      export interface AmountsOff {
+        amount: number;
+
+        currency?:
+          | 'usd'
+          | 'aed'
+          | 'all'
+          | 'amd'
+          | 'ang'
+          | 'aud'
+          | 'awg'
+          | 'azn'
+          | 'bam'
+          | 'bbd'
+          | 'bdt'
+          | 'bgn'
+          | 'bif'
+          | 'bmd'
+          | 'bnd'
+          | 'bsd'
+          | 'bwp'
+          | 'byn'
+          | 'bzd'
+          | 'brl'
+          | 'cad'
+          | 'cdf'
+          | 'chf'
+          | 'cny'
+          | 'czk'
+          | 'dkk'
+          | 'dop'
+          | 'dzd'
+          | 'egp'
+          | 'etb'
+          | 'eur'
+          | 'fjd'
+          | 'gbp'
+          | 'gel'
+          | 'gip'
+          | 'gmd'
+          | 'gyd'
+          | 'hkd'
+          | 'hrk'
+          | 'htg'
+          | 'idr'
+          | 'ils'
+          | 'inr'
+          | 'isk'
+          | 'jmd'
+          | 'jpy'
+          | 'kes'
+          | 'kgs'
+          | 'khr'
+          | 'kmf'
+          | 'krw'
+          | 'kyd'
+          | 'kzt'
+          | 'lbp'
+          | 'lkr'
+          | 'lrd'
+          | 'lsl'
+          | 'mad'
+          | 'mdl'
+          | 'mga'
+          | 'mkd'
+          | 'mmk'
+          | 'mnt'
+          | 'mop'
+          | 'mro'
+          | 'mvr'
+          | 'mwk'
+          | 'mxn'
+          | 'myr'
+          | 'mzn'
+          | 'nad'
+          | 'ngn'
+          | 'nok'
+          | 'npr'
+          | 'nzd'
+          | 'pgk'
+          | 'php'
+          | 'pkr'
+          | 'pln'
+          | 'qar'
+          | 'ron'
+          | 'rsd'
+          | 'rub'
+          | 'rwf'
+          | 'sar'
+          | 'sbd'
+          | 'scr'
+          | 'sek'
+          | 'sgd'
+          | 'sle'
+          | 'sll'
+          | 'sos'
+          | 'szl'
+          | 'thb'
+          | 'tjs'
+          | 'top'
+          | 'try'
+          | 'ttd'
+          | 'tzs'
+          | 'uah'
+          | 'uzs'
+          | 'vnd'
+          | 'vuv'
+          | 'wst'
+          | 'xaf'
+          | 'xcd'
+          | 'yer'
+          | 'zar'
+          | 'zmw'
+          | 'clp'
+          | 'djf'
+          | 'gnf'
+          | 'ugx'
+          | 'pyg'
+          | 'xof'
+          | 'xpf';
+      }
+    }
+  }
+
+  export interface BillingInformation {
+    /**
+     * Physical address
+     */
+    billingAddress?: BillingInformation.BillingAddress;
+
+    chargeOnBehalfOfAccount?: string;
+
+    couponId?: string;
+
+    integrationId?: string;
+
+    invoiceDaysUntilDue?: number;
+
+    isBackdated?: boolean;
+
+    isInvoicePaid?: boolean;
+
+    /**
+     * Additional metadata for the subscription
+     */
+    metadata?: { [key: string]: unknown };
+
+    prorationBehavior?: 'INVOICE_IMMEDIATELY' | 'CREATE_PRORATIONS' | 'NONE';
+
+    taxIds?: Array<BillingInformation.TaxID>;
+
+    taxPercentage?: number;
+
+    taxRateIds?: Array<string>;
+  }
+
+  export namespace BillingInformation {
+    /**
+     * Physical address
+     */
+    export interface BillingAddress {
+      /**
+       * City name
+       */
+      city?: string;
+
+      /**
+       * Country code or name
+       */
+      country?: string;
+
+      /**
+       * Street address line 1
+       */
+      line1?: string;
+
+      /**
+       * Street address line 2
+       */
+      line2?: string;
+
+      /**
+       * Postal or ZIP code
+       */
+      postalCode?: string;
+
+      /**
+       * State or province
+       */
+      state?: string;
+    }
+
+    export interface TaxID {
+      type: string;
+
+      value: string;
+    }
+  }
+
+  export interface Budget {
+    hasSoftLimit: boolean;
+
+    limit: number;
+  }
+
+  export interface Charge {
+    /**
+     * Charge ID
+     */
+    id: string;
+
+    quantity: number;
+
+    type: 'FEATURE' | 'CREDIT';
+  }
+
+  export interface MinimumSpend {
+    minimum?: MinimumSpend.Minimum | null;
+  }
+
+  export namespace MinimumSpend {
+    export interface Minimum {
+      amount: number;
+
+      currency?:
+        | 'usd'
+        | 'aed'
+        | 'all'
+        | 'amd'
+        | 'ang'
+        | 'aud'
+        | 'awg'
+        | 'azn'
+        | 'bam'
+        | 'bbd'
+        | 'bdt'
+        | 'bgn'
+        | 'bif'
+        | 'bmd'
+        | 'bnd'
+        | 'bsd'
+        | 'bwp'
+        | 'byn'
+        | 'bzd'
+        | 'brl'
+        | 'cad'
+        | 'cdf'
+        | 'chf'
+        | 'cny'
+        | 'czk'
+        | 'dkk'
+        | 'dop'
+        | 'dzd'
+        | 'egp'
+        | 'etb'
+        | 'eur'
+        | 'fjd'
+        | 'gbp'
+        | 'gel'
+        | 'gip'
+        | 'gmd'
+        | 'gyd'
+        | 'hkd'
+        | 'hrk'
+        | 'htg'
+        | 'idr'
+        | 'ils'
+        | 'inr'
+        | 'isk'
+        | 'jmd'
+        | 'jpy'
+        | 'kes'
+        | 'kgs'
+        | 'khr'
+        | 'kmf'
+        | 'krw'
+        | 'kyd'
+        | 'kzt'
+        | 'lbp'
+        | 'lkr'
+        | 'lrd'
+        | 'lsl'
+        | 'mad'
+        | 'mdl'
+        | 'mga'
+        | 'mkd'
+        | 'mmk'
+        | 'mnt'
+        | 'mop'
+        | 'mro'
+        | 'mvr'
+        | 'mwk'
+        | 'mxn'
+        | 'myr'
+        | 'mzn'
+        | 'nad'
+        | 'ngn'
+        | 'nok'
+        | 'npr'
+        | 'nzd'
+        | 'pgk'
+        | 'php'
+        | 'pkr'
+        | 'pln'
+        | 'qar'
+        | 'ron'
+        | 'rsd'
+        | 'rub'
+        | 'rwf'
+        | 'sar'
+        | 'sbd'
+        | 'scr'
+        | 'sek'
+        | 'sgd'
+        | 'sle'
+        | 'sll'
+        | 'sos'
+        | 'szl'
+        | 'thb'
+        | 'tjs'
+        | 'top'
+        | 'try'
+        | 'ttd'
+        | 'tzs'
+        | 'uah'
+        | 'uzs'
+        | 'vnd'
+        | 'vuv'
+        | 'wst'
+        | 'xaf'
+        | 'xcd'
+        | 'yer'
+        | 'zar'
+        | 'zmw'
+        | 'clp'
+        | 'djf'
+        | 'gnf'
+        | 'ugx'
+        | 'pyg'
+        | 'xof'
+        | 'xpf';
+    }
+  }
+
+  export interface PriceOverride {
+    /**
+     * Feature ID
+     */
+    featureId: string;
+
+    price?: PriceOverride.Price;
+  }
+
+  export namespace PriceOverride {
+    export interface Price {
+      amount: number;
+
+      currency?:
+        | 'usd'
+        | 'aed'
+        | 'all'
+        | 'amd'
+        | 'ang'
+        | 'aud'
+        | 'awg'
+        | 'azn'
+        | 'bam'
+        | 'bbd'
+        | 'bdt'
+        | 'bgn'
+        | 'bif'
+        | 'bmd'
+        | 'bnd'
+        | 'bsd'
+        | 'bwp'
+        | 'byn'
+        | 'bzd'
+        | 'brl'
+        | 'cad'
+        | 'cdf'
+        | 'chf'
+        | 'cny'
+        | 'czk'
+        | 'dkk'
+        | 'dop'
+        | 'dzd'
+        | 'egp'
+        | 'etb'
+        | 'eur'
+        | 'fjd'
+        | 'gbp'
+        | 'gel'
+        | 'gip'
+        | 'gmd'
+        | 'gyd'
+        | 'hkd'
+        | 'hrk'
+        | 'htg'
+        | 'idr'
+        | 'ils'
+        | 'inr'
+        | 'isk'
+        | 'jmd'
+        | 'jpy'
+        | 'kes'
+        | 'kgs'
+        | 'khr'
+        | 'kmf'
+        | 'krw'
+        | 'kyd'
+        | 'kzt'
+        | 'lbp'
+        | 'lkr'
+        | 'lrd'
+        | 'lsl'
+        | 'mad'
+        | 'mdl'
+        | 'mga'
+        | 'mkd'
+        | 'mmk'
+        | 'mnt'
+        | 'mop'
+        | 'mro'
+        | 'mvr'
+        | 'mwk'
+        | 'mxn'
+        | 'myr'
+        | 'mzn'
+        | 'nad'
+        | 'ngn'
+        | 'nok'
+        | 'npr'
+        | 'nzd'
+        | 'pgk'
+        | 'php'
+        | 'pkr'
+        | 'pln'
+        | 'qar'
+        | 'ron'
+        | 'rsd'
+        | 'rub'
+        | 'rwf'
+        | 'sar'
+        | 'sbd'
+        | 'scr'
+        | 'sek'
+        | 'sgd'
+        | 'sle'
+        | 'sll'
+        | 'sos'
+        | 'szl'
+        | 'thb'
+        | 'tjs'
+        | 'top'
+        | 'try'
+        | 'ttd'
+        | 'tzs'
+        | 'uah'
+        | 'uzs'
+        | 'vnd'
+        | 'vuv'
+        | 'wst'
+        | 'xaf'
+        | 'xcd'
+        | 'yer'
+        | 'zar'
+        | 'zmw'
+        | 'clp'
+        | 'djf'
+        | 'gnf'
+        | 'ugx'
+        | 'pyg'
+        | 'xof'
+        | 'xpf';
+    }
+  }
+
+  export interface SubscriptionEntitlement {
+    id?: string;
+
+    featureId?: string;
+
+    hasSoftLimit?: boolean;
+
+    hasUnlimitedUsage?: boolean;
+
+    monthlyResetPeriodConfiguration?: SubscriptionEntitlement.MonthlyResetPeriodConfiguration;
+
+    resetPeriod?: 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR';
+
+    usageLimit?: number;
+
+    weeklyResetPeriodConfiguration?: SubscriptionEntitlement.WeeklyResetPeriodConfiguration;
+
+    yearlyResetPeriodConfiguration?: SubscriptionEntitlement.YearlyResetPeriodConfiguration;
+  }
+
+  export namespace SubscriptionEntitlement {
+    export interface MonthlyResetPeriodConfiguration {
+      accordingTo: 'SubscriptionStart' | 'StartOfTheMonth';
+    }
+
+    export interface WeeklyResetPeriodConfiguration {
+      accordingTo:
+        | 'SubscriptionStart'
+        | 'EverySunday'
+        | 'EveryMonday'
+        | 'EveryTuesday'
+        | 'EveryWednesday'
+        | 'EveryThursday'
+        | 'EveryFriday'
+        | 'EverySaturday';
+    }
+
+    export interface YearlyResetPeriodConfiguration {
+      accordingTo: 'SubscriptionStart';
+    }
+  }
+}
+
+export interface SubscriptionListParams extends MyCursorIDPageParams {
+  /**
+   * Filter by customer ID
+   */
+  customerId?: string;
+
+  /**
+   * Filter by status (comma-separated)
+   */
+  status?: string;
+}
+
+export interface SubscriptionCancelParams {
+  /**
+   * Action on cancellation (downgrade or revoke)
+   */
+  cancellationAction?: 'DEFAULT' | 'REVOKE_ENTITLEMENTS';
+
+  /**
+   * When to cancel (immediate, period end, or date)
+   */
+  cancellationTime?: 'END_OF_BILLING_PERIOD' | 'IMMEDIATE' | 'SPECIFIC_DATE';
+
+  /**
+   * Subscription end date
+   */
+  endDate?: string;
+
+  /**
+   * If set, enables or disables prorating of credits on subscription cancellation.
+   */
+  prorate?: boolean;
+}
+
+export interface SubscriptionDelegateParams {
+  /**
+   * The unique identifier of the customer who will assume payment responsibility for
+   * this subscription. This customer must already exist in your Stigg account and
+   * have a valid payment method if the subscription requires payment.
+   */
+  targetCustomerId: string;
+}
+
+export interface SubscriptionImportParams {
+  /**
+   * List of subscription objects to import
+   */
+  subscriptions: Array<SubscriptionImportParams.Subscription>;
+}
+
+export namespace SubscriptionImportParams {
+  export interface Subscription {
+    /**
+     * Subscription ID
+     */
+    id: string;
+
+    /**
+     * Customer ID
+     */
+    customerId: string;
+
+    /**
+     * Plan ID
+     */
+    planId: string;
+
+    /**
+     * Billing ID
+     */
+    billingId?: string | null;
+
+    /**
+     * Subscription end date
+     */
+    endDate?: string | null;
+
+    /**
+     * Additional metadata for the subscription
+     */
+    metadata?: { [key: string]: string };
+
+    /**
+     * Resource ID
+     */
+    resourceId?: string | null;
+
+    /**
+     * Subscription start date
+     */
+    startDate?: string;
+  }
+}
+
+export interface SubscriptionMigrateParams {
+  /**
+   * When to migrate (immediate or period end)
+   */
+  subscriptionMigrationTime?: 'END_OF_BILLING_PERIOD' | 'IMMEDIATE';
+}
+
+export interface SubscriptionPreviewParams {
+  /**
+   * Customer ID
+   */
+  customerId: string;
+
+  /**
+   * Plan ID
+   */
+  planId: string;
+
+  /**
+   * Addons to include
+   */
+  addons?: Array<SubscriptionPreviewParams.Addon>;
+
+  /**
+   * Coupon or discount to apply
+   */
+  appliedCoupon?: SubscriptionPreviewParams.AppliedCoupon;
+
+  /**
+   * Billable features with quantities
+   */
+  billableFeatures?: Array<SubscriptionPreviewParams.BillableFeature>;
+
+  /**
+   * ISO 3166-1 country code for localization
+   */
+  billingCountryCode?: string;
+
+  /**
+   * Billing and tax configuration
+   */
+  billingInformation?: SubscriptionPreviewParams.BillingInformation;
+
+  /**
+   * Billing period (MONTHLY or ANNUALLY)
+   */
+  billingPeriod?: 'MONTHLY' | 'ANNUALLY';
+
+  /**
+   * One-time or recurring charges
+   */
+  charges?: Array<SubscriptionPreviewParams.Charge>;
+
+  /**
+   * Paying customer ID for delegated billing
+   */
+  payingCustomerId?: string;
+
+  /**
+   * Resource ID for multi-instance subscriptions
+   */
+  resourceId?: string;
+
+  /**
+   * When to apply subscription changes
+   */
+  scheduleStrategy?: 'END_OF_BILLING_PERIOD' | 'END_OF_BILLING_MONTH' | 'IMMEDIATE';
+
+  /**
+   * Subscription start date
+   */
+  startDate?: string;
+
+  /**
+   * Trial period override settings
+   */
+  trialOverrideConfiguration?: SubscriptionPreviewParams.TrialOverrideConfiguration;
+
+  /**
+   * Unit quantity for per-unit pricing
+   */
+  unitQuantity?: number;
+}
+
+export namespace SubscriptionPreviewParams {
+  /**
+   * Addon configuration
+   */
+  export interface Addon {
+    /**
+     * Addon ID
+     */
+    addonId: string;
+
+    /**
+     * Number of addon instances
+     */
+    quantity?: number;
+  }
+
+  /**
+   * Coupon or discount to apply
+   */
+  export interface AppliedCoupon {
+    /**
+     * Billing provider coupon ID
+     */
+    billingCouponId?: string;
+
+    /**
+     * Coupon timing configuration
+     */
+    configuration?: AppliedCoupon.Configuration;
+
+    /**
+     * Stigg coupon ID
+     */
+    couponId?: string;
+
+    /**
+     * Ad-hoc discount configuration
+     */
+    discount?: AppliedCoupon.Discount;
+
+    /**
+     * Promotion code to apply
+     */
+    promotionCode?: string;
+  }
+
+  export namespace AppliedCoupon {
+    /**
+     * Coupon timing configuration
+     */
+    export interface Configuration {
+      /**
+       * Coupon start date
+       */
+      startDate?: string;
+    }
+
+    /**
+     * Ad-hoc discount configuration
+     */
+    export interface Discount {
+      /**
+       * Fixed amounts off by currency
+       */
+      amountsOff?: Array<Discount.AmountsOff> | null;
+
+      /**
+       * Ad-hoc discount
+       */
+      description?: string;
+
+      /**
+       * Duration in months
+       */
+      durationInMonths?: number;
+
+      /**
+       * Discount name
+       */
+      name?: string;
+
+      /**
+       * Percentage discount
+       */
+      percentOff?: number;
+    }
+
+    export namespace Discount {
+      export interface AmountsOff {
+        /**
+         * The price amount
+         */
+        amount: number;
+
+        /**
+         * The price currency
+         */
+        currency:
+          | 'usd'
+          | 'aed'
+          | 'all'
+          | 'amd'
+          | 'ang'
+          | 'aud'
+          | 'awg'
+          | 'azn'
+          | 'bam'
+          | 'bbd'
+          | 'bdt'
+          | 'bgn'
+          | 'bif'
+          | 'bmd'
+          | 'bnd'
+          | 'bsd'
+          | 'bwp'
+          | 'byn'
+          | 'bzd'
+          | 'brl'
+          | 'cad'
+          | 'cdf'
+          | 'chf'
+          | 'cny'
+          | 'czk'
+          | 'dkk'
+          | 'dop'
+          | 'dzd'
+          | 'egp'
+          | 'etb'
+          | 'eur'
+          | 'fjd'
+          | 'gbp'
+          | 'gel'
+          | 'gip'
+          | 'gmd'
+          | 'gyd'
+          | 'hkd'
+          | 'hrk'
+          | 'htg'
+          | 'idr'
+          | 'ils'
+          | 'inr'
+          | 'isk'
+          | 'jmd'
+          | 'jpy'
+          | 'kes'
+          | 'kgs'
+          | 'khr'
+          | 'kmf'
+          | 'krw'
+          | 'kyd'
+          | 'kzt'
+          | 'lbp'
+          | 'lkr'
+          | 'lrd'
+          | 'lsl'
+          | 'mad'
+          | 'mdl'
+          | 'mga'
+          | 'mkd'
+          | 'mmk'
+          | 'mnt'
+          | 'mop'
+          | 'mro'
+          | 'mvr'
+          | 'mwk'
+          | 'mxn'
+          | 'myr'
+          | 'mzn'
+          | 'nad'
+          | 'ngn'
+          | 'nok'
+          | 'npr'
+          | 'nzd'
+          | 'pgk'
+          | 'php'
+          | 'pkr'
+          | 'pln'
+          | 'qar'
+          | 'ron'
+          | 'rsd'
+          | 'rub'
+          | 'rwf'
+          | 'sar'
+          | 'sbd'
+          | 'scr'
+          | 'sek'
+          | 'sgd'
+          | 'sle'
+          | 'sll'
+          | 'sos'
+          | 'szl'
+          | 'thb'
+          | 'tjs'
+          | 'top'
+          | 'try'
+          | 'ttd'
+          | 'tzs'
+          | 'uah'
+          | 'uzs'
+          | 'vnd'
+          | 'vuv'
+          | 'wst'
+          | 'xaf'
+          | 'xcd'
+          | 'yer'
+          | 'zar'
+          | 'zmw'
+          | 'clp'
+          | 'djf'
+          | 'gnf'
+          | 'ugx'
+          | 'pyg'
+          | 'xof'
+          | 'xpf';
+      }
+    }
+  }
+
+  /**
+   * Feature with quantity
+   */
+  export interface BillableFeature {
+    /**
+     * Feature ID
+     */
+    featureId: string;
+
+    /**
+     * Quantity of feature units
+     */
+    quantity: number;
+  }
+
+  /**
+   * Billing and tax configuration
+   */
+  export interface BillingInformation {
+    /**
+     * Billing address
+     */
+    billingAddress?: BillingInformation.BillingAddress;
+
+    /**
+     * Connected account ID for platform billing
+     */
+    chargeOnBehalfOfAccount?: string;
+
+    /**
+     * Billing integration ID
+     */
+    integrationId?: string;
+
+    /**
+     * Days until invoice is due
+     */
+    invoiceDaysUntilDue?: number;
+
+    /**
+     * Whether subscription is backdated
+     */
+    isBackdated?: boolean;
+
+    /**
+     * Whether invoice is already paid
+     */
+    isInvoicePaid?: boolean;
+
+    /**
+     * Additional billing metadata
+     */
+    metadata?: unknown;
+
+    /**
+     * Proration behavior
+     */
+    prorationBehavior?: 'INVOICE_IMMEDIATELY' | 'CREATE_PRORATIONS' | 'NONE';
+
+    /**
+     * Customer tax IDs
+     */
+    taxIds?: Array<BillingInformation.TaxID>;
+
+    /**
+     * Tax percentage to apply
+     */
+    taxPercentage?: number;
+
+    /**
+     * Tax rate IDs from billing provider
+     */
+    taxRateIds?: Array<string>;
+  }
+
+  export namespace BillingInformation {
+    /**
+     * Billing address
+     */
+    export interface BillingAddress {
+      city?: string;
+
+      country?: string;
+
+      line1?: string;
+
+      line2?: string;
+
+      postalCode?: string;
+
+      state?: string;
+    }
+
+    /**
+     * Tax exemption identifier
+     */
+    export interface TaxID {
+      /**
+       * Tax exemption type (e.g., vat, gst)
+       */
+      type: string;
+
+      /**
+       * Tax exemption identifier value
+       */
+      value: string;
+    }
+  }
+
+  /**
+   * Charge item
+   */
+  export interface Charge {
+    /**
+     * Charge ID
+     */
+    id: string;
+
+    /**
+     * Charge quantity
+     */
+    quantity: number;
+
+    /**
+     * Charge type
+     */
+    type: 'FEATURE' | 'CREDIT';
+  }
+
+  /**
+   * Trial period override settings
+   */
+  export interface TrialOverrideConfiguration {
+    /**
+     * Whether to start as trial
+     */
+    isTrial: boolean;
+
+    /**
+     * Behavior when trial ends
+     */
+    trialEndBehavior?: 'CONVERT_TO_PAID' | 'CANCEL_SUBSCRIPTION';
+
+    /**
+     * Trial end date
+     */
+    trialEndDate?: string;
+  }
+}
+
+export interface SubscriptionProvisionParams {
+  /**
+   * Customer ID to provision the subscription for
+   */
+  customerId: string;
+
+  /**
+   * Plan ID to provision
+   */
+  planId: string;
+
+  /**
+   * Unique identifier for the subscription
+   */
+  id?: string;
+
+  addons?: Array<SubscriptionProvisionParams.Addon>;
+
+  /**
+   * Coupon configuration
+   */
+  appliedCoupon?: SubscriptionProvisionParams.AppliedCoupon;
+
+  /**
+   * Whether to wait for payment confirmation before returning the subscription
+   */
+  awaitPaymentConfirmation?: boolean;
+
+  /**
+   * The ISO 3166-1 alpha-2 country code for billing
+   */
+  billingCountryCode?: string | null;
+
+  /**
+   * External billing system identifier
+   */
+  billingId?: string | null;
+
+  billingInformation?: SubscriptionProvisionParams.BillingInformation;
+
+  /**
+   * Billing period (MONTHLY or ANNUALLY)
+   */
+  billingPeriod?: 'MONTHLY' | 'ANNUALLY';
+
+  budget?: SubscriptionProvisionParams.Budget | null;
+
+  charges?: Array<SubscriptionProvisionParams.Charge>;
+
+  /**
+   * Checkout page configuration for payment collection
+   */
+  checkoutOptions?: SubscriptionProvisionParams.CheckoutOptions;
+
+  /**
+   * Additional metadata for the subscription
+   */
+  metadata?: { [key: string]: string };
+
+  minimumSpend?: SubscriptionProvisionParams.MinimumSpend | null;
+
+  /**
+   * Optional paying customer ID for split billing scenarios
+   */
+  payingCustomerId?: string | null;
+
+  /**
+   * How payments should be collected for this subscription
+   */
+  paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE';
+
+  priceOverrides?: Array<SubscriptionProvisionParams.PriceOverride>;
+
+  /**
+   * Optional resource ID for multi-instance subscriptions
+   */
+  resourceId?: string | null;
+
+  /**
+   * Salesforce ID
+   */
+  salesforceId?: string | null;
+
+  /**
+   * Strategy for scheduling subscription changes
+   */
+  scheduleStrategy?: 'END_OF_BILLING_PERIOD' | 'END_OF_BILLING_MONTH' | 'IMMEDIATE';
+
+  /**
+   * Subscription start date
+   */
+  startDate?: string;
+
+  subscriptionEntitlements?: Array<SubscriptionProvisionParams.SubscriptionEntitlement>;
+
+  /**
+   * Trial period override settings
+   */
+  trialOverrideConfiguration?: SubscriptionProvisionParams.TrialOverrideConfiguration;
+
+  unitQuantity?: number;
+}
+
+export namespace SubscriptionProvisionParams {
+  export interface Addon {
+    /**
+     * Addon identifier
+     */
+    addonId: string;
+
+    /**
+     * Number of addon units
+     */
+    quantity?: number;
+  }
+
+  /**
+   * Coupon configuration
+   */
+  export interface AppliedCoupon {
+    /**
+     * Billing provider coupon ID
+     */
+    billingCouponId?: string;
+
+    /**
+     * Coupon timing configuration
+     */
+    configuration?: AppliedCoupon.Configuration;
+
+    /**
+     * Stigg coupon ID
+     */
+    couponId?: string;
+
+    /**
+     * Ad-hoc discount configuration
+     */
+    discount?: AppliedCoupon.Discount;
+
+    /**
+     * Promotion code to apply
+     */
+    promotionCode?: string;
+  }
+
+  export namespace AppliedCoupon {
+    /**
+     * Coupon timing configuration
+     */
+    export interface Configuration {
+      /**
+       * Coupon start date
+       */
+      startDate?: string;
+    }
+
+    /**
+     * Ad-hoc discount configuration
+     */
+    export interface Discount {
+      /**
+       * Fixed amounts off by currency
+       */
+      amountsOff?: Array<Discount.AmountsOff> | null;
+
+      /**
+       * Ad-hoc discount
+       */
+      description?: string;
+
+      /**
+       * Duration in months
+       */
+      durationInMonths?: number;
+
+      /**
+       * Discount name
+       */
+      name?: string;
+
+      /**
+       * Percentage discount
+       */
+      percentOff?: number;
+    }
+
+    export namespace Discount {
+      export interface AmountsOff {
+        /**
+         * The price amount
+         */
+        amount: number;
+
+        /**
+         * The price currency
+         */
+        currency:
+          | 'usd'
+          | 'aed'
+          | 'all'
+          | 'amd'
+          | 'ang'
+          | 'aud'
+          | 'awg'
+          | 'azn'
+          | 'bam'
+          | 'bbd'
+          | 'bdt'
+          | 'bgn'
+          | 'bif'
+          | 'bmd'
+          | 'bnd'
+          | 'bsd'
+          | 'bwp'
+          | 'byn'
+          | 'bzd'
+          | 'brl'
+          | 'cad'
+          | 'cdf'
+          | 'chf'
+          | 'cny'
+          | 'czk'
+          | 'dkk'
+          | 'dop'
+          | 'dzd'
+          | 'egp'
+          | 'etb'
+          | 'eur'
+          | 'fjd'
+          | 'gbp'
+          | 'gel'
+          | 'gip'
+          | 'gmd'
+          | 'gyd'
+          | 'hkd'
+          | 'hrk'
+          | 'htg'
+          | 'idr'
+          | 'ils'
+          | 'inr'
+          | 'isk'
+          | 'jmd'
+          | 'jpy'
+          | 'kes'
+          | 'kgs'
+          | 'khr'
+          | 'kmf'
+          | 'krw'
+          | 'kyd'
+          | 'kzt'
+          | 'lbp'
+          | 'lkr'
+          | 'lrd'
+          | 'lsl'
+          | 'mad'
+          | 'mdl'
+          | 'mga'
+          | 'mkd'
+          | 'mmk'
+          | 'mnt'
+          | 'mop'
+          | 'mro'
+          | 'mvr'
+          | 'mwk'
+          | 'mxn'
+          | 'myr'
+          | 'mzn'
+          | 'nad'
+          | 'ngn'
+          | 'nok'
+          | 'npr'
+          | 'nzd'
+          | 'pgk'
+          | 'php'
+          | 'pkr'
+          | 'pln'
+          | 'qar'
+          | 'ron'
+          | 'rsd'
+          | 'rub'
+          | 'rwf'
+          | 'sar'
+          | 'sbd'
+          | 'scr'
+          | 'sek'
+          | 'sgd'
+          | 'sle'
+          | 'sll'
+          | 'sos'
+          | 'szl'
+          | 'thb'
+          | 'tjs'
+          | 'top'
+          | 'try'
+          | 'ttd'
+          | 'tzs'
+          | 'uah'
+          | 'uzs'
+          | 'vnd'
+          | 'vuv'
+          | 'wst'
+          | 'xaf'
+          | 'xcd'
+          | 'yer'
+          | 'zar'
+          | 'zmw'
+          | 'clp'
+          | 'djf'
+          | 'gnf'
+          | 'ugx'
+          | 'pyg'
+          | 'xof'
+          | 'xpf';
+      }
+    }
+  }
 
-export namespace SubscriptionTransferResponse {
-  export interface Data {
+  export interface BillingInformation {
     /**
-     * Subscription ID
+     * Billing address for the subscription
      */
-    id: string;
+    billingAddress?: BillingInformation.BillingAddress;
 
     /**
-     * Billing ID
+     * Stripe Connect account to charge on behalf of
      */
-    billingId: string | null;
+    chargeOnBehalfOfAccount?: string | null;
 
     /**
-     * Created at
+     * Billing integration identifier
      */
-    createdAt: string;
+    integrationId?: string | null;
 
     /**
-     * Customer ID
+     * Number of days until invoice is due
      */
-    customerId: string;
+    invoiceDaysUntilDue?: number;
 
     /**
-     * Payment collection
+     * Whether the subscription is backdated
      */
-    paymentCollection: 'NOT_REQUIRED' | 'PROCESSING' | 'FAILED' | 'ACTION_REQUIRED';
+    isBackdated?: boolean;
 
     /**
-     * Plan ID
+     * Whether the invoice is marked as paid
      */
-    planId: string;
+    isInvoicePaid?: boolean;
 
     /**
-     * Pricing type
+     * Additional metadata for the subscription
      */
-    pricingType: 'FREE' | 'PAID' | 'CUSTOM';
+    metadata?: { [key: string]: string };
 
     /**
-     * Subscription start date
+     * How to handle proration for billing changes
      */
-    startDate: string;
+    prorationBehavior?: 'INVOICE_IMMEDIATELY' | 'CREATE_PRORATIONS' | 'NONE';
 
     /**
-     * Subscription status
+     * Customer tax identification numbers
      */
-    status: 'PAYMENT_PENDING' | 'ACTIVE' | 'EXPIRED' | 'IN_TRIAL' | 'CANCELED' | 'NOT_STARTED';
+    taxIds?: Array<BillingInformation.TaxID>;
 
     /**
-     * Subscription cancellation date
+     * Tax percentage (0-100)
      */
-    cancellationDate?: string | null;
+    taxPercentage?: number;
 
     /**
-     * Subscription cancel reason
+     * Tax rate identifiers to apply
      */
-    cancelReason?:
-      | 'UPGRADE_OR_DOWNGRADE'
-      | 'CANCELLED_BY_BILLING'
-      | 'EXPIRED'
-      | 'DETACH_BILLING'
-      | 'TRIAL_ENDED'
-      | 'Immediate'
-      | 'TRIAL_CONVERTED'
-      | 'PENDING_PAYMENT_EXPIRED'
-      | 'ScheduledCancellation'
-      | 'CustomerArchived'
-      | 'AutoCancellationRule'
-      | null;
+    taxRateIds?: Array<string>;
+  }
 
+  export namespace BillingInformation {
     /**
-     * End of the current billing period
+     * Billing address for the subscription
      */
-    currentBillingPeriodEnd?: string | null;
+    export interface BillingAddress {
+      city?: string;
 
-    /**
-     * Start of the current billing period
-     */
-    currentBillingPeriodStart?: string | null;
+      country?: string;
 
-    /**
-     * Subscription effective end date
-     */
-    effectiveEndDate?: string | null;
+      line1?: string;
 
-    /**
-     * Subscription end date
-     */
-    endDate?: string | null;
+      line2?: string;
+
+      postalCode?: string;
+
+      state?: string;
+    }
+
+    export interface TaxID {
+      /**
+       * The type of tax exemption identifier, such as VAT.
+       */
+      type: string;
+
+      /**
+       * The actual tax identifier value
+       */
+      value: string;
+    }
+  }
 
+  export interface Budget {
     /**
-     * Additional metadata for the subscription
+     * Whether the budget is a soft limit
      */
-    metadata?: { [key: string]: string };
+    hasSoftLimit: boolean;
 
     /**
-     * Paying customer ID for delegated billing
+     * Maximum spending limit
      */
-    payingCustomerId?: string | null;
+    limit: number;
+  }
 
+  /**
+   * Charge item
+   */
+  export interface Charge {
     /**
-     * The method used to collect payments for a subscription
+     * Charge ID
      */
-    paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
+    id: string;
 
     /**
-     * Resource ID
+     * Charge quantity
      */
-    resourceId?: string | null;
+    quantity: number;
 
     /**
-     * Subscription trial end date
+     * Charge type
      */
-    trialEndDate?: string | null;
+    type: 'FEATURE' | 'CREDIT';
   }
-}
-
-export interface SubscriptionCreateParams {
-  /**
-   * Customer ID to provision the subscription for
-   */
-  customerId: string;
-
-  /**
-   * Plan ID to provision
-   */
-  planId: string;
-
-  /**
-   * Unique identifier for the subscription
-   */
-  id?: string | null;
-
-  /**
-   * Whether to wait for payment confirmation before returning the subscription
-   */
-  awaitPaymentConfirmation?: boolean;
-
-  billingPeriod?: 'MONTHLY' | 'ANNUALLY';
-
-  checkoutOptions?: SubscriptionCreateParams.CheckoutOptions;
 
   /**
-   * Additional metadata for the subscription
-   */
-  metadata?: { [key: string]: string };
-
-  /**
-   * Optional paying customer ID for split billing scenarios
-   */
-  payingCustomerId?: string | null;
-
-  /**
-   * Optional resource ID for multi-instance subscriptions
+   * Checkout page configuration for payment collection
    */
-  resourceId?: string | null;
-
-  trialOverrideConfiguration?: SubscriptionCreateParams.TrialOverrideConfiguration;
-}
-
-export namespace SubscriptionCreateParams {
   export interface CheckoutOptions {
     /**
      * URL to redirect to if checkout is canceled
@@ -1078,145 +3058,513 @@ export namespace SubscriptionCreateParams {
     referenceId?: string | null;
   }
 
-  export interface TrialOverrideConfiguration {
-    /**
-     * Whether the subscription should start with a trial period
-     */
-    isTrial: boolean;
-
+  export interface MinimumSpend {
     /**
-     * Behavior when trial ends: CONVERT_TO_PAID or CANCEL_SUBSCRIPTION
+     * Minimum spend amount
      */
-    trialEndBehavior?: 'CONVERT_TO_PAID' | 'CANCEL_SUBSCRIPTION';
+    minimum?: MinimumSpend.Minimum | null;
+  }
 
+  export namespace MinimumSpend {
     /**
-     * Custom trial end date
+     * Minimum spend amount
      */
-    trialEndDate?: string;
-  }
-}
-
-export interface SubscriptionListParams extends MyCursorIDPageParams {
-  /**
-   * Filter by customer ID
-   */
-  customerId?: string;
-
-  /**
-   * Filter by subscription status (comma-separated for multiple statuses, e.g.,
-   * ACTIVE,IN_TRIAL)
-   */
-  status?: string;
-}
-
-export interface SubscriptionDelegateParams {
-  /**
-   * The customer ID to delegate the subscription to
-   */
-  targetCustomerId: string;
-}
-
-export interface SubscriptionMigrateParams {
-  /**
-   * When to migrate the subscription: IMMEDIATE or END_OF_BILLING_PERIOD
-   */
-  subscriptionMigrationTime?: 'END_OF_BILLING_PERIOD' | 'IMMEDIATE';
-}
-
-export interface SubscriptionPreviewParams {
-  /**
-   * Customer ID
-   */
-  customerId: string;
-
-  /**
-   * Plan ID
-   */
-  planId: string;
-
-  addons?: Array<SubscriptionPreviewParams.Addon>;
-
-  appliedCoupon?: SubscriptionPreviewParams.AppliedCoupon;
-
-  billableFeatures?: Array<SubscriptionPreviewParams.BillableFeature>;
-
-  billingCountryCode?: string;
-
-  billingInformation?: SubscriptionPreviewParams.BillingInformation;
-
-  billingPeriod?: 'MONTHLY' | 'ANNUALLY';
+    export interface Minimum {
+      /**
+       * The price amount
+       */
+      amount?: number;
 
-  charges?: Array<SubscriptionPreviewParams.Charge>;
+      /**
+       * The billing country code of the price
+       */
+      billingCountryCode?: string | null;
 
-  payingCustomerId?: string;
+      /**
+       * The price currency
+       */
+      currency?:
+        | 'usd'
+        | 'aed'
+        | 'all'
+        | 'amd'
+        | 'ang'
+        | 'aud'
+        | 'awg'
+        | 'azn'
+        | 'bam'
+        | 'bbd'
+        | 'bdt'
+        | 'bgn'
+        | 'bif'
+        | 'bmd'
+        | 'bnd'
+        | 'bsd'
+        | 'bwp'
+        | 'byn'
+        | 'bzd'
+        | 'brl'
+        | 'cad'
+        | 'cdf'
+        | 'chf'
+        | 'cny'
+        | 'czk'
+        | 'dkk'
+        | 'dop'
+        | 'dzd'
+        | 'egp'
+        | 'etb'
+        | 'eur'
+        | 'fjd'
+        | 'gbp'
+        | 'gel'
+        | 'gip'
+        | 'gmd'
+        | 'gyd'
+        | 'hkd'
+        | 'hrk'
+        | 'htg'
+        | 'idr'
+        | 'ils'
+        | 'inr'
+        | 'isk'
+        | 'jmd'
+        | 'jpy'
+        | 'kes'
+        | 'kgs'
+        | 'khr'
+        | 'kmf'
+        | 'krw'
+        | 'kyd'
+        | 'kzt'
+        | 'lbp'
+        | 'lkr'
+        | 'lrd'
+        | 'lsl'
+        | 'mad'
+        | 'mdl'
+        | 'mga'
+        | 'mkd'
+        | 'mmk'
+        | 'mnt'
+        | 'mop'
+        | 'mro'
+        | 'mvr'
+        | 'mwk'
+        | 'mxn'
+        | 'myr'
+        | 'mzn'
+        | 'nad'
+        | 'ngn'
+        | 'nok'
+        | 'npr'
+        | 'nzd'
+        | 'pgk'
+        | 'php'
+        | 'pkr'
+        | 'pln'
+        | 'qar'
+        | 'ron'
+        | 'rsd'
+        | 'rub'
+        | 'rwf'
+        | 'sar'
+        | 'sbd'
+        | 'scr'
+        | 'sek'
+        | 'sgd'
+        | 'sle'
+        | 'sll'
+        | 'sos'
+        | 'szl'
+        | 'thb'
+        | 'tjs'
+        | 'top'
+        | 'try'
+        | 'ttd'
+        | 'tzs'
+        | 'uah'
+        | 'uzs'
+        | 'vnd'
+        | 'vuv'
+        | 'wst'
+        | 'xaf'
+        | 'xcd'
+        | 'yer'
+        | 'zar'
+        | 'zmw'
+        | 'clp'
+        | 'djf'
+        | 'gnf'
+        | 'ugx'
+        | 'pyg'
+        | 'xof'
+        | 'xpf';
+    }
+  }
 
-  resourceId?: string;
+  export interface PriceOverride {
+    /**
+     * Addon identifier for the price override
+     */
+    addonId?: string | null;
 
-  scheduleStrategy?: 'END_OF_BILLING_PERIOD' | 'END_OF_BILLING_MONTH' | 'IMMEDIATE';
+    /**
+     * Whether this is a base charge override
+     */
+    baseCharge?: boolean;
 
-  /**
-   * Subscription start date
-   */
-  startDate?: string;
+    /**
+     * Block size for pricing
+     */
+    blockSize?: number;
 
-  trialOverrideConfiguration?: SubscriptionPreviewParams.TrialOverrideConfiguration;
+    creditGrantCadence?: 'BEGINNING_OF_BILLING_PERIOD' | 'MONTHLY';
 
-  unitQuantity?: number;
-}
+    creditRate?: PriceOverride.CreditRate;
 
-export namespace SubscriptionPreviewParams {
-  export interface Addon {
     /**
-     * Addon ID
+     * Feature identifier for the price override
      */
-    addonId: string;
+    featureId?: string | null;
 
-    quantity?: number;
+    /**
+     * Override price amount
+     */
+    price?: PriceOverride.Price;
+
+    /**
+     * Pricing tiers configuration
+     */
+    tiers?: Array<PriceOverride.Tier>;
   }
 
-  export interface AppliedCoupon {
-    billingCouponId?: string;
+  export namespace PriceOverride {
+    export interface CreditRate {
+      /**
+       * The credit rate amount
+       */
+      amount: number;
 
-    configuration?: AppliedCoupon.Configuration;
+      /**
+       * The custom currency refId for the credit rate
+       */
+      currencyId: string;
 
-    couponId?: string;
+      /**
+       * A custom formula for calculating cost based on single event dimensions
+       */
+      costFormula?: string | null;
+    }
 
-    discount?: AppliedCoupon.Discount;
+    /**
+     * Override price amount
+     */
+    export interface Price {
+      /**
+       * The price amount
+       */
+      amount?: number;
 
-    promotionCode?: string;
-  }
+      /**
+       * The billing country code of the price
+       */
+      billingCountryCode?: string | null;
 
-  export namespace AppliedCoupon {
-    export interface Configuration {
       /**
-       * Coupon start date
+       * The price currency
        */
-      startDate?: string;
+      currency?:
+        | 'usd'
+        | 'aed'
+        | 'all'
+        | 'amd'
+        | 'ang'
+        | 'aud'
+        | 'awg'
+        | 'azn'
+        | 'bam'
+        | 'bbd'
+        | 'bdt'
+        | 'bgn'
+        | 'bif'
+        | 'bmd'
+        | 'bnd'
+        | 'bsd'
+        | 'bwp'
+        | 'byn'
+        | 'bzd'
+        | 'brl'
+        | 'cad'
+        | 'cdf'
+        | 'chf'
+        | 'cny'
+        | 'czk'
+        | 'dkk'
+        | 'dop'
+        | 'dzd'
+        | 'egp'
+        | 'etb'
+        | 'eur'
+        | 'fjd'
+        | 'gbp'
+        | 'gel'
+        | 'gip'
+        | 'gmd'
+        | 'gyd'
+        | 'hkd'
+        | 'hrk'
+        | 'htg'
+        | 'idr'
+        | 'ils'
+        | 'inr'
+        | 'isk'
+        | 'jmd'
+        | 'jpy'
+        | 'kes'
+        | 'kgs'
+        | 'khr'
+        | 'kmf'
+        | 'krw'
+        | 'kyd'
+        | 'kzt'
+        | 'lbp'
+        | 'lkr'
+        | 'lrd'
+        | 'lsl'
+        | 'mad'
+        | 'mdl'
+        | 'mga'
+        | 'mkd'
+        | 'mmk'
+        | 'mnt'
+        | 'mop'
+        | 'mro'
+        | 'mvr'
+        | 'mwk'
+        | 'mxn'
+        | 'myr'
+        | 'mzn'
+        | 'nad'
+        | 'ngn'
+        | 'nok'
+        | 'npr'
+        | 'nzd'
+        | 'pgk'
+        | 'php'
+        | 'pkr'
+        | 'pln'
+        | 'qar'
+        | 'ron'
+        | 'rsd'
+        | 'rub'
+        | 'rwf'
+        | 'sar'
+        | 'sbd'
+        | 'scr'
+        | 'sek'
+        | 'sgd'
+        | 'sle'
+        | 'sll'
+        | 'sos'
+        | 'szl'
+        | 'thb'
+        | 'tjs'
+        | 'top'
+        | 'try'
+        | 'ttd'
+        | 'tzs'
+        | 'uah'
+        | 'uzs'
+        | 'vnd'
+        | 'vuv'
+        | 'wst'
+        | 'xaf'
+        | 'xcd'
+        | 'yer'
+        | 'zar'
+        | 'zmw'
+        | 'clp'
+        | 'djf'
+        | 'gnf'
+        | 'ugx'
+        | 'pyg'
+        | 'xof'
+        | 'xpf';
     }
 
-    export interface Discount {
-      amountsOff?: Array<Discount.AmountsOff> | null;
+    export interface Tier {
+      /**
+       * The flat fee price of the price tier
+       */
+      flatPrice?: Tier.FlatPrice;
 
-      description?: string;
+      /**
+       * The unit price of the price tier
+       */
+      unitPrice?: Tier.UnitPrice;
 
-      durationInMonths?: number;
+      /**
+       * The up to quantity of the price tier
+       */
+      upTo?: number;
+    }
 
-      name?: string;
+    export namespace Tier {
+      /**
+       * The flat fee price of the price tier
+       */
+      export interface FlatPrice {
+        /**
+         * The price amount
+         */
+        amount?: number;
 
-      percentOff?: number;
-    }
+        /**
+         * The billing country code of the price
+         */
+        billingCountryCode?: string | null;
 
-    export namespace Discount {
-      export interface AmountsOff {
+        /**
+         * The price currency
+         */
+        currency?:
+          | 'usd'
+          | 'aed'
+          | 'all'
+          | 'amd'
+          | 'ang'
+          | 'aud'
+          | 'awg'
+          | 'azn'
+          | 'bam'
+          | 'bbd'
+          | 'bdt'
+          | 'bgn'
+          | 'bif'
+          | 'bmd'
+          | 'bnd'
+          | 'bsd'
+          | 'bwp'
+          | 'byn'
+          | 'bzd'
+          | 'brl'
+          | 'cad'
+          | 'cdf'
+          | 'chf'
+          | 'cny'
+          | 'czk'
+          | 'dkk'
+          | 'dop'
+          | 'dzd'
+          | 'egp'
+          | 'etb'
+          | 'eur'
+          | 'fjd'
+          | 'gbp'
+          | 'gel'
+          | 'gip'
+          | 'gmd'
+          | 'gyd'
+          | 'hkd'
+          | 'hrk'
+          | 'htg'
+          | 'idr'
+          | 'ils'
+          | 'inr'
+          | 'isk'
+          | 'jmd'
+          | 'jpy'
+          | 'kes'
+          | 'kgs'
+          | 'khr'
+          | 'kmf'
+          | 'krw'
+          | 'kyd'
+          | 'kzt'
+          | 'lbp'
+          | 'lkr'
+          | 'lrd'
+          | 'lsl'
+          | 'mad'
+          | 'mdl'
+          | 'mga'
+          | 'mkd'
+          | 'mmk'
+          | 'mnt'
+          | 'mop'
+          | 'mro'
+          | 'mvr'
+          | 'mwk'
+          | 'mxn'
+          | 'myr'
+          | 'mzn'
+          | 'nad'
+          | 'ngn'
+          | 'nok'
+          | 'npr'
+          | 'nzd'
+          | 'pgk'
+          | 'php'
+          | 'pkr'
+          | 'pln'
+          | 'qar'
+          | 'ron'
+          | 'rsd'
+          | 'rub'
+          | 'rwf'
+          | 'sar'
+          | 'sbd'
+          | 'scr'
+          | 'sek'
+          | 'sgd'
+          | 'sle'
+          | 'sll'
+          | 'sos'
+          | 'szl'
+          | 'thb'
+          | 'tjs'
+          | 'top'
+          | 'try'
+          | 'ttd'
+          | 'tzs'
+          | 'uah'
+          | 'uzs'
+          | 'vnd'
+          | 'vuv'
+          | 'wst'
+          | 'xaf'
+          | 'xcd'
+          | 'yer'
+          | 'zar'
+          | 'zmw'
+          | 'clp'
+          | 'djf'
+          | 'gnf'
+          | 'ugx'
+          | 'pyg'
+          | 'xof'
+          | 'xpf';
+      }
+
+      /**
+       * The unit price of the price tier
+       */
+      export interface UnitPrice {
         /**
          * The price amount
          */
-        amount: number;
+        amount?: number;
+
+        /**
+         * The billing country code of the price
+         */
+        billingCountryCode?: string | null;
 
         /**
          * The price currency
          */
-        currency:
+        currency?:
           | 'usd'
           | 'aed'
           | 'all'
@@ -1337,79 +3685,33 @@ export namespace SubscriptionPreviewParams {
     }
   }
 
-  export interface BillableFeature {
+  export interface SubscriptionEntitlement {
     /**
      * Feature ID
      */
     featureId: string;
 
-    quantity: number;
-  }
-
-  export interface BillingInformation {
-    billingAddress?: BillingInformation.BillingAddress;
-
-    chargeOnBehalfOfAccount?: string;
-
-    integrationId?: string;
-
-    invoiceDaysUntilDue?: number;
-
-    isBackdated?: boolean;
-
-    isInvoicePaid?: boolean;
-
-    metadata?: unknown;
-
-    prorationBehavior?: 'INVOICE_IMMEDIATELY' | 'CREATE_PRORATIONS' | 'NONE';
-
-    taxIds?: Array<BillingInformation.TaxID>;
-
-    taxPercentage?: number;
-
-    taxRateIds?: Array<string>;
-  }
-
-  export namespace BillingInformation {
-    export interface BillingAddress {
-      city?: string;
-
-      country?: string;
-
-      line1?: string;
-
-      line2?: string;
-
-      postalCode?: string;
-
-      state?: string;
-    }
-
-    export interface TaxID {
-      type: string;
+    usageLimit: number;
 
-      value: string;
-    }
+    isGranted?: boolean;
   }
 
-  export interface Charge {
+  /**
+   * Trial period override settings
+   */
+  export interface TrialOverrideConfiguration {
     /**
-     * Charge ID
+     * Whether the subscription should start with a trial period
      */
-    id: string;
-
-    quantity: number;
-
-    type: 'FEATURE' | 'CREDIT';
-  }
-
-  export interface TrialOverrideConfiguration {
     isTrial: boolean;
 
+    /**
+     * Behavior when trial ends: CONVERT_TO_PAID or CANCEL_SUBSCRIPTION
+     */
     trialEndBehavior?: 'CONVERT_TO_PAID' | 'CANCEL_SUBSCRIPTION';
 
     /**
-     * Trial end date
+     * Custom trial end date
      */
     trialEndDate?: string;
   }
@@ -1417,8 +3719,7 @@ export namespace SubscriptionPreviewParams {
 
 export interface SubscriptionTransferParams {
   /**
-   * The resource ID to transfer the subscription to. The destination resource must
-   * belong to the same customer.
+   * Resource ID to transfer the subscription to
    */
   destinationResourceId: string;
 }
@@ -1427,25 +3728,22 @@ Subscriptions.FutureUpdate = FutureUpdate;
 
 export declare namespace Subscriptions {
   export {
-    type SubscriptionCreateResponse as SubscriptionCreateResponse,
-    type SubscriptionRetrieveResponse as SubscriptionRetrieveResponse,
+    type Subscription as Subscription,
     type SubscriptionListResponse as SubscriptionListResponse,
-    type SubscriptionDelegateResponse as SubscriptionDelegateResponse,
-    type SubscriptionMigrateResponse as SubscriptionMigrateResponse,
+    type SubscriptionImportResponse as SubscriptionImportResponse,
     type SubscriptionPreviewResponse as SubscriptionPreviewResponse,
-    type SubscriptionTransferResponse as SubscriptionTransferResponse,
+    type SubscriptionProvisionResponse as SubscriptionProvisionResponse,
     type SubscriptionListResponsesMyCursorIDPage as SubscriptionListResponsesMyCursorIDPage,
-    type SubscriptionCreateParams as SubscriptionCreateParams,
+    type SubscriptionUpdateParams as SubscriptionUpdateParams,
     type SubscriptionListParams as SubscriptionListParams,
+    type SubscriptionCancelParams as SubscriptionCancelParams,
     type SubscriptionDelegateParams as SubscriptionDelegateParams,
+    type SubscriptionImportParams as SubscriptionImportParams,
     type SubscriptionMigrateParams as SubscriptionMigrateParams,
     type SubscriptionPreviewParams as SubscriptionPreviewParams,
+    type SubscriptionProvisionParams as SubscriptionProvisionParams,
     type SubscriptionTransferParams as SubscriptionTransferParams,
   };
 
-  export {
-    FutureUpdate as FutureUpdate,
-    type FutureUpdateCancelPendingPaymentResponse as FutureUpdateCancelPendingPaymentResponse,
-    type FutureUpdateCancelScheduleResponse as FutureUpdateCancelScheduleResponse,
-  };
+  export { FutureUpdate as FutureUpdate, type CancelSubscription as CancelSubscription };
 }