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

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

@@ -1,312 +1,73 @@
 import { APIResource } from "../../../core/resource.js";
 import * as FutureUpdateAPI from "./future-update.js";
-import { FutureUpdate, FutureUpdateCancelPendingPaymentResponse, FutureUpdateCancelScheduleResponse } from "./future-update.js";
+import { CancelSubscription, FutureUpdate } from "./future-update.js";
 import { APIPromise } from "../../../core/api-promise.js";
 import { MyCursorIDPage, type MyCursorIDPageParams, PagePromise } from "../../../core/pagination.js";
 import { RequestOptions } from "../../../internal/request-options.js";
 export declare class Subscriptions extends APIResource {
     futureUpdate: FutureUpdateAPI.FutureUpdate;
     /**
-     * Provision 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): PagePromise<SubscriptionListResponsesMyCursorIDPage, SubscriptionListResponse>;
     /**
-     * Delegate subscription payment to customer
+     * 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>;
     /**
-     * Migrate subscription to latest plan version
+     * 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>;
     /**
-     * Preview subscription
+     * Imports multiple subscriptions in bulk. Used for migrating subscription data
+     * from external systems.
      */
-    preview(body: SubscriptionPreviewParams, options?: RequestOptions): APIPromise<SubscriptionPreviewResponse>;
+    import(body: SubscriptionImportParams, options?: RequestOptions): APIPromise<SubscriptionImportResponse>;
     /**
-     * Transfer subscription to resource
+     * Migrates a subscription to the latest published version of its plan or add-ons.
+     * Handles prorated charges or credits automatically.
      */
-    transfer(id: string, body: SubscriptionTransferParams, options?: RequestOptions): APIPromise<SubscriptionTransferResponse>;
-}
-export type SubscriptionListResponsesMyCursorIDPage = MyCursorIDPage<SubscriptionListResponse>;
-/**
- * Response object
- */
-export interface SubscriptionCreateResponse {
+    migrate(id: string, body: SubscriptionMigrateParams, options?: RequestOptions): APIPromise<Subscription>;
     /**
-     * Provisioning result with status and subscription or checkout URL.
+     * Previews the pricing impact of creating or updating a subscription without
+     * making changes. Returns estimated costs, taxes, and proration details.
      */
-    data: SubscriptionCreateResponse.Data;
-}
-export declare namespace SubscriptionCreateResponse {
+    preview(body: SubscriptionPreviewParams, options?: RequestOptions): APIPromise<SubscriptionPreviewResponse>;
     /**
-     * Provisioning result with status and subscription or checkout URL.
+     * Creates a new subscription for an existing customer. When payment is required
+     * and no payment method exists, returns a checkout URL.
      */
-    interface Data {
-        /**
-         * Unique identifier for the provisioned subscription
-         */
-        id: string;
-        entitlements: Array<Data.Entitlement>;
-        /**
-         * Provision status: SUCCESS or PAYMENT_REQUIRED
-         */
-        status: 'SUCCESS' | 'PAYMENT_REQUIRED';
-        /**
-         * Checkout billing ID when payment is required
-         */
-        checkoutBillingId?: string | null;
-        /**
-         * URL to complete payment when PAYMENT_REQUIRED
-         */
-        checkoutUrl?: string | null;
-        /**
-         * Whether the subscription is scheduled for future activation
-         */
-        isScheduled?: boolean;
-        /**
-         * Created subscription (when status is SUCCESS)
-         */
-        subscription?: Data.Subscription;
-    }
-    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
-             */
-            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';
-                    }
-                }
-            }
-        }
-    }
+    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 type SubscriptionListResponsesMyCursorIDPage = MyCursorIDPage<SubscriptionListResponse>;
 /**
  * Response object
  */
-export interface SubscriptionRetrieveResponse {
+export interface Subscription {
     /**
      * Customer subscription to a plan
      */
-    data: SubscriptionRetrieveResponse.Data;
+    data: Subscription.Data;
 }
-export declare namespace SubscriptionRetrieveResponse {
+export declare namespace Subscription {
     /**
      * Customer subscription to a plan
      */
@@ -521,233 +282,15 @@ export declare namespace SubscriptionListResponse {
 /**
  * Response object
  */
-export interface SubscriptionDelegateResponse {
-    /**
-     * Customer subscription to a plan
-     */
-    data: SubscriptionDelegateResponse.Data;
+export interface SubscriptionImportResponse {
+    data: SubscriptionImportResponse.Data;
 }
-export declare namespace SubscriptionDelegateResponse {
-    /**
-     * Customer subscription to a plan
-     */
+export declare namespace SubscriptionImportResponse {
     interface Data {
         /**
-         * Subscription ID
-         */
-        id: string;
-        /**
-         * Billing ID
-         */
-        billingId: string | null;
-        /**
-         * Created at
+         * Unique identifier for the import task
          */
-        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<Data.Price>;
-        /**
-         * Resource ID
-         */
-        resourceId?: string | null;
-        /**
-         * Subscription trial end date
-         */
-        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
-         */
-        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<Data.Price>;
-        /**
-         * Resource ID
-         */
-        resourceId?: string | null;
-        /**
-         * Subscription trial end date
-         */
-        trialEndDate?: string | null;
-    }
-    namespace Data {
-        interface Price {
-            /**
-             * Price ID
-             */
-            id: string;
-            /**
-             * Creation timestamp
-             */
-            createdAt: string;
-            /**
-             * Last update timestamp
-             */
-            updatedAt: string;
-            [k: string]: unknown;
-        }
+        taskId: string;
     }
 }
 /**
@@ -1051,73 +594,612 @@ export declare namespace SubscriptionPreviewResponse {
 /**
  * Response object
  */
-export interface SubscriptionTransferResponse {
+export interface SubscriptionProvisionResponse {
     /**
-     * Customer subscription to a plan
+     * Provisioning result with status and subscription or checkout URL.
      */
-    data: SubscriptionTransferResponse.Data;
+    data: SubscriptionProvisionResponse.Data;
 }
-export declare namespace SubscriptionTransferResponse {
+export declare namespace SubscriptionProvisionResponse {
     /**
-     * Customer subscription to a plan
+     * Provisioning result with status and subscription or checkout URL.
      */
     interface Data {
         /**
-         * Subscription ID
+         * Unique identifier for the provisioned subscription
          */
         id: string;
+        entitlements: Array<Data.UnionMember0 | Data.UnionMember1> | null;
         /**
-         * 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
+         * Provision status: SUCCESS or PAYMENT_REQUIRED
          */
-        cancellationDate?: string | null;
+        status: 'SUCCESS' | 'PAYMENT_REQUIRED';
         /**
-         * Subscription cancel reason
+         * Created subscription (when status is SUCCESS)
          */
-        cancelReason?: 'UPGRADE_OR_DOWNGRADE' | 'CANCELLED_BY_BILLING' | 'EXPIRED' | 'DETACH_BILLING' | 'TRIAL_ENDED' | 'Immediate' | 'TRIAL_CONVERTED' | 'PENDING_PAYMENT_EXPIRED' | 'ScheduledCancellation' | 'CustomerArchived' | 'AutoCancellationRule' | null;
+        subscription: Data.Subscription | null;
         /**
-         * End of the current billing period
+         * Checkout billing ID when payment is required
          */
-        currentBillingPeriodEnd?: string | null;
+        checkoutBillingId?: string;
         /**
-         * Start of the current billing period
+         * URL to complete payment when PAYMENT_REQUIRED
          */
-        currentBillingPeriodStart?: string | null;
+        checkoutUrl?: string;
         /**
-         * Subscription effective end date
+         * Whether the subscription is scheduled for future activation
          */
-        effectiveEndDate?: string | null;
+        isScheduled?: boolean;
+    }
+    namespace Data {
+        interface UnionMember0 {
+            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?: UnionMember0.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 UnionMember0 {
+            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 UnionMember1 {
+            accessDeniedReason: 'FeatureNotFound' | 'CustomerNotFound' | 'CustomerIsArchived' | 'CustomerResourceNotFound' | 'NoActiveSubscription' | 'NoFeatureEntitlementInSubscription' | 'RequestedUsageExceedingLimit' | 'RequestedValuesMismatch' | 'BudgetExceeded' | 'Unknown' | 'FeatureTypeMismatch' | 'Revoked' | 'InsufficientCredits' | 'EntitlementNotFound' | null;
+            /**
+             * The currency associated with a credit entitlement.
+             */
+            currency: UnionMember1.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 UnionMember1 {
+            /**
+             * The currency associated with a credit entitlement.
+             */
+            interface Currency {
+                /**
+                 * The unique identifier of the custom currency.
+                 */
+                currencyId: string;
+            }
+        }
+        /**
+         * Created subscription (when status is SUCCESS)
+         */
+        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 {
+        /**
+         * Addon ID
+         */
+        addonId: string;
+        quantity: number;
+    }
+    interface AppliedCoupon {
+        billingCouponId?: string;
+        configuration?: AppliedCoupon.Configuration;
+        couponId?: string;
+        discount?: AppliedCoupon.Discount;
+        promotionCode?: string | null;
+    }
+    namespace AppliedCoupon {
+        interface Configuration {
+            /**
+             * Coupon start date
+             */
+            startDate?: string;
+        }
+        interface Discount {
+            amountsOff?: Array<Discount.AmountsOff> | null;
+            description?: string;
+            durationInMonths?: number;
+            name?: string;
+            percentOff?: number;
+        }
+        namespace Discount {
+            interface AmountsOff {
+                amount: number;
+                currency?: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
+            }
+        }
+    }
+    interface BillingInformation {
+        /**
+         * Physical address
+         */
+        billingAddress?: BillingInformation.BillingAddress;
+        chargeOnBehalfOfAccount?: string;
+        couponId?: string;
+        integrationId?: string;
+        invoiceDaysUntilDue?: number;
+        isBackdated?: boolean;
+        isInvoicePaid?: boolean;
+        /**
+         * Additional metadata for the subscription
+         */
+        metadata?: {
+            [key: string]: unknown;
+        };
+        prorationBehavior?: 'INVOICE_IMMEDIATELY' | 'CREATE_PRORATIONS' | 'NONE';
+        taxIds?: Array<BillingInformation.TaxID>;
+        taxPercentage?: number;
+        taxRateIds?: Array<string>;
+    }
+    namespace BillingInformation {
+        /**
+         * Physical address
+         */
+        interface BillingAddress {
+            /**
+             * City name
+             */
+            city?: string;
+            /**
+             * Country code or name
+             */
+            country?: string;
+            /**
+             * Street address line 1
+             */
+            line1?: string;
+            /**
+             * Street address line 2
+             */
+            line2?: string;
+            /**
+             * Postal or ZIP code
+             */
+            postalCode?: string;
+            /**
+             * State or province
+             */
+            state?: string;
+        }
+        interface TaxID {
+            type: string;
+            value: string;
+        }
+    }
+    interface Budget {
+        hasSoftLimit: boolean;
+        limit: number;
+    }
+    interface Charge {
+        /**
+         * Charge ID
+         */
+        id: string;
+        quantity: number;
+        type: 'FEATURE' | 'CREDIT';
+    }
+    interface MinimumSpend {
+        minimum?: MinimumSpend.Minimum | null;
+    }
+    namespace MinimumSpend {
+        interface Minimum {
+            amount: number;
+            currency?: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf';
+        }
+    }
+    interface PriceOverride {
+        /**
+         * 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 ID
+         */
+        id: string;
+        /**
+         * Customer ID
+         */
+        customerId: string;
+        /**
+         * Plan ID
+         */
+        planId: string;
+        /**
+         * Billing ID
+         */
+        billingId?: string | null;
         /**
          * Subscription end date
          */
@@ -1128,135 +1210,100 @@ 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;
-        prices?: Array<Data.Price>;
         /**
          * Resource ID
          */
         resourceId?: string | null;
         /**
-         * Subscription trial end date
+         * Subscription start date
          */
-        trialEndDate?: string | null;
-    }
-    namespace Data {
-        interface Price {
-            /**
-             * Price ID
-             */
-            id: string;
-            /**
-             * Creation timestamp
-             */
-            createdAt: string;
-            /**
-             * Last update timestamp
-             */
-            updatedAt: string;
-            [k: string]: unknown;
-        }
+        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
      */
-    id?: string;
-    addons?: Array<SubscriptionCreateParams.Addon>;
+    addons?: Array<SubscriptionPreviewParams.Addon>;
     /**
-     * Coupon configuration
+     * Coupon or discount to apply
      */
-    appliedCoupon?: SubscriptionCreateParams.AppliedCoupon;
+    appliedCoupon?: SubscriptionPreviewParams.AppliedCoupon;
     /**
-     * Whether to wait for payment confirmation before returning the subscription
+     * Billable features with quantities
      */
-    awaitPaymentConfirmation?: boolean;
+    billableFeatures?: Array<SubscriptionPreviewParams.BillableFeature>;
     /**
-     * The ISO 3166-1 alpha-2 country code for billing
+     * ISO 3166-1 country code for localization
      */
-    billingCountryCode?: string | null;
+    billingCountryCode?: string;
     /**
-     * External billing system identifier
+     * Billing and tax configuration
      */
-    billingId?: string | null;
-    billingInformation?: SubscriptionCreateParams.BillingInformation;
+    billingInformation?: SubscriptionPreviewParams.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
-     */
-    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
+     * One-time or recurring charges
      */
-    paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE';
-    priceOverrides?: Array<SubscriptionCreateParams.PriceOverride>;
+    charges?: Array<SubscriptionPreviewParams.Charge>;
     /**
-     * Optional resource ID for multi-instance subscriptions
+     * Paying customer ID for delegated billing
      */
-    resourceId?: string | null;
+    payingCustomerId?: string;
     /**
-     * Salesforce ID
+     * Resource ID for multi-instance subscriptions
      */
-    salesforceId?: string | null;
+    resourceId?: string;
     /**
-     * Strategy for scheduling subscription changes
+     * When to apply 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;
+    trialOverrideConfiguration?: SubscriptionPreviewParams.TrialOverrideConfiguration;
+    /**
+     * Unit quantity for per-unit pricing
+     */
     unitQuantity?: number;
 }
-export declare namespace SubscriptionCreateParams {
+export declare namespace SubscriptionPreviewParams {
+    /**
+     * Addon configuration
+     */
     interface Addon {
         /**
-         * Addon identifier
+         * Addon ID
          */
         addonId: string;
         /**
-         * Number of addon units
+         * Number of addon instances
          */
         quantity?: number;
     }
     /**
-     * Coupon configuration
+     * Coupon or discount to apply
      */
     interface AppliedCoupon {
         /**
@@ -1328,401 +1375,222 @@ export declare namespace SubscriptionCreateParams {
             }
         }
     }
-    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
+     * Feature with quantity
      */
-    interface Charge {
+    interface BillableFeature {
         /**
-         * Charge ID
+         * Feature ID
          */
-        id: string;
+        featureId: string;
         /**
-         * Charge quantity
+         * Quantity of feature units
          */
         quantity: number;
-        /**
-         * Charge type
-         */
-        type: 'FEATURE' | 'CREDIT';
     }
     /**
-     * Checkout page configuration for payment collection
+     * Billing and tax configuration
      */
-    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;
+    interface BillingInformation {
         /**
-         * Collect billing address during checkout
+         * Billing address
          */
-        collectBillingAddress?: boolean;
+        billingAddress?: BillingInformation.BillingAddress;
         /**
-         * Collect phone number during checkout
+         * Connected account ID for platform billing
          */
-        collectPhoneNumber?: boolean;
+        chargeOnBehalfOfAccount?: string;
         /**
-         * Optional reference ID for the checkout session
+         * Billing integration ID
          */
-        referenceId?: string | null;
-    }
-    interface MinimumSpend {
+        integrationId?: string;
         /**
-         * Minimum spend amount
+         * Days until invoice is due
          */
-        minimum?: MinimumSpend.Minimum | null;
-    }
-    namespace MinimumSpend {
+        invoiceDaysUntilDue?: number;
         /**
-         * Minimum spend amount
+         * Whether subscription is backdated
          */
-        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 {
+        isBackdated?: boolean;
         /**
-         * Addon identifier for the price override
+         * Whether invoice is already paid
          */
-        addonId?: string | null;
+        isInvoicePaid?: boolean;
         /**
-         * Whether this is a base charge override
+         * Additional billing metadata
          */
-        baseCharge?: boolean;
+        metadata?: unknown;
         /**
-         * Block size for pricing
+         * Proration behavior
          */
-        blockSize?: number;
-        creditGrantCadence?: 'BEGINNING_OF_BILLING_PERIOD' | 'MONTHLY';
-        creditRate?: PriceOverride.CreditRate;
+        prorationBehavior?: 'INVOICE_IMMEDIATELY' | 'CREATE_PRORATIONS' | 'NONE';
         /**
-         * Feature identifier for the price override
+         * Customer tax IDs
          */
-        featureId?: string | null;
+        taxIds?: Array<BillingInformation.TaxID>;
         /**
-         * Override price amount
+         * Tax percentage to apply
          */
-        price?: PriceOverride.Price;
+        taxPercentage?: number;
         /**
-         * Pricing tiers configuration
+         * Tax rate IDs from billing provider
          */
-        tiers?: Array<PriceOverride.Tier>;
+        taxRateIds?: Array<string>;
     }
-    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;
-        }
+    namespace BillingInformation {
         /**
-         * Override price amount
+         * Billing address
          */
-        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;
+        interface BillingAddress {
+            city?: string;
+            country?: string;
+            line1?: string;
+            line2?: string;
+            postalCode?: string;
+            state?: string;
         }
-        namespace Tier {
+        /**
+         * Tax exemption identifier
+         */
+        interface TaxID {
             /**
-             * The flat fee price of the price tier
+             * Tax exemption type (e.g., vat, gst)
              */
-            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';
-            }
+            type: string;
             /**
-             * The unit price of the price tier
+             * Tax exemption identifier value
              */
-            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';
-            }
+            value: string;
         }
     }
-    interface SubscriptionEntitlement {
+    /**
+     * Charge item
+     */
+    interface Charge {
         /**
-         * Feature ID
+         * Charge ID
          */
-        featureId: string;
-        usageLimit: number;
-        isGranted?: boolean;
+        id: string;
+        /**
+         * Charge quantity
+         */
+        quantity: number;
+        /**
+         * Charge type
+         */
+        type: 'FEATURE' | 'CREDIT';
     }
     /**
      * Trial period override settings
      */
     interface TrialOverrideConfiguration {
         /**
-         * Whether the subscription should start with a trial period
+         * Whether to start as trial
          */
         isTrial: boolean;
         /**
-         * Behavior when trial ends: CONVERT_TO_PAID or CANCEL_SUBSCRIPTION
+         * Behavior when trial ends
          */
         trialEndBehavior?: 'CONVERT_TO_PAID' | 'CANCEL_SUBSCRIPTION';
         /**
-         * Custom trial end date
+         * Trial end date
          */
         trialEndDate?: string;
     }
 }
-export interface SubscriptionListParams extends MyCursorIDPageParams {
-    /**
-     * Filter by customer ID
-     */
-    customerId?: string;
+export interface SubscriptionProvisionParams {
     /**
-     * Filter by status (comma-separated)
+     * Customer ID to provision the subscription for
      */
-    status?: string;
-}
-export interface SubscriptionDelegateParams {
+    customerId: string;
     /**
-     * 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.
+     * Plan ID to provision
      */
-    targetCustomerId: string;
-}
-export interface SubscriptionMigrateParams {
+    planId: string;
     /**
-     * When to migrate (immediate or period end)
+     * Unique identifier for the subscription
      */
-    subscriptionMigrationTime?: 'END_OF_BILLING_PERIOD' | 'IMMEDIATE';
-}
-export interface SubscriptionPreviewParams {
+    id?: string;
+    addons?: Array<SubscriptionProvisionParams.Addon>;
     /**
-     * Customer ID
+     * Coupon configuration
      */
-    customerId: string;
+    appliedCoupon?: SubscriptionProvisionParams.AppliedCoupon;
     /**
-     * Plan ID
+     * Whether to wait for payment confirmation before returning the subscription
      */
-    planId: string;
+    awaitPaymentConfirmation?: boolean;
     /**
-     * Addons to include
+     * The ISO 3166-1 alpha-2 country code for billing
      */
-    addons?: Array<SubscriptionPreviewParams.Addon>;
+    billingCountryCode?: string | null;
     /**
-     * Coupon or discount to apply
+     * External billing system identifier
      */
-    appliedCoupon?: SubscriptionPreviewParams.AppliedCoupon;
+    billingId?: string | null;
+    billingInformation?: SubscriptionProvisionParams.BillingInformation;
     /**
-     * Billable features with quantities
+     * Billing period (MONTHLY or ANNUALLY)
      */
-    billableFeatures?: Array<SubscriptionPreviewParams.BillableFeature>;
+    billingPeriod?: 'MONTHLY' | 'ANNUALLY';
+    budget?: SubscriptionProvisionParams.Budget | null;
+    charges?: Array<SubscriptionProvisionParams.Charge>;
     /**
-     * ISO 3166-1 country code for localization
+     * Checkout page configuration for payment collection
      */
-    billingCountryCode?: string;
+    checkoutOptions?: SubscriptionProvisionParams.CheckoutOptions;
     /**
-     * Billing and tax configuration
+     * Additional metadata for the subscription
      */
-    billingInformation?: SubscriptionPreviewParams.BillingInformation;
+    metadata?: {
+        [key: string]: string;
+    };
+    minimumSpend?: SubscriptionProvisionParams.MinimumSpend | null;
     /**
-     * Billing period (MONTHLY or ANNUALLY)
+     * Optional paying customer ID for split billing scenarios
      */
-    billingPeriod?: 'MONTHLY' | 'ANNUALLY';
+    payingCustomerId?: string | null;
     /**
-     * One-time or recurring charges
+     * How payments should be collected for this subscription
      */
-    charges?: Array<SubscriptionPreviewParams.Charge>;
+    paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE';
+    priceOverrides?: Array<SubscriptionProvisionParams.PriceOverride>;
     /**
-     * Paying customer ID for delegated billing
+     * Optional resource ID for multi-instance subscriptions
      */
-    payingCustomerId?: string;
+    resourceId?: string | null;
     /**
-     * Resource ID for multi-instance subscriptions
+     * Salesforce ID
      */
-    resourceId?: string;
+    salesforceId?: string | null;
     /**
-     * When to apply subscription changes
+     * Strategy for scheduling subscription changes
      */
     scheduleStrategy?: 'END_OF_BILLING_PERIOD' | 'END_OF_BILLING_MONTH' | 'IMMEDIATE';
     /**
      * Subscription start date
      */
     startDate?: string;
+    subscriptionEntitlements?: Array<SubscriptionProvisionParams.SubscriptionEntitlement>;
     /**
      * Trial period override settings
      */
-    trialOverrideConfiguration?: SubscriptionPreviewParams.TrialOverrideConfiguration;
-    /**
-     * Unit quantity for per-unit pricing
-     */
-    unitQuantity?: number;
-}
-export declare namespace SubscriptionPreviewParams {
-    /**
-     * Addon configuration
-     */
+    trialOverrideConfiguration?: SubscriptionProvisionParams.TrialOverrideConfiguration;
+    unitQuantity?: number;
+}
+export declare namespace SubscriptionProvisionParams {
     interface Addon {
         /**
-         * Addon ID
+         * Addon identifier
          */
         addonId: string;
         /**
-         * Number of addon instances
+         * Number of addon units
          */
         quantity?: number;
     }
     /**
-     * Coupon or discount to apply
+     * Coupon configuration
      */
     interface AppliedCoupon {
         /**
@@ -1794,71 +1662,57 @@ export declare namespace SubscriptionPreviewParams {
             }
         }
     }
-    /**
-     * Feature with quantity
-     */
-    interface BillableFeature {
-        /**
-         * Feature ID
-         */
-        featureId: string;
-        /**
-         * Quantity of feature units
-         */
-        quantity: number;
-    }
-    /**
-     * Billing and tax configuration
-     */
     interface BillingInformation {
         /**
-         * Billing address
+         * Billing address for the subscription
          */
         billingAddress?: BillingInformation.BillingAddress;
         /**
-         * Connected account ID for platform billing
+         * Stripe Connect account to charge on behalf of
          */
-        chargeOnBehalfOfAccount?: string;
+        chargeOnBehalfOfAccount?: string | null;
         /**
-         * Billing integration ID
+         * Billing integration identifier
          */
-        integrationId?: string;
+        integrationId?: string | null;
         /**
-         * Days until invoice is due
+         * Number of days until invoice is due
          */
         invoiceDaysUntilDue?: number;
         /**
-         * Whether subscription is backdated
+         * Whether the subscription is backdated
          */
         isBackdated?: boolean;
         /**
-         * Whether invoice is already paid
+         * Whether the invoice is marked as paid
          */
         isInvoicePaid?: boolean;
         /**
-         * Additional billing metadata
+         * Additional metadata for the subscription
          */
-        metadata?: unknown;
+        metadata?: {
+            [key: string]: string;
+        };
         /**
-         * Proration behavior
+         * How to handle proration for billing changes
          */
         prorationBehavior?: 'INVOICE_IMMEDIATELY' | 'CREATE_PRORATIONS' | 'NONE';
         /**
-         * Customer tax IDs
+         * Customer tax identification numbers
          */
         taxIds?: Array<BillingInformation.TaxID>;
         /**
-         * Tax percentage to apply
+         * Tax percentage (0-100)
          */
         taxPercentage?: number;
         /**
-         * Tax rate IDs from billing provider
+         * Tax rate identifiers to apply
          */
         taxRateIds?: Array<string>;
     }
     namespace BillingInformation {
         /**
-         * Billing address
+         * Billing address for the subscription
          */
         interface BillingAddress {
             city?: string;
@@ -1868,20 +1722,27 @@ export declare namespace SubscriptionPreviewParams {
             postalCode?: string;
             state?: string;
         }
-        /**
-         * Tax exemption identifier
-         */
         interface TaxID {
             /**
-             * Tax exemption type (e.g., vat, gst)
+             * The type of tax exemption identifier, such as VAT.
              */
             type: string;
             /**
-             * Tax exemption identifier value
+             * 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
      */
@@ -1899,20 +1760,197 @@ export declare namespace SubscriptionPreviewParams {
          */
         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 to start as trial
+         * Whether the subscription should start with a trial period
          */
         isTrial: boolean;
         /**
-         * Behavior when trial ends
+         * 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;
     }
@@ -1924,7 +1962,7 @@ export interface SubscriptionTransferParams {
     destinationResourceId: string;
 }
 export declare namespace Subscriptions {
-    export { type SubscriptionCreateResponse as SubscriptionCreateResponse, type SubscriptionRetrieveResponse as SubscriptionRetrieveResponse, type SubscriptionListResponse as SubscriptionListResponse, type SubscriptionDelegateResponse as SubscriptionDelegateResponse, type SubscriptionMigrateResponse as SubscriptionMigrateResponse, type SubscriptionPreviewResponse as SubscriptionPreviewResponse, type SubscriptionTransferResponse as SubscriptionTransferResponse, type SubscriptionListResponsesMyCursorIDPage as SubscriptionListResponsesMyCursorIDPage, type SubscriptionCreateParams as SubscriptionCreateParams, type SubscriptionListParams as SubscriptionListParams, type SubscriptionDelegateParams as SubscriptionDelegateParams, type SubscriptionMigrateParams as SubscriptionMigrateParams, type SubscriptionPreviewParams as SubscriptionPreviewParams, type SubscriptionTransferParams as SubscriptionTransferParams, };
-    export { FutureUpdate as FutureUpdate, type FutureUpdateCancelPendingPaymentResponse as FutureUpdateCancelPendingPaymentResponse, type FutureUpdateCancelScheduleResponse as FutureUpdateCancelScheduleResponse, };
+    export { type Subscription as Subscription, type SubscriptionListResponse as SubscriptionListResponse, type SubscriptionImportResponse as SubscriptionImportResponse, type SubscriptionPreviewResponse as SubscriptionPreviewResponse, type SubscriptionProvisionResponse as SubscriptionProvisionResponse, type SubscriptionListResponsesMyCursorIDPage as SubscriptionListResponsesMyCursorIDPage, type SubscriptionUpdateParams as SubscriptionUpdateParams, type SubscriptionListParams as SubscriptionListParams, type SubscriptionCancelParams as SubscriptionCancelParams, type SubscriptionDelegateParams as SubscriptionDelegateParams, type SubscriptionImportParams as SubscriptionImportParams, type SubscriptionMigrateParams as SubscriptionMigrateParams, type SubscriptionPreviewParams as SubscriptionPreviewParams, type SubscriptionProvisionParams as SubscriptionProvisionParams, type SubscriptionTransferParams as SubscriptionTransferParams, };
+    export { FutureUpdate as FutureUpdate, type CancelSubscription as CancelSubscription };
 }
 //# sourceMappingURL=subscriptions.d.ts.map