@solvapay/server 1.2.0 → 1.2.1-preview-e89fa52f99b6d0c7bf9834fcf2d1403141051fa0

package/dist/fetch/index.d.ts

@@ -29,6 +29,15 @@ interface components {
              * @example usd
              */
             defaultCurrency?: string;
+            /**
+             * Full set of currencies a customer may pay credit topups in, including the default currency. Omitted/single-entry means single-currency behavior.
+             * @example [
+             *       "USD",
+             *       "EUR",
+             *       "GBP"
+             *     ]
+             */
+            supportedTopupCurrencies?: string[];
             /**
              * Descriptor appearing on the customer card statement
              * @example ACME INC
@@ -246,6 +255,33 @@ interface components {
              */
             checkoutUrl: string;
         };
+        PlanPricingOptionDto: {
+            /**
+             * ISO 4217 currency code
+             * @example USD
+             */
+            currency: string;
+            /**
+             * Price in smallest currency unit (e.g. cents)
+             * @example 2999
+             */
+            price: number;
+            /**
+             * Base price in smallest currency unit (hybrid plans)
+             * @example 1999
+             */
+            basePrice?: number;
+            /**
+             * One-time setup fee in smallest currency unit
+             * @example 500
+             */
+            setupFee?: number;
+            /**
+             * Whether this is the default currency option for the plan
+             * @example true
+             */
+            default?: boolean;
+        };
         Plan: {
             /**
              * Plan type exposed in SDK
@@ -283,6 +319,8 @@ interface components {
              * @example USD
              */
             currency: string;
+            /** @description Per-currency price options for this plan */
+            pricingOptions?: components["schemas"]["PlanPricingOptionDto"][];
             /**
              * Currency symbol (derived from currency)
              * @example $
@@ -376,6 +414,13 @@ interface components {
             price?: number;
             creditsPerUnit?: number;
             currency?: string;
+            pricingOptions?: {
+                currency: string;
+                price: number;
+                basePrice?: number;
+                setupFee?: number;
+                default?: boolean;
+            }[];
             /** @enum {string} */
             billingModel?: "pre-paid" | "post-paid";
             freeUnits?: number;
@@ -414,6 +459,13 @@ interface components {
             price?: number;
             creditsPerUnit?: number;
             currency?: string;
+            pricingOptions?: {
+                currency: string;
+                price: number;
+                basePrice?: number;
+                setupFee?: number;
+                default?: boolean;
+            }[];
             /** @enum {string} */
             billingModel?: "pre-paid" | "post-paid";
             freeUnits?: number;
@@ -658,6 +710,13 @@ interface components {
                 name: string;
                 price: number;
                 currency: string;
+                pricingOptions?: {
+                    currency: string;
+                    price: number;
+                    basePrice?: number;
+                    setupFee?: number;
+                    default?: boolean;
+                }[];
                 /** @enum {string} */
                 billingCycle?: "weekly" | "monthly" | "quarterly" | "yearly" | "custom";
                 /** @enum {string} */
@@ -726,6 +785,13 @@ interface components {
                 name: string;
                 price: number;
                 currency: string;
+                pricingOptions?: {
+                    currency: string;
+                    price: number;
+                    basePrice?: number;
+                    setupFee?: number;
+                    default?: boolean;
+                }[];
                 /** @enum {string} */
                 billingCycle?: "weekly" | "monthly" | "quarterly" | "yearly" | "custom";
                 /** @enum {string} */
@@ -759,6 +825,52 @@ interface components {
         CloneProductDto: {
             name?: string;
         };
+        CreditDebitSuccessResponse: {
+            /** @enum {number} */
+            debited: true;
+            /**
+             * Credits debited for this usage event
+             * @example 10
+             */
+            amount: number;
+            /**
+             * Estimated remaining units after debit
+             * @example 99
+             */
+            unitsRemaining: number;
+        };
+        CreditDebitSkippedResponse: {
+            /** @enum {number} */
+            debited: false;
+            /**
+             * Reason no credit debit was recorded
+             * @example duplicate
+             * @enum {string}
+             */
+            reason: "duplicate" | "no_product_ref" | "customer_not_found" | "no_active_purchase" | "plan_not_credit_based";
+        };
+        UsageRecordResponse: {
+            /** @example true */
+            success: boolean;
+            /** @example usage_A1B2C3D4 */
+            reference: string;
+            creditDebit?: components["schemas"]["CreditDebitSuccessResponse"] | components["schemas"]["CreditDebitSkippedResponse"];
+        };
+        BulkUsageResultResponse: {
+            /** @example usage_A1B2C3D4 */
+            reference: string;
+            creditDebit?: components["schemas"]["CreditDebitSuccessResponse"] | components["schemas"]["CreditDebitSkippedResponse"];
+        };
+        BulkUsageResponse: {
+            /** @example true */
+            success: boolean;
+            /**
+             * Number of usage events inserted
+             * @example 2
+             */
+            inserted: number;
+            results: components["schemas"]["BulkUsageResultResponse"][];
+        };
         CreateUsageRequest: {
             customerRef: string;
             /**
@@ -1028,6 +1140,8 @@ interface components {
             creditsPerUnit?: number;
             billingModel?: string;
             billingCycle?: string;
+            /** @description Per-currency price options for this plan */
+            pricingOptions?: components["schemas"]["PlanPricingOptionDto"][];
         };
         LimitBalanceDto: {
             /** @description Credit balance in mils */
@@ -1111,6 +1225,22 @@ interface components {
             };
             externalRef?: string;
         };
+        GrantCustomerCreditsRequest: {
+            credits: number;
+            reason?: string;
+        };
+        GrantCustomerCreditsResponse: {
+            /** @description Whether the grant was recorded */
+            success: boolean;
+            /** @description Customer reference identifier */
+            customerRef: string;
+            /** @description Granted credit amount */
+            credits: number;
+            /** @description Customer credit balance after the grant */
+            balance: number;
+            /** @description Machine-readable grant reason */
+            reason?: string;
+        };
         CreateCustomerSessionRequest: {
             customerRef: string;
             productRef?: string;

package/dist/fetch/index.js

@@ -23,6 +23,7 @@ function handleRouteError(error, operationName, defaultMessage) {
 }
 
 // src/helpers/auth.ts
+import { SOLVAPAY_USER_ID_HEADER } from "@solvapay/auth";
 function base64UrlDecode(input) {
   const padded = input.replace(/-/g, "+").replace(/_/g, "/");
   const padding = padded.length % 4 === 0 ? "" : "=".repeat(4 - padded.length % 4);
@@ -99,7 +100,7 @@ async function getAuthenticatedUserCore(request, options = {}) {
   try {
     const includeEmail = options.includeEmail !== false;
     const includeName = options.includeName !== false;
-    const headerUserId = request.headers.get("x-user-id");
+    const headerUserId = request.headers.get(SOLVAPAY_USER_ID_HEADER);
     if (headerUserId) {
       let email = null;
       let name = null;
@@ -178,7 +179,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Check limits failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Check limits failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       const result = await res.json();
       return result;
@@ -194,8 +197,28 @@ function createSolvaPayClient(opts) {
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Track usage failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Track usage failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
+      return await res.json();
+    },
+    // POST: /v1/sdk/usages/bulk
+    async trackUsageBulk(params) {
+      const url = `${base}/v1/sdk/usages/bulk`;
+      const res = await fetch(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(params)
+      });
+      if (!res.ok) {
+        const error = await res.text();
+        log(`\u274C API Error: ${res.status} - ${error}`);
+        throw new SolvaPayError2(`Track usage bulk failed (${res.status}): ${error}`, {
+          status: res.status
+        });
+      }
+      return await res.json();
     },
     // POST: /v1/sdk/customers
     async createCustomer(params) {
@@ -208,7 +231,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Create customer failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Create customer failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       const result = await res.json();
       return {
@@ -226,7 +251,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Update customer failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Update customer failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       const result = await res.json();
       return {
@@ -256,7 +283,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Get customer failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Get customer failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       const result = await res.json();
       let customer = result;
@@ -277,6 +306,27 @@ function createSolvaPayClient(opts) {
         purchases: customer.purchases || []
       };
     },
+    // POST: /v1/sdk/customers/{reference}/credits
+    async assignCredits(params) {
+      const { customerRef, idempotencyKey, ...body } = params;
+      const url = `${base}/v1/sdk/customers/${encodeURIComponent(customerRef)}/credits`;
+      const res = await fetch(url, {
+        method: "POST",
+        headers: {
+          ...headers,
+          ...idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {}
+        },
+        body: JSON.stringify(body)
+      });
+      if (!res.ok) {
+        const error = await res.text();
+        log(`\u274C API Error: ${res.status} - ${error}`);
+        throw new SolvaPayError2(`Assign credits failed (${res.status}): ${error}`, {
+          status: res.status
+        });
+      }
+      return await res.json();
+    },
     // GET: /v1/sdk/merchant
     async getMerchant() {
       const url = `${base}/v1/sdk/merchant`;
@@ -287,7 +337,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Get merchant failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Get merchant failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       return res.json();
     },
@@ -301,7 +353,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Get platform config failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Get platform config failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       return res.json();
     },
@@ -315,7 +369,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Get product failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Get product failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       const result = await res.json();
       const data = result.data || {};
@@ -332,7 +388,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`List products failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`List products failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       const result = await res.json();
       const products = Array.isArray(result) ? result : result.products || [];
@@ -352,7 +410,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Create product failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Create product failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       const result = await res.json();
       return result;
@@ -368,7 +428,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Bootstrap MCP product failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Bootstrap MCP product failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       return await res.json();
     },
@@ -383,7 +445,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Configure MCP plans failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Configure MCP plans failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       return await res.json();
     },
@@ -397,7 +461,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok && res.status !== 404) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Delete product failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Delete product failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
     },
     // POST: /v1/sdk/products/{productRef}/clone
@@ -411,7 +477,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Clone product failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Clone product failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       return await res.json();
     },
@@ -425,7 +493,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`List plans failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`List plans failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       const result = await res.json();
       const plans = Array.isArray(result) ? result : result.plans || [];
@@ -452,7 +522,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Create plan failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Create plan failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       const result = await res.json();
       return result;
@@ -468,7 +540,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Update plan failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Update plan failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       return await res.json();
     },
@@ -482,7 +556,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok && res.status !== 404) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Delete plan failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Delete plan failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
     },
     // POST: /payment-intents
@@ -498,13 +574,16 @@ function createSolvaPayClient(opts) {
         body: JSON.stringify({
           productRef: params.productRef,
           planRef: params.planRef,
-          customerRef: params.customerRef
+          customerRef: params.customerRef,
+          ...params.currency && { currency: params.currency }
         })
       });
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Create payment intent failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Create payment intent failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       return await res.json();
     },
@@ -529,7 +608,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Create topup payment intent failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Create topup payment intent failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       return await res.json();
     },
@@ -551,7 +632,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Process payment failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Process payment failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       const result = await res.json();
       return result;
@@ -579,7 +662,9 @@ function createSolvaPayClient(opts) {
             { status: 400 }
           );
         }
-        throw new SolvaPayError2(`Cancel purchase failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Cancel purchase failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       const responseText = await res.text();
       let responseData;
@@ -623,12 +708,11 @@ function createSolvaPayClient(opts) {
           throw new SolvaPayError2(`Purchase not found: ${error}`, { status: 404 });
         }
         if (res.status === 400) {
-          throw new SolvaPayError2(
-            `Purchase cannot be reactivated: ${error}`,
-            { status: 400 }
-          );
+          throw new SolvaPayError2(`Purchase cannot be reactivated: ${error}`, { status: 400 });
         }
-        throw new SolvaPayError2(`Reactivate purchase failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Reactivate purchase failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       const responseText = await res.text();
       let responseData;
@@ -669,7 +753,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Get user info failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Get user info failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       return await res.json();
     },
@@ -683,7 +769,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Get customer balance failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Get customer balance failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       return await res.json();
     },
@@ -698,7 +786,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Create checkout session failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Create checkout session failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       const result = await res.json();
       return result;
@@ -714,7 +804,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Create customer session failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Create customer session failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       const result = await res.json();
       return result;
@@ -730,7 +822,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Activate plan failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Activate plan failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       return await res.json();
     },
@@ -741,7 +835,9 @@ function createSolvaPayClient(opts) {
       if (!res.ok) {
         const error = await res.text();
         log(`\u274C API Error: ${res.status} - ${error}`);
-        throw new SolvaPayError2(`Get payment method failed (${res.status}): ${error}`, { status: res.status });
+        throw new SolvaPayError2(`Get payment method failed (${res.status}): ${error}`, {
+          status: res.status
+        });
       }
       return await res.json();
     }
@@ -2016,6 +2112,12 @@ function createSolvaPay(config) {
     trackUsage(params) {
       return apiClient.trackUsage(params);
     },
+    trackUsageBulk(params) {
+      if (!apiClient.trackUsageBulk) {
+        throw new SolvaPayError3("trackUsageBulk is not available on this API client");
+      }
+      return apiClient.trackUsageBulk(params);
+    },
     createCustomer(params) {
       if (!apiClient.createCustomer) {
         throw new SolvaPayError3("createCustomer is not available on this API client");
@@ -2025,6 +2127,12 @@ function createSolvaPay(config) {
     getCustomer(params) {
       return apiClient.getCustomer(params);
     },
+    assignCredits(params) {
+      if (!apiClient.assignCredits) {
+        throw new SolvaPayError3("assignCredits is not available on this API client");
+      }
+      return apiClient.assignCredits(params);
+    },
     getCustomerBalance(params) {
       if (!apiClient.getCustomerBalance) {
         throw new SolvaPayError3("getCustomerBalance is not available on this API client");
@@ -2110,7 +2218,9 @@ function createSolvaPay(config) {
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         async function(businessLogic) {
           const getCustomerRef = (args) => {
-            const configuredRef = options.getCustomerRef?.(args);
+            const configuredRef = options.getCustomerRef?.(
+              args
+            );
             if (typeof configuredRef === "string") {
               return configuredRef;
             }
@@ -2129,9 +2239,7 @@ function createSolvaPay(config) {
           );
           if (decision.outcome === "gate") {
             const errorMessage = decision.gate.kind === "activation_required" ? "Activation required" : "Payment required";
-            const body = paywallErrorToClientPayload(
-              new PaywallError(errorMessage, decision.gate)
-            );
+            const body = paywallErrorToClientPayload(new PaywallError(errorMessage, decision.gate));
             const response = new Response(JSON.stringify(body), {
               status: 402,
               headers: { "content-type": "application/json" }
@@ -2258,7 +2366,8 @@ async function createPaymentIntentCore(request, body, options = {}) {
     const paymentIntent = await solvaPay.createPaymentIntent({
       productRef: body.productRef,
       planRef: body.planRef,
-      customerRef
+      customerRef,
+      ...body.currency && { currency: body.currency }
     });
     return {
       processorPaymentId: paymentIntent.processorPaymentId,
@@ -2788,15 +2897,16 @@ async function trackUsageCore(request, body, options = {}) {
       email: email || void 0,
       name: name || void 0
     });
-    await solvaPay.trackUsage({
+    const result = await solvaPay.trackUsage({
       customerRef,
       actionType: body.actionType,
       units: body.units,
       productRef: body.productRef,
       description: body.description,
-      metadata: body.metadata
+      metadata: body.metadata,
+      idempotencyKey: body.idempotencyKey
     });
-    return { success: true };
+    return result;
   } catch (error) {
     return handleRouteError(error, "Track usage", "Track usage failed");
   }