FAQ
Hyvä POS is on the App Store
The free app is out for iPhone, iPad and Mac: install it from the App Store, connect your Magento store and sell. PRO, the Magento module with a license per terminal, follows shortly. News and pricing are at hyva.io/pos.
Do I need to install anything in Magento to use Hyvä POS? No. The free app works against any standard Magento 2.4.x store over the normal REST API. The Magento module is only needed for PRO.
My admin login fails from the app, but the password is right. The admin account has two-factor authentication (the Magento default). When the store's 2FA provider is Google Authenticator, the app asks for the six-digit code after the password and signs in with it. For Duo Security, Authy or security keys the app cannot answer the challenge: use an integration token for those accounts; integrations are not subject to admin 2FA. More on the troubleshooting page.
My staging store sits behind HTTP basic authentication and the app cannot connect.
Basic authentication stops the app before it reaches Magento: the wizard's connection test fails, or every request comes back as unauthorized. Two ways out: exempt Magento's REST API, everything under /rest/, from the basic authentication in your web server configuration, or allow the IP address your devices connect from. The storefront and the admin can stay behind the password; the app only needs /rest/. The connection troubleshooting page has the checks.
Where are my receipts stored? On the device, always: every sale writes an immutable local receipt. On PRO, receipts also sync to Magento as a central archive. The Magento order exists in both tiers.
Can I see the register's Z reports in Magento? On PRO with module 1.4.0, yes: every closing is sent to Magento and listed under Hyvä POS → Reports → Register Reports, with totals per location or terminal under Register Totals. See register reports.
What happens when the internet goes down? On the free tier, sales need the store to be reachable. With PRO offline mode, the register keeps selling from its offline cache and sends queued sales when the connection returns. Staff who signed in on the device in the last 24 hours can sign in offline. Refunds wait until the store is reachable again.
A customer paid, but the sale was not saved. The card payment went through, and the register could not save the sale afterwards. The register keeps the checkout as it was when the card was charged, so nothing is lost and nothing is charged twice. The cart shows "Sales paused. A paid sale still needs to be saved." and no new sale starts on the device until the paid sale is dealt with. Tap the notice to open the sale. Save paid sale saves it with the payment already taken; if saving fails, the button reads Try saving again and the screen shows why. Refund to the card returns the money instead, and the sale is not saved. Back to register leaves the sale for later, and sales stay paused. A payment the provider has not confirmed pauses sales the same way ("Sales paused. A card payment is not confirmed yet."); check that payment under Reports → Terminal Payments. See when a card payment goes wrong.
Why does a cashier need a manager to give a discount? On PRO, a discount and a price change are role permissions: Apply Discounts and Price Override, under Hyvä POS → Staff → Roles. The Cashier role starts without them. When a cashier enters a discount, the register opens Manager approval: a staff member whose role allows the discount enters their passcode, and the cashier stays signed in. The approval covers that one discount and the amount it takes off; a larger discount needs a new approval. Magento records each approval as a comment on the order. To let a cashier discount without asking, give their role Apply Discounts.
Why can't I refund while the store is offline? With module 1.5.0 the store authorizes every refund before the register pays it out, so a staff member's refund right is checked by the store. While the store is unreachable, no new refund starts, and the register shows "Refunds need a connection to the store. The return is kept; pay it out once the store is reachable." A refund the store authorized before the connection dropped still completes and syncs later. On the free tier, refunds are credit memos created through Magento, so they need the store as well.
Can I move a PRO license to a new device? Yes. Activate the terminal on the new device (the old one is signed out), or create a new terminal and move the license to it in the admin. See terminals.
Which printer should I buy? See the hardware recommendations: the Epson TM-m30III for a one-cable counter, the Star mPOP for tight spaces, Brother RJ for mobile.
Does my barcode scanner work? Most do: any Bluetooth scanner with HID (keyboard) mode works, and Socket Mobile / Zebra scanners have smoother native support. See barcode scanners.
Do gift cards bought online work at the register? On PRO, yes, including third-party gift-card modules through a bridge.
Is there a cost per sale? No. PRO is a flat price per terminal. No percentage of sales, no per-user or per-SKU fees; your payment-provider contract stays your own.