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

package/resources/v1/subscriptions/subscriptions.d.ts

@@ -1,159 +1,66 @@
 import { APIResource } from "../../../core/resource.js";
 import * as FutureUpdateAPI from "./future-update.js";
-import { FutureUpdate, FutureUpdateCancelPendingPaymentResponse, FutureUpdateCancelScheduleResponse } from "./future-update.js";
+import { CancelSubscription, FutureUpdate } from "./future-update.js";
 import { APIPromise } from "../../../core/api-promise.js";
 import { MyCursorIDPage, type MyCursorIDPageParams, PagePromise } from "../../../core/pagination.js";
 import { RequestOptions } from "../../../internal/request-options.js";
 export declare class Subscriptions extends APIResource {
     futureUpdate: FutureUpdateAPI.FutureUpdate;
     /**
-     * Create a new Subscription
+     * Get a single subscription by ID
      */
-    create(body: SubscriptionCreateParams, options?: RequestOptions): APIPromise<SubscriptionCreateResponse>;
+    retrieve(id: string, options?: RequestOptions): APIPromise<Subscription>;
     /**
-     * Get a single Subscription by id
+     * Update a subscription
      */
-    retrieve(id: string, options?: RequestOptions): APIPromise<SubscriptionRetrieveResponse>;
+    update(id: string, body: SubscriptionUpdateParams, options?: RequestOptions): APIPromise<Subscription>;
     /**
-     * Get a list of Subscriptions
+     * Get a list of subscriptions
      */
     list(query?: SubscriptionListParams | null | undefined, options?: RequestOptions): PagePromise<SubscriptionListResponsesMyCursorIDPage, SubscriptionListResponse>;
     /**
-     * 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>;
     /**
-     * Perform migrate to latest plan version on a Subscription
+     * Delegate subscription payment to customer
      */
-    migrate(id: string, body: SubscriptionMigrateParams, options?: RequestOptions): APIPromise<SubscriptionMigrateResponse>;
+    delegate(id: string, body: SubscriptionDelegateParams, options?: RequestOptions): APIPromise<Subscription>;
     /**
-     * Create a new Subscription Preview
+     * Bulk import subscriptions
+     */
+    import(body: SubscriptionImportParams, options?: RequestOptions): APIPromise<SubscriptionImportResponse>;
+    /**
+     * Migrate subscription to latest plan version
+     */
+    migrate(id: string, body: SubscriptionMigrateParams, options?: RequestOptions): APIPromise<Subscription>;
+    /**
+     * Preview subscription
      */
     preview(body: SubscriptionPreviewParams, options?: RequestOptions): APIPromise<SubscriptionPreviewResponse>;
     /**
-     * Perform transfer to resource on a Subscription
+     * Provision subscription
      */
-    transfer(id: string, body: SubscriptionTransferParams, options?: RequestOptions): APIPromise<SubscriptionTransferResponse>;
+    provision(body: SubscriptionProvisionParams, options?: RequestOptions): APIPromise<SubscriptionProvisionResponse>;
+    /**
+     * Transfer subscription to resource
+     */
+    transfer(id: string, body: SubscriptionTransferParams, options?: RequestOptions): APIPromise<Subscription>;
 }
 export type SubscriptionListResponsesMyCursorIDPage = MyCursorIDPage<SubscriptionListResponse>;
-export interface SubscriptionCreateResponse {
-    data: SubscriptionCreateResponse.Data;
-}
-export declare namespace SubscriptionCreateResponse {
-    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;
-    }
-    namespace Data {
-        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 declare namespace SubscriptionRetrieveResponse {
+export declare namespace Subscription {
+    /**
+     * Customer subscription to a plan
+     */
     interface Data {
         /**
          * Subscription ID
@@ -229,6 +136,7 @@ export declare namespace SubscriptionRetrieveResponse {
          * The method used to collect payments for a subscription
          */
         paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
+        prices?: Array<Data.Price>;
         /**
          * Resource ID
          */
@@ -238,7 +146,27 @@ export declare namespace SubscriptionRetrieveResponse {
          */
         trialEndDate?: string | null;
     }
+    namespace Data {
+        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
@@ -314,6 +242,7 @@ export interface SubscriptionListResponse {
      * The method used to collect payments for a subscription
      */
     paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
+    prices?: Array<SubscriptionListResponse.Price>;
     /**
      * Resource ID
      */
@@ -323,209 +252,122 @@ export interface SubscriptionListResponse {
      */
     trialEndDate?: string | null;
 }
-export interface SubscriptionDelegateResponse {
-    data: SubscriptionDelegateResponse.Data;
-}
-export declare namespace SubscriptionDelegateResponse {
-    interface Data {
+export declare namespace SubscriptionListResponse {
+    interface Price {
         /**
-         * Subscription ID
+         * Price ID
          */
         id: string;
         /**
-         * Billing ID
-         */
-        billingId: string | null;
-        /**
-         * Created at
+         * Creation timestamp
          */
         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
+         * Last update timestamp
          */
-        trialEndDate?: string | null;
+        updatedAt: string;
+        [k: string]: unknown;
     }
 }
-export interface SubscriptionMigrateResponse {
-    data: SubscriptionMigrateResponse.Data;
+/**
+ * Response object
+ */
+export interface SubscriptionImportResponse {
+    data: SubscriptionImportResponse.Data;
 }
-export declare namespace SubscriptionMigrateResponse {
+export declare namespace SubscriptionImportResponse {
     interface Data {
         /**
-         * Subscription ID
-         */
-        id: string;
-        /**
-         * Billing ID
-         */
-        billingId: string | null;
-        /**
-         * Created at
-         */
-        createdAt: string;
-        /**
-         * Customer ID
+         * Unique identifier for the import task
          */
-        customerId: string;
+        taskId: string;
+    }
+}
+/**
+ * Response object
+ */
+export interface SubscriptionPreviewResponse {
+    /**
+     * Pricing preview with invoices
+     */
+    data: SubscriptionPreviewResponse.Data;
+}
+export declare namespace SubscriptionPreviewResponse {
+    /**
+     * Pricing preview with invoices
+     */
+    interface Data {
         /**
-         * Payment collection
+         * Invoice due immediately
          */
-        paymentCollection: 'NOT_REQUIRED' | 'PROCESSING' | 'FAILED' | 'ACTION_REQUIRED';
+        immediateInvoice: Data.ImmediateInvoice;
         /**
-         * Plan ID
+         * Billing period range
          */
-        planId: string;
+        billingPeriodRange?: Data.BillingPeriodRange;
         /**
-         * Pricing type
+         * Free items included
          */
-        pricingType: 'FREE' | 'PAID' | 'CUSTOM';
+        freeItems?: Array<Data.FreeItem>;
         /**
-         * Subscription start date
+         * Whether updates are scheduled
          */
-        startDate: string;
+        hasScheduledUpdates?: boolean;
         /**
-         * Subscription status
+         * Whether this is a downgrade
          */
-        status: 'PAYMENT_PENDING' | 'ACTIVE' | 'EXPIRED' | 'IN_TRIAL' | 'CANCELED' | 'NOT_STARTED';
+        isPlanDowngrade?: boolean;
         /**
-         * Subscription cancellation date
+         * Recurring invoice preview
          */
-        cancellationDate?: string | null;
+        recurringInvoice?: Data.RecurringInvoice;
+    }
+    namespace Data {
         /**
-         * Subscription cancel reason
+         * Invoice due immediately
          */
-        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 declare namespace SubscriptionPreviewResponse {
-    interface Data {
-        immediateInvoice: Data.ImmediateInvoice;
-        billingPeriodRange?: Data.BillingPeriodRange;
-        freeItems?: Array<Data.FreeItem>;
-        hasScheduledUpdates?: boolean;
-        isPlanDowngrade?: boolean;
-        recurringInvoice?: Data.RecurringInvoice;
-    }
-    namespace Data {
         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;
         }
         namespace ImmediateInvoice {
+            /**
+             * Billing period covered
+             */
             interface BillingPeriodRange {
                 /**
                  * Billing period end date
@@ -536,24 +378,69 @@ export declare namespace SubscriptionPreviewResponse {
                  */
                 start: string;
             }
+            /**
+             * Discount breakdown
+             */
             interface DiscountDetails {
+                /**
+                 * Promo code used
+                 */
                 code?: string;
+                /**
+                 * Fixed discount amount
+                 */
                 fixedAmount?: number;
+                /**
+                 * Percentage discount
+                 */
                 percentage?: number;
             }
+            /**
+             * Applied discount amount
+             */
             interface Discount {
+                /**
+                 * Discount amount
+                 */
                 amount: number;
+                /**
+                 * Currency code
+                 */
                 currency: string;
+                /**
+                 * Discount description
+                 */
                 description: string;
             }
+            /**
+             * Invoice line item
+             */
             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
+         */
         interface BillingPeriodRange {
             /**
              * Billing period end date
@@ -564,22 +451,64 @@ export declare namespace SubscriptionPreviewResponse {
              */
             start?: string;
         }
+        /**
+         * Free item in subscription
+         */
         interface FreeItem {
+            /**
+             * Addon ID
+             */
             addonId: string;
+            /**
+             * Quantity
+             */
             quantity: number;
         }
+        /**
+         * Recurring invoice preview
+         */
         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;
         }
         namespace RecurringInvoice {
+            /**
+             * Billing period covered
+             */
             interface BillingPeriodRange {
                 /**
                  * Billing period end date
@@ -590,272 +519,1010 @@ export declare namespace SubscriptionPreviewResponse {
                  */
                 start: string;
             }
+            /**
+             * Discount breakdown
+             */
             interface DiscountDetails {
+                /**
+                 * Promo code used
+                 */
                 code?: string;
+                /**
+                 * Fixed discount amount
+                 */
                 fixedAmount?: number;
+                /**
+                 * Percentage discount
+                 */
                 percentage?: number;
             }
+            /**
+             * Applied discount amount
+             */
             interface Discount {
+                /**
+                 * Discount amount
+                 */
                 amount: number;
+                /**
+                 * Currency code
+                 */
                 currency: string;
+                /**
+                 * Discount description
+                 */
                 description: string;
             }
+            /**
+             * Invoice line item
+             */
             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 declare namespace SubscriptionTransferResponse {
+export declare namespace SubscriptionProvisionResponse {
+    /**
+     * Provisioning result with status and subscription or checkout URL.
+     */
     interface Data {
         /**
-         * Subscription ID
+         * Unique identifier for the provisioned subscription
          */
         id: string;
+        entitlements: Array<Data.Entitlement>;
         /**
-         * 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
+         * Provision status: SUCCESS or PAYMENT_REQUIRED
          */
-        endDate?: string | null;
+        status: 'SUCCESS' | 'PAYMENT_REQUIRED';
         /**
-         * Additional metadata for the subscription
+         * Checkout billing ID when payment is required
          */
-        metadata?: {
-            [key: string]: string;
-        };
+        checkoutBillingId?: string | null;
         /**
-         * Paying customer ID for delegated billing
+         * URL to complete payment when PAYMENT_REQUIRED
          */
-        payingCustomerId?: string | null;
+        checkoutUrl?: string | null;
         /**
-         * The method used to collect payments for a subscription
+         * Whether the subscription is scheduled for future activation
          */
-        paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
+        isScheduled?: boolean;
         /**
-         * Resource ID
+         * Created subscription (when status is SUCCESS)
          */
-        resourceId?: string | null;
+        subscription?: Data.Subscription;
+    }
+    namespace Data {
+        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;
+        }
+        namespace Entitlement {
+            interface Feature {
+                /**
+                 * Feature ID
+                 */
+                refId: string;
+            }
+        }
         /**
-         * Subscription trial end date
+         * Created subscription (when status is SUCCESS)
          */
-        trialEndDate?: string | null;
-    }
-}
-export interface SubscriptionCreateParams {
+        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;
+        }
+        namespace Subscription {
+            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>;
+            }
+            namespace Price {
+                /**
+                 * Override price amount
+                 */
+                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';
+                }
+                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;
+                }
+                namespace Tier {
+                    /**
+                     * The flat fee price of the price tier
+                     */
+                    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
+                     */
+                    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>;
     /**
-     * Customer ID to provision the subscription for
+     * 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 declare namespace SubscriptionUpdateParams {
+    interface Addon {
+        /**
+         * Addon ID
+         */
+        addonId: string;
+        quantity: number;
+    }
+    interface AppliedCoupon {
+        billingCouponId?: string;
+        configuration?: AppliedCoupon.Configuration;
+        couponId?: string;
+        discount?: AppliedCoupon.Discount;
+        promotionCode?: string | null;
+    }
+    namespace AppliedCoupon {
+        interface Configuration {
+            /**
+             * Coupon start date
+             */
+            startDate?: string;
+        }
+        interface Discount {
+            amountsOff?: Array<Discount.AmountsOff> | null;
+            description?: string;
+            durationInMonths?: number;
+            name?: string;
+            percentOff?: number;
+        }
+        namespace Discount {
+            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';
+            }
+        }
+    }
+    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>;
+    }
+    namespace BillingInformation {
+        /**
+         * Physical address
+         */
+        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;
+        }
+        interface TaxID {
+            type: string;
+            value: string;
+        }
+    }
+    interface Budget {
+        hasSoftLimit: boolean;
+        limit: number;
+    }
+    interface Charge {
+        /**
+         * Charge ID
+         */
+        id: string;
+        quantity: number;
+        type: 'FEATURE' | 'CREDIT';
+    }
+    interface MinimumSpend {
+        minimum?: MinimumSpend.Minimum | null;
+    }
+    namespace MinimumSpend {
+        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';
+        }
+    }
+    interface PriceOverride {
+        /**
+         * Feature ID
+         */
+        featureId: string;
+        price?: PriceOverride.Price;
+    }
+    namespace PriceOverride {
+        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';
+        }
+    }
+    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;
+    }
+    namespace SubscriptionEntitlement {
+        interface MonthlyResetPeriodConfiguration {
+            accordingTo: 'SubscriptionStart' | 'StartOfTheMonth';
+        }
+        interface WeeklyResetPeriodConfiguration {
+            accordingTo: 'SubscriptionStart' | 'EverySunday' | 'EveryMonday' | 'EveryTuesday' | 'EveryWednesday' | 'EveryThursday' | 'EveryFriday' | 'EverySaturday';
+        }
+        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 declare namespace SubscriptionImportParams {
+    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 to provision
+     * Plan ID
      */
     planId: string;
     /**
-     * Unique identifier for the subscription
+     * Addons to include
      */
-    id?: string | null;
+    addons?: Array<SubscriptionPreviewParams.Addon>;
     /**
-     * Whether to wait for payment confirmation before returning the subscription
+     * 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)
      */
-    awaitPaymentConfirmation?: boolean;
     billingPeriod?: 'MONTHLY' | 'ANNUALLY';
-    checkoutOptions?: SubscriptionCreateParams.CheckoutOptions;
     /**
-     * Additional metadata for the subscription
+     * One-time or recurring charges
      */
-    metadata?: {
-        [key: string]: string;
-    };
+    charges?: Array<SubscriptionPreviewParams.Charge>;
     /**
-     * Optional paying customer ID for split billing scenarios
+     * Paying customer ID for delegated billing
      */
-    payingCustomerId?: string | null;
+    payingCustomerId?: string;
     /**
-     * Optional resource ID for multi-instance subscriptions
+     * Resource ID for multi-instance subscriptions
      */
-    resourceId?: string | null;
-    trialOverrideConfiguration?: SubscriptionCreateParams.TrialOverrideConfiguration;
+    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 declare namespace SubscriptionCreateParams {
-    interface CheckoutOptions {
+export declare namespace SubscriptionPreviewParams {
+    /**
+     * Addon configuration
+     */
+    interface Addon {
         /**
-         * URL to redirect to if checkout is canceled
+         * Addon ID
          */
-        cancelUrl: string;
+        addonId: string;
         /**
-         * URL to redirect to after successful checkout
+         * Number of addon instances
          */
-        successUrl: string;
+        quantity?: number;
+    }
+    /**
+     * Coupon or discount to apply
+     */
+    interface AppliedCoupon {
         /**
-         * Allow promotional codes during checkout
+         * Billing provider coupon ID
          */
-        allowPromoCodes?: boolean;
+        billingCouponId?: string;
         /**
-         * Allow tax ID collection during checkout
+         * Coupon timing configuration
          */
-        allowTaxIdCollection?: boolean;
+        configuration?: AppliedCoupon.Configuration;
         /**
-         * Collect billing address during checkout
+         * Stigg coupon ID
          */
-        collectBillingAddress?: boolean;
+        couponId?: string;
         /**
-         * Collect phone number during checkout
+         * Ad-hoc discount configuration
          */
-        collectPhoneNumber?: boolean;
+        discount?: AppliedCoupon.Discount;
         /**
-         * Optional reference ID for the checkout session
+         * Promotion code to apply
          */
-        referenceId?: string | null;
+        promotionCode?: string;
+    }
+    namespace AppliedCoupon {
+        /**
+         * Coupon timing configuration
+         */
+        interface Configuration {
+            /**
+             * Coupon start date
+             */
+            startDate?: string;
+        }
+        /**
+         * Ad-hoc discount configuration
+         */
+        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;
+        }
+        namespace Discount {
+            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
+     */
+    interface BillableFeature {
+        /**
+         * Feature ID
+         */
+        featureId: string;
+        /**
+         * Quantity of feature units
+         */
+        quantity: number;
+    }
+    /**
+     * Billing and tax configuration
+     */
+    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>;
+    }
+    namespace BillingInformation {
+        /**
+         * Billing address
+         */
+        interface BillingAddress {
+            city?: string;
+            country?: string;
+            line1?: string;
+            line2?: string;
+            postalCode?: string;
+            state?: string;
+        }
+        /**
+         * Tax exemption identifier
+         */
+        interface TaxID {
+            /**
+             * Tax exemption type (e.g., vat, gst)
+             */
+            type: string;
+            /**
+             * Tax exemption identifier value
+             */
+            value: string;
+        }
+    }
+    /**
+     * Charge item
+     */
+    interface Charge {
+        /**
+         * Charge ID
+         */
+        id: string;
+        /**
+         * Charge quantity
+         */
+        quantity: number;
+        /**
+         * Charge type
+         */
+        type: 'FEATURE' | 'CREDIT';
+    }
+    /**
+     * Trial period override settings
+     */
     interface TrialOverrideConfiguration {
         /**
-         * Whether the subscription should start with a trial period
+         * Whether to start as trial
          */
         isTrial: boolean;
         /**
-         * Behavior when trial ends: CONVERT_TO_PAID or CANCEL_SUBSCRIPTION
+         * Behavior when trial ends
          */
         trialEndBehavior?: 'CONVERT_TO_PAID' | 'CANCEL_SUBSCRIPTION';
         /**
-         * Custom trial end date
+         * Trial end date
          */
         trialEndDate?: string;
     }
 }
-export interface SubscriptionListParams extends MyCursorIDPageParams {
+export interface SubscriptionProvisionParams {
+    /**
+     * Customer ID to provision the subscription for
+     */
+    customerId: string;
     /**
-     * Filter by customer ID
+     * Plan ID to provision
      */
-    customerId?: string;
+    planId: string;
     /**
-     * Filter by subscription status (comma-separated for multiple statuses, e.g.,
-     * ACTIVE,IN_TRIAL)
+     * Unique identifier for the subscription
      */
-    status?: string;
-}
-export interface SubscriptionDelegateParams {
+    id?: string;
+    addons?: Array<SubscriptionProvisionParams.Addon>;
     /**
-     * The customer ID to delegate the subscription to
+     * Coupon configuration
      */
-    targetCustomerId: string;
-}
-export interface SubscriptionMigrateParams {
+    appliedCoupon?: SubscriptionProvisionParams.AppliedCoupon;
     /**
-     * When to migrate the subscription: IMMEDIATE or END_OF_BILLING_PERIOD
+     * Whether to wait for payment confirmation before returning the subscription
      */
-    subscriptionMigrationTime?: 'END_OF_BILLING_PERIOD' | 'IMMEDIATE';
-}
-export interface SubscriptionPreviewParams {
+    awaitPaymentConfirmation?: boolean;
     /**
-     * Customer ID
+     * The ISO 3166-1 alpha-2 country code for billing
      */
-    customerId: string;
+    billingCountryCode?: string | null;
     /**
-     * Plan ID
+     * External billing system identifier
+     */
+    billingId?: string | null;
+    billingInformation?: SubscriptionProvisionParams.BillingInformation;
+    /**
+     * Billing period (MONTHLY or ANNUALLY)
      */
-    planId: string;
-    addons?: Array<SubscriptionPreviewParams.Addon>;
-    appliedCoupon?: SubscriptionPreviewParams.AppliedCoupon;
-    billableFeatures?: Array<SubscriptionPreviewParams.BillableFeature>;
-    billingCountryCode?: string;
-    billingInformation?: SubscriptionPreviewParams.BillingInformation;
     billingPeriod?: 'MONTHLY' | 'ANNUALLY';
-    charges?: Array<SubscriptionPreviewParams.Charge>;
-    payingCustomerId?: string;
-    resourceId?: string;
+    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;
-    trialOverrideConfiguration?: SubscriptionPreviewParams.TrialOverrideConfiguration;
+    subscriptionEntitlements?: Array<SubscriptionProvisionParams.SubscriptionEntitlement>;
+    /**
+     * Trial period override settings
+     */
+    trialOverrideConfiguration?: SubscriptionProvisionParams.TrialOverrideConfiguration;
     unitQuantity?: number;
 }
-export declare namespace SubscriptionPreviewParams {
+export declare namespace SubscriptionProvisionParams {
     interface Addon {
         /**
-         * Addon ID
+         * Addon identifier
          */
         addonId: string;
+        /**
+         * Number of addon units
+         */
         quantity?: number;
     }
+    /**
+     * Coupon configuration
+     */
     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;
     }
     namespace AppliedCoupon {
+        /**
+         * Coupon timing configuration
+         */
         interface Configuration {
             /**
              * Coupon start date
              */
             startDate?: string;
         }
+        /**
+         * Ad-hoc discount configuration
+         */
         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;
         }
         namespace Discount {
@@ -871,27 +1538,58 @@ export declare namespace SubscriptionPreviewParams {
             }
         }
     }
-    interface BillableFeature {
+    interface BillingInformation {
         /**
-         * Feature ID
+         * Billing address for the subscription
          */
-        featureId: string;
-        quantity: number;
-    }
-    interface BillingInformation {
         billingAddress?: BillingInformation.BillingAddress;
-        chargeOnBehalfOfAccount?: string;
-        integrationId?: string;
+        /**
+         * Stripe Connect account to charge on behalf of
+         */
+        chargeOnBehalfOfAccount?: string | null;
+        /**
+         * Billing integration identifier
+         */
+        integrationId?: string | null;
+        /**
+         * Number of days until invoice is due
+         */
         invoiceDaysUntilDue?: number;
+        /**
+         * Whether the subscription is backdated
+         */
         isBackdated?: boolean;
+        /**
+         * Whether the invoice is marked as paid
+         */
         isInvoicePaid?: boolean;
-        metadata?: unknown;
+        /**
+         * Additional metadata for the subscription
+         */
+        metadata?: {
+            [key: string]: string;
+        };
+        /**
+         * How to handle proration for billing changes
+         */
         prorationBehavior?: 'INVOICE_IMMEDIATELY' | 'CREATE_PRORATIONS' | 'NONE';
+        /**
+         * Customer tax identification numbers
+         */
         taxIds?: Array<BillingInformation.TaxID>;
+        /**
+         * Tax percentage (0-100)
+         */
         taxPercentage?: number;
+        /**
+         * Tax rate identifiers to apply
+         */
         taxRateIds?: Array<string>;
     }
     namespace BillingInformation {
+        /**
+         * Billing address for the subscription
+         */
         interface BillingAddress {
             city?: string;
             country?: string;
@@ -901,36 +1599,246 @@ export declare namespace SubscriptionPreviewParams {
             state?: string;
         }
         interface TaxID {
+            /**
+             * The type of tax exemption identifier, such as VAT.
+             */
             type: string;
+            /**
+             * The actual tax identifier value
+             */
             value: string;
         }
     }
+    interface Budget {
+        /**
+         * Whether the budget is a soft limit
+         */
+        hasSoftLimit: boolean;
+        /**
+         * Maximum spending limit
+         */
+        limit: number;
+    }
+    /**
+     * Charge item
+     */
     interface Charge {
         /**
          * Charge ID
          */
         id: string;
+        /**
+         * Charge quantity
+         */
         quantity: number;
+        /**
+         * Charge type
+         */
         type: 'FEATURE' | 'CREDIT';
     }
+    /**
+     * Checkout page configuration for payment collection
+     */
+    interface CheckoutOptions {
+        /**
+         * URL to redirect to if checkout is canceled
+         */
+        cancelUrl: string;
+        /**
+         * URL to redirect to after successful checkout
+         */
+        successUrl: string;
+        /**
+         * Allow promotional codes during checkout
+         */
+        allowPromoCodes?: boolean;
+        /**
+         * Allow tax ID collection during checkout
+         */
+        allowTaxIdCollection?: boolean;
+        /**
+         * Collect billing address during checkout
+         */
+        collectBillingAddress?: boolean;
+        /**
+         * Collect phone number during checkout
+         */
+        collectPhoneNumber?: boolean;
+        /**
+         * Optional reference ID for the checkout session
+         */
+        referenceId?: string | null;
+    }
+    interface MinimumSpend {
+        /**
+         * Minimum spend amount
+         */
+        minimum?: MinimumSpend.Minimum | null;
+    }
+    namespace MinimumSpend {
+        /**
+         * Minimum spend amount
+         */
+        interface Minimum {
+            /**
+             * 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';
+        }
+    }
+    interface PriceOverride {
+        /**
+         * Addon identifier for the price override
+         */
+        addonId?: string | null;
+        /**
+         * Whether this is a base charge override
+         */
+        baseCharge?: boolean;
+        /**
+         * Block size for pricing
+         */
+        blockSize?: number;
+        creditGrantCadence?: 'BEGINNING_OF_BILLING_PERIOD' | 'MONTHLY';
+        creditRate?: PriceOverride.CreditRate;
+        /**
+         * Feature identifier for the price override
+         */
+        featureId?: string | null;
+        /**
+         * Override price amount
+         */
+        price?: PriceOverride.Price;
+        /**
+         * Pricing tiers configuration
+         */
+        tiers?: Array<PriceOverride.Tier>;
+    }
+    namespace PriceOverride {
+        interface CreditRate {
+            /**
+             * The credit rate amount
+             */
+            amount: number;
+            /**
+             * The custom currency refId for the credit rate
+             */
+            currencyId: string;
+            /**
+             * A custom formula for calculating cost based on single event dimensions
+             */
+            costFormula?: string | null;
+        }
+        /**
+         * Override price amount
+         */
+        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';
+        }
+        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;
+        }
+        namespace Tier {
+            /**
+             * The flat fee price of the price tier
+             */
+            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
+             */
+            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';
+            }
+        }
+    }
+    interface SubscriptionEntitlement {
+        /**
+         * Feature ID
+         */
+        featureId: string;
+        usageLimit: number;
+        isGranted?: boolean;
+    }
+    /**
+     * Trial period override settings
+     */
     interface TrialOverrideConfiguration {
+        /**
+         * Whether the subscription should start with a trial period
+         */
         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;
     }
 }
 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;
 }
 export declare namespace Subscriptions {
-    export { type SubscriptionCreateResponse as SubscriptionCreateResponse, type SubscriptionRetrieveResponse as SubscriptionRetrieveResponse, type SubscriptionListResponse as SubscriptionListResponse, type SubscriptionDelegateResponse as SubscriptionDelegateResponse, type SubscriptionMigrateResponse as SubscriptionMigrateResponse, type SubscriptionPreviewResponse as SubscriptionPreviewResponse, type SubscriptionTransferResponse as SubscriptionTransferResponse, type SubscriptionListResponsesMyCursorIDPage as SubscriptionListResponsesMyCursorIDPage, type SubscriptionCreateParams as SubscriptionCreateParams, type SubscriptionListParams as SubscriptionListParams, type SubscriptionDelegateParams as SubscriptionDelegateParams, type SubscriptionMigrateParams as SubscriptionMigrateParams, type SubscriptionPreviewParams as SubscriptionPreviewParams, type SubscriptionTransferParams as SubscriptionTransferParams, };
-    export { FutureUpdate as FutureUpdate, type FutureUpdateCancelPendingPaymentResponse as FutureUpdateCancelPendingPaymentResponse, type FutureUpdateCancelScheduleResponse as FutureUpdateCancelScheduleResponse, };
+    export { type Subscription as Subscription, type SubscriptionListResponse as SubscriptionListResponse, type SubscriptionImportResponse as SubscriptionImportResponse, type SubscriptionPreviewResponse as SubscriptionPreviewResponse, type SubscriptionProvisionResponse as SubscriptionProvisionResponse, type SubscriptionListResponsesMyCursorIDPage as SubscriptionListResponsesMyCursorIDPage, 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 CancelSubscription as CancelSubscription };
 }
 //# sourceMappingURL=subscriptions.d.ts.map