@solvapay/server 1.0.6 → 1.0.8-preview.1

package/dist/index.d.ts

@@ -49,198 +49,35 @@ type WebhookEvent = {
 
 interface components {
     schemas: {
-        UpdateProviderDto: {
-            /** @description Legal entity information */
-            legalEntity?: Record<string, never>;
-            /**
-             * Provider description
-             * @example My business
-             */
-            description?: string;
-            /**
-             * Business website URL
-             * @example https://example.com
-             */
-            website?: string;
-            /**
-             * Business type
-             * @example individual
-             * @enum {string}
-             */
-            businessType?: "individual" | "company";
-            /**
-             * Business email address
-             * @example business@example.com
-             */
-            businessEmail?: string;
-            /**
-             * Support email address
-             * @example support@example.com
-             */
-            supportEmail?: string;
-            /**
-             * Business telephone number
-             * @example +1234567890
-             */
-            telephone?: string;
-            /**
-             * Support telephone number
-             * @example +1234567890
-             */
-            supportTelephone?: string;
-            /**
-             * Default currency code
-             * @example usd
-             */
-            defaultCurrency?: string;
-            /** @description Arbitrary metadata */
-            metadata?: Record<string, never>;
-            /** @description Terms of Service acceptance */
-            tosAcceptance?: Record<string, never>;
-        };
-        CreateSecretKey: Record<string, never>;
-        CreateUser: Record<string, never>;
-        UpdateUser: Record<string, never>;
-        UpdateProfile: Record<string, never>;
-        UpdatePreferences: Record<string, never>;
-        RequestEmailChange: {
-            newEmail: string;
-        };
-        VerifyEmailChange: {
-            code: string;
-        };
-        CreateUiCheckoutSessionRequest: {
-            /**
-             * Customer reference
-             * @example cus_3c4d5e6f7g8h
-             */
+        CreatePaymentIntentDto: {
+            productRef?: string;
             customerRef: string;
-            /**
-             * Plan reference (optional)
-             * @example pln_2b3c4d5e6f7g
-             */
             planRef?: string;
+            pricingTier?: string;
             /**
-             * Product reference (required)
-             * @example prd_1a2b3c4d5e6f
-             */
-            productRef: string;
-        };
-        CreateUiCheckoutSessionResponse: {
-            /**
-             * Checkout session ID
-             * @example 507f1f77bcf86cd799439011
-             */
-            id: string;
-            /**
-             * Public session ID used in checkout URL
-             * @example a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
-             */
-            sessionId: string;
-            /**
-             * Amount in cents
-             * @example 2999
-             */
-            amount: number;
-            /**
-             * Currency code
-             * @example USD
-             */
-            currency: string;
-            /**
-             * Session status
-             * @example active
-             */
-            status: string;
-            /**
-             * Checkout URL to open the checkout page
-             * @example https://solvapay.com/customer/checkout?id=a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
-             */
-            checkoutUrl: string;
-        };
-        SelectCustomerSessionProductRequest: {
-            /**
-             * Product reference or ID to scope the customer manage session
-             * @example prd_1a2b3c4d5e6f
-             */
-            productRef: string;
-        };
-        CancelRenewalRequest: {
-            /** @description Reason for cancelling renewal */
-            reason?: string;
-        };
-        ExternalAccount: {
-            /**
-             * Country code
-             * @example US
-             */
-            country: string;
-            /**
-             * Currency code
-             * @example usd
-             */
-            currency: string;
-            /**
-             * Account holder name
-             * @example John Doe
-             */
-            accountHolderName: string;
-            /**
-             * Account holder type
-             * @example individual
+             * @default product
              * @enum {string}
              */
-            accountHolderType: "individual" | "company";
-            /**
-             * Routing number
-             * @example 110000000
-             */
-            routingNumber: string;
-            /**
-             * Account number
-             * @example 000123456789
-             */
-            accountNumber: string;
-        };
-        TosAcceptance: {
-            /**
-             * IP address of user accepting ToS
-             * @example 192.168.1.1
-             */
-            ip: string;
-        };
-        UpdateConnectedAccount: {
-            /**
-             * Business website URL
-             * @example https://example.com
-             */
-            website?: string;
-            /** @description External bank account */
-            externalAccount?: components["schemas"]["ExternalAccount"];
-            /** @description Terms of Service acceptance */
-            tosAcceptance?: components["schemas"]["TosAcceptance"];
+            purpose: "product" | "credit_topup" | "usage_billing";
+            amount?: number;
+            currency?: string;
+            description?: string;
         };
         CreateCheckoutSessionRequest: {
-            /**
-             * Customer reference identifier
-             * @example cus_3c4d5e6f7g8h
-             */
             customerRef: string;
-            /**
-             * Product reference identifier
-             * @example prd_1A2B3C4D
-             */
-            productRef: string;
-            /**
-             * Plan reference identifier (optional)
-             * @example pln_2b3c4d5e6f7g
-             */
+            productRef?: string;
             planRef?: string;
-            /**
-             * URL to redirect to after successful payment (optional)
-             * @example https://example.com/payment-success
-             */
             returnUrl?: string;
+            /** @enum {string} */
+            purpose?: "credit_topup";
+        };
+        CancelPurchaseRequest: {
+            reason?: string;
+        };
+        ProcessPaymentIntentDto: {
+            productRef: string;
+            customerRef: string;
+            planRef?: string;
         };
         CreateCheckoutSessionResponse: {
             /**
@@ -254,151 +91,33 @@ interface components {
              */
             checkoutUrl: string;
         };
-        Signup: {
-            name: string;
-            email: string;
-            /** @enum {string} */
-            type?: "provider" | "admin" | "super_admin";
-        };
-        AuthUserDto: {
-            id: string;
-            name: string;
-            email: string;
-            /** @enum {string} */
-            type: "provider" | "admin" | "super_admin";
-            emailVerified: boolean;
-            /** @enum {string} */
-            authProvider: "local" | "google" | "github" | "facebook";
-            providerId?: string;
-            providerRole?: string;
-            preferences?: Record<string, never>;
-        };
-        AuthResponse: {
-            user: components["schemas"]["AuthUserDto"];
-            accessToken?: string;
-            refreshToken?: string;
-            expiresIn?: number;
-            message?: string;
-            requiresMfa?: boolean;
-            requiresMfaSetup?: boolean;
-        };
-        Login: {
-            /** @description Email to send a 6-digit login code to */
-            email: string;
-        };
-        VerifyLoginCode: {
-            email: string;
-            /** @description 6-digit login code sent to email */
-            code: string;
-        };
-        VerifyEmail: {
-            emailVerificationCode: string;
-        };
-        DynamicClientRegistrationDto: {
-            /** @example My AI Agent */
-            client_name: string;
-            /**
-             * @example [
-             *       "https://agent.example.com/callback"
-             *     ]
-             */
-            redirect_uris: string[];
-            /**
-             * @example [
-             *       "authorization_code",
-             *       "refresh_token"
-             *     ]
-             */
-            grant_types?: string[];
-            /**
-             * @example [
-             *       "code"
-             *     ]
-             */
-            response_types?: string[];
-            /** @example agent-123 */
-            software_id?: string;
-            /** @example 1.0.0 */
-            software_version?: string;
-            /** @example https://example.com/logo.png */
-            logo_uri?: string;
-            /** @example https://example.com/tos */
-            tos_uri?: string;
-            /** @example https://example.com/policy */
-            policy_uri?: string;
-            /** @example https://example.com */
-            client_uri?: string;
-        };
-        DynamicClientRegistrationResponseDto: {
-            /** @example client-id-123 */
-            client_id: string;
-            /** @example client-secret-456 */
-            client_secret: string;
-            /** @example 1734567890 */
-            client_id_issued_at: number;
-            /** @example 0 */
-            client_secret_expires_at: number;
-            /** @example My AI Agent */
-            client_name: string;
-            /**
-             * @example [
-             *       "https://agent.example.com/callback"
-             *     ]
-             */
-            redirect_uris: string[];
-            /**
-             * @example [
-             *       "authorization_code",
-             *       "refresh_token"
-             *     ]
-             */
-            grant_types: string[];
-            /**
-             * @example [
-             *       "code"
-             *     ]
-             */
-            response_types: string[];
-            /** @example openid profile email */
-            scope: string;
-            /** @example client_secret_basic */
-            token_endpoint_auth_method: string;
-        };
-        GoogleLoginDto: {
-            /** @description The authorization code returned by Google */
-            code: string;
-            /** @description The redirect URI used in the initial authorization request */
-            redirect_uri: string;
-            /** @description The state parameter returned by Google (contains client_id) */
-            state: string;
-        };
-        GithubLoginDto: {
-            /** @description The authorization code returned by GitHub */
-            code: string;
-            /** @description The redirect URI used in the initial authorization request */
-            redirect_uri: string;
-            /** @description The state parameter returned by GitHub (contains client_id) */
-            state: string;
-        };
-        CreateOAuthClientDto: Record<string, never>;
-        UpdateOAuthClientDto: Record<string, never>;
         Plan: {
             /**
              * Plan type exposed in SDK
              * @example recurring
              * @enum {string}
              */
-            type: "recurring" | "one-time";
-            /**
-             * Plan ID
-             * @example 507f1f77bcf86cd799439011
-             */
-            id: string;
+            type: "recurring" | "one-time" | "usage-based" | "hybrid";
             /**
              * Plan reference
              * @example pln_1A2B3C4D
              */
             reference: string;
+            /**
+             * Meter reference for usage-based plans
+             * @example mtr_1A2B3C4D
+             */
+            meterRef?: string;
+            /**
+             * Plan name
+             * @example Starter
+             */
+            name?: string;
+            /**
+             * Plan description
+             * @example Best for teams getting started
+             */
+            description?: string;
             /**
              * Plan price in cents
              * @example 2999
@@ -441,10 +160,10 @@ interface components {
              */
             billingModel?: "pre-paid" | "post-paid";
             /**
-             * Price per usage unit
-             * @example 0.01
+             * Credits per usage unit (integer, >= 1)
+             * @example 1
              */
-            pricePerUnit?: number;
+            creditsPerUnit?: number;
             /**
              * What the plan measures for usage tracking
              * @example requests
@@ -468,11 +187,6 @@ interface components {
             features?: {
                 [key: string]: unknown;
             };
-            /**
-             * Whether this is a free tier plan
-             * @example false
-             */
-            isFreeTier: boolean;
             /**
              * Whether payment is required
              * @example true
@@ -498,176 +212,87 @@ interface components {
             updatedAt: string;
         };
         CreatePlanRequest: {
-            /**
-             * Plan type exposed in SDK
-             * @example recurring
-             * @enum {string}
-             */
-            type?: "recurring" | "one-time";
-            /**
-             * Billing cycle (required for recurring/hybrid, optional for post-paid usage-based)
-             * @example monthly
-             * @enum {string}
-             */
+            name?: string;
+            description?: string;
+            /** @enum {string} */
+            type?: "recurring" | "usage-based" | "one-time" | "hybrid";
+            /** @enum {string} */
             billingCycle?: "weekly" | "monthly" | "quarterly" | "yearly" | "custom";
-            /**
-             * Plan price in cents
-             * @example 2999
-             */
             price?: number;
-            /**
-             * Currency code (ISO 4217)
-             * @example USD
-             * @enum {string}
-             */
-            currency?: "USD" | "EUR" | "GBP" | "SEK" | "NOK" | "DKK" | "CAD" | "AUD" | "JPY" | "CHF" | "PLN" | "CZK" | "HUF" | "RON" | "BGN" | "HRK" | "RSD" | "MKD" | "BAM" | "ALL" | "ISK" | "TRY" | "RUB" | "UAH" | "BYN" | "MDL" | "GEL" | "AMD" | "AZN" | "KZT" | "KGS" | "TJS" | "TMT" | "UZS" | "MNT" | "CNY" | "KRW" | "THB" | "VND" | "IDR" | "MYR" | "SGD" | "PHP" | "INR" | "PKR" | "BDT" | "LKR" | "NPR" | "AFN" | "IRR" | "IQD" | "JOD" | "KWD" | "LBP" | "OMR" | "QAR" | "SAR" | "SYP" | "AED" | "YER" | "ILS" | "EGP" | "MAD" | "TND" | "DZD" | "LYD" | "SDG" | "ETB" | "KES" | "TZS" | "UGX" | "RWF" | "BIF" | "DJF" | "SOS" | "ERN" | "SLL" | "GMD" | "GNF" | "CVE" | "STN" | "AOA" | "ZAR" | "BWP" | "SZL" | "LSL" | "NAD" | "ZMW" | "ZWL" | "MZN" | "MWK" | "MGA" | "MUR" | "SCR" | "KMF" | "MVR";
-            /**
-             * Number of free units included
-             * @example 100
-             */
+            creditsPerUnit?: number;
+            currency?: string;
+            /** @enum {string} */
+            billingModel?: "pre-paid" | "post-paid";
             freeUnits?: number;
-            /**
-             * Usage limit for the meter
-             * @example 10000
-             */
             limit?: number;
-            /**
-             * Usage limits (shape varies by plan type)
-             * @example {
-             *       "maxTransactions": 1000
-             *     }
-             */
-            limits?: {
+            basePrice?: number;
+            setupFee?: number;
+            trialDays?: number;
+            rolloverUnusedUnits?: boolean;
+            autoRenew?: boolean;
+            usageTracking: {
+                /** @enum {string} */
+                method?: "automatic" | "manual" | "hybrid";
+                /** @enum {string} */
+                granularity?: "hourly" | "daily" | "weekly" | "monthly";
+            };
+            limits: {
                 [key: string]: unknown;
             };
-            /**
-             * Plan features (generic key/value, shape is provider-defined)
-             * @example {
-             *       "apiAccess": true,
-             *       "prioritySupport": false
-             *     }
-             */
-            features?: {
+            metadata: {
                 [key: string]: unknown;
             };
-            /**
-             * Whether this is a free tier plan
-             * @example false
-             */
-            isFreeTier?: boolean;
-            /**
-             * Whether payment is required
-             * @example true
-             */
-            requiresPayment?: boolean;
-            /**
-             * Plan status
-             * @example active
-             * @enum {string}
-             */
+            features: {
+                [key: string]: unknown;
+            };
+            /** @enum {string} */
             status?: "active" | "inactive" | "archived";
-            /**
-             * Maximum number of active users
-             * @example 10
-             */
             maxActiveUsers?: number;
-            /**
-             * Access expiry in days
-             * @example 30
-             */
             accessExpiryDays?: number;
-            /** @description Additional metadata */
-            metadata?: {
-                [key: string]: unknown;
-            };
-            /**
-             * Whether this is the default plan
-             * @example false
-             */
             default?: boolean;
         };
         UpdatePlanRequest: {
-            /**
-             * Billing cycle
-             * @example monthly
-             * @enum {string}
-             */
+            name?: string;
+            description?: string;
+            /** @enum {string} */
             billingCycle?: "weekly" | "monthly" | "quarterly" | "yearly" | "custom";
-            /**
-             * Plan price in cents
-             * @example 2999
-             */
             price?: number;
-            /**
-             * Currency code (ISO 4217)
-             * @example USD
-             */
+            creditsPerUnit?: number;
             currency?: string;
-            /**
-             * Number of free units included
-             * @example 100
-             */
+            /** @enum {string} */
+            billingModel?: "pre-paid" | "post-paid";
             freeUnits?: number;
-            /**
-             * Usage limit for the meter
-             * @example 10000
-             */
             limit?: number;
-            /**
-             * Usage limits (shape varies by plan type)
-             * @example {
-             *       "maxTransactions": 1000
-             *     }
-             */
-            limits?: {
+            limits: {
                 [key: string]: unknown;
             };
-            /**
-             * Plan features (generic key/value, shape is provider-defined)
-             * @example {
-             *       "apiAccess": true,
-             *       "prioritySupport": false
-             *     }
-             */
-            features?: {
+            features: {
                 [key: string]: unknown;
             };
-            /**
-             * Whether this is a free tier plan
-             * @example false
-             */
-            isFreeTier?: boolean;
-            /**
-             * Whether payment is required
-             * @example true
-             */
-            requiresPayment?: boolean;
-            /**
-             * Plan status
-             * @example active
-             * @enum {string}
-             */
+            /** @enum {string} */
             status?: "active" | "inactive" | "archived";
-            /**
-             * Maximum number of active users
-             * @example 10
-             */
             maxActiveUsers?: number;
-            /**
-             * Access expiry in days
-             * @example 30
-             */
             accessExpiryDays?: number;
-            /** @description Additional metadata */
-            metadata?: {
+            metadata: {
                 [key: string]: unknown;
             };
-            /**
-             * Whether this is the default plan
-             * @example false
-             */
             default?: boolean;
         };
+        CreateProductRequest: {
+            name: string;
+            description?: string;
+            imageUrl?: string;
+            productType?: string;
+            isMcpPay?: boolean;
+            config: {
+                fulfillmentType?: string;
+                validityPeriod?: number;
+                deliveryMethod?: string;
+            };
+            metadata: {
+                [key: string]: unknown;
+            };
+        };
         ProductConfigDto: {
             /**
              * Fulfillment type
@@ -685,42 +310,7 @@ interface components {
              */
             deliveryMethod?: string;
         };
-        CreateProductRequest: {
-            /**
-             * Product name
-             * @example AI Writing Assistant
-             */
-            name: string;
-            /**
-             * Product description
-             * @example AI-powered writing tool
-             */
-            description?: string;
-            /** @description URL to the product image */
-            imageUrl?: string;
-            /**
-             * Free-form product type defined by the provider
-             * @example Coding Assistant
-             */
-            productType?: string;
-            /**
-             * Whether this product uses MCP Pay proxy
-             * @default false
-             */
-            isMcpPay: boolean;
-            /** @description Product-specific configuration */
-            config?: components["schemas"]["ProductConfigDto"];
-            /** @description Arbitrary key-value metadata */
-            metadata?: {
-                [key: string]: unknown;
-            };
-        };
         SdkPlanResponse: {
-            /**
-             * Plan ID
-             * @example 507f1f77bcf86cd799439011
-             */
-            id: string;
             /**
              * Plan reference
              * @example pln_1A2B3C4D
@@ -762,15 +352,20 @@ interface components {
              */
             billingModel?: string;
             /**
-             * Price per unit in cents
-             * @example 10
+             * Credits per usage unit (integer, >= 1)
+             * @example 1
              */
-            pricePerUnit?: number;
+            creditsPerUnit?: number;
             /**
              * What the plan measures for usage tracking
              * @example requests
              */
             measures?: string;
+            /**
+             * Meter reference for usage-based limits
+             * @example mtr_1A2B3C4D
+             */
+            meterRef?: string;
             /**
              * Usage limit for the meter
              * @example 10000
@@ -794,11 +389,6 @@ interface components {
             features?: {
                 [key: string]: unknown;
             };
-            /**
-             * Whether this is a free tier plan
-             * @example false
-             */
-            isFreeTier: boolean;
             /**
              * Whether payment is required
              * @example true
@@ -820,11 +410,6 @@ interface components {
             updatedAt: string;
         };
         SdkProductResponse: {
-            /**
-             * Product ID
-             * @example 507f1f77bcf86cd799439011
-             */
-            id: string;
             /**
              * Product reference
              * @example prd_1A2B3C4D
@@ -876,12 +461,11 @@ interface components {
             /**
              * MCP linkage details for MCP-enabled products
              * @example {
-             *       "mcpServerId": "67f90f1f1b1c9c0b8df0f111",
-             *       "mcpServerReference": "mcp_ABC123",
+             *       "mcpServerRef": "mcp_ABC123",
              *       "mcpSubdomain": "acme-docs",
              *       "mcpProxyUrl": "https://acme-docs.mcp.solvapay.com/mcp",
              *       "originUrl": "https://origin.example.com/mcp",
-             *       "defaultPlanId": "67f90f1f1b1c9c0b8df0f001"
+             *       "defaultPlanRef": "pln_FREE123"
              *     }
              */
             mcp?: {
@@ -889,175 +473,56 @@ interface components {
             };
         };
         UpdateProductRequest: {
-            /** @description Product name */
             name?: string;
-            /** @description Product description */
             description?: string;
-            /** @description URL to the product image */
             imageUrl?: string;
-            /** @description Free-form product type defined by the provider */
             productType?: string;
-            /**
-             * Product status
-             * @enum {string}
-             */
+            /** @enum {string} */
             status?: "active" | "inactive" | "suspended";
-            /** @description Product-specific configuration */
-            config?: components["schemas"]["ProductConfigDto"];
-            /** @description Arbitrary key-value metadata */
-            metadata?: {
-                [key: string]: unknown;
+            config: {
+                fulfillmentType?: string;
+                validityPeriod?: number;
+                deliveryMethod?: string;
             };
-        };
-        McpBootstrapFreePlanConfig: {
-            /**
-             * Free plan display name override
-             * @example Starter
-             */
-            name?: string;
-            /**
-             * Included free units (default 1000)
-             * @example 500
-             */
-            freeUnits?: number;
-        };
-        McpBootstrapPaidPlanInput: {
-            /**
-             * Logical plan key (must not be "free")
-             * @example pro
-             */
-            key: string;
-            /**
-             * Plan display name
-             * @example Pro
-             */
-            name: string;
-            /**
-             * Plan price in cents (must be > 0)
-             * @example 2000
-             */
-            price: number;
-            /**
-             * Currency code (ISO 4217)
-             * @example USD
-             */
-            currency: string;
-            /**
-             * Billing cycle for recurring plans
-             * @example monthly
-             * @enum {string}
-             */
-            billingCycle?: "weekly" | "monthly" | "quarterly" | "yearly" | "custom";
-            /**
-             * Plan type
-             * @example recurring
-             * @enum {string}
-             */
-            type?: "recurring" | "one-time";
-            /**
-             * Included free units
-             * @example 1000
-             */
-            freeUnits?: number;
-            /**
-             * Meter id for usage tracking
-             * @example 67f90f1f1b1c9c0b8df0f001
-             */
-            meterId?: string;
-            /**
-             * Plan usage limit
-             * @example 10000
-             */
-            limit?: number;
-            /** @description Plan features */
-            features?: {
+            metadata: {
                 [key: string]: unknown;
             };
         };
-        McpBootstrapToolInput: {
-            /**
-             * Tool name
-             * @example search_docs
-             */
-            name: string;
-            /**
-             * Tool description
-             * @example Search indexed documents
-             */
-            description?: string;
-            /**
-             * If true, tool is publicly available without a plan
-             * @example false
-             */
-            noPlan?: boolean;
-            /**
-             * Direct plan IDs allowed for this tool
-             * @example [
-             *       "67f90f1f1b1c9c0b8df0f001"
-             *     ]
-             */
-            planIds?: string[];
-            /**
-             * Plan references allowed for this tool
-             * @example [
-             *       "pln_ABC123"
-             *     ]
-             */
-            planRefs?: string[];
-            /**
-             * Bootstrap plan keys allowed for this tool (for example free or starter_paid)
-             * @example [
-             *       "free"
-             *     ]
-             */
-            planKeys?: string[];
-        };
-        McpBootstrapRequest: {
-            /**
-             * Product name (optional when derivable from origin MCP metadata)
-             * @example Acme MCP Toolkit
-             */
+        McpBootstrapDto: {
             name?: string;
-            /**
-             * Product description
-             * @example MCP toolkit with tiered access
-             */
             description?: string;
-            /** @description Product image URL */
             imageUrl?: string;
-            /**
-             * Free-form product type
-             * @example MCP Server
-             */
             productType?: string;
-            /**
-             * Origin MCP server URL (must be https)
-             * @example https://origin.example.com/mcp
-             */
+            /** Format: uri */
             originUrl: string;
-            /**
-             * Optional final MCP subdomain override (for example, value returned by bootstrap-subdomain-checks)
-             * @example acme-docs
-             */
             mcpDomain?: string;
-            /**
-             * Optional auth header name forwarded to origin server
-             * @example X-API-Key
-             */
             authHeaderName?: string;
-            /**
-             * Optional auth API key forwarded to origin server
-             * @example sk-origin-123
-             */
             authApiKey?: string;
-            /** @description Free plan config overrides. A free plan is always created; this just customizes name/freeUnits. */
-            freePlan?: components["schemas"]["McpBootstrapFreePlanConfig"];
-            /** @description Paid plan definitions requiring price + currency */
-            paidPlans?: components["schemas"]["McpBootstrapPaidPlanInput"][];
-            /** @description Tool to plan mapping configuration */
-            tools?: components["schemas"]["McpBootstrapToolInput"][];
-            /** @description Arbitrary product metadata */
-            metadata?: {
+            plans?: {
+                key: string;
+                name: string;
+                price: number;
+                currency: string;
+                /** @enum {string} */
+                billingCycle?: "weekly" | "monthly" | "quarterly" | "yearly" | "custom";
+                /** @enum {string} */
+                type?: "recurring" | "one-time" | "usage-based";
+                creditsPerUnit?: number;
+                /** @enum {string} */
+                billingModel?: "pre-paid" | "post-paid";
+                freeUnits?: number;
+                limit?: number;
+                features?: {
+                    [key: string]: unknown;
+                };
+            }[];
+            tools?: {
+                name: string;
+                description?: string;
+                noPlan?: boolean;
+                planKeys?: string[];
+            }[];
+            metadata: {
                 [key: string]: unknown;
             };
         };
@@ -1067,12 +532,11 @@ interface components {
             /**
              * Created or updated MCP server identity
              * @example {
-             *       "id": "67f90f1f1b1c9c0b8df0f111",
              *       "reference": "mcp_ABC123",
              *       "subdomain": "acme-docs",
              *       "mcpProxyUrl": "https://acme-docs.mcp.solvapay.com/mcp",
              *       "url": "https://origin.example.com/mcp",
-             *       "defaultPlanId": "67f90f1f1b1c9c0b8df0f001"
+             *       "defaultPlanRef": "pln_FREE123"
              *     }
              */
             mcpServer: {
@@ -1082,7 +546,6 @@ interface components {
              * Resolved plan mapping by bootstrap key
              * @example {
              *       "free": {
-             *         "id": "67f90f1f1b1c9c0b8df0f001",
              *         "reference": "pln_FREE123",
              *         "name": "Free"
              *       }
@@ -1102,27 +565,29 @@ interface components {
                 description?: string;
             }[];
         };
-        McpToolPlanMapping: {
-            /**
-             * Tool name
-             * @example deep_research
-             */
-            name: string;
-            /**
-             * Plan keys this tool should be gated to
-             * @example [
-             *       "pro"
-             *     ]
-             */
-            planKeys: string[];
-        };
-        ConfigureMcpPlansRequest: {
-            /** @description Required free plan configuration for updates. Applies to the existing default free plan only. */
-            freePlan: components["schemas"]["McpBootstrapFreePlanConfig"];
-            /** @description Optional paid plan definitions. [] reverts to free-only, omitted leaves existing paid plans unchanged. */
-            paidPlans?: components["schemas"]["McpBootstrapPaidPlanInput"][];
-            /** @description Optional tool-to-plan remapping. If paidPlans is omitted, only this remapping is applied. */
-            toolMapping?: components["schemas"]["McpToolPlanMapping"][];
+        ConfigureMcpPlansDto: {
+            plans?: {
+                key: string;
+                name: string;
+                price: number;
+                currency: string;
+                /** @enum {string} */
+                billingCycle?: "weekly" | "monthly" | "quarterly" | "yearly" | "custom";
+                /** @enum {string} */
+                type?: "recurring" | "one-time" | "usage-based";
+                creditsPerUnit?: number;
+                /** @enum {string} */
+                billingModel?: "pre-paid" | "post-paid";
+                freeUnits?: number;
+                limit?: number;
+                features?: {
+                    [key: string]: unknown;
+                };
+            }[];
+            toolMapping?: {
+                name: string;
+                planKeys: string[];
+            }[];
         };
         ConfigureMcpPlansResult: {
             /** @description Updated product */
@@ -1136,461 +601,123 @@ interface components {
                 [key: string]: unknown;
             };
         };
-        McpBootstrapPreviewResult: {
-            /** @description Discovered tools from the origin MCP server */
-            discoveredTools: {
-                name?: string;
-                description?: string;
-            }[];
-            /** @description Validation status for the provided bootstrap payload */
-            validation: {
-                valid?: boolean;
-                errors?: components["schemas"]["McpBootstrapPreviewValidationError"][];
-            };
+        CloneProductDto: {
+            name?: string;
+        };
+        CreateUsageRequest: {
+            customerRef: string;
             /**
-             * Product name derived from origin MCP metadata or hostname fallback
-             * @example acme-origin-mcp
+             * @default api_call
+             * @enum {string}
              */
-            derivedName?: string;
+            actionType: "transaction" | "api_call" | "hour" | "email" | "storage" | "custom";
+            /** @default 1 */
+            units: number;
             /**
-             * Product description derived from origin server instructions
-             * @example MCP toolkit for document retrieval and summarization.
+             * @default success
+             * @enum {string}
              */
-            derivedDescription?: string;
-            /** @description Source of derived metadata */
-            metadataSource: {
-                /** @enum {string} */
-                name?: "request" | "origin" | "hostname";
-                /** @enum {string} */
-                description?: "request" | "instructions" | "none";
+            outcome: "success" | "paywall" | "fail";
+            productRef?: string;
+            purchaseRef?: string;
+            description?: string;
+            errorMessage?: string;
+            metadata: {
+                [key: string]: unknown;
             };
-            /** @description Suggested default tool-to-plan mapping for UI review */
-            suggestedMapping: {
-                name?: string;
+            duration?: number;
+            /** Format: date-time */
+            timestamp: string;
+            idempotencyKey?: string;
+        };
+        BulkCreateUsageRequest: {
+            events: {
+                customerRef: string;
+                /**
+                 * @default api_call
+                 * @enum {string}
+                 */
+                actionType: "transaction" | "api_call" | "hour" | "email" | "storage" | "custom";
+                /** @default 1 */
+                units: number;
+                /**
+                 * @default success
+                 * @enum {string}
+                 */
+                outcome: "success" | "paywall" | "fail";
+                productRef?: string;
+                purchaseRef?: string;
                 description?: string;
-                planKey?: string;
+                errorMessage?: string;
+                metadata?: {
+                    [key: string]: unknown;
+                };
+                duration?: number;
+                /** Format: date-time */
+                timestamp: string;
+                idempotencyKey?: string;
             }[];
         };
-        RecordMeterEventDto: {
-            /**
-             * Meter name to record against
-             * @example requests
-             */
+        RecordMeterEventZodDto: {
             meterName: string;
-            /**
-             * Customer reference
-             * @example cus_ABC123
-             */
-            customerId: string;
-            /**
-             * Numeric value (default 1)
-             * @default 1
-             * @example 1
-             */
-            value: number;
-            /**
-             * Arbitrary key-value tags
-             * @example {
-             *       "endpoint": "/api/v1/search",
-             *       "region": "us-east-1"
-             *     }
-             */
-            properties?: {
+            customerRef: string;
+            value?: number;
+            properties: {
                 [key: string]: unknown;
             };
-            /** @description Product ID to scope the usage event to */
-            productId?: string;
-            /** @description Product reference to scope the usage event to */
-            productReference?: string;
-            /** @description ISO 8601 timestamp (defaults to now) */
+            productRef?: string;
             timestamp?: string;
         };
-        RecordBulkMeterEventsDto: {
-            /** @description Array of events to record */
-            events: components["schemas"]["RecordMeterEventDto"][];
+        RecordBulkMeterEventsZodDto: {
+            events: {
+                meterName: string;
+                customerRef: string;
+                value?: number;
+                properties?: {
+                    [key: string]: unknown;
+                };
+                productRef?: string;
+                timestamp?: string;
+            }[];
         };
-        CreateCustomerSessionRequest: {
-            /**
-             * Customer reference identifier
-             * @example cus_3c4d5e6f7g8h
-             */
-            customerRef: string;
+        UsageBillingDto: {
             /**
-             * Optional product reference or ID to scope the customer manage page to a single product.
-             * @example prd_1a2b3c4d5e6f
+             * Units consumed in current period
+             * @example 150
              */
-            productRef?: string;
-        };
-        CustomerSessionResponse: {
+            used: number;
             /**
-             * Customer session ID
-             * @example 507f1f77bcf86cd799439011
+             * Units exceeding the plan limit
+             * @example 0
              */
-            id: string;
+            overageUnits: number;
             /**
-             * Public session ID used in customer URL
-             * @example e3f1c2d4b6a89f001122334455667788
+             * Overage cost in cents
+             * @example 0
              */
-            sessionId: string;
+            overageCost: number;
             /**
-             * Session status
-             * @example active
+             * Period start date
+             * @example 2025-10-01T00:00:00Z
              */
-            status: string;
+            periodStart?: string;
             /**
-             * Customer URL to open the customer page
-             * @example https://solvapay.com/customer/manage?id=e3f1c2d4b6a89f001122334455667788
+             * Period end date
+             * @example 2025-11-01T00:00:00Z
              */
-            customerUrl: string;
+            periodEnd?: string;
         };
-        CreateCustomerRequest: {
+        SdkPlanSnapshotDto: {
             /**
-             * Customer email address (required)
-             * @example customer@example.com
+             * Plan reference
+             * @example pln_1A2B3C4D
              */
-            email: string;
+            reference?: string;
             /**
-             * Customer full name (optional)
-             * @example John Doe
+             * Plan price in cents
+             * @example 2999
              */
-            name?: string;
-            /**
-             * External reference ID from your auth system to map this customer to an auth user (optional)
-             * @example auth_user_12345
-             */
-            externalRef?: string;
-        };
-        PurchaseInfo: {
-            /**
-             * Purchase reference
-             * @example pur_1A2B3C4D
-             */
-            reference: string;
-            /**
-             * Product name
-             * @example API Gateway Manager
-             */
-            productName: string;
-            /**
-             * Product reference
-             * @example prd_abc123
-             */
-            productReference?: string;
-            /**
-             * Purchase status
-             * @example active
-             */
-            status: string;
-            /**
-             * Start date
-             * @example 2025-10-27T10:00:00Z
-             */
-            startDate: string;
-            /**
-             * Amount paid in original currency (in cents)
-             * @example 9900
-             */
-            amount: number;
-            /**
-             * Currency code
-             * @example USD
-             */
-            currency: string;
-            /**
-             * End date of purchase
-             * @example 2025-11-27T10:00:00Z
-             */
-            endDate?: string;
-            /**
-             * When purchase was cancelled
-             * @example 2025-10-28T10:00:00Z
-             */
-            cancelledAt?: string;
-            /**
-             * Reason for cancellation
-             * @example Customer request
-             */
-            cancellationReason?: string;
-            /** @description Snapshot of the plan at time of purchase */
-            planSnapshot?: Record<string, never>;
-        };
-        CustomerResponse: {
-            /**
-             * Customer reference identifier
-             * @example cus_3c4d5e6f7g8h
-             */
-            reference: string;
-            /**
-             * Customer full name
-             * @example John Doe
-             */
-            name: string;
-            /**
-             * Customer email address
-             * @example customer@example.com
-             */
-            email: string;
-            /**
-             * External reference ID from your auth system (if set during creation or update)
-             * @example auth_user_12345
-             */
-            externalRef?: string;
-            /** @description Active purchases */
-            purchases?: components["schemas"]["PurchaseInfo"][];
-        };
-        CreateCustomerSessionResponse: {
-            /**
-             * Customer session ID/token
-             * @example e3f1c2d4b6a89f001122334455667788
-             */
-            sessionId: string;
-            /**
-             * Full customer URL based on backend configuration (ready to redirect customer)
-             * @example https://solvapay.com/customer/manage?id=e3f1c2d4b6a89f001122334455667788
-             */
-            customerUrl: string;
-        };
-        GetCustomerSessionResponse: {
-            /**
-             * Customer session ID/token
-             * @example e3f1c2d4b6a89f001122334455667788
-             */
-            sessionId: string;
-            /**
-             * Session status
-             * @example active
-             * @enum {string}
-             */
-            status: "active" | "expired" | "used";
-            /**
-             * Full customer URL based on backend configuration (ready to redirect customer)
-             * @example https://solvapay.com/customer/manage?id=e3f1c2d4b6a89f001122334455667788
-             */
-            customerUrl: string;
-            /**
-             * Session expiration date
-             * @example 2025-01-01T12:00:00.000Z
-             */
-            expiresAt: string;
-            /** @description Customer object from session data */
-            customer: components["schemas"]["CustomerResponse"];
-            /**
-             * Session creation date
-             * @example 2025-01-01T11:45:00.000Z
-             */
-            createdAt: string;
-            /**
-             * Session last update date
-             * @example 2025-01-01T11:45:00.000Z
-             */
-            updatedAt: string;
-        };
-        UserInfoRequest: {
-            /**
-             * Customer reference
-             * @example cus_3C4D5E6F
-             */
-            customerRef: string;
-            /**
-             * Product reference
-             * @example prd_1A2B3C4D
-             */
-            productRef: string;
-        };
-        UserInfoUserDto: {
-            /** @example cus_3C4D5E6F */
-            reference: string;
-            /** @example John Doe */
-            name?: string | null;
-            /** @example john@example.com */
-            email: string;
-            /** @example auth_user_12345 */
-            externalRef?: string | null;
-        };
-        UserInfoUsageDto: {
-            /** @example 1000 */
-            total: number;
-            /** @example 250 */
-            used: number;
-            /** @example 750 */
-            remaining: number;
-            /**
-             * Meter ObjectId reference
-             * @example 507f1f77bcf86cd799439011
-             */
-            meterId?: string;
-            /** @example 25 */
-            percentUsed?: number | null;
-        };
-        UserInfoPlanDto: {
-            /** @example pln_2B3C4D5E */
-            reference: string;
-            /**
-             * Price in minor currency units (e.g. cents)
-             * @example 2999
-             */
-            price: number;
-            /** @example USD */
-            currency: string;
-            /** @example recurring */
-            type: string;
-            /** @example monthly */
-            billingCycle?: string | null;
-            features?: string[] | null;
-            limits?: {
-                [key: string]: unknown;
-            } | null;
-        };
-        UserInfoPurchaseDto: {
-            /** @example pur_1A2B3C4D */
-            reference: string;
-            /** @example active */
-            status: string;
-            /** @example My API Product */
-            productName: string;
-            /** @example recurring */
-            planType: string;
-            /** @example 2025-10-27T10:00:00Z */
-            startDate?: string | null;
-            /** @example 2025-11-27T10:00:00Z */
-            endDate?: string | null;
-            usage?: components["schemas"]["UserInfoUsageDto"];
-            plan?: components["schemas"]["UserInfoPlanDto"];
-        };
-        UserInfoResponse: {
-            /**
-             * Human-readable status summary
-             * @example Active subscription: My API Product (25% usage consumed)
-             */
-            status: string;
-            /**
-             * Customer portal session URL
-             * @example https://solvapay.com/customer/manage?id=abc123
-             */
-            verifyUrl?: string | null;
-            user?: components["schemas"]["UserInfoUserDto"];
-            purchase?: components["schemas"]["UserInfoPurchaseDto"];
-        };
-        McpToolDto: {
-            /**
-             * Tool name
-             * @example search_documents
-             */
-            name: string;
-            /**
-             * Plan IDs that grant access to this tool
-             * @example [
-             *       "pln_abc123"
-             *     ]
-             */
-            planIds?: string[];
-            /**
-             * If true, the tool is unprotected (no purchase check or usage tracking)
-             * @example false
-             */
-            noPlan?: boolean;
-            /**
-             * Human-readable tool description
-             * @example Search indexed documents
-             */
-            description?: string;
-            /**
-             * Whether this is a virtual platform tool handled by SolvaPay
-             * @example false
-             */
-            isVirtual?: boolean;
-        };
-        McpServerDto: {
-            /**
-             * Server ID
-             * @example 507f1f77bcf86cd799439011
-             */
-            id?: string;
-            /**
-             * Unique server reference
-             * @example mcp_abc123
-             */
-            reference?: string;
-            /**
-             * Domain slug used to derive the MCP endpoint subdomain
-             * @example my-mcp-server
-             */
-            name: string;
-            /**
-             * URL-safe subdomain derived from name
-             * @example my-mcp-server
-             */
-            subdomain: string;
-            /**
-             * SolvaPay proxy URL that MCP clients connect to
-             * @example https://mytelescope.mcp.solvapay.com/mcp
-             */
-            mcpProxyUrl?: string;
-            /**
-             * Origin URL of the actual MCP server
-             * @example https://origin.example.com/mcp
-             */
-            url: string;
-            /**
-             * Avatar image URL
-             * @example https://example.com/avatar.png
-             */
-            avatarUrl?: string;
-            /** @description Registered tools for this server */
-            tools?: components["schemas"]["McpToolDto"][];
-            /**
-             * Default plan ID for tool access gating. Must belong to the linked product and be a free-tier plan (isFreeTier=true or price=0).
-             * @example pln_default
-             */
-            defaultPlanId?: string;
-            /**
-             * Associated product ID
-             * @example 507f1f77bcf86cd799439011
-             */
-            productId?: string;
-            /**
-             * Server status
-             * @example active
-             * @enum {string}
-             */
-            status?: "active" | "inactive" | "suspended";
-            /**
-             * Provider ID that owns this server
-             * @example 507f1f77bcf86cd799439011
-             */
-            providerId: string;
-            /**
-             * Custom auth header name for origin requests
-             * @example X-API-Key
-             */
-            authHeaderName?: string;
-            /**
-             * Whether an auth API key is configured
-             * @example true
-             */
-            hasAuthApiKey?: boolean;
-            /**
-             * Total number of tool-call transactions
-             * @example 42
-             */
-            totalTransactions?: number;
-            /**
-             * Current balance in cents
-             * @example 1500
-             */
-            balance?: number;
-        };
-        PlanSnapshotDto: {
-            /**
-             * Plan reference
-             * @example pln_1A2B3C4D
-             */
-            reference?: string;
-            /**
-             * Plan price in cents
-             * @example 2999
-             */
-            price: number;
+            price: number;
             /**
              * Currency code
              * @example USD
@@ -1615,10 +742,10 @@ interface components {
                 [key: string]: unknown;
             } | null;
             /**
-             * Meter ObjectId reference
-             * @example 507f1f77bcf86cd799439011
+             * Meter reference
+             * @example mtr_1A2B3C4D
              */
-            meterId?: string;
+            meterRef?: string;
             /**
              * Usage limit for the meter
              * @example 5000
@@ -1630,44 +757,12 @@ interface components {
              */
             freeUnits?: number;
             /**
-             * Price per usage unit in cents
-             * @example 10
-             */
-            pricePerUnit?: number;
-        };
-        UsageBillingDto: {
-            /**
-             * Units consumed in current period
-             * @example 150
-             */
-            used: number;
-            /**
-             * Units exceeding the plan limit
-             * @example 0
-             */
-            overageUnits: number;
-            /**
-             * Overage cost in cents
-             * @example 0
-             */
-            overageCost: number;
-            /**
-             * Period start date
-             * @example 2025-10-01T00:00:00Z
-             */
-            periodStart?: string;
-            /**
-             * Period end date
-             * @example 2025-11-01T00:00:00Z
+             * Credits per usage unit (integer, >= 1)
+             * @example 1
              */
-            periodEnd?: string;
+            creditsPerUnit?: number;
         };
-        PurchaseResponse: {
-            /**
-             * Purchase ID
-             * @example 507f1f77bcf86cd799439011
-             */
-            id: string;
+        SdkPurchaseResponse: {
             /**
              * Purchase reference
              * @example pur_1A2B3C4D
@@ -1688,33 +783,38 @@ interface components {
              * @example prd_1A2B3C4D
              */
             productRef: string;
-            /**
-             * Product ID
-             * @example 507f1f77bcf86cd799439012
-             */
-            productId?: string;
             /**
              * Product name
              * @example API Gateway Manager
              */
             productName?: string;
-            /** @description Plan snapshot at time of purchase */
-            planSnapshot: components["schemas"]["PlanSnapshotDto"];
+            /** @description Plan snapshot at time of purchase (null for credit topups) */
+            planSnapshot?: components["schemas"]["SdkPlanSnapshotDto"];
             /**
              * Purchase status
              * @example active
              */
             status: string;
             /**
-             * Amount in cents
+             * Amount in USD cents (normalised for aggregation)
              * @example 9900
              */
             amount: number;
             /**
-             * Currency code
-             * @example USD
+             * Original amount in the payment currency (cents/pence)
+             * @example 10000
+             */
+            originalAmount?: number;
+            /**
+             * Original payment currency code
+             * @example GBP
              */
             currency: string;
+            /**
+             * Exchange rate from original currency to USD
+             * @example 1.3082
+             */
+            exchangeRate?: number;
             /** @description Start date */
             startDate: string;
             /** @description End date */
@@ -1737,279 +837,340 @@ interface components {
             nextBillingDate?: string;
             /** @description Auto-renew enabled */
             autoRenew?: boolean;
-            /** @description Whether this is a free tier purchase */
-            isFreeTier?: boolean;
             /** @description Cancelled at */
             cancelledAt?: string;
             /** @description Cancellation reason */
             cancellationReason?: string;
+            /** @description Arbitrary metadata attached to the purchase */
+            metadata?: {
+                [key: string]: unknown;
+            };
             /** @description Created at */
             createdAt: string;
         };
-        CancelPurchaseRequest: {
-            /** @description Reason for cancellation */
-            reason?: string;
-        };
         CheckLimitRequest: {
+            customerRef: string;
+            productRef: string;
+            meterName?: string;
+            usageType?: string;
+        };
+        LimitPlanItemDto: {
+            reference: string;
+            name?: string;
+            type: string;
+            /** @description Price in smallest currency unit (e.g. cents) */
+            price: number;
+            currency: string;
+            requiresPayment: boolean;
+            freeUnits?: number;
+            /** @description Credits per usage unit (usage-based plans) */
+            creditsPerUnit?: number;
+            billingModel?: string;
+            billingCycle?: string;
+        };
+        LimitBalanceDto: {
+            /** @description Credit balance in mils */
+            creditBalance: number;
+            /** @description Credits per usage unit */
+            creditsPerUnit: number;
+            currency: string;
+            /** @description Estimated whole units remaining from prepaid credit balance */
+            remainingUnits?: number;
+        };
+        LimitProductBriefDto: {
+            reference: string;
+            name?: string;
+        };
+        LimitResponse: {
             /**
-             * Customer reference identifier
-             * @example cus_3C4D5E6F
+             * Whether the customer is within their usage limits
+             * @example true
              */
-            customerRef: string;
+            withinLimits: boolean;
             /**
-             * Product reference identifier
-             * @example prd_1A2B3C4D
+             * Remaining usage units before hitting the limit
+             * @example 997
              */
-            productRef: string;
+            remaining: number;
             /**
-             * Plan reference to pre-select when creating a checkout session. If provided and the customer needs to purchase, the checkout page skips plan selection and shows the payment form directly.
-             * @example pln_2B3C4D5E
+             * Checkout session ID if payment is required
+             * @example e3f1c2d4b6a89f001122334455667788
              */
-            planRef?: string;
+            checkoutSessionId?: string;
+            /**
+             * Checkout URL if payment is required
+             * @example https://solvapay.com/customer/checkout?id=e3f1c2d4b6a89f001122334455667788
+             */
+            checkoutUrl?: string;
             /**
-             * Canonical usage meter name used for limit checks (for example: requests, tokens).
+             * The meter name to use when tracking usage events
              * @example requests
              */
-            meterName?: string;
+            meterName?: string;
+            /** @description Credit balance in mils (for pre-paid usage-based plans) */
+            creditBalance?: number;
+            /** @description Credits per usage unit (for pre-paid usage-based plans) */
+            creditsPerUnit?: number;
+            /** @description ISO 4217 currency code for credit fields */
+            currency?: string;
+            /** @description True when the customer must activate a priced default plan before usage is allowed */
+            activationRequired?: boolean;
+            /** @description Active plans on the product available for activation or checkout */
+            plans?: components["schemas"]["LimitPlanItemDto"][];
+            /** @description Prepaid usage balance context when the default plan is usage-based */
+            balance?: components["schemas"]["LimitBalanceDto"];
+            /** @description Product the limit check applies to */
+            product?: components["schemas"]["LimitProductBriefDto"];
+            /** @description Customer portal confirmation URL when activation is required (fallback when not starting checkout) */
+            confirmationUrl?: string;
+        };
+        ActivatePlanDto: {
+            customerRef: string;
+            productRef: string;
+            planRef: string;
+        };
+        ActivatePlanResponseDto: {
+            /** @enum {string} */
+            status: "activated" | "already_active" | "topup_required" | "payment_required" | "invalid";
+            purchaseRef?: string;
+            message?: string;
+            creditBalance?: number;
+            creditsPerUnit?: number;
+            currency?: string;
+            checkoutUrl?: string;
+            checkoutSessionId?: string;
+        };
+        CreateCustomerRequest: {
+            /** Format: email */
+            email: string;
+            name?: string;
+            telephone?: string;
+            metadata: {
+                [key: string]: unknown;
+            };
+            externalRef?: string;
+        };
+        CreateCustomerSessionRequest: {
+            customerRef: string;
+            productRef?: string;
+        };
+        PurchaseInfo: {
+            /**
+             * Purchase reference
+             * @example pur_1A2B3C4D
+             */
+            reference: string;
+            /**
+             * Product name
+             * @example API Gateway Manager
+             */
+            productName: string;
+            /**
+             * Product reference
+             * @example prd_abc123
+             */
+            productRef?: string;
+            /**
+             * Purchase status
+             * @example active
+             */
+            status: string;
+            /**
+             * Start date
+             * @example 2025-10-27T10:00:00Z
+             */
+            startDate: string;
             /**
-             * Usage type alias for meterName. If both are provided, meterName takes precedence.
-             * @example requests
+             * Amount in USD cents (normalised for aggregation)
+             * @example 9900
              */
-            usageType?: string;
-        };
-        LimitResponse: {
+            amount: number;
             /**
-             * Whether the customer is within their usage limits
-             * @example true
+             * Original amount in the payment currency (minor units)
+             * @example 7500
              */
-            withinLimits: boolean;
+            originalAmount?: number;
             /**
-             * Remaining usage units before hitting the limit
-             * @example 997
+             * ISO 4217 currency code of the customer-facing charge
+             * @example GBP
              */
-            remaining: number;
+            currency: string;
             /**
-             * Checkout session ID if payment is required
-             * @example e3f1c2d4b6a89f001122334455667788
+             * Exchange rate from original currency to USD
+             * @example 1.32
              */
-            checkoutSessionId?: string;
+            exchangeRate?: number;
             /**
-             * Checkout URL if payment is required
-             * @example https://solvapay.com/customer/checkout?id=e3f1c2d4b6a89f001122334455667788
+             * End date of purchase
+             * @example 2025-11-27T10:00:00Z
              */
-            checkoutUrl?: string;
+            endDate?: string;
             /**
-             * The meter name to use when tracking usage events
-             * @example requests
+             * When purchase was cancelled
+             * @example 2025-10-28T10:00:00Z
              */
-            meterName?: string;
-        };
-        ExecuteAnalyticsQuery: Record<string, never>;
-        ExecuteMultipleQueries: Record<string, never>;
-        CreateWebhookEndpointDto: {
+            cancelledAt?: string;
             /**
-             * Webhook endpoint URL
-             * @example https://example.com/webhook
+             * Reason for cancellation
+             * @example Customer request
              */
-            url: string;
+            cancellationReason?: string;
             /**
-             * Webhook endpoint description
-             * @example Production webhook
+             * Plan reference from the plan snapshot, for reliable plan matching
+             * @example pln_abc123
              */
-            description?: string;
+            planRef?: string;
+            /** @description Snapshot of the plan at time of purchase */
+            planSnapshot?: Record<string, never>;
         };
-        UpdateWebhookEndpointDto: {
+        CustomerResponse: {
             /**
-             * Webhook endpoint URL
-             * @example https://example.com/webhook
+             * Customer reference identifier
+             * @example cus_3c4d5e6f7g8h
              */
-            url?: string;
+            reference: string;
             /**
-             * Webhook endpoint description
-             * @example Updated webhook
+             * Customer full name
+             * @example John Doe
              */
-            description?: string;
-        };
-        UpdateThemePreferenceDto: {
+            name: string;
             /**
-             * Selected UI theme mode
-             * @example dark
-             * @enum {string}
+             * Customer email address
+             * @example customer@example.com
              */
-            mode: "light" | "dark";
-        };
-        ThemeModeColorsDto: {
+            email: string;
             /**
-             * Page background color
-             * @example #f7f7f8
+             * External reference ID from your auth system (if set during creation or update)
+             * @example auth_user_12345
              */
-            background?: string;
+            externalRef?: string;
+            /** @description Active purchases */
+            purchases?: components["schemas"]["PurchaseInfo"][];
+        };
+        CreateCustomerSessionResponse: {
             /**
-             * Card/surface background color
-             * @example #ffffff
+             * Customer session ID/token
+             * @example e3f1c2d4b6a89f001122334455667788
              */
-            surface?: string;
+            sessionId: string;
             /**
-             * Primary text color
-             * @example #181818
+             * Full customer URL based on backend configuration (ready to redirect customer)
+             * @example https://solvapay.com/customer/manage?id=e3f1c2d4b6a89f001122334455667788
              */
-            text?: string;
+            customerUrl: string;
+        };
+        GetCustomerSessionResponse: {
             /**
-             * Secondary/muted text color
-             * @example #5c5c5c
+             * Customer session ID/token
+             * @example e3f1c2d4b6a89f001122334455667788
              */
-            secondary?: string;
-        };
-        ThemeOverridesDto: {
-            /** @description Light mode color overrides */
-            light?: components["schemas"]["ThemeModeColorsDto"];
-            /** @description Dark mode color overrides */
-            dark?: components["schemas"]["ThemeModeColorsDto"];
-        };
-        UpdateBrandThemeDto: {
+            sessionId: string;
             /**
-             * Logo image URL displayed in hosted page headers
-             * @example /ui/files/download/provider-assets/provider-123/logos/logo.png
+             * Session status
+             * @example active
+             * @enum {string}
              */
-            logo?: string;
+            status: "active" | "expired" | "used";
             /**
-             * Provider's brand name displayed on hosted pages
-             * @example Acme Corp
+             * Full customer URL based on backend configuration (ready to redirect customer)
+             * @example https://solvapay.com/customer/manage?id=e3f1c2d4b6a89f001122334455667788
              */
-            brandName: string;
+            customerUrl: string;
             /**
-             * Primary/accent color in hex format
-             * @example #3182ce
+             * Session expiration date
+             * @example 2025-01-01T12:00:00.000Z
              */
-            primaryColor: string;
+            expiresAt: string;
+            /** @description Customer object from session data */
+            customer: components["schemas"]["CustomerResponse"];
             /**
-             * Font family for hosted pages
-             * @default Inter
-             * @example Inter
+             * Session creation date
+             * @example 2025-01-01T11:45:00.000Z
              */
-            fontFamily: string;
+            createdAt: string;
             /**
-             * Base font size
-             * @default 16px
-             * @example 16px
+             * Session last update date
+             * @example 2025-01-01T11:45:00.000Z
              */
-            fontSize: string;
-            /** @description Per-mode color overrides for light and dark themes */
-            themes?: components["schemas"]["ThemeOverridesDto"];
+            updatedAt: string;
+        };
+        UserInfoRequest: {
+            customerRef: string;
+            productRef: string;
         };
-        CreatePreregistrationDto: {
-            /** @example jane@company.com */
+        UserInfoUserDto: {
+            /** @example cus_3C4D5E6F */
+            reference: string;
+            /** @example John Doe */
+            name?: string | null;
+            /** @example john@example.com */
             email: string;
-            /** @example Jane Smith */
-            fullName: string;
-            /** @example Acme Corp */
-            companyName: string;
-            /** @example SaaS */
-            businessType?: string;
-            /** @example Purchase billing for our platform */
-            useCase?: string;
-            customFields?: {
-                [key: string]: string;
-            };
-        };
-        RevenueDataDto: {
-            grossRevenue: number;
-            refunds: number;
-            platformFees: number;
-            netRevenue: number;
-            costOfRevenue: number;
-            grossProfit?: Record<string, never> | null;
-            grossMargin?: Record<string, never> | null;
-            recognisedRevenue: number;
-            deferredRevenue: number;
-            hasCostTransactions: boolean;
-        };
-        BalanceDataDto: {
-            openingBalance: number;
-            paymentsReceived: number;
-            refundsIssued: number;
-            platformFees: number;
-            costsPaid: number;
-            closingBalance: number;
-            netChange: number;
-        };
-        MonthlyFinancialsDto: {
-            month: string;
-            revenue: components["schemas"]["RevenueDataDto"];
-            balance: components["schemas"]["BalanceDataDto"];
-        };
-        RevenueResponseDto: {
-            current: components["schemas"]["RevenueDataDto"];
-            prior: components["schemas"]["RevenueDataDto"];
-            monthly: components["schemas"]["MonthlyFinancialsDto"][];
-            periodLabel: string;
+            /** @example auth_user_12345 */
+            externalRef?: string | null;
+        };
+        UserInfoUsageDto: {
+            /** @example 1000 */
+            total: number;
+            /** @example 250 */
+            used: number;
+            /** @example 750 */
+            remaining: number;
             /**
-             * ISO 4217 currency code
-             * @example SEK
+             * Meter reference
+             * @example meter_ABC123
              */
-            currency: string;
+            meterRef?: string | null;
+            /** @example 25 */
+            percentUsed?: number | null;
         };
-        BalanceResponseDto: {
-            current: components["schemas"]["BalanceDataDto"];
-            monthly: components["schemas"]["MonthlyFinancialsDto"][];
-            periodLabel: string;
+        UserInfoPlanDto: {
+            /** @example pln_2B3C4D5E */
+            reference: string;
             /**
-             * ISO 4217 currency code
-             * @example SEK
+             * Price in minor currency units (e.g. cents)
+             * @example 2999
              */
+            price: number;
+            /** @example USD */
             currency: string;
+            /** @example recurring */
+            type: string;
+            /** @example monthly */
+            billingCycle?: string | null;
+            features?: string[] | null;
+            limits?: {
+                [key: string]: unknown;
+            } | null;
         };
-        ProductRevenueRowDto: {
-            productRef: string;
+        UserInfoPurchaseDto: {
+            /** @example pur_1A2B3C4D */
+            reference: string;
+            /** @example active */
+            status: string;
+            /** @example My API Product */
             productName: string;
-            productType: string;
-            revenue: number;
-            costs: number;
-            grossProfit?: Record<string, never> | null;
-            share: number;
-            estimatedARR: number;
-            transactionCount: number;
-        };
-        TopProductDto: {
-            name: string;
-            revenue: number;
+            /** @example recurring */
+            planType: string;
+            /** @example 2025-10-27T10:00:00Z */
+            startDate?: string | null;
+            /** @example 2025-11-27T10:00:00Z */
+            endDate?: string | null;
+            usage?: components["schemas"]["UserInfoUsageDto"];
+            plan?: components["schemas"]["UserInfoPlanDto"];
         };
-        RevenueByProductResponseDto: {
-            products: components["schemas"]["ProductRevenueRowDto"][];
-            activeProductCount: number;
-            totalMRR: number;
-            topProduct?: components["schemas"]["TopProductDto"] | null;
+        UserInfoResponse: {
             /**
-             * ISO 4217 currency code
-             * @example SEK
+             * Human-readable status summary
+             * @example Active subscription: My API Product (25% usage consumed)
              */
-            currency: string;
-        };
-        LedgerEntryDto: {
-            date: string;
-            reference: string;
-            description: string;
-            type: string;
-            direction: string;
-            account: string;
-            debit: number;
-            credit: number;
             status: string;
-        };
-        LedgerResponseDto: {
-            entries: components["schemas"]["LedgerEntryDto"][];
-            total: number;
-            totalCredit: number;
-            totalDebit: number;
             /**
-             * ISO 4217 currency code
-             * @example SEK
+             * Customer portal session URL
+             * @example https://solvapay.com/customer/manage?id=abc123
              */
-            currency: string;
-        };
-        /** @description Auto-generated fallback schema for unresolved reference: McpBootstrapPreviewValidationError */
-        McpBootstrapPreviewValidationError: {
-            [key: string]: unknown;
+            verifyUrl?: string | null;
+            user?: components["schemas"]["UserInfoUserDto"];
+            purchase?: components["schemas"]["UserInfoPurchaseDto"];
         };
     };
     responses: never;
@@ -2057,28 +1218,7 @@ interface operations {
         /** @description Payment intent creation data */
         requestBody: {
             content: {
-                "application/json": {
-                    /**
-                     * Plan reference to purchase
-                     * @example pln_2b3c4d5e6f7g
-                     */
-                    planRef: string;
-                    /**
-                     * Product reference that owns the plan
-                     * @example prd_1A2B3C4D
-                     */
-                    productRef: string;
-                    /**
-                     * Customer reference identifier
-                     * @example cus_3c4d5e6f7g8h
-                     */
-                    customerReference: string;
-                    /**
-                     * Name of the pricing tier to purchase (for plans with pricingTiers). If not specified, uses the plan base price.
-                     * @example Pro
-                     */
-                    pricingTier?: string;
-                };
+                "application/json": components["schemas"]["CreatePaymentIntentDto"];
             };
         };
         responses: {
@@ -2107,8 +1247,8 @@ interface operations {
             query?: never;
             header?: never;
             path: {
-                /** @description Payment intent MongoDB ID */
-                id: string;
+                /** @description Payment intent reference or processor payment ID */
+                reference: string;
             };
             cookie?: never;
         };
@@ -2139,31 +1279,15 @@ interface operations {
             query?: never;
             header?: never;
             path: {
-                /** @description Stripe payment intent ID (format: pi_xxx) */
-                id: string;
+                /** @description Payment processor ID returned from createPaymentIntent */
+                processorPaymentId: string;
             };
             cookie?: never;
         };
         /** @description Payment processing data */
         requestBody: {
             content: {
-                "application/json": {
-                    /**
-                     * Product reference that owns the plan
-                     * @example prd_123
-                     */
-                    productRef: string;
-                    /**
-                     * Customer reference identifier
-                     * @example cus_456
-                     */
-                    customerRef: string;
-                    /**
-                     * Plan reference - helps determine if payment is for purchase
-                     * @example pln_789
-                     */
-                    planRef?: string;
-                };
+                "application/json": components["schemas"]["ProcessPaymentIntentDto"];
             };
         };
         responses: {
@@ -2182,7 +1306,7 @@ interface operations {
                         status?: "succeeded" | "timeout" | "failed" | "cancelled";
                         /**
                          * Optional message, only present for timeout status
-                         * @example Timeout while waiting for payment intent confirmation, try again later. This could be due to Stripe webhooks not being configured correctly.
+                         * @example Timeout while waiting for payment intent confirmation, try again later. This could be due to payment webhooks not being configured correctly.
                          */
                         message?: string;
                     };
@@ -2562,7 +1686,7 @@ interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["McpBootstrapRequest"];
+                "application/json": components["schemas"]["McpBootstrapDto"];
             };
         };
         responses: {
@@ -2596,7 +1720,7 @@ interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["ConfigureMcpPlansRequest"];
+                "application/json": components["schemas"]["ConfigureMcpPlansDto"];
             };
         };
         responses: {
@@ -2635,7 +1759,11 @@ interface operations {
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CloneProductDto"];
+            };
+        };
         responses: {
             /** @description Product cloned successfully */
             201: {
@@ -2664,44 +1792,7 @@ interface operations {
         };
         requestBody: {
             content: {
-                "application/json": {
-                    /**
-                     * Customer identifier
-                     * @example cus_3C4D5E6F
-                     */
-                    customerId: string;
-                    /**
-                     * Action type (default: api_call)
-                     * @example api_call
-                     * @enum {string}
-                     */
-                    actionType?: "transaction" | "api_call" | "hour" | "email" | "storage" | "custom";
-                    /**
-                     * Number of usage units (default: 1)
-                     * @example 1
-                     */
-                    units?: number;
-                    /** @description Product reference */
-                    productReference?: string;
-                    /** @description Purchase reference */
-                    purchaseReference?: string;
-                    /**
-                     * Outcome (default: success)
-                     * @enum {string}
-                     */
-                    outcome?: "success" | "paywall" | "fail";
-                    /** @description Arbitrary event properties */
-                    metadata?: {
-                        [key: string]: unknown;
-                    };
-                    /**
-                     * Format: date-time
-                     * @description ISO 8601 timestamp (defaults to now)
-                     */
-                    timestamp?: string;
-                    /** @description Unique key to prevent duplicate recording (max 256 chars) */
-                    idempotencyKey?: string;
-                };
+                "application/json": components["schemas"]["CreateUsageRequest"];
             };
         };
         responses: {
@@ -2737,24 +1828,7 @@ interface operations {
         };
         requestBody: {
             content: {
-                "application/json": {
-                    events: {
-                        customerId: string;
-                        /** @enum {string} */
-                        actionType?: "transaction" | "api_call" | "hour" | "email" | "storage" | "custom";
-                        units?: number;
-                        productReference?: string;
-                        purchaseReference?: string;
-                        /** @enum {string} */
-                        outcome?: "success" | "paywall" | "fail";
-                        metadata?: {
-                            [key: string]: unknown;
-                        };
-                        /** Format: date-time */
-                        timestamp?: string;
-                        idempotencyKey?: string;
-                    }[];
-                };
+                "application/json": components["schemas"]["BulkCreateUsageRequest"];
             };
         };
         responses: {
@@ -2783,24 +1857,121 @@ interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["RecordMeterEventDto"];
+                "application/json": components["schemas"]["RecordMeterEventZodDto"];
+            };
+        };
+        responses: {
+            /** @description Event recorded */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example true */
+                        success?: boolean;
+                    };
+                };
+            };
+            /** @description Invalid meter name or meter is archived */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    MeterEventsSdkController_recordBulkEvents: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["RecordBulkMeterEventsZodDto"];
+            };
+        };
+        responses: {
+            /** @description Events recorded */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example true */
+                        success?: boolean;
+                        /** @example 50 */
+                        inserted?: number;
+                    };
+                };
+            };
+            /** @description Invalid meter name or meter is archived */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    PurchaseSdkController_listPurchases: {
+        parameters: {
+            query?: {
+                /** @description Filter by purchase status */
+                status?: "pending" | "active" | "trialing" | "past_due" | "cancelled" | "expired" | "suspended" | "refunded";
+                /** @description Filter by product reference */
+                productRef?: string;
+                /** @description Filter by customer reference */
+                customerRef?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Purchases retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        purchases?: components["schemas"]["SdkPurchaseResponse"][];
+                    };
+                };
+            };
+        };
+    };
+    PurchaseSdkController_getPurchasesForCustomer: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Customer reference or ID */
+                customerRef: string;
             };
+            cookie?: never;
         };
+        requestBody?: never;
         responses: {
-            /** @description Event recorded */
+            /** @description Customer purchases retrieved successfully */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
-                        /** @example true */
-                        success?: boolean;
+                        purchases?: components["schemas"]["SdkPurchaseResponse"][];
                     };
                 };
             };
-            /** @description Invalid meter name or meter is archived */
-            400: {
+            /** @description Customer not found */
+            404: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -2808,35 +1979,31 @@ interface operations {
             };
         };
     };
-    MeterEventsSdkController_recordBulkEvents: {
+    PurchaseSdkController_getPurchasesForProduct: {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["RecordBulkMeterEventsDto"];
+            path: {
+                /** @description Product reference or ID */
+                productRef: string;
             };
+            cookie?: never;
         };
+        requestBody?: never;
         responses: {
-            /** @description Events recorded */
+            /** @description Product purchases retrieved successfully */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
-                        /** @example true */
-                        success?: boolean;
-                        /** @example 50 */
-                        inserted?: number;
+                        purchases?: components["schemas"]["SdkPurchaseResponse"][];
                     };
                 };
             };
-            /** @description Invalid meter name or meter is archived */
-            400: {
+            /** @description Product not found */
+            404: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -2844,280 +2011,272 @@ interface operations {
             };
         };
     };
-    CustomerSdkController_getCustomerByQuery: {
+    PurchaseSdkController_getPurchase: {
         parameters: {
-            query?: {
-                /** @description Customer reference identifier (use exactly one query parameter) */
-                reference?: string;
-                /** @description External reference ID from your auth system (use exactly one query parameter) */
-                externalRef?: string;
-                /** @description Customer email address (use exactly one query parameter) */
-                email?: string;
-            };
+            query?: never;
             header?: never;
-            path?: never;
+            path: {
+                /** @description Purchase reference or ID */
+                purchaseRef: string;
+            };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Customer retrieved successfully */
+            /** @description Purchase retrieved successfully */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["CustomerResponse"];
-                };
-            };
-            /** @description Invalid request - must provide exactly one of reference, externalRef, or email */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": unknown;
+                    "application/json": components["schemas"]["SdkPurchaseResponse"];
                 };
             };
-            /** @description Customer not found */
+            /** @description Purchase not found */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    "application/json": unknown;
-                };
+                content?: never;
             };
         };
     };
-    CustomerSdkController_createCustomer: {
+    PurchaseSdkController_cancelPurchase: {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                /** @description Purchase reference or ID */
+                purchaseRef: string;
+            };
             cookie?: never;
         };
-        /** @description Customer creation data */
         requestBody: {
             content: {
-                "application/json": components["schemas"]["CreateCustomerRequest"];
+                "application/json": components["schemas"]["CancelPurchaseRequest"];
             };
         };
         responses: {
-            /** @description Customer created successfully */
-            201: {
+            /** @description Purchase cancelled successfully */
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["CustomerResponse"];
+                    "application/json": {
+                        success?: boolean;
+                        purchase?: components["schemas"]["SdkPurchaseResponse"];
+                    };
                 };
             };
-            /** @description Invalid email or missing required fields */
-            400: {
+            /** @description Purchase not found */
+            404: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    "application/json": unknown;
-                };
+                content?: never;
             };
         };
     };
-    CustomerSdkController_getCustomer: {
+    PurchaseSdkController_reactivatePurchase: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                /** @description Customer reference identifier */
-                reference: string;
+                /** @description Purchase reference or ID */
+                purchaseRef: string;
             };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Customer retrieved successfully */
+            /** @description Purchase reactivated successfully */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["CustomerResponse"];
+                    "application/json": {
+                        success?: boolean;
+                        purchase?: components["schemas"]["SdkPurchaseResponse"];
+                    };
                 };
             };
-            /** @description Customer not found */
-            404: {
+            /** @description Purchase cannot be reactivated */
+            400: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    "application/json": unknown;
+                content?: never;
+            };
+            /** @description Purchase not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
                 };
+                content?: never;
             };
         };
     };
-    CustomerSdkController_createCustomerSession: {
+    LimitsSdkController_checkLimits: {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** @description Customer session creation request data */
         requestBody: {
             content: {
-                "application/json": components["schemas"]["CreateCustomerSessionRequest"];
+                "application/json": components["schemas"]["CheckLimitRequest"];
             };
         };
         responses: {
-            /** @description Customer session created successfully */
-            201: {
+            /** @description Limit check result */
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["CreateCustomerSessionResponse"];
+                    "application/json": components["schemas"]["LimitResponse"];
                 };
             };
-            /** @description Invalid request data or customer not found */
+            /** @description Missing customerRef or productRef */
             400: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    "application/json": unknown;
-                };
+                content?: never;
             };
-            /** @description Customer not found */
+            /** @description Customer or product not found */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    "application/json": unknown;
-                };
+                content?: never;
             };
         };
     };
-    CustomerSdkController_getCustomerSession: {
+    ActivateSdkController_activate: {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                /** @description Customer session ID/token */
-                sessionId: string;
-            };
+            path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ActivatePlanDto"];
+            };
+        };
         responses: {
-            /** @description Customer session retrieved successfully */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["GetCustomerSessionResponse"];
-                };
-            };
-            /** @description Customer session not found */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": unknown;
+                    "application/json": components["schemas"]["ActivatePlanResponseDto"];
                 };
             };
         };
     };
-    UserInfoSdkController_getUserInfo: {
+    CustomerSdkController_getCustomerByQuery: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Customer reference identifier (use exactly one query parameter) */
+                reference?: string;
+                /** @description External reference ID from your auth system (use exactly one query parameter) */
+                externalRef?: string;
+                /** @description Customer email address (use exactly one query parameter) */
+                email?: string;
+            };
             header?: never;
             path?: never;
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["UserInfoRequest"];
-            };
-        };
+        requestBody?: never;
         responses: {
-            /** @description User info with purchase status */
+            /** @description Customer retrieved successfully */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["UserInfoResponse"];
+                    "application/json": components["schemas"]["CustomerResponse"];
                 };
             };
-            /** @description Missing customerRef or productRef */
+            /** @description Invalid request - must provide exactly one of reference, externalRef, or email */
             400: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": unknown;
+                };
             };
-            /** @description Customer or product not found */
+            /** @description Customer not found */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": unknown;
+                };
             };
         };
     };
-    PurchaseSdkController_listPurchases: {
+    CustomerSdkController_createCustomer: {
         parameters: {
-            query?: {
-                /** @description Filter by purchase status */
-                status?: "pending" | "active" | "trialing" | "past_due" | "cancelled" | "expired" | "suspended" | "refunded";
-                /** @description Filter by product ID */
-                productId?: string;
-                /** @description Filter by customer ID */
-                customerId?: string;
-            };
+            query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        /** @description Customer creation data */
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateCustomerRequest"];
+            };
+        };
         responses: {
-            /** @description Purchases retrieved successfully */
-            200: {
+            /** @description Customer created successfully */
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": {
-                        purchases?: components["schemas"]["PurchaseResponse"][];
-                    };
+                    "application/json": components["schemas"]["CustomerResponse"];
+                };
+            };
+            /** @description Invalid email or missing required fields */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
                 };
             };
         };
     };
-    PurchaseSdkController_getPurchasesForCustomer: {
+    CustomerSdkController_getCustomerBalance: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                /** @description Customer reference or ID */
-                customerRef: string;
+                /** @description Customer reference identifier */
+                reference: string;
             };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Customer purchases retrieved successfully */
+            /** @description Customer balance retrieved successfully */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": {
-                        purchases?: components["schemas"]["PurchaseResponse"][];
-                    };
+                    "application/json": unknown;
                 };
             };
             /** @description Customer not found */
@@ -3125,110 +2284,120 @@ interface operations {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": unknown;
+                };
             };
         };
     };
-    PurchaseSdkController_getPurchasesForProduct: {
+    CustomerSdkController_getCustomer: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                /** @description Product reference or ID */
-                productRef: string;
+                /** @description Customer reference identifier */
+                reference: string;
             };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Product purchases retrieved successfully */
+            /** @description Customer retrieved successfully */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": {
-                        purchases?: components["schemas"]["PurchaseResponse"][];
-                    };
+                    "application/json": components["schemas"]["CustomerResponse"];
                 };
             };
-            /** @description Product not found */
+            /** @description Customer not found */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": unknown;
+                };
             };
         };
     };
-    PurchaseSdkController_getPurchase: {
+    CustomerSdkController_createCustomerSession: {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                /** @description Purchase ID or reference */
-                id: string;
-            };
+            path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        /** @description Customer session creation request data */
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateCustomerSessionRequest"];
+            };
+        };
         responses: {
-            /** @description Purchase retrieved successfully */
-            200: {
+            /** @description Customer session created successfully */
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["PurchaseResponse"];
+                    "application/json": components["schemas"]["CreateCustomerSessionResponse"];
                 };
             };
-            /** @description Purchase not found */
+            /** @description Invalid request data or customer not found */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @description Customer not found */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": unknown;
+                };
             };
         };
     };
-    PurchaseSdkController_cancelPurchase: {
+    CustomerSdkController_getCustomerSession: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                /** @description Purchase reference or ID */
-                purchaseRef: string;
+                /** @description Customer session ID/token */
+                sessionId: string;
             };
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["CancelPurchaseRequest"];
-            };
-        };
+        requestBody?: never;
         responses: {
-            /** @description Purchase cancelled successfully */
+            /** @description Customer session retrieved successfully */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": {
-                        success?: boolean;
-                        purchase?: components["schemas"]["PurchaseResponse"];
-                    };
+                    "application/json": components["schemas"]["GetCustomerSessionResponse"];
                 };
             };
-            /** @description Purchase not found */
+            /** @description Customer session not found */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": unknown;
+                };
             };
         };
     };
-    LimitsSdkController_checkLimits: {
+    UserInfoSdkController_getUserInfo: {
         parameters: {
             query?: never;
             header?: never;
@@ -3237,17 +2406,17 @@ interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["CheckLimitRequest"];
+                "application/json": components["schemas"]["UserInfoRequest"];
             };
         };
         responses: {
-            /** @description Limit check result */
+            /** @description User info with purchase status */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["LimitResponse"];
+                    "application/json": components["schemas"]["UserInfoResponse"];
                 };
             };
             /** @description Missing customerRef or productRef */
@@ -3274,17 +2443,12 @@ interface operations {
  * Types related to the SolvaPay API client and backend communication.
  */
 
-type UsageMeterType = 'requests' | 'tokens';
-type CheckLimitsRequest = components['schemas']['CheckLimitRequest'] & {
-    meterName?: string;
-    usageType?: UsageMeterType;
-};
+type CheckLimitsRequest = components['schemas']['CheckLimitRequest'];
 /**
- * Extended LimitResponse with plan field
+ * Extended LimitResponse with SDK-added plan field
  */
 type LimitResponseWithPlan = components['schemas']['LimitResponse'] & {
     plan: string;
-    meterName?: string;
 };
 /**
  * Extended CustomerResponse with proper field mapping
@@ -3323,62 +2487,41 @@ interface ProcessPaymentResult {
     oneTimePurchase?: OneTimePurchaseInfo;
     status: 'completed';
 }
-interface McpBootstrapFreePlanConfig {
-    name?: string;
-    freeUnits?: number;
-}
-interface McpBootstrapPaidPlanInput {
-    key: string;
-    name: string;
-    /** Price in cents (e.g. 2000 = $20.00) */
-    price: number;
-    currency: string;
-    billingCycle?: 'weekly' | 'monthly' | 'quarterly' | 'yearly' | 'custom';
-    type?: 'recurring' | 'one-time';
-    freeUnits?: number;
-    meterId?: string;
-    limit?: number;
-    features?: Record<string, unknown>;
-}
-interface ToolPlanMappingInput {
-    name: string;
-    description?: string;
-    noPlan?: boolean;
-    planIds?: string[];
-    planRefs?: string[];
-    planKeys?: string[];
-}
-interface McpToolPlanMappingInput {
-    name: string;
-    planKeys: string[];
-}
-interface McpBootstrapRequest {
-    name?: string;
-    description?: string;
-    imageUrl?: string;
-    productType?: string;
-    originUrl: string;
-    /** Optional token combined with provider name to derive the final MCP subdomain. */
-    mcpDomain?: string;
-    authHeaderName?: string;
-    authApiKey?: string;
-    freePlan?: McpBootstrapFreePlanConfig;
-    paidPlans?: McpBootstrapPaidPlanInput[];
-    tools?: ToolPlanMappingInput[];
-    metadata?: Record<string, unknown>;
-}
+type ActivatePlanResult = components['schemas']['ActivatePlanResponseDto'];
+/**
+ * SDK-facing merchant identity (source: GET /v1/sdk/merchant).
+ *
+ * Hand-typed here until the OpenAPI generator picks up the new endpoint.
+ * Fields match `SdkMerchantResponseDto` on the backend.
+ */
+type SdkMerchantResponse = {
+    displayName: string;
+    legalName: string;
+    supportEmail?: string;
+    supportUrl?: string;
+    termsUrl?: string;
+    privacyUrl?: string;
+    country?: string;
+    defaultCurrency?: string;
+    statementDescriptor?: string;
+    logoUrl?: string;
+};
+/** SDK-facing product projection. Sourced from the existing OpenAPI spec. */
+type SdkProductResponse = components['schemas']['SdkProductResponse'];
+type McpBootstrapPlanInput = NonNullable<components['schemas']['McpBootstrapDto']['plans']>[number];
+type ToolPlanMappingInput = NonNullable<components['schemas']['McpBootstrapDto']['tools']>[number];
+type McpBootstrapRequest = components['schemas']['McpBootstrapDto'];
+type McpToolPlanMappingInput = NonNullable<components['schemas']['ConfigureMcpPlansDto']['toolMapping']>[number];
 interface McpBootstrapResponse {
     product: components['schemas']['SdkProductResponse'];
     mcpServer: {
-        id?: string;
         reference?: string;
         subdomain?: string;
         mcpProxyUrl?: string;
         url: string;
-        defaultPlanId?: string;
+        defaultPlanRef?: string;
     };
     planMap: Record<string, {
-        id: string;
         reference: string;
         name?: string;
     }>;
@@ -3388,22 +2531,17 @@ interface McpBootstrapResponse {
         description?: string;
     }>;
 }
-interface ConfigureMcpPlansRequest {
-    paidPlans?: McpBootstrapPaidPlanInput[];
-    toolMapping?: McpToolPlanMappingInput[];
-}
+type ConfigureMcpPlansRequest = components['schemas']['ConfigureMcpPlansDto'];
 interface ConfigureMcpPlansResponse {
     product: components['schemas']['SdkProductResponse'];
     mcpServer: {
-        id?: string;
         reference?: string;
         subdomain?: string;
         mcpProxyUrl?: string;
         url: string;
-        defaultPlanId?: string;
+        defaultPlanRef?: string;
     };
     planMap: Record<string, {
-        id: string;
         reference: string;
         name?: string;
     }>;
@@ -3422,8 +2560,8 @@ interface SolvaPayClient {
         actionType?: 'transaction' | 'api_call' | 'hour' | 'email' | 'storage' | 'custom';
         units?: number;
         outcome?: 'success' | 'paywall' | 'fail';
-        productReference?: string;
-        purchaseReference?: string;
+        productRef?: string;
+        purchaseRef?: string;
         description?: string;
         metadata?: Record<string, unknown>;
         duration?: number;
@@ -3438,6 +2576,13 @@ interface SolvaPayClient {
         externalRef?: string;
         email?: string;
     }): Promise<CustomerResponseMapped>;
+    /**
+     * SDK-facing merchant identity (GET /v1/sdk/merchant).
+     * Returns the subset of provider fields safe for browser consumption —
+     * used by `<MandateText>`, `<CheckoutSummary>`, and trust signals.
+     */
+    getMerchant?(): Promise<SdkMerchantResponse>;
+    getProduct?(productRef: string): Promise<SdkProductResponse>;
     listProducts?(): Promise<Array<{
         reference: string;
         name: string;
@@ -3458,29 +2603,11 @@ interface SolvaPayClient {
         reference: string;
         name: string;
     }>;
-    listPlans?(productRef: string): Promise<Array<{
-        reference: string;
-        price?: number;
-        currency?: string;
-        interval?: string;
-        isFreeTier?: boolean;
-        freeUnits?: number;
-        measures?: string;
-        limit?: number;
-        pricePerUnit?: number;
-        billingModel?: string;
-        metadata?: Record<string, unknown>;
-        [key: string]: unknown;
-    }>>;
+    listPlans?(productRef: string): Promise<components['schemas']['Plan'][]>;
     createPlan?(params: components['schemas']['CreatePlanRequest'] & {
         productRef: string;
-    }): Promise<{
-        reference: string;
-    }>;
-    updatePlan?(productRef: string, planRef: string, params: Partial<components['schemas']['CreatePlanRequest']>): Promise<{
-        reference: string;
-        [key: string]: unknown;
-    }>;
+    }): Promise<components['schemas']['Plan']>;
+    updatePlan?(productRef: string, planRef: string, params: components['schemas']['UpdatePlanRequest']): Promise<components['schemas']['Plan']>;
     deletePlan?(productRef: string, planRef: string): Promise<void>;
     createPaymentIntent?(params: {
         productRef: string;
@@ -3488,7 +2615,19 @@ interface SolvaPayClient {
         customerRef: string;
         idempotencyKey?: string;
     }): Promise<{
-        id: string;
+        processorPaymentId: string;
+        clientSecret: string;
+        publishableKey: string;
+        accountId?: string;
+    }>;
+    createTopupPaymentIntent?(params: {
+        customerRef: string;
+        amount: number;
+        currency: string;
+        description?: string;
+        idempotencyKey?: string;
+    }): Promise<{
+        processorPaymentId: string;
         clientSecret: string;
         publishableKey: string;
         accountId?: string;
@@ -3497,6 +2636,9 @@ interface SolvaPayClient {
         purchaseRef: string;
         reason?: string;
     }): Promise<components['schemas']['PurchaseInfo']>;
+    reactivatePurchase?(params: {
+        purchaseRef: string;
+    }): Promise<components['schemas']['PurchaseInfo']>;
     processPaymentIntent?(params: {
         paymentIntentId: string;
         productRef: string;
@@ -3507,8 +2649,18 @@ interface SolvaPayClient {
         customerRef: string;
         productRef: string;
     }): Promise<components['schemas']['UserInfoResponse']>;
+    getCustomerBalance?(params: {
+        customerRef: string;
+    }): Promise<{
+        customerRef: string;
+        credits: number;
+        displayCurrency: string;
+        creditsPerMinorUnit: number;
+        displayExchangeRate: number;
+    }>;
     createCheckoutSession(params: operations['CheckoutSessionSdkController_createCheckoutSession']['requestBody']['content']['application/json']): Promise<components['schemas']['CreateCheckoutSessionResponse']>;
     createCustomerSession(params: components['schemas']['CreateCustomerSessionRequest']): Promise<components['schemas']['CreateCustomerSessionResponse']>;
+    activatePlan?(params: components['schemas']['ActivatePlanDto']): Promise<ActivatePlanResult>;
 }
 
 /**
@@ -3516,6 +2668,10 @@ interface SolvaPayClient {
  *
  * Types related to paywall protection, limits, and gating functionality.
  */
+
+type LimitPlanSummary = components['schemas']['LimitPlanItemDto'];
+type LimitActivationBalance = components['schemas']['LimitBalanceDto'];
+type LimitActivationProduct = components['schemas']['LimitProductBriefDto'];
 /**
  * Arguments passed to protected handlers
  */
@@ -3530,18 +2686,32 @@ interface PaywallArgs {
  */
 interface PaywallMetadata {
     product?: string;
-    plan?: string;
     usageType?: 'requests' | 'tokens';
 }
 /**
- * Structured content for paywall errors
+ * Structured content for paywall errors (MCP structuredContent and manual handling).
  */
-interface PaywallStructuredContent {
+type PaywallStructuredContent = {
     kind: 'payment_required';
+    /** Product ref from paywall metadata (or env default) */
     product: string;
     checkoutUrl: string;
     message: string;
-}
+} | {
+    kind: 'activation_required';
+    /** Product ref from paywall metadata (or env default) */
+    product: string;
+    message: string;
+    /**
+     * Best URL for completing purchase or confirmation; mirrors confirmationUrl when present.
+     */
+    checkoutUrl: string;
+    confirmationUrl?: string;
+    plans?: LimitPlanSummary[];
+    balance?: LimitActivationBalance;
+    /** Rich product context from checkLimits (name, ref, provider slug/id) */
+    productDetails?: LimitActivationProduct;
+};
 /**
  * MCP tool result with optional paywall information
  */
@@ -3617,14 +2787,6 @@ interface PayableOptions {
      * Product reference (alias for product, preferred for consistency with backend API)
      */
     productRef?: string;
-    /**
-     * Plan identifier (defaults to product name if not provided)
-     */
-    plan?: string;
-    /**
-     * Plan reference (alias for plan, preferred for consistency with backend API)
-     */
-    planRef?: string;
     /**
      * Usage meter type to charge against (defaults to 'requests')
      */
@@ -3798,7 +2960,7 @@ interface CreateSolvaPayConfig {
  *
  * @example
  * ```typescript
- * const payable = solvaPay.payable({ product: 'prd_myapi', plan: 'pln_premium' });
+ * const payable = solvaPay.payable({ product: 'prd_myapi' });
  *
  * // Express.js
  * app.post('/tasks', payable.http(createTask));
@@ -3896,34 +3058,24 @@ interface PayableFunction {
  * const solvaPay = createSolvaPay();
  *
  * // Create payable handlers
-   * const payable = solvaPay.payable({ product: 'prd_myapi', plan: 'pln_premium' });
+   * const payable = solvaPay.payable({ product: 'prd_myapi' });
    *
    * // Manage customers
    * const customerRef = await solvaPay.ensureCustomer('user_123', 'user_123', {
    *   email: 'user@example.com'
    * });
-   *
-   * // Create payment intents
-   * const intent = await solvaPay.createPaymentIntent({
-   *   productRef: 'prd_myapi',
-   *   planRef: 'pln_premium',
-   *   customerRef: 'user_123'
-   * });
  * ```
  */
 interface SolvaPay {
     /**
      * Create a payable handler with explicit adapters for different frameworks.
      *
-     * @param options - Payable options including product and plan references
+     * @param options - Payable options including product reference and usage type
      * @returns PayableFunction with framework-specific adapters
      *
      * @example
      * ```typescript
-     * const payable = solvaPay.payable({
-     *   product: 'prd_myapi',
-     *   plan: 'pln_premium'
-     * });
+     * const payable = solvaPay.payable({ product: 'prd_myapi' });
      *
      * app.post('/tasks', payable.http(createTask));
      * ```
@@ -3963,11 +3115,10 @@ interface SolvaPay {
         name?: string;
     }): Promise<string>;
     /**
-     * Create a Stripe payment intent for a customer to purchase a plan.
+     * Create a payment intent for a customer to purchase a plan.
      *
-     * This creates a payment intent that can be confirmed on the client side
-     * using Stripe.js. After confirmation, call `processPaymentIntent()` to complete
-     * the purchase.
+     * This creates a payment intent that can be confirmed on the client side.
+     * After confirmation, call `processPaymentIntent()` to complete the purchase.
      *
      * @param params - Payment intent parameters
      * @param params.productRef - Product reference
@@ -3985,7 +3136,7 @@ interface SolvaPay {
      *   idempotencyKey: 'unique-key-123'
      * });
      *
-     * // Use intent.clientSecret with Stripe.js on client
+     * // Use intent.clientSecret on the client to confirm payment
      * ```
      */
     createPaymentIntent(params: {
@@ -3994,19 +3145,38 @@ interface SolvaPay {
         customerRef: string;
         idempotencyKey?: string;
     }): Promise<{
-        id: string;
+        processorPaymentId: string;
+        clientSecret: string;
+        publishableKey: string;
+        accountId?: string;
+    }>;
+    /**
+     * Create a payment intent for a credit top-up.
+     *
+     * Unlike `createPaymentIntent`, this does not require a product or plan.
+     * Credits are recorded via webhook after payment confirmation — no
+     * `processPaymentIntent` call is needed.
+     */
+    createTopupPaymentIntent(params: {
+        customerRef: string;
+        amount: number;
+        currency: string;
+        description?: string;
+        idempotencyKey?: string;
+    }): Promise<{
+        processorPaymentId: string;
         clientSecret: string;
         publishableKey: string;
         accountId?: string;
     }>;
     /**
-     * Process a payment intent after client-side Stripe confirmation.
+     * Process a payment intent after client-side payment confirmation.
      *
      * Creates the purchase immediately, eliminating webhook delay.
-     * Call this after the client has confirmed the payment intent with Stripe.js.
+     * Call this after the client has confirmed the payment intent.
      *
      * @param params - Payment processing parameters
-     * @param params.paymentIntentId - Stripe payment intent ID from client confirmation
+     * @param params.paymentIntentId - Processor payment ID from client confirmation
      * @param params.productRef - Product reference
      * @param params.customerRef - Customer reference
      * @param params.planRef - Optional plan reference (if not in payment intent)
@@ -4014,7 +3184,7 @@ interface SolvaPay {
      *
      * @example
      * ```typescript
-     * // After client confirms payment with Stripe.js
+     * // After client confirms payment
      * const result = await solvaPay.processPaymentIntent({
      *   paymentIntentId: 'pi_1234567890',
      *   productRef: 'prd_myapi',
@@ -4049,7 +3219,6 @@ interface SolvaPay {
      * const limits = await solvaPay.checkLimits({
      *   customerRef: 'user_123',
      *   productRef: 'prd_myapi',
-     *   planRef: 'pln_premium'
      * });
      *
      * if (!limits.withinLimits) {
@@ -4062,14 +3231,17 @@ interface SolvaPay {
         customerRef: string;
         productRef: string;
         planRef?: string;
-        meterName?: 'requests' | 'tokens';
-        usageType?: 'requests' | 'tokens';
+        meterName?: string;
+        usageType?: string;
     }): Promise<{
         withinLimits: boolean;
         remaining: number;
         plan: string;
         checkoutUrl?: string;
         meterName?: string;
+        creditBalance?: number;
+        creditsPerUnit?: number;
+        currency?: string;
     }>;
     /**
      * Track usage for a customer action.
@@ -4079,12 +3251,12 @@ interface SolvaPay {
      *
      * @param params - Usage tracking parameters
      * @param params.customerRef - Customer reference
-     * @param params.productRef - Product reference
-     * @param params.planRef - Plan reference
+     * @param params.actionType - Action type category
+     * @param params.units - Number of units consumed (default 1)
      * @param params.outcome - Action outcome ('success', 'paywall', or 'fail')
-     * @param params.action - Optional action name for analytics
-     * @param params.requestId - Unique request ID
-     * @param params.actionDuration - Action duration in milliseconds
+     * @param params.productRef - Product reference
+     * @param params.metadata - Additional metadata (e.g. tool name, endpoint)
+     * @param params.duration - Action duration in milliseconds
      * @param params.timestamp - ISO timestamp of the action
      *
      * @example
@@ -4103,8 +3275,8 @@ interface SolvaPay {
         actionType?: 'transaction' | 'api_call' | 'hour' | 'email' | 'storage' | 'custom';
         units?: number;
         outcome?: 'success' | 'paywall' | 'fail';
-        productReference?: string;
-        purchaseReference?: string;
+        productRef?: string;
+        purchaseRef?: string;
         description?: string;
         metadata?: Record<string, unknown>;
         duration?: number;
@@ -4133,6 +3305,7 @@ interface SolvaPay {
     createCustomer(params: {
         email: string;
         name?: string;
+        metadata?: Record<string, unknown>;
     }): Promise<{
         customerRef: string;
     }>;
@@ -4164,11 +3337,27 @@ interface SolvaPay {
         customerRef?: string;
         externalRef?: string;
     }): Promise<CustomerResponseMapped>;
+    /**
+     * Get credits for a customer.
+     *
+     * @param params - Credits query parameters
+     * @param params.customerRef - Customer reference
+     * @returns Customer reference, credits, and display currency
+     */
+    getCustomerBalance(params: {
+        customerRef: string;
+    }): Promise<{
+        customerRef: string;
+        credits: number;
+        displayCurrency: string;
+        creditsPerMinorUnit: number;
+        displayExchangeRate: number;
+    }>;
     /**
      * Create a hosted checkout session for a customer.
      *
-     * This creates a Stripe Checkout session that redirects the customer
-     * to a hosted payment page. After payment, customer is redirected back.
+     * This creates a checkout session that redirects the customer
+     * to a hosted payment page. After payment, the customer is redirected back.
      *
      * @param params - Checkout session parameters
      * @param params.productRef - Product reference
@@ -4202,7 +3391,7 @@ interface SolvaPay {
     /**
      * Create a customer portal session for managing purchases.
      *
-     * This creates a Stripe Customer Portal session that allows customers
+     * This creates a customer portal session that allows customers
      * to manage their purchases, update payment methods, and view invoices.
      *
      * @param params - Customer session parameters
@@ -4227,6 +3416,17 @@ interface SolvaPay {
         sessionId: string;
         customerUrl: string;
     }>;
+    /**
+     * Activate a plan for a customer (usage-based / free plans that don't require payment).
+     *
+     * Returns the activation result indicating whether the plan was activated,
+     * is already active, requires a credit top-up, or requires payment.
+     */
+    activatePlan(params: {
+        customerRef: string;
+        productRef: string;
+        planRef: string;
+    }): Promise<ActivatePlanResult>;
     /**
      * Bootstrap an MCP-enabled product with plans and tool mappings.
      *
@@ -4320,10 +3520,7 @@ interface SolvaPay {
  * });
  *
  * // Create payable handlers for your product
- * const payable = solvaPay.payable({
- *   product: 'prd_myapi',
- *   plan: 'pln_premium'
- * });
+ * const payable = solvaPay.payable({ product: 'prd_myapi' });
  *
  * // Protect endpoints with framework-specific adapters
  * app.post('/tasks', payable.http(createTask));      // Express/Fastify
@@ -4448,6 +3645,8 @@ declare class PaywallError extends Error {
      */
     constructor(message: string, structuredContent: PaywallStructuredContent);
 }
+/** JSON body shape for HTTP adapters and MCP text content (stable fields for clients). */
+declare function paywallErrorToClientPayload(error: PaywallError): Record<string, unknown>;
 
 /**
  * MCP OAuth helper utilities.
@@ -4653,6 +3852,13 @@ declare function getAuthenticatedUserCore(request: Request, options?: {
  * Works with standard Web API Request (works everywhere).
  */
 
+type CustomerBalanceResult = {
+    customerRef: string;
+    credits: number;
+    displayCurrency: string;
+    creditsPerMinorUnit: number;
+    displayExchangeRate: number;
+};
 /**
  * Sync customer with SolvaPay backend (ensure customer exists).
  *
@@ -4695,16 +3901,28 @@ declare function syncCustomerCore(request: Request, options?: {
     includeEmail?: boolean;
     includeName?: boolean;
 }): Promise<string | ErrorResult>;
+/**
+ * Get credits for the authenticated customer.
+ *
+ * Authenticates the request, syncs the customer, then fetches credits.
+ *
+ * @param request - Standard Web API Request object
+ * @param options - Configuration options
+ * @returns Customer credits result or error result
+ */
+declare function getCustomerBalanceCore(request: Request, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<CustomerBalanceResult | ErrorResult>;
 
 /**
- * Create a Stripe payment intent for a customer to purchase a plan.
+ * Create a payment intent for a customer to purchase a plan.
  *
  * This is a framework-agnostic helper that:
  * 1. Extracts authenticated user from the request
  * 2. Syncs customer with SolvaPay backend
  * 3. Creates a payment intent for the specified plan
  *
- * The payment intent can then be confirmed on the client side using Stripe.js.
+ * The payment intent can then be confirmed on the client side.
  * After confirmation, use `processPaymentIntentCore()` to complete the purchase.
  *
  * @param request - Standard Web API Request object
@@ -4744,24 +3962,53 @@ declare function createPaymentIntentCore(request: Request, body: {
     includeEmail?: boolean;
     includeName?: boolean;
 }): Promise<{
-    id: string;
+    processorPaymentId: string;
+    clientSecret: string;
+    publishableKey: string;
+    accountId?: string;
+    customerRef: string;
+} | ErrorResult>;
+/**
+ * Create a payment intent for a credit top-up.
+ *
+ * Unlike `createPaymentIntentCore`, this does not require a product or plan.
+ * After client-side payment confirmation, credits are recorded via webhook —
+ * no `processPaymentIntentCore` call is needed.
+ *
+ * @param request - Standard Web API Request object
+ * @param body - Top-up parameters
+ * @param body.amount - Amount in smallest currency unit (e.g. cents). Must be > 0
+ * @param body.currency - ISO 4217 currency code (e.g. 'usd')
+ * @param body.description - Optional description for the payment intent
+ * @param options - Configuration options
+ * @returns Payment intent response with client secret and customer reference, or error result
+ */
+declare function createTopupPaymentIntentCore(request: Request, body: {
+    amount: number;
+    currency: string;
+    description?: string;
+}, options?: {
+    solvaPay?: SolvaPay;
+    includeEmail?: boolean;
+    includeName?: boolean;
+}): Promise<{
+    processorPaymentId: string;
     clientSecret: string;
     publishableKey: string;
     accountId?: string;
     customerRef: string;
 } | ErrorResult>;
 /**
- * Process a payment intent after client-side Stripe confirmation.
+ * Process a payment intent after client-side payment confirmation.
  *
  * This helper processes a payment intent that has been confirmed on the client
- * side using Stripe.js. It creates the purchase immediately,
- * eliminating webhook delay.
+ * side. It creates the purchase immediately, eliminating webhook delay.
  *
- * Call this after the client has confirmed the payment intent with Stripe.js.
+ * Call this after the client has confirmed the payment intent.
  *
  * @param request - Standard Web API Request object
  * @param body - Payment processing parameters
- * @param body.paymentIntentId - Stripe payment intent ID from client confirmation (required)
+ * @param body.paymentIntentId - Processor payment ID from client confirmation (required)
  * @param body.productRef - Product reference (required)
  * @param body.planRef - Optional plan reference (if not in payment intent)
  * @param options - Configuration options
@@ -4840,9 +4087,9 @@ declare function createCustomerSessionCore(request: Request, options?: {
 } | ErrorResult>;
 
 /**
- * Purchase Cancellation Helpers (Core)
+ * Purchase Cancellation & Reactivation Helpers (Core)
  *
- * Generic helpers for purchase cancellation operations.
+ * Generic helpers for purchase cancellation and reactivation operations.
  * Works with standard Web API Request (works everywhere).
  */
 
@@ -4860,6 +4107,31 @@ declare function cancelPurchaseCore(request: Request, body: {
 }, options?: {
     solvaPay?: SolvaPay;
 }): Promise<Record<string, unknown> | ErrorResult>;
+/**
+ * Reactivate purchase - core implementation
+ *
+ * Undoes a pending cancellation, restoring auto-renewal and clearing cancellation fields.
+ * Only works while the purchase is still active and the end date hasn't passed.
+ *
+ * @param request - Standard Web API Request
+ * @param body - Reactivation parameters
+ * @param options - Configuration options
+ * @returns Reactivated purchase response or error result
+ */
+declare function reactivatePurchaseCore(request: Request, body: {
+    purchaseRef: string;
+}, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<Record<string, unknown> | ErrorResult>;
+
+declare function activatePlanCore(request: Request, body: {
+    productRef: string;
+    planRef: string;
+}, options?: {
+    solvaPay?: SolvaPay;
+    includeEmail?: boolean;
+    includeName?: boolean;
+}): Promise<ActivatePlanResult | ErrorResult>;
 
 /**
  * Plans Helper (Core)
@@ -4869,14 +4141,87 @@ declare function cancelPurchaseCore(request: Request, body: {
  * This is a public route - no authentication required.
  */
 
+type Plan = components['schemas']['Plan'];
 /**
- * List plans - core implementation
+ * List plans - core implementation.
+ *
+ * Pass `options.solvaPay` to route through a pre-configured SolvaPay instance
+ * (e.g. stub-backed in examples). When omitted, the helper reads
+ * `SOLVAPAY_SECRET_KEY` from environment and constructs a real API client.
  */
-declare function listPlansCore(request: Request): Promise<{
-    plans: Record<string, unknown>[];
+declare function listPlansCore(request: Request, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<{
+    plans: Plan[];
     productRef: string;
 } | ErrorResult>;
 
+/**
+ * Merchant Helper (Core)
+ *
+ * Generic helper for GET /api/merchant — returns the SDK-facing merchant
+ * identity used by `<MandateText>`, `<CheckoutSummary>`, and trust signals.
+ * Works with standard Web API Request (Express, Fastify, Next.js, Edge).
+ */
+
+declare function getMerchantCore(_request: Request, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<SdkMerchantResponse | ErrorResult>;
+
+/**
+ * Product Helper (Core)
+ *
+ * Generic helper for GET /api/get-product?productRef=...
+ * Returns a single product by reference, used by the `useProduct` React hook.
+ */
+
+declare function getProductCore(request: Request, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<SdkProductResponse | ErrorResult>;
+
+interface PurchaseCheckResult {
+    customerRef: string;
+    email?: string;
+    name?: string;
+    purchases: Array<{
+        reference: string;
+        productName?: string;
+        productRef?: string;
+        status?: string;
+        startDate?: string;
+        planSnapshot?: {
+            meterId?: string;
+            limit?: number;
+            freeUnits?: number;
+        };
+        usage?: {
+            used?: number;
+            overageUnits?: number;
+            overageCost?: number;
+            periodStart?: string;
+            periodEnd?: string;
+        };
+        [key: string]: unknown;
+    }>;
+}
+declare function checkPurchaseCore(request: Request, options?: {
+    solvaPay?: SolvaPay;
+    includeEmail?: boolean;
+    includeName?: boolean;
+}): Promise<PurchaseCheckResult | ErrorResult>;
+
+declare function trackUsageCore(request: Request, body: {
+    actionType?: 'transaction' | 'api_call' | 'hour' | 'email' | 'storage' | 'custom';
+    units?: number;
+    productRef?: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+}, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<{
+    success: true;
+} | ErrorResult>;
+
 /**
  * SolvaPay Server SDK
  *
@@ -4932,4 +4277,4 @@ declare function verifyWebhook({ body, signature, secret, }: {
     secret: string;
 }): WebhookEvent;
 
-export { type AuthenticatedUser, type ConfigureMcpPlansRequest, type ConfigureMcpPlansResponse, type CreateSolvaPayConfig, type CustomerResponseMapped, type CustomerWebhookObject, type ErrorResult, type HttpAdapterOptions, type McpAdapterOptions, McpBearerAuthError, type McpBootstrapFreePlanConfig, type McpBootstrapPaidPlanInput, type McpBootstrapRequest, type McpBootstrapResponse, type McpServerLike, type McpToolExtra, type McpToolPlanMappingInput, type NextAdapterOptions, type OneTimePurchaseInfo, type PayableFunction, type PayableOptions, type PaywallArgs, PaywallError, type PaywallMetadata, type PaywallStructuredContent, type PaywallToolResult, type ProcessPaymentResult, type RegisterVirtualToolsMcpOptions, type RetryOptions, type ServerClientOptions, type SolvaPay, type SolvaPayClient, type ToolPlanMappingInput, VIRTUAL_TOOL_DEFINITIONS, type VirtualToolDefinition, type VirtualToolsOptions, type WebhookEvent, type WebhookEventForType, type WebhookEventObjectMap, type WebhookEventType, type WebhookProduct, buildAuthInfoFromBearer, cancelPurchaseCore, createCheckoutSessionCore, createCustomerSessionCore, createMcpOAuthBridge, createPaymentIntentCore, createSolvaPay, createSolvaPayClient, createVirtualTools, decodeJwtPayload, extractBearerToken, getAuthenticatedUserCore, getCustomerRefFromBearerAuthHeader, getCustomerRefFromJwtPayload, getOAuthAuthorizationServerResponse, getOAuthProtectedResourceResponse, handleRouteError, isErrorResult, jsonSchemaToZodRawShape, listPlansCore, processPaymentIntentCore, registerVirtualToolsMcpImpl, syncCustomerCore, verifyWebhook, withRetry };
+export { type ActivatePlanResult, type AuthenticatedUser, type ConfigureMcpPlansRequest, type ConfigureMcpPlansResponse, type CreateSolvaPayConfig, type CustomerBalanceResult, type CustomerResponseMapped, type CustomerWebhookObject, type ErrorResult, type HttpAdapterOptions, type LimitActivationBalance, type LimitActivationProduct, type LimitPlanSummary, type McpAdapterOptions, McpBearerAuthError, type McpBootstrapPlanInput, type McpBootstrapRequest, type McpBootstrapResponse, type McpServerLike, type McpToolExtra, type McpToolPlanMappingInput, type NextAdapterOptions, type OneTimePurchaseInfo, type PayableFunction, type PayableOptions, type PaywallArgs, PaywallError, type PaywallMetadata, type PaywallStructuredContent, type PaywallToolResult, type ProcessPaymentResult, type PurchaseCheckResult, type RegisterVirtualToolsMcpOptions, type RetryOptions, type SdkMerchantResponse, type SdkProductResponse, type ServerClientOptions, type SolvaPay, type SolvaPayClient, type ToolPlanMappingInput, VIRTUAL_TOOL_DEFINITIONS, type VirtualToolDefinition, type VirtualToolsOptions, type WebhookEvent, type WebhookEventForType, type WebhookEventObjectMap, type WebhookEventType, type WebhookProduct, activatePlanCore, buildAuthInfoFromBearer, cancelPurchaseCore, checkPurchaseCore, type components, createCheckoutSessionCore, createCustomerSessionCore, createMcpOAuthBridge, createPaymentIntentCore, createSolvaPay, createSolvaPayClient, createTopupPaymentIntentCore, createVirtualTools, decodeJwtPayload, extractBearerToken, getAuthenticatedUserCore, getCustomerBalanceCore, getCustomerRefFromBearerAuthHeader, getCustomerRefFromJwtPayload, getMerchantCore, getOAuthAuthorizationServerResponse, getOAuthProtectedResourceResponse, getProductCore, handleRouteError, isErrorResult, jsonSchemaToZodRawShape, listPlansCore, paywallErrorToClientPayload, processPaymentIntentCore, reactivatePurchaseCore, registerVirtualToolsMcpImpl, syncCustomerCore, trackUsageCore, verifyWebhook, withRetry };