@payware/mcp-server 1.1.1 → 1.3.0

package/src/isv/poi/index.js

@@ -9,11 +9,14 @@ import { getPOIStatusTool } from './get-status.js';
 import { setPOIPriceTool } from './set-price.js';
 import { cancelPOIPriceTool } from './cancel-price.js';
 import { getPOIQRCodeTool } from './get-qrcode.js';
+import { createPOITool, createPOIBatchTool } from './create.js';
 
 /**
  * All POI tools for ISV
  */
 export const isvPOITools = [
+  createPOITool,
+  createPOIBatchTool,
   listPOIsTool,
   getPOITool,
   getPOIStatusTool,
@@ -23,6 +26,8 @@ export const isvPOITools = [
 ];
 
 export {
+  createPOITool,
+  createPOIBatchTool,
   listPOIsTool,
   getPOITool,
   getPOIStatusTool,

package/src/isv/poi/list-pois.js

@@ -1,6 +1,7 @@
 import axios from 'axios';
 import { createJWTForPartner } from '../../core/auth/jwt-factory.js';
 import { getSandboxUrl, getProductionUrl, getPartnerIdSafe, getPrivateKeySafe } from '../../config/env.js';
+import { apiErrorResult } from '../../shared/api-errors.js';
 
 /**
  * List all POIs for a merchant via ISV authentication
@@ -48,16 +49,7 @@ export async function listPOIs({ merchantPartnerId, oauth2Token, useSandbox = tr
       timestamp: new Date().toISOString()
     };
   } catch (error) {
-    return {
-      success: false,
-      error: {
-        message: error.response?.data?.message || error.message,
-        status: error.response?.status,
-        code: error.response?.data?.code,
-        details: error.response?.data
-      },
-      timestamp: new Date().toISOString()
-    };
+    return apiErrorResult(error);
   }
 }
 

package/src/isv/poi/set-price.js

@@ -1,225 +1,217 @@
-import axios from 'axios';
-import { createJWTForPartner } from '../../core/auth/jwt-factory.js';
-import { getSandboxUrl, getProductionUrl, getPartnerIdSafe, getPrivateKeySafe } from '../../config/env.js';
-
-/**
- * Set price on a POI via ISV authentication
- * @param {Object} params - Parameters for set price request
- * @returns {Object} Set price response
- */
-export async function setPOIPrice({ poiId, amount, currency, reasonL1, reasonL2, timeToLive, callbackUrl, passbackParams, merchantPartnerId, oauth2Token, useSandbox = true }) {
-  if (!poiId) {
-    throw new Error('POI ID is required');
-  }
-
-  if (!amount) {
-    throw new Error('Amount is required');
-  }
-
-  if (!currency) {
-    throw new Error('Currency is required');
-  }
-
-  if (!reasonL1) {
-    throw new Error('Reason (reasonL1) is required');
-  }
-
-  if (!merchantPartnerId) {
-    throw new Error('Merchant Partner ID is required for ISV operations');
-  }
-
-  if (!oauth2Token) {
-    throw new Error('OAuth2 token is required for ISV operations');
-  }
-
-  const isvPartnerId = getPartnerIdSafe();
-  const privateKey = getPrivateKeySafe(useSandbox);
-
-  // Build request body
-  const requestBody = {
-    amount: String(amount),
-    currency: currency.toUpperCase(),
-    reasonL1
-  };
-
-  if (reasonL2) requestBody.reasonL2 = reasonL2;
-  if (timeToLive) requestBody.timeToLive = timeToLive;
-  if (callbackUrl) requestBody.callbackUrl = callbackUrl;
-  if (passbackParams) requestBody.passbackParams = passbackParams;
-
-  const jwtData = await createJWTForPartner({
-    partnerId: isvPartnerId,
-    privateKey,
-    requestBody,
-    merchantId: merchantPartnerId,
-    oauth2Token
-  });
-
-  const headers = {
-    'Authorization': `Bearer ${jwtData.token}`,
-    'Content-Type': 'application/json',
-    'Api-Version': '1'
-  };
-
-  try {
-    const baseUrl = useSandbox ? getSandboxUrl() : getProductionUrl();
-    const response = await axios.put(`${baseUrl}/poi/${poiId}/price`, requestBody, { headers });
-
-    return {
-      success: true,
-      result: response.data,
-      requestId: response.headers['x-request-id'],
-      timestamp: new Date().toISOString()
-    };
-  } catch (error) {
-    return {
-      success: false,
-      error: {
-        message: error.response?.data?.message || error.message,
-        status: error.response?.status,
-        code: error.response?.data?.code,
-        details: error.response?.data
-      },
-      timestamp: new Date().toISOString()
-    };
-  }
-}
-
-/**
- * Set POI price tool implementation for ISV
- */
-export const setPOIPriceTool = {
-  name: "payware_poi_set_price",
-  description: `Set a pending price on a POI for customer payment.
-
-**ISV Authentication:** Uses ISV JWT with merchant partner ID and OAuth2 token.
-**Endpoint:** PUT /poi/{poiId}/price
-**Use Case:** Set the amount a customer should pay when they scan the POI.
-
-The POI will transition to READY state and wait for a customer scan until the TTL expires.
-
-**Required:** POI ID, amount, currency, reason, Merchant Partner ID, and OAuth2 token.`,
-
-  inputSchema: {
-    type: "object",
-    required: ["poiId", "amount", "currency", "reasonL1", "merchantPartnerId", "oauth2Token"],
-    properties: {
-      poiId: {
-        type: "string",
-        description: "The POI identifier (format: pi + 8 alphanumeric chars, e.g., piABC12345)"
-      },
-      amount: {
-        type: "string",
-        description: "Payment amount (e.g., '25.50')"
-      },
-      currency: {
-        type: "string",
-        description: "ISO 4217 currency code (e.g., 'EUR', 'USD', 'BGN')"
-      },
-      reasonL1: {
-        type: "string",
-        description: "Payment description (e.g., 'Table 5', 'Order #123')"
-      },
-      reasonL2: {
-        type: "string",
-        description: "Additional description (optional)"
-      },
-      timeToLive: {
-        type: "integer",
-        description: "Seconds until price expires (60-600, default: 120)"
-      },
-      callbackUrl: {
-        type: "string",
-        description: "Override callback URL for this payment (optional)"
-      },
-      passbackParams: {
-        type: "string",
-        description: "Data to pass back in callback (optional, max 200 chars)"
-      },
-      merchantPartnerId: {
-        type: "string",
-        description: "Partner ID of the target merchant (8 alphanumeric characters)"
-      },
-      oauth2Token: {
-        type: "string",
-        description: "OAuth2 access token obtained from the merchant"
-      },
-      useSandbox: {
-        type: "boolean",
-        description: "Use sandbox environment for testing",
-        default: true
-      }
-    }
-  },
-
-  async handler(args) {
-    const { poiId, amount, currency, reasonL1, reasonL2, timeToLive, callbackUrl, passbackParams, merchantPartnerId, oauth2Token, useSandbox = true } = args;
-
-    if (!poiId) throw new Error("POI ID is required");
-    if (!amount) throw new Error("Amount is required");
-    if (!currency) throw new Error("Currency is required");
-    if (!reasonL1) throw new Error("Reason (reasonL1) is required");
-    if (!merchantPartnerId) throw new Error("Merchant Partner ID is required");
-    if (!oauth2Token) throw new Error("OAuth2 token is required");
-
-    const result = await setPOIPrice({
-      poiId, amount, currency, reasonL1, reasonL2, timeToLive, callbackUrl, passbackParams,
-      merchantPartnerId, oauth2Token, useSandbox
-    });
-
-    if (result.success) {
-      const data = result.result;
-
-      return {
-        content: [{
-          type: "text",
-          text: `✅ **Price Set Successfully**
-
-**POI ID:** ${data.poiId || poiId}
-**Status:** 🟡 ${data.status || 'READY'}
-
-**Payment Details:**
-- Amount: **${data.amount || amount} ${data.currency || currency}**
-- Reason: ${reasonL1}${reasonL2 ? ` - ${reasonL2}` : ''}
-
-**Session:**
-- Token: ${data.sessionToken || 'N/A'}
-- Expires: ${data.sessionExpiresAt || 'N/A'}
-
-**Next Steps:**
-1. Customer scans the POI (QR code, NFC tag, or barcode)
-2. Customer sees the amount and confirms payment
-3. You receive a callback when payment completes
-
-**ISV -> Merchant:** ${getPartnerIdSafe()} -> ${merchantPartnerId}
-**Request ID:** ${result.requestId || 'N/A'}
-**Timestamp:** ${result.timestamp}`
-        }]
-      };
-    } else {
-      return {
-        content: [{
-          type: "text",
-          text: `❌ **Failed to Set Price**
-
-**POI ID:** ${poiId}
-**Attempted:** ${amount} ${currency}
-
-**Error:** ${result.error.message}
-**Code:** ${result.error.code || 'N/A'}
-**Status:** ${result.error.status || 'N/A'}
-
-**Common Issues:**
-- INVALID_POI_ID (400): POI ID format invalid (must be pi + 8 alphanumeric chars)
-- POI_NOT_FOUND (404): POI doesn't exist or doesn't belong to merchant
-- POI_DISABLED (409): POI is disabled
-- POI_NOT_IDLE (409): POI already has a pending price (cancel it first)
-- INVALID_AMOUNT (400): Check amount format (e.g., '25.50')
-- UNKNOWN_CURRENCY (400): Invalid currency code
-
-**Timestamp:** ${result.timestamp}`
-        }]
-      };
-    }
-  }
-};
+import axios from 'axios';
+import { createJWTForPartner } from '../../core/auth/jwt-factory.js';
+import { getSandboxUrl, getProductionUrl, getPartnerIdSafe, getPrivateKeySafe } from '../../config/env.js';
+import { apiErrorResult } from '../../shared/api-errors.js';
+
+/**
+ * Set price on a POI via ISV authentication
+ * @param {Object} params - Parameters for set price request
+ * @returns {Object} Set price response
+ */
+export async function setPOIPrice({ poiId, amount, currency, reasonL1, reasonL2, timeToLive, callbackUrl, passbackParams, merchantPartnerId, oauth2Token, useSandbox = true }) {
+  if (!poiId) {
+    throw new Error('POI ID is required');
+  }
+
+  if (!amount) {
+    throw new Error('Amount is required');
+  }
+
+  if (!currency) {
+    throw new Error('Currency is required');
+  }
+
+  if (!reasonL1) {
+    throw new Error('Reason (reasonL1) is required');
+  }
+
+  if (!merchantPartnerId) {
+    throw new Error('Merchant Partner ID is required for ISV operations');
+  }
+
+  if (!oauth2Token) {
+    throw new Error('OAuth2 token is required for ISV operations');
+  }
+
+  const isvPartnerId = getPartnerIdSafe();
+  const privateKey = getPrivateKeySafe(useSandbox);
+
+  // Build request body
+  const requestBody = {
+    amount: String(amount),
+    currency: currency.toUpperCase(),
+    reasonL1
+  };
+
+  if (reasonL2) requestBody.reasonL2 = reasonL2;
+  if (timeToLive) requestBody.timeToLive = timeToLive;
+  if (callbackUrl) requestBody.callbackUrl = callbackUrl;
+  if (passbackParams) requestBody.passbackParams = passbackParams;
+
+  const jwtData = await createJWTForPartner({
+    partnerId: isvPartnerId,
+    privateKey,
+    requestBody,
+    merchantId: merchantPartnerId,
+    oauth2Token
+  });
+
+  const headers = {
+    'Authorization': `Bearer ${jwtData.token}`,
+    'Content-Type': 'application/json',
+    'Api-Version': '1'
+  };
+
+  try {
+    const baseUrl = useSandbox ? getSandboxUrl() : getProductionUrl();
+    const response = await axios.put(`${baseUrl}/poi/${poiId}/price`, requestBody, { headers });
+
+    return {
+      success: true,
+      result: response.data,
+      requestId: response.headers['x-request-id'],
+      timestamp: new Date().toISOString()
+    };
+  } catch (error) {
+    return apiErrorResult(error);
+  }
+}
+
+/**
+ * Set POI price tool implementation for ISV
+ */
+export const setPOIPriceTool = {
+  name: "payware_poi_set_price",
+  description: `Set a pending price on a POI for customer payment.
+
+**ISV Authentication:** Uses ISV JWT with merchant partner ID and OAuth2 token.
+**Endpoint:** PUT /poi/{poiId}/price
+**Use Case:** Set the amount a customer should pay when they scan the POI.
+
+The POI will transition to READY state and wait for a customer scan until the TTL expires.
+
+**Required:** POI ID, amount, currency, reason, Merchant Partner ID, and OAuth2 token.`,
+
+  inputSchema: {
+    type: "object",
+    required: ["poiId", "amount", "currency", "reasonL1", "merchantPartnerId", "oauth2Token"],
+    properties: {
+      poiId: {
+        type: "string",
+        description: "The POI identifier (format: pi + 8 alphanumeric chars, e.g., piABC12345)"
+      },
+      amount: {
+        type: "string",
+        description: "Payment amount (e.g., '25.50')"
+      },
+      currency: {
+        type: "string",
+        description: "ISO 4217 currency code (e.g., 'EUR', 'USD', 'GBP')"
+      },
+      reasonL1: {
+        type: "string",
+        description: "Payment description (e.g., 'Table 5', 'Order #123')"
+      },
+      reasonL2: {
+        type: "string",
+        description: "Additional description (optional)"
+      },
+      timeToLive: {
+        type: "integer",
+        description: "Seconds until price expires (60-600, default: 120)"
+      },
+      callbackUrl: {
+        type: "string",
+        description: "Override callback URL for this payment (optional)"
+      },
+      passbackParams: {
+        type: "string",
+        description: "Data to pass back in callback (optional, max 200 chars)"
+      },
+      merchantPartnerId: {
+        type: "string",
+        description: "Partner ID of the target merchant (8 alphanumeric characters)"
+      },
+      oauth2Token: {
+        type: "string",
+        description: "OAuth2 access token obtained from the merchant"
+      },
+      useSandbox: {
+        type: "boolean",
+        description: "Use sandbox environment for testing",
+        default: true
+      }
+    }
+  },
+
+  async handler(args) {
+    const { poiId, amount, currency, reasonL1, reasonL2, timeToLive, callbackUrl, passbackParams, merchantPartnerId, oauth2Token, useSandbox = true } = args;
+
+    if (!poiId) throw new Error("POI ID is required");
+    if (!amount) throw new Error("Amount is required");
+    if (!currency) throw new Error("Currency is required");
+    if (!reasonL1) throw new Error("Reason (reasonL1) is required");
+    if (!merchantPartnerId) throw new Error("Merchant Partner ID is required");
+    if (!oauth2Token) throw new Error("OAuth2 token is required");
+
+    const result = await setPOIPrice({
+      poiId, amount, currency, reasonL1, reasonL2, timeToLive, callbackUrl, passbackParams,
+      merchantPartnerId, oauth2Token, useSandbox
+    });
+
+    if (result.success) {
+      const data = result.result;
+
+      return {
+        content: [{
+          type: "text",
+          text: `✅ **Price Set Successfully**
+
+**POI ID:** ${data.poiId || poiId}
+**Status:** 🟡 ${data.status || 'READY'}
+
+**Payment Details:**
+- Amount: **${data.amount || amount} ${data.currency || currency}**
+- Reason: ${reasonL1}${reasonL2 ? ` - ${reasonL2}` : ''}
+
+**Session:**
+- Token: ${data.sessionToken || 'N/A'}
+- Expires: ${data.sessionExpiresAt || 'N/A'}
+
+**Next Steps:**
+1. Customer scans the POI (QR code, NFC tag, or barcode)
+2. Customer sees the amount and confirms payment
+3. You receive a callback when payment completes
+
+**ISV -> Merchant:** ${getPartnerIdSafe()} -> ${merchantPartnerId}
+**Request ID:** ${result.requestId || 'N/A'}
+**Timestamp:** ${result.timestamp}`
+        }]
+      };
+    } else {
+      return {
+        content: [{
+          type: "text",
+          text: `❌ **Failed to Set Price**
+
+**POI ID:** ${poiId}
+**Attempted:** ${amount} ${currency}
+
+**Error:** ${result.error.message}
+**Code:** ${result.error.code || 'N/A'}
+**Status:** ${result.error.status || 'N/A'}
+
+**Common Issues:**
+- INVALID_POI_ID (400): POI ID format invalid (must be pi + 8 alphanumeric chars)
+- POI_NOT_FOUND (404): POI doesn't exist or doesn't belong to merchant
+- POI_DISABLED (409): POI is disabled
+- POI_NOT_IDLE (409): POI already has a pending price (cancel it first)
+- INVALID_AMOUNT (400): Check amount format (e.g., '25.50')
+- UNKNOWN_CURRENCY (400): Invalid currency code
+
+**Timestamp:** ${result.timestamp}`
+        }]
+      };
+    }
+  }
+};