Cash register agent for Windows and Linux

A browser POS that talks to hardware directly

HW Connector runs on the cashier PC and gives your web application access to fiscal printers, payment terminals, printers, scanners and the cash drawer through a single REST API.

FFD 1.05–1.2 Card and SBP payments ESC/POS · ZPL · TSPL No drivers for Shtrih-M, Pirit, KIT
localhost:7790
# one-step sale: card → receipt → slip
POST /api/v1/checkouts
Idempotency-Key: 3f2c9a71-…
Prefer: wait=30

# a retry with the same key never
# charges the card twice
← 202 Accepted
Location: /api/v1/operations/{id}

# receipt not printed — payment is reversed
Features

Everything a checkout needs in one agent

Fiscal receipts, card acquiring, printing and peripherals through one API with clear operations.

Fiscal receipts

Sale, refund, expense, correction, cash in and out, X and Z reports. The agent opens a closed shift by itself.

Card and SBP payments

Payment, refund, cancel and settlement. SBP QR codes in a window, on a second monitor or on a QR display.

One-step sale

Card, receipt and slip in one request. If the receipt fails to print, the payment is reversed automatically.

Printing without dialogs

PDF and images to Windows printers, ESC/POS, ZPL, TSPL and FGL directly: receipts, labels, tickets on blanks.

Peripherals

Barcode scanners, NFC/RFID readers, customer displays, cash drawer, UPS power events.

Reliable API

Every operation has an idempotency key: a retried request never prints a receipt or charges twice. Described in Swagger.

Hardware

Works with what is already at the checkout

Many devices are driven directly by protocol, without vendor drivers.

Fiscal printers

ATOL (DTO10)Shtrih-MMercury RetailELVESPaykiosk Pirit 2FViki PrintDreamkas-F KIT Online-FTerminal-FA

Payment terminals

INPASSberbank UPOSARCUS 2 UCS EFTPOSTTK2 SBP T-BankSBP Sberbank

Printers

ESC/POSZPLTSPL EZPL (Godex)Boca FGLWindows printers

Peripherals

COM and HID POS scannersPC/SC NFC/RFID VFD/LCD displaysSecond monitorCash drawer
How it works

Three steps to the first receipt

  1. Install the agent

    MSI for Windows or the Linux build on the cashier PC.

  2. Connect the hardware

    On the agent setup page: choose the port, test the connection, print a test page.

  3. Call the API

    From your web application at http://localhost:7790/api/v1.

FAQ

Frequently asked questions

Do I need vendor drivers?

Not for Shtrih-M, Pirit, KIT, UCS and TTK2: the agent speaks their protocols directly. ATOL needs the DTO10 driver; INPAS, Sberbank and ARCUS need the bank software.

Which systems are supported?

Windows and Linux. The setup page, help and API are available in Russian and English.

Can I test the checkout without hardware?

Yes. The agent has fiscal printer and terminal emulators, and shows each receipt on screen exactly as it would print.

Where is the API reference?

In Documentation: the agent help and Swagger with every method and field. Help · API (Swagger)

How do I get the software?

Sign up for an account. Once your request is approved, Windows and Linux builds appear there.

Who do I contact if something does not work?

Write to support@hw-connector.ru with the device model and the agent operation log.

Connect your checkout to the hardware

Sign up — once approved, your account will have the latest agent builds.