Hyvä POS PRO
Hyvä POS is in closed beta
Hyvä POS is currently in a closed beta (pilot phase) with a small group of merchants. It is not yet generally available: the App Store release follows the pilot, and features and configuration may still change - possibly in backwards-incompatible ways - before the general release. Want to take part? Sign up at hyva.io/pos.
PRO turns the free app into a centrally managed, multi-register system. The free tier is one device selling against your store; PRO is locations, terminals and staff, orchestrated from your Magento admin.
What PRO Adds
- Central orchestration: configure receipts, payment methods, tax and categories once in Magento; every register at the location picks it up. Lock out a stolen device remotely.
- Staff and roles: PIN login per employee, with granular permissions managed in Magento.
- Offline mode: keep selling when the internet or Magento is down.
- Receipt sync: every register receipt mirrored to Magento, with a public QR page per receipt.
- Cross-channel credits: gift cards, store credit and reward points as tender at the register.
- Staged returns, layaway, pay by invoice, special orders, shipping labels, stock transfers, self-checkout and, where required, fiscal compliance. The paired-iPad customer display is PRO too; it lives with the rest of the display hardware.
Looking for the complete feature comparison?
The free vs PRO matrix lists every difference, feature by feature - what the free app does on its own and exactly what the module and a license add.
The Three Pieces
- A license per terminal, bought on hyva.io. One license, one register. Nothing else is metered: not locations, not staff, not SKUs, not revenue.
- The Hyvä POS Magento module, installed with Composer. It adds the Hyvä POS section to your admin and the
pos/API the PRO features run on. - An activation code per terminal, generated in the Magento admin. Entering it on the device binds that device to the terminal and unlocks PRO.
Before You Start
Three prerequisites, all ordinary:
- A Magento 2.4 store with cron running. License renewal, fiscal exports and pickup automation all ride on Magento cron; a store with dead cron will eventually show as a licensing problem.
- The Hyvä POS app on each device, already able to connect to your store as a free-tier register (connecting your store). PRO setup builds on a working connection.
- A hyva.io account to buy licenses and generate API credentials.
The Setup Journey
Work through these in order. Each step has its own page with exact paths, field explanations and troubleshooting.
- Buy terminals and understand your license. Buy one license per register on hyva.io and generate the API key and token that connect your store to your license pool. Done when: your hyva.io account shows the licenses and you have the Composer credentials, the API key and the API token at hand.
- Install the module.
composer requirefrom Hyvä's private Packagist, thensetup:upgrade. Done when:bin/magento module:status Hyva_Posreports the module enabled and the Hyvä POS menu appears in the admin sidebar. - Connect hyva.io and configure the global settings. Enter the API key and token under Stores → Configuration → Hyvä POS, press Fetch Licenses, and set the chain-wide defaults and locks. Done when: Hyvä POS → Store Setup → Licenses lists your purchased licenses.
- Create your locations. One record per physical store: address, MSI inventory source, tax, receipt branding, categories, payments. Done when: every store has a location with the right inventory source.
- Create terminals and attach licenses. One record per register, each with a license from your pool and a one-time activation code. Done when: every terminal shows an assigned license and an activation code.
- Activate each device. Scan the terminal's QR code (or type the code) on the device. Done when: the register shows the terminal name, staff log in with PINs, and the terminal's Last Seen At in the admin updates.
Where Everything Lives in the Admin
The module adds one sidebar menu and one configuration section:
| Place | What is there |
|---|---|
| Hyvä POS → Store Setup | Locations, Licenses, Terminals, Receipts |
| Hyvä POS → Staff | Manage Staff, Roles |
| Hyvä POS → Operations | Held Carts, Audit Log, Telemetry, Fiscal Exports |
| Stores → Configuration → Hyvä POS | Global settings: General, Terminal Defaults, Payments, Lock Settings, Advanced |
Day-to-day changes (a new employee, a receipt footer, a deactivated terminal) reach every register through its heartbeat - within minutes, no redeploy, no app update.
Rolling Out More Than One Register
The journey above reads as one device, but it scales without repetition:
- Locations and terminals are cheap records: clone terminals for a bank of identical registers; each clone gets its own activation code.
- Devices activate independently - there is no per-device Magento work beyond reading a QR code off the terminal's edit form.
- Set chain-wide values (receipts, payments, locks) once in the global settings; locations override only what genuinely differs per store.