Docs / Hardware

Pair a Smartpay EFTPOS terminal

JSON-RPC over TCP to a Smartpay terminal — configure once, done.

Smartpay is our second EFTPOS reference. Terminals listen on TCP port 7300 by default; halopos sends JSON-RPC.

Configure

HALOPOS_BRIDGE_EFTPOS_DRIVER=smartpay
HALOPOS_BRIDGE_EFTPOS_HOST=192.168.1.60
HALOPOS_BRIDGE_EFTPOS_PORT=7300
HALOPOS_BRIDGE_EFTPOS_TIMEOUT_MS=45000

Keep in mind

  • The 45-second timeout is deliberate — Smartpay terminals can hold

a transaction open while the cardholder enters a PIN and signs. We don't retry inside that window.

  • Voids and refunds follow the same JSON-RPC shape as sales — the

cashier doesn't see a difference.