Quickstart

import { MyazaPOS } from '@myazahq/pos-sdk';

// Create an instance
const pos = new MyazaPOS({
  merchantId: 'your-merchant-id',
  isSandbox: true, // use false for production
});

// Initialize — fetches your merchant profile
await pos.init();

// Listen for payment events
pos.on('payment.confirmed', (event) => {
  console.log('Payment complete!', event.session.id);
  // Verify on your server, then fulfill the order
});

pos.on('payment.failed', (event) => {
  console.log('Payment failed:', event.reason);
});

pos.on('payment.cancelled', (event) => {
  console.log('Customer cancelled payment');
});

// Open the checkout modal
await pos.checkout({
  amount: 25.00,
  currency: 'USD',
});

// Fetch available banks
const banks = await pos.getBanks('NGN');
console.log(banks);
// [{ id: '...', name: 'First Bank', networkId: 'first-bank-ng', ... }]

// Verify the account holder
const account = await pos.resolveAccount('first-bank-ng', '0123456789');
console.log(account.accountName); // "John Doe"

// Open checkout with payout details
await pos.checkout({
  amount: 5000,
  currency: 'NGN',
  payoutAccountNumber: '0123456789',
  payoutNetworkId: 'first-bank-ng',
});

// Fetch supported networks
const networks = await pos.getNetworks();
// [{ chain: 'polygon', name: 'Polygon', supportedTokens: [{ symbol: 'USDC', ... }] }]

// Get the exchange rate
const rate = await pos.getExchangeRate('USD', 'USDC');
console.log(`1 USDC = ${rate.rate} USD`);

// Create a session with a specific chain and token
const session = await pos.createSession({
  amount: 25.00,
  chain: 'polygon',
  token: 'USDC',
});

// The SDK starts polling automatically
// Listen for events as usual

await pos.terminate();