Test your integration

const terminal = await vinr.terminals.create({
  label: 'Test counter 1',
  locationId: 'loc_test_main',
});
// terminal.id → "term_test_abc123..."

const vinr = new Vinr({ secretKey: 'sk_test_...' });

const tp = await vinr.terminal.payments.create({
  terminalId: 'term_test_default',
  amount: 2500,
  currency: 'USD',
  reference: 'test_order_001',
});

// Sandbox auto-completes after ~2 seconds
// Your webhook receives terminal_payment.completed

const tp = await vinr.terminal.payments.create({
  terminalId: 'term_test_default',
  amount: 2500,
  currency: 'USD',
  reference: 'test_order_002',
  testCard: '4000000000000002', // card_declined
});

// Your webhook receives terminal_payment.failed
// event.data.object.declineCode === 'card_declined'

const tp = await vinr.terminal.payments.create({
  terminalId: 'term_test_offline', // goes online after 10 s
  amount: 1000,
  currency: 'USD',
  reference: 'test_order_003',
});

// Session stays in 'pending' for ~10 seconds, then auto-completes
// Useful for testing your UI loading/waiting state

const tp = await vinr.terminal.payments.create({
  terminalId: 'term_test_default',
  amount: 1000,
  currency: 'USD',
  reference: 'test_order_004',
  testScenario: 'timeout', // session expires after 5 s in sandbox
});

// Your webhook receives terminal_payment.cancelled
// event.data.object.cancellationReason === 'timeout'

# Install the CLI
npm install -g @vinr/cli

# Login with your test key
vinr login --key sk_test_...

# Forward terminal events to your local server
vinr listen --forward-to localhost:3000/api/webhooks \
  --events terminal_payment.completed,terminal_payment.failed,terminal_payment.cancelled