@solvapay/server 1.3.0 → 1.4.0-preview-e2cd9bda9dee33e68f6bba7098f7d683e6f1b742

package/dist/index.cjs

@@ -35,6 +35,7 @@ __export(index_exports, {
   TOPUP_BALANCE_POLL_DELAYS_MS: () => TOPUP_BALANCE_POLL_DELAYS_MS,
   VIRTUAL_TOOL_DEFINITIONS: () => VIRTUAL_TOOL_DEFINITIONS,
   activatePlanCore: () => activatePlanCore,
+  attachBusinessDetailsCore: () => attachBusinessDetailsCore,
   buildGateMessage: () => buildGateMessage,
   buildNudgeMessage: () => buildNudgeMessage,
   buildPaywallGate: () => buildPaywallGate,
@@ -76,7 +77,7 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 var import_node_crypto = __toESM(require("crypto"), 1);
-var import_core8 = require("@solvapay/core");
+var import_core9 = require("@solvapay/core");
 
 // src/client.ts
 var import_core = require("@solvapay/core");
@@ -566,6 +567,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_core.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`;
@@ -2089,6 +2115,14 @@ function createSolvaPay(config) {
       }
       return apiClient.processPaymentIntent(params);
     },
+    attachBusinessDetails(params) {
+      if (!apiClient.attachBusinessDetails) {
+        throw new import_core2.SolvaPayError(
+          "attachBusinessDetails is not available on this API client"
+        );
+      }
+      return apiClient.attachBusinessDetails(params);
+    },
     checkLimits(params) {
       return apiClient.checkLimits(params);
     },
@@ -2490,6 +2524,9 @@ async function getCustomerBalanceCore(request, options = {}) {
   }
 }
 
+// src/helpers/payment.ts
+var import_core4 = require("@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];
@@ -2622,6 +2659,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 = (0, import_core4.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) {
@@ -2745,7 +2826,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) {
@@ -2791,7 +2872,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 {
@@ -2859,7 +2940,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 {
@@ -2988,7 +3069,7 @@ async function disableAutoRechargeCore(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);
@@ -3000,7 +3081,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,
@@ -3063,11 +3144,11 @@ async function checkLimitsCore(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,
@@ -3094,7 +3175,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);
@@ -3106,7 +3187,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,
@@ -3254,34 +3335,34 @@ 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 expectedHmac = import_node_crypto.default.createHmac("sha256", secret).update(`${timestamp}.${body}`).digest("hex");
   if (receivedHmac.length !== expectedHmac.length) {
-    throw new import_core8.SolvaPayError("Invalid webhook signature");
+    throw new import_core9.SolvaPayError("Invalid webhook signature");
   }
   const ok = import_node_crypto.default.timingSafeEqual(Buffer.from(expectedHmac), Buffer.from(receivedHmac));
-  if (!ok) throw new import_core8.SolvaPayError("Invalid webhook signature");
+  if (!ok) 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");
   }
 }
 // Annotate the CommonJS export names for ESM import in node:
@@ -3291,6 +3372,7 @@ function verifyWebhook({
   TOPUP_BALANCE_POLL_DELAYS_MS,
   VIRTUAL_TOOL_DEFINITIONS,
   activatePlanCore,
+  attachBusinessDetailsCore,
   buildGateMessage,
   buildNudgeMessage,
   buildPaywallGate,

package/dist/index.d.cts

@@ -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
@@ -3383,6 +3469,7 @@ interface SolvaPayClient {
         customerRef: string;
         planRef?: string;
     }): Promise<ProcessPaymentResult>;
+    attachBusinessDetails?(params: AttachBusinessDetailsParams): Promise<AttachBusinessDetailsResult>;
     getUserInfo?(params: {
         customerRef: string;
         productRef: string;
@@ -4137,6 +4224,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.
      *
@@ -5152,6 +5254,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?: {
@@ -5484,4 +5601,4 @@ declare function verifyWebhook({ body, signature, secret, }: {
     secret: string;
 }): WebhookEvent;
 
-export { type ActivatePlanResult, type AssignCreditsRequest, type AssignCreditsResponse, type AuthenticatedUser, type AutoRechargeConfig, type AutoRechargeDisplayBlock, type AutoRechargeInput, type AutoRechargeResponse, BALANCE_RECONCILE_DELAYS_MS, type ConfigureMcpPlansRequest, type ConfigureMcpPlansResponse, type CreateSolvaPayConfig, type CreditDebitResult, type CreditDebitSkipReason, type CreditDisplayBlock, 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 McpServerLike, 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 ProtectHandlerContext, type PurchaseCheckResult, type RegisterVirtualToolsMcpOptions, type RetryOptions, type SaveAutoRechargeInput, type SaveAutoRechargeResponse, type SdkMerchantResponse, type SdkProductResponse, type ServerClientOptions, type SolvaPay, type SolvaPayClient, TOPUP_BALANCE_POLL_DELAYS_MS, type ToolPlanMappingInput, type TopupProcessResult, type TrackUsageBulkRequest, type TrackUsageBulkResponse, type TrackUsageRequest, type TrackUsageResponse, VIRTUAL_TOOL_DEFINITIONS, type VirtualToolDefinition, type VirtualToolsOptions, 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, createVirtualTools, disableAutoRechargeCore, getAuthenticatedUserCore, getAutoRechargeCore, getCustomerBalanceCore, getMerchantCore, getPaymentMethodCore, getProductCore, getUsageCore, handleRouteError, isErrorResult, isPaywallStructuredContent, jsonSchemaToZodRawShape, listPlansCore, paywallErrorToClientPayload, pollBalanceUntilIncreased, processPaymentIntentCore, processTopupPaymentIntentCore, reactivatePurchaseCore, registerVirtualToolsMcpImpl, saveAutoRechargeCore, syncCustomerCore, trackUsageCore, verifyWebhook, withRetry };
+export { type ActivatePlanResult, type AssignCreditsRequest, type AssignCreditsResponse, type AuthenticatedUser, type AutoRechargeConfig, type AutoRechargeDisplayBlock, type AutoRechargeInput, type AutoRechargeResponse, BALANCE_RECONCILE_DELAYS_MS, type ConfigureMcpPlansRequest, type ConfigureMcpPlansResponse, type CreateSolvaPayConfig, type CreditDebitResult, type CreditDebitSkipReason, type CreditDisplayBlock, 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 McpServerLike, 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 ProtectHandlerContext, type PurchaseCheckResult, type RegisterVirtualToolsMcpOptions, type RetryOptions, type SaveAutoRechargeInput, type SaveAutoRechargeResponse, type SdkMerchantResponse, type SdkProductResponse, type ServerClientOptions, type SolvaPay, type SolvaPayClient, TOPUP_BALANCE_POLL_DELAYS_MS, type ToolPlanMappingInput, type TopupProcessResult, type TrackUsageBulkRequest, type TrackUsageBulkResponse, type TrackUsageRequest, type TrackUsageResponse, VIRTUAL_TOOL_DEFINITIONS, type VirtualToolDefinition, type VirtualToolsOptions, 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, createVirtualTools, disableAutoRechargeCore, getAuthenticatedUserCore, getAutoRechargeCore, getCustomerBalanceCore, getMerchantCore, getPaymentMethodCore, getProductCore, getUsageCore, handleRouteError, isErrorResult, isPaywallStructuredContent, jsonSchemaToZodRawShape, listPlansCore, paywallErrorToClientPayload, pollBalanceUntilIncreased, processPaymentIntentCore, processTopupPaymentIntentCore, reactivatePurchaseCore, registerVirtualToolsMcpImpl, saveAutoRechargeCore, syncCustomerCore, trackUsageCore, verifyWebhook, withRetry };

package/dist/index.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
@@ -3383,6 +3469,7 @@ interface SolvaPayClient {
         customerRef: string;
         planRef?: string;
     }): Promise<ProcessPaymentResult>;
+    attachBusinessDetails?(params: AttachBusinessDetailsParams): Promise<AttachBusinessDetailsResult>;
     getUserInfo?(params: {
         customerRef: string;
         productRef: string;
@@ -4137,6 +4224,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.
      *
@@ -5152,6 +5254,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?: {
@@ -5484,4 +5601,4 @@ declare function verifyWebhook({ body, signature, secret, }: {
     secret: string;
 }): WebhookEvent;
 
-export { type ActivatePlanResult, type AssignCreditsRequest, type AssignCreditsResponse, type AuthenticatedUser, type AutoRechargeConfig, type AutoRechargeDisplayBlock, type AutoRechargeInput, type AutoRechargeResponse, BALANCE_RECONCILE_DELAYS_MS, type ConfigureMcpPlansRequest, type ConfigureMcpPlansResponse, type CreateSolvaPayConfig, type CreditDebitResult, type CreditDebitSkipReason, type CreditDisplayBlock, 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 McpServerLike, 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 ProtectHandlerContext, type PurchaseCheckResult, type RegisterVirtualToolsMcpOptions, type RetryOptions, type SaveAutoRechargeInput, type SaveAutoRechargeResponse, type SdkMerchantResponse, type SdkProductResponse, type ServerClientOptions, type SolvaPay, type SolvaPayClient, TOPUP_BALANCE_POLL_DELAYS_MS, type ToolPlanMappingInput, type TopupProcessResult, type TrackUsageBulkRequest, type TrackUsageBulkResponse, type TrackUsageRequest, type TrackUsageResponse, VIRTUAL_TOOL_DEFINITIONS, type VirtualToolDefinition, type VirtualToolsOptions, 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, createVirtualTools, disableAutoRechargeCore, getAuthenticatedUserCore, getAutoRechargeCore, getCustomerBalanceCore, getMerchantCore, getPaymentMethodCore, getProductCore, getUsageCore, handleRouteError, isErrorResult, isPaywallStructuredContent, jsonSchemaToZodRawShape, listPlansCore, paywallErrorToClientPayload, pollBalanceUntilIncreased, processPaymentIntentCore, processTopupPaymentIntentCore, reactivatePurchaseCore, registerVirtualToolsMcpImpl, saveAutoRechargeCore, syncCustomerCore, trackUsageCore, verifyWebhook, withRetry };
+export { type ActivatePlanResult, type AssignCreditsRequest, type AssignCreditsResponse, type AuthenticatedUser, type AutoRechargeConfig, type AutoRechargeDisplayBlock, type AutoRechargeInput, type AutoRechargeResponse, BALANCE_RECONCILE_DELAYS_MS, type ConfigureMcpPlansRequest, type ConfigureMcpPlansResponse, type CreateSolvaPayConfig, type CreditDebitResult, type CreditDebitSkipReason, type CreditDisplayBlock, 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 McpServerLike, 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 ProtectHandlerContext, type PurchaseCheckResult, type RegisterVirtualToolsMcpOptions, type RetryOptions, type SaveAutoRechargeInput, type SaveAutoRechargeResponse, type SdkMerchantResponse, type SdkProductResponse, type ServerClientOptions, type SolvaPay, type SolvaPayClient, TOPUP_BALANCE_POLL_DELAYS_MS, type ToolPlanMappingInput, type TopupProcessResult, type TrackUsageBulkRequest, type TrackUsageBulkResponse, type TrackUsageRequest, type TrackUsageResponse, VIRTUAL_TOOL_DEFINITIONS, type VirtualToolDefinition, type VirtualToolsOptions, 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, createVirtualTools, disableAutoRechargeCore, getAuthenticatedUserCore, getAutoRechargeCore, getCustomerBalanceCore, getMerchantCore, getPaymentMethodCore, getProductCore, getUsageCore, handleRouteError, isErrorResult, isPaywallStructuredContent, jsonSchemaToZodRawShape, listPlansCore, paywallErrorToClientPayload, pollBalanceUntilIncreased, processPaymentIntentCore, processTopupPaymentIntentCore, reactivatePurchaseCore, registerVirtualToolsMcpImpl, saveAutoRechargeCore, syncCustomerCore, trackUsageCore, verifyWebhook, withRetry };