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

package/resources/v1/subscriptions/subscriptions.d.mts

@@ -1,157 +1,82 @@
 import { APIResource } from "../../../core/resource.mjs";
 import * as FutureUpdateAPI from "./future-update.mjs";
-import { FutureUpdate, FutureUpdateCancelPendingPaymentResponse, FutureUpdateCancelScheduleResponse } from "./future-update.mjs";
+import { CancelSubscription, FutureUpdate } from "./future-update.mjs";
+import * as InvoiceAPI from "./invoice.mjs";
+import { Invoice, InvoiceMarkAsPaidResponse } from "./invoice.mjs";
+import * as UsageAPI from "./usage.mjs";
+import { Usage, UsageChargeUsageParams, UsageChargeUsageResponse, UsageSyncResponse } from "./usage.mjs";
 import { APIPromise } from "../../../core/api-promise.mjs";
+import { MyCursorIDPage, type MyCursorIDPageParams, PagePromise } from "../../../core/pagination.mjs";
 import { RequestOptions } from "../../../internal/request-options.mjs";
 export declare class Subscriptions extends APIResource {
     futureUpdate: FutureUpdateAPI.FutureUpdate;
+    usage: UsageAPI.Usage;
+    invoice: InvoiceAPI.Invoice;
     /**
-     * Create a new Subscription
+     * Retrieves a subscription by its unique identifier, including plan details,
+     * billing period, status, and add-ons.
      */
-    create(body: SubscriptionCreateParams, options?: RequestOptions): APIPromise<SubscriptionCreateResponse>;
+    retrieve(id: string, options?: RequestOptions): APIPromise<Subscription>;
     /**
-     * Get a single Subscription by id
+     * Updates an active subscription's properties including billing period, add-ons,
+     * unit quantities, and discounts.
      */
-    retrieve(id: string, options?: RequestOptions): APIPromise<SubscriptionRetrieveResponse>;
+    update(id: string, body: SubscriptionUpdateParams, options?: RequestOptions): APIPromise<Subscription>;
     /**
-     * Get a list of Subscriptions
+     * Retrieves a paginated list of subscriptions, with optional filters for customer,
+     * status, and plan.
      */
-    list(query?: SubscriptionListParams | null | undefined, options?: RequestOptions): APIPromise<SubscriptionListResponse>;
+    list(query?: SubscriptionListParams | null | undefined, options?: RequestOptions): PagePromise<SubscriptionListResponsesMyCursorIDPage, SubscriptionListResponse>;
     /**
-     * Perform delegate on a Subscription
+     * Cancels an active subscription, either immediately or at a specified time such
+     * as end of billing period.
      */
-    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
+     * Delegates the payment responsibility of a subscription to a different customer.
+     * The delegated customer will be billed for this subscription.
      */
-    migrate(id: string, body: SubscriptionMigrateParams, options?: RequestOptions): APIPromise<SubscriptionMigrateResponse>;
+    delegate(id: string, body: SubscriptionDelegateParams, options?: RequestOptions): APIPromise<Subscription>;
     /**
-     * Create a new Subscription Preview
+     * Imports multiple subscriptions in bulk. Used for migrating subscription data
+     * from external systems.
+     */
+    import(body: SubscriptionImportParams, options?: RequestOptions): APIPromise<SubscriptionImportResponse>;
+    /**
+     * Migrates a subscription to the latest published version of its plan or add-ons.
+     * Handles prorated charges or credits automatically.
+     */
+    migrate(id: string, body: SubscriptionMigrateParams, options?: RequestOptions): APIPromise<Subscription>;
+    /**
+     * Previews the pricing impact of creating or updating a subscription without
+     * making changes. Returns estimated costs, taxes, and proration details.
      */
     preview(body: SubscriptionPreviewParams, options?: RequestOptions): APIPromise<SubscriptionPreviewResponse>;
     /**
-     * Perform transfer to resource on a Subscription
+     * Creates a new subscription for an existing customer. When payment is required
+     * and no payment method exists, returns a checkout URL.
      */
-    transfer(id: string, body: SubscriptionTransferParams, options?: RequestOptions): APIPromise<SubscriptionTransferResponse>;
-}
-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;
-        }
-    }
+    provision(body: SubscriptionProvisionParams, options?: RequestOptions): APIPromise<SubscriptionProvisionResponse>;
+    /**
+     * Transfers a subscription to a different resource ID. Used for multi-resource
+     * products where subscriptions apply to specific entities like websites or apps.
+     */
+    transfer(id: string, body: SubscriptionTransferParams, options?: RequestOptions): APIPromise<Subscription>;
 }
-export interface SubscriptionRetrieveResponse {
-    data: SubscriptionRetrieveResponse.Data;
+export type SubscriptionListResponsesMyCursorIDPage = MyCursorIDPage<SubscriptionListResponse>;
+/**
+ * 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
@@ -227,6 +152,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,303 +162,228 @@ 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
+         * Last update timestamp
          */
-        cancellationDate?: string | null;
+        updatedAt: string;
+        [k: string]: unknown;
+    }
+}
+/**
+ * Response object
+ */
+export interface SubscriptionImportResponse {
+    data: SubscriptionImportResponse.Data;
+}
+export declare namespace SubscriptionImportResponse {
+    interface Data {
         /**
-         * Subscription cancel reason
+         * Unique identifier for the import task
          */
-        cancelReason?: 'UPGRADE_OR_DOWNGRADE' | 'CANCELLED_BY_BILLING' | 'EXPIRED' | 'DETACH_BILLING' | 'TRIAL_ENDED' | 'Immediate' | 'TRIAL_CONVERTED' | 'PENDING_PAYMENT_EXPIRED' | 'ScheduledCancellation' | 'CustomerArchived' | 'AutoCancellationRule' | null;
+        taskId: string;
+    }
+}
+/**
+ * Response object
+ */
+export interface SubscriptionPreviewResponse {
+    /**
+     * Pricing preview with invoices
+     */
+    data: SubscriptionPreviewResponse.Data;
+}
+export declare namespace SubscriptionPreviewResponse {
+    /**
+     * Pricing preview with invoices
+     */
+    interface Data {
         /**
-         * End of the current billing period
+         * Invoice due immediately
          */
-        currentBillingPeriodEnd?: string | null;
+        immediateInvoice: Data.ImmediateInvoice;
         /**
-         * Start of the current billing period
+         * Billing period range
          */
-        currentBillingPeriodStart?: string | null;
+        billingPeriodRange?: Data.BillingPeriodRange;
         /**
-         * Subscription effective end date
+         * Free items included
          */
-        effectiveEndDate?: string | null;
+        freeItems?: Array<Data.FreeItem>;
         /**
-         * Subscription end date
+         * Whether updates are scheduled
          */
-        endDate?: string | null;
+        hasScheduledUpdates?: boolean;
         /**
-         * Additional metadata for the subscription
+         * Whether this is a downgrade
          */
-        metadata?: {
-            [key: string]: string;
-        };
+        isPlanDowngrade?: boolean;
         /**
-         * Paying customer ID for delegated billing
+         * Recurring invoice preview
          */
-        payingCustomerId?: string | null;
+        recurringInvoice?: Data.RecurringInvoice;
+    }
+    namespace Data {
         /**
-         * The method used to collect payments for a subscription
+         * Invoice due immediately
          */
-        paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
-        /**
-         * Resource ID
-         */
-        resourceId?: string | null;
-        /**
-         * Subscription trial end date
-         */
-        trialEndDate?: string | null;
-    }
-}
-export interface SubscriptionDelegateResponse {
-    data: SubscriptionDelegateResponse.Data;
-}
-export declare namespace SubscriptionDelegateResponse {
-    interface Data {
-        /**
-         * Subscription ID
-         */
-        id: string;
-        /**
-         * Billing ID
-         */
-        billingId: string | null;
-        /**
-         * Created at
-         */
-        createdAt: string;
-        /**
-         * Customer ID
-         */
-        customerId: string;
-        /**
-         * Payment collection
-         */
-        paymentCollection: 'NOT_REQUIRED' | 'PROCESSING' | 'FAILED' | 'ACTION_REQUIRED';
-        /**
-         * Plan ID
-         */
-        planId: string;
-        /**
-         * Pricing type
-         */
-        pricingType: 'FREE' | 'PAID' | 'CUSTOM';
-        /**
-         * Subscription start date
-         */
-        startDate: string;
-        /**
-         * Subscription status
-         */
-        status: 'PAYMENT_PENDING' | 'ACTIVE' | 'EXPIRED' | 'IN_TRIAL' | 'CANCELED' | 'NOT_STARTED';
-        /**
-         * Subscription cancellation date
-         */
-        cancellationDate?: string | null;
-        /**
-         * Subscription cancel reason
-         */
-        cancelReason?: 'UPGRADE_OR_DOWNGRADE' | 'CANCELLED_BY_BILLING' | 'EXPIRED' | 'DETACH_BILLING' | 'TRIAL_ENDED' | 'Immediate' | 'TRIAL_CONVERTED' | 'PENDING_PAYMENT_EXPIRED' | 'ScheduledCancellation' | 'CustomerArchived' | 'AutoCancellationRule' | null;
-        /**
-         * End of the current billing period
-         */
-        currentBillingPeriodEnd?: string | null;
-        /**
-         * Start of the current billing period
-         */
-        currentBillingPeriodStart?: string | null;
-        /**
-         * Subscription effective end date
-         */
-        effectiveEndDate?: string | null;
-        /**
-         * Subscription end date
-         */
-        endDate?: string | null;
-        /**
-         * Additional metadata for the subscription
-         */
-        metadata?: {
-            [key: string]: string;
-        };
-        /**
-         * Paying customer ID for delegated billing
-         */
-        payingCustomerId?: string | null;
-        /**
-         * The method used to collect payments for a subscription
-         */
-        paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
-        /**
-         * Resource ID
-         */
-        resourceId?: string | null;
-        /**
-         * Subscription trial end date
-         */
-        trialEndDate?: string | null;
-    }
-}
-export interface SubscriptionMigrateResponse {
-    data: SubscriptionMigrateResponse.Data;
-}
-export declare namespace SubscriptionMigrateResponse {
-    interface Data {
-        /**
-         * Subscription ID
-         */
-        id: string;
-        /**
-         * Billing ID
-         */
-        billingId: string | null;
-        /**
-         * Created at
-         */
-        createdAt: string;
-        /**
-         * Customer ID
-         */
-        customerId: string;
-        /**
-         * Payment collection
-         */
-        paymentCollection: 'NOT_REQUIRED' | 'PROCESSING' | 'FAILED' | 'ACTION_REQUIRED';
-        /**
-         * Plan ID
-         */
-        planId: string;
-        /**
-         * Pricing type
-         */
-        pricingType: 'FREE' | 'PAID' | 'CUSTOM';
-        /**
-         * Subscription start date
-         */
-        startDate: string;
-        /**
-         * Subscription status
-         */
-        status: 'PAYMENT_PENDING' | 'ACTIVE' | 'EXPIRED' | 'IN_TRIAL' | 'CANCELED' | 'NOT_STARTED';
-        /**
-         * Subscription cancellation date
-         */
-        cancellationDate?: string | null;
-        /**
-         * Subscription cancel reason
-         */
-        cancelReason?: 'UPGRADE_OR_DOWNGRADE' | 'CANCELLED_BY_BILLING' | 'EXPIRED' | 'DETACH_BILLING' | 'TRIAL_ENDED' | 'Immediate' | 'TRIAL_CONVERTED' | 'PENDING_PAYMENT_EXPIRED' | 'ScheduledCancellation' | 'CustomerArchived' | 'AutoCancellationRule' | null;
-        /**
-         * End of the current billing period
-         */
-        currentBillingPeriodEnd?: string | null;
-        /**
-         * Start of the current billing period
-         */
-        currentBillingPeriodStart?: string | null;
-        /**
-         * Subscription effective end date
-         */
-        effectiveEndDate?: string | null;
-        /**
-         * Subscription end date
-         */
-        endDate?: string | null;
-        /**
-         * Additional metadata for the subscription
-         */
-        metadata?: {
-            [key: string]: string;
-        };
-        /**
-         * Paying customer ID for delegated billing
-         */
-        payingCustomerId?: string | null;
-        /**
-         * The method used to collect payments for a subscription
-         */
-        paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE' | null;
-        /**
-         * Resource ID
-         */
-        resourceId?: string | null;
-        /**
-         * Subscription trial end date
-         */
-        trialEndDate?: string | null;
-    }
-}
-export interface SubscriptionPreviewResponse {
-    data: SubscriptionPreviewResponse.Data;
-}
-export 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
@@ -543,24 +394,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
@@ -571,22 +467,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;
-            total: 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,87 +535,697 @@ 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.UnionObjectVariant0 | Data.UnionObjectVariant1> | null;
         /**
-         * Billing ID
+         * Provision status: SUCCESS or PAYMENT_REQUIRED
          */
-        billingId: string | null;
+        status: 'SUCCESS' | 'PAYMENT_REQUIRED';
         /**
-         * Created at
+         * Created subscription (when status is SUCCESS)
          */
-        createdAt: string;
+        subscription: Data.Subscription | null;
         /**
-         * Customer ID
+         * Checkout billing ID when payment is required
          */
-        customerId: string;
+        checkoutBillingId?: string;
         /**
-         * Payment collection
+         * URL to complete payment when PAYMENT_REQUIRED
          */
-        paymentCollection: 'NOT_REQUIRED' | 'PROCESSING' | 'FAILED' | 'ACTION_REQUIRED';
+        checkoutUrl?: string;
         /**
-         * Plan ID
+         * Whether the subscription is scheduled for future activation
          */
-        planId: string;
+        isScheduled?: boolean;
+    }
+    namespace Data {
+        interface UnionObjectVariant0 {
+            accessDeniedReason: 'FeatureNotFound' | 'CustomerNotFound' | 'CustomerIsArchived' | 'CustomerResourceNotFound' | 'NoActiveSubscription' | 'NoFeatureEntitlementInSubscription' | 'RequestedUsageExceedingLimit' | 'RequestedValuesMismatch' | 'BudgetExceeded' | 'Unknown' | 'FeatureTypeMismatch' | 'Revoked' | 'InsufficientCredits' | 'EntitlementNotFound' | null;
+            isGranted: boolean;
+            type: 'FEATURE';
+            currentUsage?: number;
+            /**
+             * Timestamp of the last update to the entitlement grant or configuration.
+             */
+            entitlementUpdatedAt?: string;
+            feature?: UnionObjectVariant0.Feature;
+            hasUnlimitedUsage?: boolean;
+            resetPeriod?: 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | null;
+            usageLimit?: number | null;
+            /**
+             * The anchor for calculating the usage period for metered entitlements with a
+             * reset period configured
+             */
+            usagePeriodAnchor?: string;
+            /**
+             * The end date of the usage period for metered entitlements with a reset period
+             * configured
+             */
+            usagePeriodEnd?: string;
+            /**
+             * The start date of the usage period for metered entitlements with a reset period
+             * configured
+             */
+            usagePeriodStart?: string;
+            /**
+             * The next time the entitlement should be recalculated
+             */
+            validUntil?: string;
+        }
+        namespace UnionObjectVariant0 {
+            interface Feature {
+                /**
+                 * The human-readable name of the entitlement, shown in UI elements.
+                 */
+                displayName: string;
+                /**
+                 * The current status of the feature.
+                 */
+                featureStatus: 'NEW' | 'SUSPENDED' | 'ACTIVE';
+                /**
+                 * The type of feature associated with the entitlement.
+                 */
+                featureType: 'BOOLEAN' | 'NUMBER' | 'ENUM';
+                /**
+                 * The unique reference ID of the entitlement.
+                 */
+                refId: string;
+            }
+        }
+        interface UnionObjectVariant1 {
+            accessDeniedReason: 'FeatureNotFound' | 'CustomerNotFound' | 'CustomerIsArchived' | 'CustomerResourceNotFound' | 'NoActiveSubscription' | 'NoFeatureEntitlementInSubscription' | 'RequestedUsageExceedingLimit' | 'RequestedValuesMismatch' | 'BudgetExceeded' | 'Unknown' | 'FeatureTypeMismatch' | 'Revoked' | 'InsufficientCredits' | 'EntitlementNotFound' | null;
+            /**
+             * The currency associated with a credit entitlement.
+             */
+            currency: UnionObjectVariant1.Currency;
+            currentUsage: number;
+            isGranted: boolean;
+            type: 'CREDIT';
+            usageLimit: number;
+            /**
+             * Timestamp of the last update to the credit usage.
+             */
+            usageUpdatedAt: string;
+            /**
+             * Timestamp of the last update to the entitlement grant or configuration.
+             */
+            entitlementUpdatedAt?: string;
+            /**
+             * The end date of the current billing period for recurring credit grants.
+             */
+            usagePeriodEnd?: string;
+            /**
+             * The next time the entitlement should be recalculated
+             */
+            validUntil?: string;
+        }
+        namespace UnionObjectVariant1 {
+            /**
+             * The currency associated with a credit entitlement.
+             */
+            interface Currency {
+                /**
+                 * The unique identifier of the custom currency.
+                 */
+                currencyId: string;
+                /**
+                 * The display name of the currency.
+                 */
+                displayName: string;
+                /**
+                 * Additional metadata associated with the currency.
+                 */
+                additionalMetaData?: unknown;
+                /**
+                 * A description of the currency.
+                 */
+                description?: string | null;
+                /**
+                 * The plural form of the currency unit.
+                 */
+                unitPlural?: string | null;
+                /**
+                 * The singular form of the currency unit.
+                 */
+                unitSingular?: string | null;
+            }
+        }
         /**
-         * Pricing type
+         * Created subscription (when status is SUCCESS)
          */
-        pricingType: 'FREE' | 'PAID' | 'CUSTOM';
+        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>;
+    /**
+     * 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 {
         /**
-         * Subscription start date
+         * Addon ID
          */
-        startDate: string;
+        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 {
         /**
-         * Subscription status
+         * Physical address
          */
-        status: 'PAYMENT_PENDING' | 'ACTIVE' | 'EXPIRED' | 'IN_TRIAL' | 'CANCELED' | 'NOT_STARTED';
+        billingAddress?: BillingInformation.BillingAddress;
+        chargeOnBehalfOfAccount?: string;
+        couponId?: string;
+        integrationId?: string;
+        invoiceDaysUntilDue?: number;
+        isBackdated?: boolean;
+        isInvoicePaid?: boolean;
         /**
-         * Subscription cancellation date
+         * Additional metadata for the subscription
          */
-        cancellationDate?: string | null;
+        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 {
+        /**
+         * Addon ID
+         */
+        addonId?: string;
+        /**
+         * Whether this is a base charge override
+         */
+        baseCharge?: boolean;
+        /**
+         * The corresponding custom currency id of the recurring credits price
+         */
+        currencyId?: string;
+        /**
+         * 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 creation date using range operators: gt, gte, lt, lte
+     */
+    createdAt?: SubscriptionListParams.CreatedAt;
+    /**
+     * Filter by customer ID
+     */
+    customerId?: string;
+    /**
+     * Filter by plan ID
+     */
+    planId?: string;
+    /**
+     * Filter by pricing type. Supports comma-separated values for multiple types
+     */
+    pricingType?: string;
+    /**
+     * Filter by resource ID
+     */
+    resourceId?: string;
+    /**
+     * Filter by subscription status. Supports comma-separated values for multiple
+     * statuses
+     */
+    status?: string;
+}
+export declare namespace SubscriptionListParams {
+    /**
+     * Filter by creation date using range operators: gt, gte, lt, lte
+     */
+    interface CreatedAt {
+        /**
+         * Greater than the specified createdAt value
+         */
+        gt?: string;
+        /**
+         * Greater than or equal to the specified createdAt value
+         */
+        gte?: string;
+        /**
+         * Less than the specified createdAt value
+         */
+        lt?: string;
+        /**
+         * Less than or equal to the specified createdAt value
+         */
+        lte?: 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>;
+    /**
+     * Integration ID to use for importing subscriptions
+     */
+    integrationId?: string | null;
+}
+export declare namespace SubscriptionImportParams {
+    interface Subscription {
         /**
-         * Subscription cancel reason
+         * Subscription ID
          */
-        cancelReason?: 'UPGRADE_OR_DOWNGRADE' | 'CANCELLED_BY_BILLING' | 'EXPIRED' | 'DETACH_BILLING' | 'TRIAL_ENDED' | 'Immediate' | 'TRIAL_CONVERTED' | 'PENDING_PAYMENT_EXPIRED' | 'ScheduledCancellation' | 'CustomerArchived' | 'AutoCancellationRule' | null;
+        id: string;
         /**
-         * End of the current billing period
+         * Customer ID
          */
-        currentBillingPeriodEnd?: string | null;
+        customerId: string;
         /**
-         * Start of the current billing period
+         * Plan ID
          */
-        currentBillingPeriodStart?: string | null;
+        planId: string;
         /**
-         * Subscription effective end date
+         * Billing ID
          */
-        effectiveEndDate?: string | null;
+        billingId?: string | null;
         /**
          * Subscription end date
          */
@@ -688,223 +1236,510 @@ export declare namespace SubscriptionTransferResponse {
         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
+         * Subscription start date
          */
-        trialEndDate?: string | null;
+        startDate?: string;
     }
 }
-export interface SubscriptionCreateParams {
+export interface SubscriptionMigrateParams {
     /**
-     * Customer ID to provision the subscription for
+     * 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
+     */
+    addons?: Array<SubscriptionPreviewParams.Addon>;
+    /**
+     * Coupon or discount to apply
      */
-    id?: string | null;
+    appliedCoupon?: SubscriptionPreviewParams.AppliedCoupon;
     /**
-     * Whether to wait for payment confirmation before returning the subscription
+     * 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 {
+export interface SubscriptionProvisionParams {
+    /**
+     * Customer ID to provision the subscription for
+     */
+    customerId: string;
     /**
-     * Filter by customer ID
+     * Plan ID to provision
      */
-    customerId?: string;
+    planId: string;
     /**
-     * Ending before this UUID for pagination
+     * Unique identifier for the subscription
      */
-    endingBefore?: string;
+    id?: string;
+    addons?: Array<SubscriptionProvisionParams.Addon>;
     /**
-     * Items per page
+     * Coupon configuration
      */
-    limit?: number;
+    appliedCoupon?: SubscriptionProvisionParams.AppliedCoupon;
     /**
-     * Starting after this UUID for pagination
+     * Whether to wait for payment confirmation before returning the subscription
      */
-    startingAfter?: string;
+    awaitPaymentConfirmation?: boolean;
     /**
-     * Filter by subscription status (comma-separated for multiple statuses, e.g.,
-     * ACTIVE,IN_TRIAL)
+     * The ISO 3166-1 alpha-2 country code for billing
      */
-    status?: string;
-}
-export interface SubscriptionDelegateParams {
+    billingCountryCode?: string | null;
     /**
-     * The customer ID to delegate the subscription to
+     * External billing system identifier
      */
-    targetCustomerId: string;
-}
-export interface SubscriptionMigrateParams {
+    billingId?: string | null;
+    billingInformation?: SubscriptionProvisionParams.BillingInformation;
     /**
-     * When to migrate the subscription: IMMEDIATE or END_OF_BILLING_PERIOD
+     * Billing period (MONTHLY or ANNUALLY)
      */
-    subscriptionMigrationTime?: 'END_OF_BILLING_PERIOD' | 'IMMEDIATE';
-}
-export interface SubscriptionPreviewParams {
+    billingPeriod?: 'MONTHLY' | 'ANNUALLY';
+    budget?: SubscriptionProvisionParams.Budget | null;
+    charges?: Array<SubscriptionProvisionParams.Charge>;
     /**
-     * Customer ID
+     * Checkout page configuration for payment collection
      */
-    customerId: string;
+    checkoutOptions?: SubscriptionProvisionParams.CheckoutOptions;
     /**
-     * Plan ID
+     * 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
      */
-    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;
     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 {
             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';
             }
         }
     }
-    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;
@@ -914,36 +1749,248 @@ 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 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 };
+    export { Usage as Usage, type UsageChargeUsageResponse as UsageChargeUsageResponse, type UsageSyncResponse as UsageSyncResponse, type UsageChargeUsageParams as UsageChargeUsageParams, };
+    export { Invoice as Invoice, type InvoiceMarkAsPaidResponse as InvoiceMarkAsPaidResponse };
 }
 //# sourceMappingURL=subscriptions.d.mts.map