Actions Reference

function getTerminals(ws) {
  ws.send(JSON.stringify({ action: 'getTerminals' }));
}

// Handle response
ws.on('message', (data) => {
  const message = JSON.parse(data.toString());

  if (message.action === 'terminalsResponse') {
    const terminals = message.terminals;

    console.log(`Found ${terminals.length} terminal(s)`);

    terminals.forEach((terminal) => {
      console.log(`- ${terminal.deviceId}: ${terminal.status}`);
    });

    // Store terminals for payment operations
    availableTerminals = terminals;
  }
});

function initiatePayment(ws, terminalId, paymentData) {
  const request = {
    action: 'payment',
    terminalId: terminalId,
    paymentRequest: {
      transactionId: `TXN-${Date.now()}`,
      amount: paymentData.amount,
      currency: paymentData.currency || 'USD',
      paymentMethod: 'CARD',
      products: paymentData.products || [],
      customerInfo: paymentData.customer || {},
      metadata: {
        orderId: paymentData.orderId
      }
    }
  };

  ws.send(JSON.stringify(request));
  console.log(`Payment initiated: ${request.paymentRequest.transactionId}`);

  return request.paymentRequest.transactionId;
}

// Handle payment completion
ws.on('message', (data) => {
  const message = JSON.parse(data.toString());

  if (message.action === 'paymentComplete') {
    const response = message.paymentResponse;

    if (response.status === 'SUCCESS') {
      console.log(`Payment successful: ${response.transactionId}`);
      console.log(`Authorization: ${response.authorizationCode}`);
      // Update order status, print receipt, etc.
    } else {
      console.error(`Payment failed: ${response.errorMessage}`);
      // Handle failure, notify customer
    }
  }
});

// Usage
const txnId = initiatePayment(ws, 'TERM-001', {
  amount: '99.99',
  orderId: 'ORD-12345',
  products: [
    { id: 'PROD-001', name: 'Widget', price: '99.99', quantity: 1 }
  ]
});

let pingTimeout;
let heartbeatInterval;

function startHeartbeat(ws) {
  heartbeatInterval = setInterval(() => {
    ws.send(JSON.stringify({ action: 'ping' }));

    pingTimeout = setTimeout(() => {
      console.log('Connection timeout - reconnecting');
      ws.terminate();
    }, 10000);
  }, 30000);
}

function handlePong() {
  clearTimeout(pingTimeout);
}

ws.on('message', (data) => {
  const message = JSON.parse(data.toString());

  if (message.action === 'pong') {
    handlePong();
  }
});