@stigg/typescript 0.1.0-alpha.1 → 0.1.0-alpha.3

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

@@ -2,47 +2,59 @@ import { APIResource } from "../../../core/resource.js";
 import * as FutureUpdateAPI from "./future-update.js";
 import { FutureUpdate, FutureUpdateCancelPendingPaymentResponse, FutureUpdateCancelScheduleResponse } 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
+     * Provision subscription
      */
     create(body: SubscriptionCreateParams, options?: RequestOptions): APIPromise<SubscriptionCreateResponse>;
     /**
-     * Get a single Subscription by id
+     * Get a single subscription by ID
      */
     retrieve(id: string, options?: RequestOptions): APIPromise<SubscriptionRetrieveResponse>;
     /**
-     * Get a list of Subscriptions
+     * Get a list of subscriptions
      */
-    list(query?: SubscriptionListParams | null | undefined, options?: RequestOptions): APIPromise<SubscriptionListResponse>;
+    list(query?: SubscriptionListParams | null | undefined, options?: RequestOptions): PagePromise<SubscriptionListResponsesMyCursorIDPage, SubscriptionListResponse>;
     /**
-     * Perform delegate on a Subscription
+     * Delegate subscription payment to customer
      */
     delegate(id: string, body: SubscriptionDelegateParams, options?: RequestOptions): APIPromise<SubscriptionDelegateResponse>;
     /**
-     * Perform migrate to latest plan version on a Subscription
+     * Migrate subscription to latest plan version
      */
     migrate(id: string, body: SubscriptionMigrateParams, options?: RequestOptions): APIPromise<SubscriptionMigrateResponse>;
     /**
-     * Create a new Subscription Preview
+     * Preview subscription
      */
     preview(body: SubscriptionPreviewParams, options?: RequestOptions): APIPromise<SubscriptionPreviewResponse>;
     /**
-     * Perform transfer to resource on a Subscription
+     * Transfer subscription to resource
      */
     transfer(id: string, body: SubscriptionTransferParams, options?: RequestOptions): APIPromise<SubscriptionTransferResponse>;
 }
+export type SubscriptionListResponsesMyCursorIDPage = MyCursorIDPage<SubscriptionListResponse>;
+/**
+ * Response object
+ */
 export interface SubscriptionCreateResponse {
+    /**
+     * Provisioning result with status and subscription or checkout URL.
+     */
     data: SubscriptionCreateResponse.Data;
 }
 export declare namespace SubscriptionCreateResponse {
+    /**
+     * Provisioning result with status and subscription or checkout URL.
+     */
     interface Data {
         /**
          * Unique identifier for the provisioned subscription
          */
         id: string;
+        entitlements: Array<Data.Entitlement>;
         /**
          * Provision status: SUCCESS or PAYMENT_REQUIRED
          */
@@ -59,9 +71,48 @@ export declare namespace SubscriptionCreateResponse {
          * Whether the subscription is scheduled for future activation
          */
         isScheduled?: boolean;
+        /**
+         * Created subscription (when status is SUCCESS)
+         */
         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;
+            }
+        }
+        /**
+         * Created subscription (when status is SUCCESS)
+         */
         interface Subscription {
             /**
              * Subscription ID
@@ -137,6 +188,7 @@ export declare namespace SubscriptionCreateResponse {
              * The method used to collect payments for a subscription
              */
             paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
+            prices?: Array<Subscription.Price>;
             /**
              * Resource ID
              */
@@ -146,12 +198,118 @@ export declare namespace SubscriptionCreateResponse {
              */
             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';
+                    }
+                }
+            }
+        }
     }
 }
+/**
+ * Response object
+ */
 export interface SubscriptionRetrieveResponse {
+    /**
+     * Customer subscription to a plan
+     */
     data: SubscriptionRetrieveResponse.Data;
 }
 export declare namespace SubscriptionRetrieveResponse {
+    /**
+     * Customer subscription to a plan
+     */
     interface Data {
         /**
          * Subscription ID
@@ -227,6 +385,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
          */
@@ -236,104 +395,142 @@ 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 {
-    data: Array<SubscriptionListResponse.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;
+    prices?: Array<SubscriptionListResponse.Price>;
+    /**
+     * Resource ID
+     */
+    resourceId?: string | null;
+    /**
+     * Subscription trial end date
+     */
+    trialEndDate?: string | null;
 }
 export declare namespace SubscriptionListResponse {
-    interface Data {
+    interface Price {
         /**
-         * Subscription ID
+         * Price ID
          */
         id: string;
         /**
-         * Billing ID
-         */
-        billingId: string | null;
-        /**
-         * Created at
+         * Creation timestamp
          */
         createdAt: string;
         /**
-         * Cursor ID for query pagination
-         */
-        cursorId: 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;
     }
 }
+/**
+ * Response object
+ */
 export interface SubscriptionDelegateResponse {
+    /**
+     * Customer subscription to a plan
+     */
     data: SubscriptionDelegateResponse.Data;
 }
 export declare namespace SubscriptionDelegateResponse {
+    /**
+     * Customer subscription to a plan
+     */
     interface Data {
         /**
          * Subscription ID
@@ -409,6 +606,7 @@ export declare namespace SubscriptionDelegateResponse {
          * The method used to collect payments for a subscription
          */
         paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
+        prices?: Array<Data.Price>;
         /**
          * Resource ID
          */
@@ -418,11 +616,37 @@ export declare namespace SubscriptionDelegateResponse {
          */
         trialEndDate?: string | null;
     }
+    namespace Data {
+        interface Price {
+            /**
+             * Price ID
+             */
+            id: string;
+            /**
+             * Creation timestamp
+             */
+            createdAt: string;
+            /**
+             * Last update timestamp
+             */
+            updatedAt: string;
+            [k: string]: unknown;
+        }
+    }
 }
+/**
+ * Response object
+ */
 export interface SubscriptionMigrateResponse {
+    /**
+     * Customer subscription to a plan
+     */
     data: SubscriptionMigrateResponse.Data;
 }
 export declare namespace SubscriptionMigrateResponse {
+    /**
+     * Customer subscription to a plan
+     */
     interface Data {
         /**
          * Subscription ID
@@ -498,6 +722,7 @@ export declare namespace SubscriptionMigrateResponse {
          * The method used to collect payments for a subscription
          */
         paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
+        prices?: Array<Data.Price>;
         /**
          * Resource ID
          */
@@ -507,32 +732,109 @@ export declare namespace SubscriptionMigrateResponse {
          */
         trialEndDate?: string | null;
     }
+    namespace Data {
+        interface Price {
+            /**
+             * Price ID
+             */
+            id: string;
+            /**
+             * Creation timestamp
+             */
+            createdAt: string;
+            /**
+             * Last update timestamp
+             */
+            updatedAt: string;
+            [k: string]: unknown;
+        }
+    }
 }
+/**
+ * Response object
+ */
 export interface SubscriptionPreviewResponse {
+    /**
+     * Pricing preview with invoices
+     */
     data: SubscriptionPreviewResponse.Data;
 }
 export declare namespace SubscriptionPreviewResponse {
+    /**
+     * Pricing preview with invoices
+     */
     interface Data {
+        /**
+         * Invoice due immediately
+         */
         immediateInvoice: Data.ImmediateInvoice;
+        /**
+         * Billing period range
+         */
         billingPeriodRange?: Data.BillingPeriodRange;
+        /**
+         * Free items included
+         */
         freeItems?: Array<Data.FreeItem>;
+        /**
+         * Whether updates are scheduled
+         */
         hasScheduledUpdates?: boolean;
+        /**
+         * Whether this is a downgrade
+         */
         isPlanDowngrade?: boolean;
+        /**
+         * Recurring invoice preview
+         */
         recurringInvoice?: Data.RecurringInvoice;
     }
     namespace Data {
+        /**
+         * Invoice due immediately
+         */
         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
@@ -543,24 +845,69 @@ export declare namespace SubscriptionPreviewResponse {
                  */
                 start: string;
             }
+            /**
+             * Discount breakdown
+             */
             interface DiscountDetails {
+                /**
+                 * Promo code used
+                 */
                 code?: string;
+                /**
+                 * Fixed discount amount
+                 */
                 fixedAmount?: number;
-                percentage?: 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
@@ -571,22 +918,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
@@ -597,30 +986,81 @@ 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;
             }
         }
     }
 }
+/**
+ * Response object
+ */
 export interface SubscriptionTransferResponse {
+    /**
+     * Customer subscription to a plan
+     */
     data: SubscriptionTransferResponse.Data;
 }
 export declare namespace SubscriptionTransferResponse {
+    /**
+     * Customer subscription to a plan
+     */
     interface Data {
         /**
          * Subscription ID
@@ -696,6 +1136,7 @@ export declare namespace SubscriptionTransferResponse {
          * The method used to collect payments for a subscription
          */
         paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
+        prices?: Array<Data.Price>;
         /**
          * Resource ID
          */
@@ -705,6 +1146,23 @@ export declare namespace SubscriptionTransferResponse {
          */
         trialEndDate?: string | null;
     }
+    namespace Data {
+        interface Price {
+            /**
+             * Price ID
+             */
+            id: string;
+            /**
+             * Creation timestamp
+             */
+            createdAt: string;
+            /**
+             * Last update timestamp
+             */
+            updatedAt: string;
+            [k: string]: unknown;
+        }
+    }
 }
 export interface SubscriptionCreateParams {
     /**
@@ -718,12 +1176,34 @@ export interface SubscriptionCreateParams {
     /**
      * Unique identifier for the subscription
      */
-    id?: string | null;
+    id?: string;
+    addons?: Array<SubscriptionCreateParams.Addon>;
+    /**
+     * Coupon configuration
+     */
+    appliedCoupon?: SubscriptionCreateParams.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?: SubscriptionCreateParams.BillingInformation;
+    /**
+     * Billing period (MONTHLY or ANNUALLY)
+     */
     billingPeriod?: 'MONTHLY' | 'ANNUALLY';
+    budget?: SubscriptionCreateParams.Budget | null;
+    charges?: Array<SubscriptionCreateParams.Charge>;
+    /**
+     * Checkout page configuration for payment collection
+     */
     checkoutOptions?: SubscriptionCreateParams.CheckoutOptions;
     /**
      * Additional metadata for the subscription
@@ -731,17 +1211,224 @@ export interface SubscriptionCreateParams {
     metadata?: {
         [key: string]: string;
     };
+    minimumSpend?: SubscriptionCreateParams.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<SubscriptionCreateParams.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<SubscriptionCreateParams.SubscriptionEntitlement>;
+    /**
+     * Trial period override settings
+     */
     trialOverrideConfiguration?: SubscriptionCreateParams.TrialOverrideConfiguration;
+    unitQuantity?: number;
 }
 export declare namespace SubscriptionCreateParams {
+    interface Addon {
+        /**
+         * 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 {
+            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';
+            }
+        }
+    }
+    interface BillingInformation {
+        /**
+         * Billing address for the subscription
+         */
+        billingAddress?: BillingInformation.BillingAddress;
+        /**
+         * 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;
+        /**
+         * 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;
+            line1?: string;
+            line2?: string;
+            postalCode?: string;
+            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
@@ -772,6 +1459,153 @@ export declare namespace SubscriptionCreateParams {
          */
         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
@@ -787,38 +1621,27 @@ export declare namespace SubscriptionCreateParams {
         trialEndDate?: string;
     }
 }
-export interface SubscriptionListParams {
+export interface SubscriptionListParams extends MyCursorIDPageParams {
     /**
      * Filter by customer ID
      */
     customerId?: string;
     /**
-     * Ending before this UUID for pagination
-     */
-    endingBefore?: string;
-    /**
-     * Items per page
-     */
-    limit?: number;
-    /**
-     * Starting after this UUID for pagination
-     */
-    startingAfter?: string;
-    /**
-     * Filter by subscription status (comma-separated for multiple statuses, e.g.,
-     * ACTIVE,IN_TRIAL)
+     * Filter by status (comma-separated)
      */
     status?: string;
 }
 export interface SubscriptionDelegateParams {
     /**
-     * The customer ID to delegate the subscription to
+     * 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 SubscriptionMigrateParams {
     /**
-     * When to migrate the subscription: IMMEDIATE or END_OF_BILLING_PERIOD
+     * When to migrate (immediate or period end)
      */
     subscriptionMigrationTime?: 'END_OF_BILLING_PERIOD' | 'IMMEDIATE';
 }
@@ -831,80 +1654,212 @@ export interface SubscriptionPreviewParams {
      * 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 declare namespace SubscriptionPreviewParams {
+    /**
+     * Addon configuration
+     */
     interface Addon {
         /**
          * Addon ID
          */
         addonId: string;
+        /**
+         * Number of addon instances
+         */
         quantity?: number;
     }
+    /**
+     * Coupon or discount to apply
+     */
     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 {
             interface AmountsOff {
+                /**
+                 * The price amount
+                 */
                 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';
+                /**
+                 * 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;
@@ -913,21 +1868,48 @@ export declare namespace SubscriptionPreviewParams {
             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 to start as trial
+         */
         isTrial: boolean;
+        /**
+         * Behavior when trial ends
+         */
         trialEndBehavior?: 'CONVERT_TO_PAID' | 'CANCEL_SUBSCRIPTION';
         /**
          * Trial end date
@@ -937,13 +1919,12 @@ export declare 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;
 }
 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 SubscriptionCreateParams as SubscriptionCreateParams, type SubscriptionListParams as SubscriptionListParams, type SubscriptionDelegateParams as SubscriptionDelegateParams, type SubscriptionMigrateParams as SubscriptionMigrateParams, type SubscriptionPreviewParams as SubscriptionPreviewParams, type SubscriptionTransferParams as SubscriptionTransferParams, };
+    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, };
 }
 //# sourceMappingURL=subscriptions.d.ts.map