@nagpal_a_hsl/zvt-client

Unified TypeScript ZVT client for Verifone and Clover terminals in React Native and Expo apps.

Install

npm install @nagpal_a_hsl/zvt-client

Quick Start

React Native / Expo

import { ZvtClient } from "@nagpal_a_hsl/zvt-client";

const client = new ZvtClient({
  terminal: "clover",
  host: "192.168.178.132",
  port: 25690,
  password: "000000",
});

The root package auto-configures the native TCP transport for Android and iOS.

Constructor

new ZvtClient({
  terminal: "verifone" | "clover",
  host: string,
  port: number,
  password?: string,
  orderNo?: string | number,
}, forwardLog?)

Methods

• register(opts?)
• status(opts?)
• authorize(amountCents, opts?)
• cancel()
• raw(hex)
• reconcileLast(opts?)
• clearCooldown()
• cooldownStatus()

Notes

• password validation: exactly 6 digits when required.
• Verifone:
  • supports orderNo/reference in legacy payload mode.
• Clover:
  • uses readiness probing + cooldown guard to avoid early retries after abort/cancel.
• React Native / Expo:
  • the package is intended for Expo 54 / React Native 0.81 native apps.
  • custom native code means this package does not run in Expo Go.
  • use an Expo development build, a prebuilt app, or a bare React Native app, then build Android with Gradle as usual such as ./gradlew assembleRelease.

Build

npm run build

Publish

npm login
npm publish --access public