PayX Node SDK

npm install payx-node@latest

const { PayX } = require('payx-node');

const payx = new PayX({
  apiKey: process.env.PAYX_SECRET_KEY // or 'px_live_v2_YOUR_SECRET_KEY'
});

const checkout = await payx.checkout.create({
  amount: 100.00,
  currency: 'GHS',
  email: 'user@example.com'
});

console.log('Scoped Checkout Token:', checkout.checkoutToken);
console.log('Hosted Checkout URL:', checkout.url);

const charge = await payx.charge.create({
  amount: 50.00,
  currency: 'GHS',
  phoneNumber: '0551234987',
  network: 'MTN',
  payerMessage: 'Order #1234'
});

console.log('Transaction ID:', charge.transactionId);
console.log('Status:', charge.status); // PENDING

const payout = await payx.payouts.create({
  amount: 250.00,
  currency: 'GHS',
  phoneNumber: '0241234567',
  network: 'MTN',
  idempotencyKey: 'sample-unique-idempotency-key-12345',
  payeeNote: 'Vendor Disbursement'
});

console.log('Payout Transaction ID:', payout.transactionId);
console.log('Payout Status:', payout.status);

// Express.js Webhook Route
app.post('/api/webhooks', (req, res) => {
  const signature = req.headers['x-payx-signature'];
  const webhookSecret = process.env.PAYX_WEBHOOK_SECRET; // whsec_live_...

  const isValid = payx.webhooks.verifySignature(
    req.body,
    signature,
    webhookSecret
  );

  if (!isValid) {
    return res.status(401).json({ error: 'Invalid signature' });
  }

  const { event, data } = req.body;
  if (event === 'transaction.success') {
    console.log('Transaction succeeded:', data.id);
  }

  res.status(200).send('OK');
});