@payware/mcp-server 1.0.0 → 1.1.1

package/src/merchant/transactions/simulate-callback.js

@@ -15,6 +15,7 @@ export function generateMockCallback(transactionId, status = 'CONFIRMED', option
     currency = 'EUR',
     payerAmount = null,
     payeeAmount = null,
+    paymentMethod = null,
     statusMessage = null,
     passbackParams = null
   } = options;
@@ -38,6 +39,7 @@ export function generateMockCallback(transactionId, status = 'CONFIRMED', option
     currency,
     status,
     statusMessage,
+    ...(paymentMethod && { paymentMethod }),
     created: currentTime - 300000, // Created 5 minutes ago (milliseconds)
     ...(status !== 'EXPIRED' && { finalized: currentTime })
   };
@@ -152,6 +154,11 @@ export const simulateCallbackTool = {
       statusMessage: {
         type: "string",
         description: "Custom status message for the transaction callback"
+      },
+      paymentMethod: {
+        type: "string",
+        enum: ["A2A", "CARD_FUNDED", "BNPL", "INSTANT_CREDIT"],
+        description: "Payment method chosen by customer. A2A = direct transfer. CARD_FUNDED = card-linked account. BNPL = buy now pay later. INSTANT_CREDIT = credit line."
       }
     },
     required: ["transactionId"],
@@ -166,7 +173,8 @@ export const simulateCallbackTool = {
       amount = '57.60',
       currency = 'EUR',
       fee = '0.00',
-      statusMessage
+      statusMessage,
+      paymentMethod
     } = args;
     
     if (!transactionId) {
@@ -178,7 +186,8 @@ export const simulateCallbackTool = {
       amount,
       currency,
       fee,
-      statusMessage
+      statusMessage,
+      paymentMethod
     });
     
     // Simulate callback delivery if URL provided

package/src/merchant/transactions/transaction-history.js

@@ -161,7 +161,7 @@ export const getTransactionHistoryTool = {
 - ID: ${result.transaction.transactionId || 'N/A'}
 - Initiated By: ${result.transaction.initiatedBy || 'N/A'}
 - Amount: ${result.transaction.amount ? `${result.transaction.amount} ${result.transaction.currency}` : 'N/A'}
-- Reason: ${result.transaction.reasonL1 || 'N/A'}${result.transaction.reasonL2 ? ` (${result.transaction.reasonL2})` : ''}
+${result.transaction.paymentMethod ? `- Payment Method: ${result.transaction.paymentMethod}\n` : ''}- Reason: ${result.transaction.reasonL1 || 'N/A'}${result.transaction.reasonL2 ? ` (${result.transaction.reasonL2})` : ''}
 
 **Parties:**
 - Payee: ${result.transaction.payeeFriendlyName || 'N/A'} (${result.transaction.payeeAccount || 'N/A'})

package/src/payment-institution/data/index.js

@@ -11,6 +11,9 @@ import {
   downloadExport,
   cancelReport,
   cancelExport,
+  listReports,
+  getReportRequests,
+  getExportList,
   REPORT_TYPES,
   EXPORT_FORMATS,
   LOCALES
@@ -218,6 +221,23 @@ This feature is only available in the production environment, not in sandbox.
 };
 
 // Create all other PI data tools
+export const listReportsTool = createPIDataTool('list_reports', listReports, 'List All Available Reports', {});
+
+export const getReportRequestsTool = createPIDataTool('get_report_requests', getReportRequests, 'Get Report Request History', {
+  reportId: {
+    type: "string",
+    description: "The report unit ID (path) to get execution history for (e.g., '/processedTransactions')",
+    enum: Object.values(REPORT_TYPES)
+  }
+});
+
+export const getExportListTool = createPIDataTool('get_export_list', getExportList, 'Get Export List for Request', {
+  requestId: {
+    type: "string",
+    description: "The request ID (UUID) to get exports for"
+  }
+});
+
 export const getReportStatusTool = createPIDataTool('get_report_status', getReportStatus, 'Get Report Status', {
   requestId: {
     type: "string",
@@ -270,9 +290,12 @@ export const cancelExportTool = createPIDataTool('cancel_export', cancelExport,
  * All Payment Institution data tools
  */
 export const paymentInstitutionDataTools = [
+  listReportsTool,
   generateReportTool,
+  getReportRequestsTool,
   getReportStatusTool,
   exportReportTool,
+  getExportListTool,
   getExportStatusTool,
   downloadExportTool,
   cancelReportTool,

package/src/payment-institution/deep-links/delete-transaction-link.js

@@ -76,7 +76,7 @@ export const deleteTransactionLinkTool = {
 **Deletion Details:**
 - Transaction ID: ${transactionId}
 - Status: Successfully deleted
-- Link URL: https://url.payware.eu/${transactionId} (now inactive)
+- Link URL: https://go.payware.eu/${transactionId} (now inactive)
 
 **Payment Institution Info:**
 - Partner ID: ${partnerId}

package/src/payment-institution/deep-links/get-transaction-link.js

@@ -9,7 +9,7 @@ export const getTransactionLinkTool = {
   description: `Get an active deep link for a transaction where the payment institution acts as source (SRC) or destination (DST). Returns a clickable URL that redirects to the payware mobile app.
 
 **Deep Link Format:**
-- Web URL: https://url.payware.eu/{transactionId}
+- Web URL: https://go.payware.eu/{transactionId}
 - Mobile Redirect: payware://{transactionId}
 
 **Use Cases:**

package/src/payment-institution/transactions/create-pi-transaction.js

@@ -407,6 +407,8 @@ export const createPITransactionTool = {
       useSandbox
     });
 
+    const baseUrl = useSandbox ? getSandboxUrl() : getProductionUrl();
+
     if (result.success) {
       const roleDescription = role === 'SRC' ? 'Payer (Source)' : 'Payee (Destination)';
       const status = result.transaction.status || 'ACTIVE';

package/src/payment-institution/transactions/finalize-transaction.js

@@ -263,6 +263,7 @@ export const finalizeTransactionTool = {
 ${statusMessage ? `- Status Message: ${statusMessage}` : ''}
 ${amount ? `- Final Amount: ${amount} ${currency}` : ''}
 ${fee !== undefined ? `- Fee Collected: ${fee} ${currency}` : ''}
+${result.transaction.paymentMethod ? `- Payment Method: ${result.transaction.paymentMethod}` : ''}
 
 **Transaction Response:**
 \`\`\`json

package/src/payment-institution/transactions/get-transaction-history.js

@@ -166,7 +166,7 @@ ${tx.statusMessage ? `- Status Message: ${tx.statusMessage}` : ''}
 
 **Transaction Details:**
 - Amount: ${tx.amount || 'N/A'} ${tx.currency || 'N/A'}
-- Reason L1: ${tx.reasonL1 || 'N/A'}
+${tx.paymentMethod ? `- Payment Method: ${tx.paymentMethod}\n` : ''}- Reason L1: ${tx.reasonL1 || 'N/A'}
 ${tx.reasonL2 ? `- Reason L2: ${tx.reasonL2}` : ''}
 
 **Payee Information:**

package/src/payment-institution/transactions/get-transaction-status.js

@@ -156,7 +156,7 @@ export const getPITransactionStatusTool = {
 
 **Transaction Details:**
 - Amount: ${tx.amount || 'N/A'} ${tx.currency || 'N/A'}
-- Reason L1: ${tx.reasonL1 || 'N/A'}
+${tx.paymentMethod ? `- Payment Method: ${tx.paymentMethod}\n` : ''}- Reason L1: ${tx.reasonL1 || 'N/A'}
 ${tx.reasonL2 ? `- Reason L2: ${tx.reasonL2}` : ''}
 
 **Payee Information:**

package/src/payment-institution/transactions/process-pi-transaction.js

@@ -24,6 +24,8 @@ export async function processPITransaction({
   privateKey,
   // Delivery address for SHIPPABLE transactions
   deliveryAddress,
+  // Payment method for POI transactions (Payment Choice Architecture)
+  paymentMethod,
   useSandbox = true
 }) {
   if (!transactionId) {
@@ -56,6 +58,7 @@ export async function processPITransaction({
     friendlyName,
     ...(callbackUrl && { callbackUrl }),
     ...(passbackParams && { passbackParams }),
+    ...(paymentMethod && { paymentMethod }),
     trData: {
       ...(amount !== undefined && { amount: amount.toString() }),
       currency,
@@ -213,6 +216,12 @@ export const processPITransactionTool = {
         description: "RSA private key for JWT token creation. Uses environment-specific private key as default.",
         default: getPrivateKeySafe()
       },
+      // Payment method for POI transactions
+      paymentMethod: {
+        type: "string",
+        enum: ["A2A", "CARD_FUNDED", "BNPL", "INSTANT_CREDIT"],
+        description: "Payment method chosen by customer (for POI transactions only). A2A = direct transfer (lower fee, no rewards). CARD_FUNDED = card-linked account (higher fee, rewards eligible). BNPL = buy now pay later (installments). INSTANT_CREDIT = credit line approved at purchase."
+      },
       // Delivery address for SHIPPABLE transactions
       deliveryAddress: {
         type: "object",
@@ -290,6 +299,7 @@ export const processPITransactionTool = {
       timeToLive,
       partnerId = getPartnerIdSafe(),
       privateKey = getPrivateKeySafe(args.useSandbox ?? true),
+      paymentMethod,
       deliveryAddress,
       useSandbox = true
     } = args;
@@ -335,6 +345,7 @@ export const processPITransactionTool = {
       timeToLive,
       partnerId,
       privateKey,
+      paymentMethod,
       deliveryAddress,
       useSandbox
     });
@@ -353,6 +364,7 @@ export const processPITransactionTool = {
 - Friendly Name: ${friendlyName}
 ${amount ? `- Amount: ${amount} ${currency}` : ''}
 ${reasonL1 ? `- Reason: ${reasonL1}${reasonL2 ? ` (${reasonL2})` : ''}` : ''}
+${paymentMethod ? `- Payment Method: ${paymentMethod}` : ''}
 ${timeToLive ? `- Time to Live: ${timeToLive} seconds` : ''}
 ${callbackUrl ? `- Callback URL: ${callbackUrl}` : ''}
 ${passbackParams ? `- Passback Params: ${passbackParams}` : ''}

package/src/payment-institution/transactions/simulate-pi-callback.js

@@ -27,6 +27,7 @@ export function generateMockPICallback(transactionId, callbackType = 'TRANSACTIO
     timeToLive = 600,
     initiatedBy = 'PEER',
     transactionType = 'DEFAULT',
+    paymentMethod = null,
     status = 'CONFIRMED',
     statusMessage = null,
     passbackParams = null
@@ -60,7 +61,8 @@ export function generateMockPICallback(transactionId, callbackType = 'TRANSACTIO
       ...(reasonL2 && { reasonL2 }),
       timeToLive,
       transactionType,
-      initiatedBy
+      initiatedBy,
+      ...(paymentMethod && { paymentMethod })
     };
   } else {
     // TRANSACTION_FINALIZED
@@ -73,6 +75,7 @@ export function generateMockPICallback(transactionId, callbackType = 'TRANSACTIO
       currency,
       status,
       ...(statusMessage && { statusMessage }),
+      ...(paymentMethod && { paymentMethod }),
       created: Date.now() - 300000, // Created 5 minutes ago (milliseconds)
       finalized: Date.now()
     };
@@ -202,6 +205,11 @@ export const simulatePICallbackTool = {
       statusMessage: {
         type: "string",
         description: "Status message (only for TRANSACTION_FINALIZED callbacks)"
+      },
+      paymentMethod: {
+        type: "string",
+        enum: ["A2A", "CARD_FUNDED", "BNPL", "INSTANT_CREDIT"],
+        description: "Payment method chosen by customer. A2A = direct transfer. CARD_FUNDED = card-linked account. BNPL = buy now pay later. INSTANT_CREDIT = credit line."
       }
     },
     required: ["transactionId"]
@@ -225,7 +233,8 @@ export const simulatePICallbackTool = {
       reasonL2,
       timeToLive = 600,
       status = 'CONFIRMED',
-      statusMessage
+      statusMessage,
+      paymentMethod
     } = args;
 
     if (!transactionId) {
@@ -248,6 +257,7 @@ export const simulatePICallbackTool = {
       timeToLive,
       initiatedBy: 'PEER',
       transactionType: 'DEFAULT',
+      paymentMethod,
       status,
       statusMessage
     });

package/src/payment-institution/transactions/soundbite-transaction.js

@@ -152,6 +152,8 @@ export const soundbiteTransactionTool = {
       useSandbox
     });
 
+    const baseUrl = useSandbox ? getSandboxUrl() : getProductionUrl();
+
     if (result.success) {
       const tx = result.transaction;
       const createdDate = tx.created ? new Date(tx.created * 1000).toISOString() : 'N/A';

package/src/shared/data/data-api.js

@@ -369,4 +369,101 @@ export async function cancelExport({
   } catch (error) {
     throw new Error(`Failed to cancel export: ${error.response?.data?.message || error.message}`);
   }
+}
+
+/**
+ * List all available reports
+ */
+export async function listReports({
+  partnerType,
+  ...authParams
+}) {
+  const headers = await createAuthHeaders(partnerType, authParams);
+
+  try {
+    const response = await axios.get(
+      `${getProductionUrl()}/data-retrieval/reports`,
+      { headers }
+    );
+
+    return {
+      success: true,
+      data: response.data,
+      requestInfo: {
+        url: `${getProductionUrl()}/data-retrieval/reports`,
+        method: 'GET',
+        statusCode: response.status
+      }
+    };
+  } catch (error) {
+    throw new Error(`Failed to list reports: ${error.response?.data?.message || error.message}`);
+  }
+}
+
+/**
+ * Get report request history for a specific report type
+ */
+export async function getReportRequests({
+  reportId,
+  partnerType,
+  ...authParams
+}) {
+  if (!reportId) {
+    throw new Error('reportId is required (e.g., "/processedTransactions")');
+  }
+
+  const headers = await createAuthHeaders(partnerType, authParams);
+
+  try {
+    const response = await axios.get(
+      `${getProductionUrl()}/data-retrieval${reportId}`,
+      { headers }
+    );
+
+    return {
+      success: true,
+      data: response.data,
+      requestInfo: {
+        url: `${getProductionUrl()}/data-retrieval${reportId}`,
+        method: 'GET',
+        statusCode: response.status
+      }
+    };
+  } catch (error) {
+    throw new Error(`Failed to get report requests: ${error.response?.data?.message || error.message}`);
+  }
+}
+
+/**
+ * Get export list for a specific request
+ */
+export async function getExportList({
+  requestId,
+  partnerType,
+  ...authParams
+}) {
+  if (!requestId) {
+    throw new Error('requestId is required (UUID from report generation)');
+  }
+
+  const headers = await createAuthHeaders(partnerType, authParams);
+
+  try {
+    const response = await axios.get(
+      `${getProductionUrl()}/data-retrieval/exports/${requestId}`,
+      { headers }
+    );
+
+    return {
+      success: true,
+      data: response.data,
+      requestInfo: {
+        url: `${getProductionUrl()}/data-retrieval/exports/${requestId}`,
+        method: 'GET',
+        statusCode: response.status
+      }
+    };
+  } catch (error) {
+    throw new Error(`Failed to get export list: ${error.response?.data?.message || error.message}`);
+  }
 }

package/src/utils/code-examples/merchant/transactions.js

@@ -50,7 +50,8 @@ export const MerchantTransactionOperations = {
     method: 'POST',
     sampleBody: {
       account: 'MERCHANT_ACCOUNT_123',
-      friendlyName: 'My Store'
+      friendlyName: 'My Store',
+      paymentMethod: 'A2A'  // Optional: A2A, CARD_FUNDED, BNPL, INSTANT_CREDIT
     }
   },
 

package/src/utils/code-examples/payment-institution/transactions.js

@@ -33,6 +33,7 @@ export const PITransactionOperations = {
     sampleBody: {
       account: 'PI_ACCOUNT',
       friendlyName: 'Payment Institution Name',
+      paymentMethod: 'A2A',  // Optional: A2A, CARD_FUNDED, BNPL, INSTANT_CREDIT
       trData: {
         amount: '50.00',
         currency: 'EUR',