Web SDK (TypeScript)

Installation

npm install @onemyposmate/sdk

Quick Start

const client = new OneMyPosMateClient({
  baseUrl: 'https://payus.co.nz',
  system: 'pos',
});

const resp = await client.payments.payNow({
  grandTotal: '10.00',
  referenceId: 'REF-001',
  branchId: 17,
  configId: 123,
  channel: 'WECHAT',
});

Authentication Flow

// 1. Activate (one-time)
await client.auth.activate('ABC123');

// 2. Token is cached in TokenStore (localStorage by default)
// Every subsequent call auto-refreshes if within 60s of expiry
const token = await client.auth.currentToken();

// 3. Single-flight Promise cache prevents concurrent refreshes

Error Handling

try {
  await client.payments.payNow(request);
} catch (e) {
  if (e instanceof OneMyPosMateError) {
    switch (e.errorCode) {
      case 'ERR_GATEWAY_NOT_FOUND': // Terminal not configured
      case 'ERR_DUPLICATE_TRANSACTION': // referenceId reused
      case 'ERR_UNAUTHORIZED': // Token expired, SDK auto-retried
    }
  }
}

Common Error Codes