@solvapay/server 1.3.0 → 1.4.0-preview-e2cd9bda9dee33e68f6bba7098f7d683e6f1b742

package/dist/edge.d.ts

@@ -1,3 +1,6 @@
+import * as _solvapay_core from '@solvapay/core';
+import { BusinessDetailsInput, TaxBreakdown } from '@solvapay/core';
+
 interface components {
     schemas: {
         SdkMerchantResponseDto: {
@@ -243,6 +246,28 @@ interface components {
             customerRef: string;
             planRef?: string;
         };
+        BusinessDetailsDto: {
+            /** Whether the purchase is on behalf of a business */
+            isBusiness: boolean;
+            /** Legal business name */
+            businessName?: string;
+            /** ISO 3166-1 alpha-2 country code */
+            country?: string;
+            /** Tax / VAT identification number */
+            taxId?: string;
+        };
+        TaxBreakdownResponse: {
+            subtotal: number;
+            taxAmount: number;
+            taxRate: number;
+            treatment: "reverse_charge" | "standard" | "none" | "not_collecting";
+            total: number;
+            currency: string;
+            inclusive: boolean;
+        };
+        AttachBusinessDetailsResponse: {
+            taxBreakdown: components["schemas"]["TaxBreakdownResponse"];
+        };
         CreateCheckoutSessionResponse: {
             /**
              * Checkout session ID/token
@@ -403,6 +428,11 @@ interface components {
             createdAt: string;
             /** @description Last update timestamp */
             updatedAt: string;
+            /**
+             * Tax inclusion behavior for business checkout
+             * @enum {string}
+             */
+            taxBehavior?: "auto" | "inclusive" | "exclusive";
         };
         CreatePlanRequest: {
             name: string;
@@ -450,6 +480,8 @@ interface components {
             maxActiveUsers?: number;
             accessExpiryDays?: number;
             default?: boolean;
+            /** @enum {string} */
+            taxBehavior?: "auto" | "inclusive" | "exclusive";
         };
         UpdatePlanRequest: {
             name?: string;
@@ -484,6 +516,8 @@ interface components {
                 [key: string]: unknown;
             };
             default?: boolean;
+            /** @enum {string} */
+            taxBehavior?: "auto" | "inclusive" | "exclusive";
         };
         CreateProductRequest: {
             name: string;
@@ -1673,6 +1707,51 @@ interface operations {
             };
         };
     };
+    PaymentIntentSdkController_attachBusinessDetails: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Stripe payment intent ID */
+                processorPaymentId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["BusinessDetailsDto"];
+            };
+        };
+        responses: {
+            /** @description Tax breakdown after applying business details */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AttachBusinessDetailsResponse"];
+                };
+            };
+            /** @description Invalid business details or payment intent state */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @description Payment intent not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+        };
+    };
     CheckoutSessionSdkController_createCheckoutSession: {
         parameters: {
             query?: never;
@@ -2999,6 +3078,13 @@ type WebhookEvent = {
  * Types related to the SolvaPay API client and backend communication.
  */
 
+type AttachBusinessDetailsParams = {
+    paymentIntentId: string;
+    customerRef?: string;
+} & BusinessDetailsInput;
+type AttachBusinessDetailsResult = {
+    taxBreakdown: TaxBreakdown;
+};
 type CheckLimitsRequest = components['schemas']['CheckLimitRequest'] & {
     /**
      * When `true`, the backend mints a checkout session (or customer
@@ -3381,6 +3467,7 @@ interface SolvaPayClient {
         customerRef: string;
         planRef?: string;
     }): Promise<ProcessPaymentResult>;
+    attachBusinessDetails?(params: AttachBusinessDetailsParams): Promise<AttachBusinessDetailsResult>;
     getUserInfo?(params: {
         customerRef: string;
         productRef: string;
@@ -4174,6 +4261,21 @@ interface SolvaPay {
         customerRef: string;
         planRef?: string;
     }): Promise<ProcessPaymentResult>;
+    /**
+     * Attach business purchase details to a payment intent
+     * and retrieve the computed tax breakdown.
+     */
+    attachBusinessDetails(params: {
+        paymentIntentId: string;
+        customerRef?: string;
+        isBusiness: boolean;
+        businessName?: string;
+        country?: string;
+        taxId?: string;
+        taxIdType?: _solvapay_core.TaxIdType;
+    }): Promise<{
+        taxBreakdown: _solvapay_core.TaxBreakdown;
+    }>;
     /**
      * Check if customer is within usage limits for a product.
      *
@@ -5103,6 +5205,21 @@ declare function processPaymentIntentCore(request: Request, body: {
  * }
  * ```
  */
+/**
+ * Attach business purchase details to a credit-topup payment intent and
+ * retrieve the computed tax breakdown.
+ *
+ * Validates business fields client-side via `@solvapay/core` before
+ * forwarding to the SolvaPay backend.
+ */
+declare function attachBusinessDetailsCore(request: Request, body: {
+    paymentIntentId: string;
+    customerRef?: string;
+} & BusinessDetailsInput, options?: {
+    solvaPay?: SolvaPay;
+}): Promise<{
+    taxBreakdown: TaxBreakdown;
+} | ErrorResult>;
 declare function processTopupPaymentIntentCore(request: Request, body: {
     paymentIntentId: string;
 }, options?: {
@@ -5384,4 +5501,4 @@ declare function verifyWebhook({ body, signature, secret, }: {
     secret: string;
 }): Promise<WebhookEvent>;
 
-export { type ActivatePlanResult, type AuthenticatedUser, type ConfigureMcpPlansRequest, type ConfigureMcpPlansResponse, type CreateSolvaPayConfig, type CustomerBalanceResult, type CustomerResponseMapped, type CustomerWebhookObject, type ErrorResult, type GetUsageResult, type HttpAdapterOptions, type LimitActivationBalance, type LimitActivationProduct, type LimitPlanSummary, type LimitResponseWithPlan, type McpBootstrapPlanInput, type McpBootstrapRequest, type McpBootstrapResponse, type McpToolPlanMappingInput, type NextAdapterOptions, type OneTimePurchaseInfo, type PayableAllowResult, type PayableFunction, type PayableGateOptions, type PayableGateResult, type PayableOptions, type PayablePaywallResult, type PaymentMethodInfo, type PaywallArgs, type PaywallDecision, PaywallError, type PaywallMetadata, type PaywallState, type PaywallStructuredContent, type ProcessPaymentResult, type PurchaseCheckResult, type RetryOptions, type SdkMerchantResponse, type SdkProductResponse, type ServerClientOptions, type SolvaPay, type SolvaPayClient, type ToolPlanMappingInput, type TopupProcessResult, type WebhookEvent, type WebhookEventForType, type WebhookEventObjectMap, type WebhookEventType, type WebhookProduct, activatePlanCore, buildGateMessage, buildNudgeMessage, buildPaywallGate, cancelPurchaseCore, checkLimitsCore, checkPurchaseCore, classifyPaywallState, type components, createCheckoutSessionCore, createCustomerSessionCore, createPaymentIntentCore, createSolvaPay, createSolvaPayClient, createTopupPaymentIntentCore, disableAutoRechargeCore, getAuthenticatedUserCore, getAutoRechargeCore, getCustomerBalanceCore, getMerchantCore, getPaymentMethodCore, getProductCore, getUsageCore, handleRouteError, isErrorResult, isPaywallStructuredContent, listPlansCore, paywallErrorToClientPayload, processPaymentIntentCore, processTopupPaymentIntentCore, reactivatePurchaseCore, saveAutoRechargeCore, syncCustomerCore, trackUsageCore, verifyWebhook, withRetry };
+export { type ActivatePlanResult, type AuthenticatedUser, type ConfigureMcpPlansRequest, type ConfigureMcpPlansResponse, type CreateSolvaPayConfig, type CustomerBalanceResult, type CustomerResponseMapped, type CustomerWebhookObject, type ErrorResult, type GetUsageResult, type HttpAdapterOptions, type LimitActivationBalance, type LimitActivationProduct, type LimitPlanSummary, type LimitResponseWithPlan, type McpBootstrapPlanInput, type McpBootstrapRequest, type McpBootstrapResponse, type McpToolPlanMappingInput, type NextAdapterOptions, type OneTimePurchaseInfo, type PayableAllowResult, type PayableFunction, type PayableGateOptions, type PayableGateResult, type PayableOptions, type PayablePaywallResult, type PaymentMethodInfo, type PaywallArgs, type PaywallDecision, PaywallError, type PaywallMetadata, type PaywallState, type PaywallStructuredContent, type ProcessPaymentResult, type PurchaseCheckResult, type RetryOptions, type SdkMerchantResponse, type SdkProductResponse, type ServerClientOptions, type SolvaPay, type SolvaPayClient, type ToolPlanMappingInput, type TopupProcessResult, type WebhookEvent, type WebhookEventForType, type WebhookEventObjectMap, type WebhookEventType, type WebhookProduct, activatePlanCore, attachBusinessDetailsCore, buildGateMessage, buildNudgeMessage, buildPaywallGate, cancelPurchaseCore, checkLimitsCore, checkPurchaseCore, classifyPaywallState, type components, createCheckoutSessionCore, createCustomerSessionCore, createPaymentIntentCore, createSolvaPay, createSolvaPayClient, createTopupPaymentIntentCore, disableAutoRechargeCore, getAuthenticatedUserCore, getAutoRechargeCore, getCustomerBalanceCore, getMerchantCore, getPaymentMethodCore, getProductCore, getUsageCore, handleRouteError, isErrorResult, isPaywallStructuredContent, listPlansCore, paywallErrorToClientPayload, processPaymentIntentCore, processTopupPaymentIntentCore, reactivatePurchaseCore, saveAutoRechargeCore, syncCustomerCore, trackUsageCore, verifyWebhook, withRetry };

package/dist/edge.js

@@ -489,6 +489,31 @@ function createSolvaPayClient(opts) {
       const result = await res.json();
       return result;
     },
+    // POST: /v1/sdk/payment-intents/{paymentIntentId}/business-details
+    async attachBusinessDetails(params) {
+      const url = `${base}/v1/sdk/payment-intents/${params.paymentIntentId}/business-details`;
+      const res = await fetch(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({
+          isBusiness: params.isBusiness,
+          ...params.businessName !== void 0 && { businessName: params.businessName },
+          ...params.country !== void 0 && { country: params.country },
+          ...params.taxId !== void 0 && { taxId: params.taxId },
+          ...params.taxIdType !== void 0 && { taxIdType: params.taxIdType },
+          ...params.customerRef !== void 0 && { customerRef: params.customerRef }
+        })
+      });
+      if (!res.ok) {
+        const error = await res.text();
+        log(`\u274C API Error: ${res.status} - ${error}`);
+        throw new SolvaPayError(
+          `Attach business details failed (${res.status}): ${error}`,
+          { status: res.status }
+        );
+      }
+      return await res.json();
+    },
     // POST: /v1/sdk/purchases/{purchaseRef}/cancel
     async cancelPurchase(params) {
       const url = `${base}/v1/sdk/purchases/${params.purchaseRef}/cancel`;
@@ -2011,6 +2036,14 @@ function createSolvaPay(config) {
       }
       return apiClient.processPaymentIntent(params);
     },
+    attachBusinessDetails(params) {
+      if (!apiClient.attachBusinessDetails) {
+        throw new SolvaPayError2(
+          "attachBusinessDetails is not available on this API client"
+        );
+      }
+      return apiClient.attachBusinessDetails(params);
+    },
     checkLimits(params) {
       return apiClient.checkLimits(params);
     },
@@ -2412,6 +2445,11 @@ async function getCustomerBalanceCore(request, options = {}) {
   }
 }
 
+// src/helpers/payment.ts
+import {
+  validateBusinessDetails
+} from "@solvapay/core";
+
 // src/helpers/balance-poll.ts
 var TOPUP_BALANCE_POLL_DELAYS_MS = [500, 1e3, 2e3, 4e3];
 var BALANCE_RECONCILE_DELAYS_MS = [500, 1e3, 2e3, 4e3, 8e3, 16e3];
@@ -2544,6 +2582,50 @@ async function processPaymentIntentCore(request, body, options = {}) {
     return handleRouteError(error, "Process payment intent", "Payment processing failed");
   }
 }
+async function attachBusinessDetailsCore(request, body, options = {}) {
+  try {
+    if (!body.paymentIntentId) {
+      return {
+        error: "paymentIntentId is required",
+        status: 400
+      };
+    }
+    const validation = validateBusinessDetails({
+      isBusiness: body.isBusiness,
+      businessName: body.businessName,
+      country: body.country,
+      taxId: body.taxId,
+      taxIdType: body.taxIdType
+    });
+    if (!validation.success) {
+      const firstIssue = validation.error.issues[0];
+      return {
+        error: firstIssue?.message ?? "Invalid business details",
+        status: 400
+      };
+    }
+    const solvaPay = options.solvaPay || createSolvaPay();
+    if (typeof solvaPay.attachBusinessDetails !== "function") {
+      return {
+        error: "attachBusinessDetails is not available on this SolvaPay client",
+        status: 501
+      };
+    }
+    const details = validation.data;
+    const result = await solvaPay.attachBusinessDetails({
+      paymentIntentId: body.paymentIntentId,
+      ...body.customerRef !== void 0 && { customerRef: body.customerRef },
+      ...details
+    });
+    return result;
+  } catch (error) {
+    return handleRouteError(
+      error,
+      "Attach business details",
+      "Failed to attach business details"
+    );
+  }
+}
 async function processTopupPaymentIntentCore(request, body, options = {}) {
   try {
     if (!body.paymentIntentId) {
@@ -3224,6 +3306,7 @@ async function verifyWebhook({
 export {
   PaywallError,
   activatePlanCore,
+  attachBusinessDetailsCore,
   buildGateMessage,
   buildNudgeMessage,
   buildPaywallGate,

package/dist/fetch/index.cjs

@@ -693,6 +693,31 @@ function createSolvaPayClient(opts) {
       const result = await res.json();
       return result;
     },
+    // POST: /v1/sdk/payment-intents/{paymentIntentId}/business-details
+    async attachBusinessDetails(params) {
+      const url = `${base}/v1/sdk/payment-intents/${params.paymentIntentId}/business-details`;
+      const res = await fetch(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({
+          isBusiness: params.isBusiness,
+          ...params.businessName !== void 0 && { businessName: params.businessName },
+          ...params.country !== void 0 && { country: params.country },
+          ...params.taxId !== void 0 && { taxId: params.taxId },
+          ...params.taxIdType !== void 0 && { taxIdType: params.taxIdType },
+          ...params.customerRef !== void 0 && { customerRef: params.customerRef }
+        })
+      });
+      if (!res.ok) {
+        const error = await res.text();
+        log(`\u274C API Error: ${res.status} - ${error}`);
+        throw new import_core2.SolvaPayError(
+          `Attach business details failed (${res.status}): ${error}`,
+          { status: res.status }
+        );
+      }
+      return await res.json();
+    },
     // POST: /v1/sdk/purchases/{purchaseRef}/cancel
     async cancelPurchase(params) {
       const url = `${base}/v1/sdk/purchases/${params.purchaseRef}/cancel`;
@@ -2201,6 +2226,14 @@ function createSolvaPay(config) {
       }
       return apiClient.processPaymentIntent(params);
     },
+    attachBusinessDetails(params) {
+      if (!apiClient.attachBusinessDetails) {
+        throw new import_core3.SolvaPayError(
+          "attachBusinessDetails is not available on this API client"
+        );
+      }
+      return apiClient.attachBusinessDetails(params);
+    },
     checkLimits(params) {
       return apiClient.checkLimits(params);
     },
@@ -2440,6 +2473,7 @@ async function getCustomerBalanceCore(request, options = {}) {
 }
 
 // src/helpers/payment.ts
+var import_core4 = require("@solvapay/core");
 async function createPaymentIntentCore(request, body, options = {}) {
   try {
     if (!body.planRef || !body.productRef) {
@@ -2618,7 +2652,7 @@ async function createCustomerSessionCore(request, options = {}) {
 }
 
 // src/helpers/renewal.ts
-var import_core4 = require("@solvapay/core");
+var import_core5 = require("@solvapay/core");
 async function cancelPurchaseCore(request, body, options = {}) {
   try {
     if (!body.purchaseRef) {
@@ -2664,7 +2698,7 @@ async function cancelPurchaseCore(request, body, options = {}) {
     await new Promise((resolve) => setTimeout(resolve, 500));
     return cancelledPurchase;
   } catch (error) {
-    if (error instanceof import_core4.SolvaPayError) {
+    if (error instanceof import_core5.SolvaPayError) {
       const errorMessage = error.message;
       if (errorMessage.includes("not found")) {
         return {
@@ -2732,7 +2766,7 @@ async function reactivatePurchaseCore(request, body, options = {}) {
     await new Promise((resolve) => setTimeout(resolve, 500));
     return reactivatedPurchase;
   } catch (error) {
-    if (error instanceof import_core4.SolvaPayError) {
+    if (error instanceof import_core5.SolvaPayError) {
       const errorMessage = error.message;
       if (errorMessage.includes("not found")) {
         return {
@@ -2813,7 +2847,7 @@ async function getPaymentMethodCore(request, options = {}) {
 }
 
 // src/helpers/plans.ts
-var import_core5 = require("@solvapay/core");
+var import_core6 = require("@solvapay/core");
 async function listPlansCore(request, options = {}) {
   try {
     const url = new URL(request.url);
@@ -2825,7 +2859,7 @@ async function listPlansCore(request, options = {}) {
       };
     }
     const apiClient = options.solvaPay?.apiClient ?? (() => {
-      const config = (0, import_core5.getSolvaPayConfig)();
+      const config = (0, import_core6.getSolvaPayConfig)();
       if (!config.apiKey) return null;
       return createSolvaPayClient({
         apiKey: config.apiKey,
@@ -2855,11 +2889,11 @@ async function listPlansCore(request, options = {}) {
 }
 
 // src/helpers/merchant.ts
-var import_core6 = require("@solvapay/core");
+var import_core7 = require("@solvapay/core");
 async function getMerchantCore(_request, options = {}) {
   try {
     const apiClient = options.solvaPay?.apiClient ?? (() => {
-      const config = (0, import_core6.getSolvaPayConfig)();
+      const config = (0, import_core7.getSolvaPayConfig)();
       if (!config.apiKey) return null;
       return createSolvaPayClient({
         apiKey: config.apiKey,
@@ -2886,7 +2920,7 @@ async function getMerchantCore(_request, options = {}) {
 }
 
 // src/helpers/product.ts
-var import_core7 = require("@solvapay/core");
+var import_core8 = require("@solvapay/core");
 async function getProductCore(request, options = {}) {
   try {
     const url = new URL(request.url);
@@ -2898,7 +2932,7 @@ async function getProductCore(request, options = {}) {
       };
     }
     const apiClient = options.solvaPay?.apiClient ?? (() => {
-      const config = (0, import_core7.getSolvaPayConfig)();
+      const config = (0, import_core8.getSolvaPayConfig)();
       if (!config.apiKey) return null;
       return createSolvaPayClient({
         apiKey: config.apiKey,
@@ -3009,7 +3043,7 @@ async function trackUsageCore(request, body, options = {}) {
 }
 
 // src/edge.ts
-var import_core8 = require("@solvapay/core");
+var import_core9 = require("@solvapay/core");
 function timingSafeEqual(a, b) {
   if (a.length !== b.length) return false;
   let mismatch = 0;
@@ -3024,22 +3058,22 @@ async function verifyWebhook({
   secret
 }) {
   const toleranceSec = 300;
-  if (!signature) throw new import_core8.SolvaPayError("Missing webhook signature");
+  if (!signature) throw new import_core9.SolvaPayError("Missing webhook signature");
   const parts = signature.split(",");
   const tPart = parts.find((p) => p.startsWith("t="));
   const v1Part = parts.find((p) => p.startsWith("v1="));
   if (!tPart || !v1Part) {
-    throw new import_core8.SolvaPayError("Malformed webhook signature");
+    throw new import_core9.SolvaPayError("Malformed webhook signature");
   }
   const timestamp = parseInt(tPart.slice(2), 10);
   const receivedHmac = v1Part.slice(3);
   if (Number.isNaN(timestamp) || !receivedHmac) {
-    throw new import_core8.SolvaPayError("Malformed webhook signature");
+    throw new import_core9.SolvaPayError("Malformed webhook signature");
   }
   if (toleranceSec > 0) {
     const age = Math.abs(Math.floor(Date.now() / 1e3) - timestamp);
     if (age > toleranceSec) {
-      throw new import_core8.SolvaPayError("Webhook signature timestamp too old");
+      throw new import_core9.SolvaPayError("Webhook signature timestamp too old");
     }
   }
   const enc = new TextEncoder();
@@ -3053,12 +3087,12 @@ async function verifyWebhook({
   const sigBuf = await crypto.subtle.sign("HMAC", key, enc.encode(`${timestamp}.${body}`));
   const expectedHmac = Array.from(new Uint8Array(sigBuf)).map((b) => b.toString(16).padStart(2, "0")).join("");
   if (!timingSafeEqual(expectedHmac, receivedHmac)) {
-    throw new import_core8.SolvaPayError("Invalid webhook signature");
+    throw new import_core9.SolvaPayError("Invalid webhook signature");
   }
   try {
     return JSON.parse(body);
   } catch {
-    throw new import_core8.SolvaPayError("Invalid webhook payload: body is not valid JSON");
+    throw new import_core9.SolvaPayError("Invalid webhook payload: body is not valid JSON");
   }
 }
 

package/dist/fetch/index.d.cts

@@ -243,6 +243,28 @@ interface components {
             customerRef: string;
             planRef?: string;
         };
+        BusinessDetailsDto: {
+            /** Whether the purchase is on behalf of a business */
+            isBusiness: boolean;
+            /** Legal business name */
+            businessName?: string;
+            /** ISO 3166-1 alpha-2 country code */
+            country?: string;
+            /** Tax / VAT identification number */
+            taxId?: string;
+        };
+        TaxBreakdownResponse: {
+            subtotal: number;
+            taxAmount: number;
+            taxRate: number;
+            treatment: "reverse_charge" | "standard" | "none" | "not_collecting";
+            total: number;
+            currency: string;
+            inclusive: boolean;
+        };
+        AttachBusinessDetailsResponse: {
+            taxBreakdown: components["schemas"]["TaxBreakdownResponse"];
+        };
         CreateCheckoutSessionResponse: {
             /**
              * Checkout session ID/token
@@ -403,6 +425,11 @@ interface components {
             createdAt: string;
             /** @description Last update timestamp */
             updatedAt: string;
+            /**
+             * Tax inclusion behavior for business checkout
+             * @enum {string}
+             */
+            taxBehavior?: "auto" | "inclusive" | "exclusive";
         };
         CreatePlanRequest: {
             name: string;
@@ -450,6 +477,8 @@ interface components {
             maxActiveUsers?: number;
             accessExpiryDays?: number;
             default?: boolean;
+            /** @enum {string} */
+            taxBehavior?: "auto" | "inclusive" | "exclusive";
         };
         UpdatePlanRequest: {
             name?: string;
@@ -484,6 +513,8 @@ interface components {
                 [key: string]: unknown;
             };
             default?: boolean;
+            /** @enum {string} */
+            taxBehavior?: "auto" | "inclusive" | "exclusive";
         };
         CreateProductRequest: {
             name: string;

package/dist/fetch/index.d.ts

@@ -243,6 +243,28 @@ interface components {
             customerRef: string;
             planRef?: string;
         };
+        BusinessDetailsDto: {
+            /** Whether the purchase is on behalf of a business */
+            isBusiness: boolean;
+            /** Legal business name */
+            businessName?: string;
+            /** ISO 3166-1 alpha-2 country code */
+            country?: string;
+            /** Tax / VAT identification number */
+            taxId?: string;
+        };
+        TaxBreakdownResponse: {
+            subtotal: number;
+            taxAmount: number;
+            taxRate: number;
+            treatment: "reverse_charge" | "standard" | "none" | "not_collecting";
+            total: number;
+            currency: string;
+            inclusive: boolean;
+        };
+        AttachBusinessDetailsResponse: {
+            taxBreakdown: components["schemas"]["TaxBreakdownResponse"];
+        };
         CreateCheckoutSessionResponse: {
             /**
              * Checkout session ID/token
@@ -403,6 +425,11 @@ interface components {
             createdAt: string;
             /** @description Last update timestamp */
             updatedAt: string;
+            /**
+             * Tax inclusion behavior for business checkout
+             * @enum {string}
+             */
+            taxBehavior?: "auto" | "inclusive" | "exclusive";
         };
         CreatePlanRequest: {
             name: string;
@@ -450,6 +477,8 @@ interface components {
             maxActiveUsers?: number;
             accessExpiryDays?: number;
             default?: boolean;
+            /** @enum {string} */
+            taxBehavior?: "auto" | "inclusive" | "exclusive";
         };
         UpdatePlanRequest: {
             name?: string;
@@ -484,6 +513,8 @@ interface components {
                 [key: string]: unknown;
             };
             default?: boolean;
+            /** @enum {string} */
+            taxBehavior?: "auto" | "inclusive" | "exclusive";
         };
         CreateProductRequest: {
             name: string;

package/dist/fetch/index.js

@@ -640,6 +640,31 @@ function createSolvaPayClient(opts) {
       const result = await res.json();
       return result;
     },
+    // POST: /v1/sdk/payment-intents/{paymentIntentId}/business-details
+    async attachBusinessDetails(params) {
+      const url = `${base}/v1/sdk/payment-intents/${params.paymentIntentId}/business-details`;
+      const res = await fetch(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({
+          isBusiness: params.isBusiness,
+          ...params.businessName !== void 0 && { businessName: params.businessName },
+          ...params.country !== void 0 && { country: params.country },
+          ...params.taxId !== void 0 && { taxId: params.taxId },
+          ...params.taxIdType !== void 0 && { taxIdType: params.taxIdType },
+          ...params.customerRef !== void 0 && { customerRef: params.customerRef }
+        })
+      });
+      if (!res.ok) {
+        const error = await res.text();
+        log(`\u274C API Error: ${res.status} - ${error}`);
+        throw new SolvaPayError2(
+          `Attach business details failed (${res.status}): ${error}`,
+          { status: res.status }
+        );
+      }
+      return await res.json();
+    },
     // POST: /v1/sdk/purchases/{purchaseRef}/cancel
     async cancelPurchase(params) {
       const url = `${base}/v1/sdk/purchases/${params.purchaseRef}/cancel`;
@@ -2148,6 +2173,14 @@ function createSolvaPay(config) {
       }
       return apiClient.processPaymentIntent(params);
     },
+    attachBusinessDetails(params) {
+      if (!apiClient.attachBusinessDetails) {
+        throw new SolvaPayError3(
+          "attachBusinessDetails is not available on this API client"
+        );
+      }
+      return apiClient.attachBusinessDetails(params);
+    },
     checkLimits(params) {
       return apiClient.checkLimits(params);
     },
@@ -2387,6 +2420,9 @@ async function getCustomerBalanceCore(request, options = {}) {
 }
 
 // src/helpers/payment.ts
+import {
+  validateBusinessDetails
+} from "@solvapay/core";
 async function createPaymentIntentCore(request, body, options = {}) {
   try {
     if (!body.planRef || !body.productRef) {