@payware/mcp-server 1.0.0

package/src/merchant/deep-links/get-product-link.js

@@ -0,0 +1,134 @@
+import { getProductDeepLink } from '../../shared/deep-links/api.js';
+import { getPartnerIdSafe, getPrivateKeySafe } from '../../config/env.js';
+
+/**
+ * Get deep link for a merchant product
+ */
+export const getProductLinkTool = {
+  name: "payware_deep_links_get_product_link",
+  description: `Get an active deep link for a product. Returns a clickable URL that redirects to the payware mobile app.
+
+**Deep Link Format:**
+- Web URL: https://url.payware.eu/{productId}
+- Mobile Redirect: payware://{productId}
+
+**Use Cases:**
+- Mobile-only e-commerce product references
+- Advertisement links to products
+- Product sharing via messaging
+
+**Important Notes:**
+- Deep links are only supported in production environment
+- Link expiration is synchronized with the referenced product
+- Traditional deep links that route to app content when app is installed`,
+
+  inputSchema: {
+    type: "object",
+    properties: {
+      productId: {
+        type: "string",
+        description: "The product identifier (e.g., 'pr7e4rCToG')",
+        pattern: "^[a-zA-Z0-9]+$"
+      },
+      partnerId: {
+        type: "string",
+        description: "Partner ID from payware dashboard. Uses PAYWARE_PARTNER_ID env var as default.",
+        default: getPartnerIdSafe()
+      },
+      privateKey: {
+        type: "string",
+        description: "RSA private key for JWT token creation. Uses environment-specific private key as default.",
+        default: getPrivateKeySafe()
+      }
+    },
+    required: ["productId"]
+  },
+
+  async handler(args) {
+    const {
+      productId,
+      partnerId = getPartnerIdSafe(),
+      privateKey = getPrivateKeySafe()
+    } = args;
+
+    if (!productId) {
+      throw new Error("productId is required");
+    }
+
+    if (!partnerId) {
+      throw new Error("Partner ID is required. Provide via 'partnerId' parameter or set PAYWARE_PARTNER_ID environment variable.");
+    }
+
+    if (!privateKey) {
+      throw new Error("Private key is required. Provide via 'privateKey' parameter or set PAYWARE_PRIVATE_KEY environment variable.");
+    }
+
+    try {
+      const result = await getProductDeepLink({
+        productId,
+        partnerType: 'merchant',
+        partnerId,
+        privateKey
+      });
+
+      // Extract the URL - API returns either string directly or object with link property
+      const linkUrl = typeof result.data === 'string' ? result.data : (result.data.link || result.data)
+
+      return {
+        content: [{
+          type: "text",
+          text: `🔗 **Product Deep Link Retrieved**
+
+**Deep Link Details:**
+- Product ID: ${productId}
+- Web URL: ${linkUrl}
+- Mobile Redirect: payware://${productId}
+
+**Link Information:**
+- Status: Active
+- Expiration: Synchronized with product
+- Platform: Production only
+
+**API Response:**
+\`\`\`json
+${JSON.stringify(result.data, null, 2)}
+\`\`\`
+
+**API Call Details:**
+- Endpoint: GET ${result.requestInfo.url}
+- Status: ${result.requestInfo.statusCode}
+- Method: ${result.requestInfo.method}
+
+**Usage:**
+1. Share the web URL: \`${linkUrl}\`
+2. On mobile devices, it will redirect to: \`payware://${productId}\`
+3. Link expires when the product expires
+4. Recreate if product is updated`
+        }]
+      };
+    } catch (error) {
+      return {
+        content: [{
+          type: "text",
+          text: `❌ **Failed to Get Product Deep Link**
+
+**Error Details:**
+- Product ID: ${productId}
+- Message: ${error.message}
+
+**Common Issues:**
+1. **Product not found**: Check if product exists and is not expired
+2. **Authentication failed**: Verify partner ID and private key
+3. **Sandbox environment**: Deep links are production-only
+4. **Invalid product ID**: Ensure product ID format is correct
+
+**Troubleshooting:**
+1. Verify product exists in your payware dashboard
+2. Check if running in production environment
+3. Ensure JWT authentication is working
+4. Confirm product is active and not expired`
+        }]
+      };
+    }
+  }
+};

package/src/merchant/deep-links/get-transaction-link.js

@@ -0,0 +1,134 @@
+import { getTransactionDeepLink } from '../../shared/deep-links/api.js';
+import { getPartnerIdSafe, getPrivateKeySafe } from '../../config/env.js';
+
+/**
+ * Get deep link for a merchant transaction
+ */
+export const getTransactionLinkTool = {
+  name: "payware_deep_links_get_transaction_link",
+  description: `Get an active deep link for a transaction. Returns a clickable URL that redirects to the payware mobile app.
+
+**Deep Link Format:**
+- Web URL: https://url.payware.eu/{transactionId}
+- Mobile Redirect: payware://{transactionId}
+
+**Use Cases:**
+- P2P payments via messaging services
+- Mobile-only e-commerce payments
+- Advertisement references
+
+**Important Notes:**
+- Deep links are only supported in production environment
+- Link expiration is synchronized with the referenced transaction
+- Traditional deep links that route to app content when app is installed`,
+
+  inputSchema: {
+    type: "object",
+    properties: {
+      transactionId: {
+        type: "string",
+        description: "The transaction identifier (e.g., 'pw7e4rCToG')",
+        pattern: "^[a-zA-Z0-9]+$"
+      },
+      partnerId: {
+        type: "string",
+        description: "Partner ID from payware dashboard. Uses PAYWARE_PARTNER_ID env var as default.",
+        default: getPartnerIdSafe()
+      },
+      privateKey: {
+        type: "string",
+        description: "RSA private key for JWT token creation. Uses environment-specific private key as default.",
+        default: getPrivateKeySafe()
+      }
+    },
+    required: ["transactionId"]
+  },
+
+  async handler(args) {
+    const {
+      transactionId,
+      partnerId = getPartnerIdSafe(),
+      privateKey = getPrivateKeySafe()
+    } = args;
+
+    if (!transactionId) {
+      throw new Error("transactionId is required");
+    }
+
+    if (!partnerId) {
+      throw new Error("Partner ID is required. Provide via 'partnerId' parameter or set PAYWARE_PARTNER_ID environment variable.");
+    }
+
+    if (!privateKey) {
+      throw new Error("Private key is required. Provide via 'privateKey' parameter or set PAYWARE_PRIVATE_KEY environment variable.");
+    }
+
+    try {
+      const result = await getTransactionDeepLink({
+        transactionId,
+        partnerType: 'merchant',
+        partnerId,
+        privateKey
+      });
+
+      // Extract the URL - API returns either string directly or object with link property
+      const linkUrl = typeof result.data === 'string' ? result.data : (result.data.link || result.data)
+
+      return {
+        content: [{
+          type: "text",
+          text: `🔗 **Transaction Deep Link Retrieved**
+
+**Deep Link Details:**
+- Transaction ID: ${transactionId}
+- Web URL: ${linkUrl}
+- Mobile Redirect: payware://${transactionId}
+
+**Link Information:**
+- Status: Active
+- Expiration: Synchronized with transaction
+- Platform: Production only
+
+**API Response:**
+\`\`\`json
+${JSON.stringify(result.data, null, 2)}
+\`\`\`
+
+**API Call Details:**
+- Endpoint: GET ${result.requestInfo.url}
+- Status: ${result.requestInfo.statusCode}
+- Method: ${result.requestInfo.method}
+
+**Usage:**
+1. Share the web URL: \`${linkUrl}\`
+2. On mobile devices, it will redirect to: \`payware://${transactionId}\`
+3. Link expires when the transaction expires
+4. Recreate if transaction is extended`
+        }]
+      };
+    } catch (error) {
+      return {
+        content: [{
+          type: "text",
+          text: `❌ **Failed to Get Transaction Deep Link**
+
+**Error Details:**
+- Transaction ID: ${transactionId}
+- Message: ${error.message}
+
+**Common Issues:**
+1. **Transaction not found**: Check if transaction exists and is not expired
+2. **Authentication failed**: Verify partner ID and private key
+3. **Sandbox environment**: Deep links are production-only
+4. **Invalid transaction ID**: Ensure transaction ID format is correct
+
+**Troubleshooting:**
+1. Verify transaction exists using \`payware_transactions_get_transaction_status\`
+2. Check if running in production environment
+3. Ensure JWT authentication is working
+4. Confirm transaction is not expired`
+        }]
+      };
+    }
+  }
+};

package/src/merchant/deep-links/index.js

@@ -0,0 +1,23 @@
+/**
+ * Merchant Deep Links Tools
+ * Deep link management for merchants
+ */
+
+import { getTransactionLinkTool } from './get-transaction-link.js';
+import { getProductLinkTool } from './get-product-link.js';
+import { deleteTransactionLinkTool } from './delete-transaction-link.js';
+import { deleteProductLinkTool } from './delete-product-link.js';
+
+export const merchantDeepLinksTools = [
+  getTransactionLinkTool,
+  getProductLinkTool,
+  deleteTransactionLinkTool,
+  deleteProductLinkTool
+];
+
+export {
+  getTransactionLinkTool,
+  getProductLinkTool,
+  deleteTransactionLinkTool,
+  deleteProductLinkTool
+};

package/src/merchant/index.js

@@ -0,0 +1,92 @@
+/**
+ * Merchant partner tools registry
+ * Tools available for merchants accepting payments directly
+ */
+
+// Transaction tools
+import { createTransactionTool } from './transactions/create-transaction.js';
+import { getTransactionStatusTool } from './transactions/get-status.js';
+import { cancelTransactionTool } from './transactions/cancel-transaction.js';
+import { getTransactionHistoryTool } from './transactions/transaction-history.js';
+import { processTransactionTool } from './transactions/process-transaction.js';
+import { simulateCallbackTool } from './transactions/simulate-callback.js';
+
+// Data tools
+import { merchantDataTools } from './data/index.js';
+
+// Product tools
+import { merchantProductTools } from './products/index.js';
+
+// Deep links tools
+import { merchantDeepLinksTools } from './deep-links/index.js';
+
+// Shared utility tools
+import { getServerInfoTool } from '../utils/server-info.js';
+
+// Import shared tools
+import { sharedTools } from '../shared/index.js';
+
+/**
+ * All merchant-specific tools
+ */
+export const merchantTools = [
+  // Shared tools (authentication, utilities, etc.)
+  ...sharedTools,
+
+  // Transaction management
+  createTransactionTool,
+  getTransactionStatusTool,
+  cancelTransactionTool,
+  getTransactionHistoryTool,
+  processTransactionTool,
+  simulateCallbackTool,
+
+  // Data management
+  ...merchantDataTools,
+
+  // Product management
+  ...merchantProductTools,
+
+  // Deep links management
+  ...merchantDeepLinksTools
+];
+
+/**
+ * Get tools for merchant partner type
+ * @returns {Array} Array of merchant tools with proper grouping names
+ */
+export function getMerchantTools() {
+  return merchantTools.map(tool => {
+    let newName = tool.name;
+
+    // Authentication tools use authentication grouping
+    if (tool.name.startsWith('payware_authentication_')) {
+      newName = tool.name; // Keep authentication grouping
+    }
+    // Utility tools keep their utils grouping
+    else if (tool.name.startsWith('payware_utils_')) {
+      newName = tool.name; // Keep utils grouping
+    }
+    // Operations tools (previously transactions) keep operations grouping
+    else if (tool.name.startsWith('payware_operations_')) {
+      newName = tool.name; // Keep operations grouping
+    }
+    // Data tools keep their data grouping
+    else if (tool.name.startsWith('payware_data_')) {
+      newName = tool.name; // Keep data grouping
+    }
+    // Product tools keep their products grouping
+    else if (tool.name.startsWith('payware_products_')) {
+      newName = tool.name; // Keep products grouping
+    }
+    // Deep links tools keep their deep_links grouping
+    else if (tool.name.startsWith('payware_deep_links_')) {
+      newName = tool.name; // Keep deep_links grouping
+    }
+
+    return {
+      ...tool,
+      name: newName
+    };
+  });
+}