Skip to content

Receipts and Printing

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.

Every completed sale writes a receipt to the device, prints it on a receipt printer or any AirPrint printer, and can email it to the customer. All of this works on the free tier; the receipt never depends on a server round-trip.

What a Receipt Stores on the Device

The receipt is the register's own record of the sale, written the moment the sale completes and immutable afterwards - see local receipts for why that matters. In plain terms, each receipt stores:

  • the date and time at the register (not the sync time),
  • every line: product, quantity, unit price, per-line discount, tax rate and amount,
  • the VAT breakdown per rate, and any cash rounding,
  • the tenders used, including split payments; card payments keep the brand, masked number and terminal reference - never a full card number,
  • the customer's name and email when one was attached to the sale,
  • who rang the sale, on which terminal, and the Magento order number,
  • refund or exchange references, the sequential receipt number, and the fiscal signature where fiscal compliance applies.

Receipts are stored in per-month files on the device, encrypted at rest, with no automatic purge. On the free tier they exist on that device only; PRO receipt sync mirrors every receipt to Magento, so the archive survives a lost or reset device. See data and security for the full data story.

Printing Paths

The app speaks to printers over three different paths, chosen automatically per printer - you configure the printer once under Settings → Printers and the right path is used:

  • ESC/POS: the native command language of Epson, Star and generic network or Bluetooth receipt printers. Fast text output with real bold, alignment and paper cut.
  • Rendered image: Brother mobile printers and other models without a usable text mode receive the receipt as a print-ready image, rendered for crisp output on thermal paper.
  • TSPL: newer Brother mobile models (RJ-2035B, RJ-2055WB, RJ-3035B, RJ-3055WB) print via their native label language, which is much faster over Bluetooth than sending an image.

The layout is identical on every path: the same columns, the same VAT summary, the same header and footer. Which printers are supported, how each connects and which paper widths they take is covered in the hardware section.

AirPrint

No receipt printer? Any AirPrint-capable office printer prints receipts through the system print dialog. Long receipts split cleanly across pages, and each saved AirPrint printer has its own color mode, print quality, scale and margin settings. AirPrint cannot kick a cash drawer.

The Cash Drawer

A cash drawer plugs into the receipt printer's drawer port, and the printer kicks it open on command:

  • Automatic: turn on the auto-open toggle under Settings → Payments and the drawer opens whenever a sale takes cash. Default is off.
  • Manual: the Cash Drawer tile on the register opens it on demand (a no-sale opening).

The kick works on Epson, Star and generic ESC/POS printers with a drawer port. AirPrint and label printers have no drawer port. Details and tested drawers are in the hardware section.

What the Cashier Sees

After checkout the success screen shows a print tile per document: the sales receipt, and for card payments the customer terminal slip and the merchant terminal slip (the signature copy). Each prints automatically or on demand depending on the auto-print toggles, and a long-press on any tile picks a different printer for that one print. Reprinting later works from the sales list: open any past sale and print or re-send it - the reprint reproduces the original receipt exactly, because everything is stored with the sale.

Email Receipts

  • Free tier: the app asks Magento to send the order and invoice emails for the sale, so the customer gets the totals through your store's normal transactional mail.
  • PRO: the app sends a dedicated receipt email through the PRO module, with the rendered receipt attached as an image - the customer gets the same document that came out of the printer.

The cashier can email from the checkout success screen, from the hand-over screen below, or later from any sale's detail view. The email address is prefilled when a customer is attached to the sale.

On PRO, the email entry doubles as a newsletter moment. The cashier's email dialog carries a Subscribe to the newsletter checkbox with an ask-the-customer-first hint; the hand-over screen and the customer display show the same opt-in to the customer directly, ticked by their own hand. In every case the subscription happens only after the receipt email actually sent, uses the same validation your webshop applies (including the guest-subscription setting for emails that don't belong to an account), and a known customer's email links the subscription to their account.

Hand the iPad to the Customer

After the sale completes, tap Hand over and pass (or turn) the iPad to the buyer. The screen flips into a customer-facing mode - "How would you like your receipt?" - with the store's name and logo, and everything cashier-side hidden: no totals, no buttons into the register.

The customer picks one of two:

  • Email it to me: a large email field, prefilled when a customer is attached to the sale, that sends the receipt through the normal email flow.
  • Scan the QR: opens their personal receipt page in their own browser. The QR appears when the store runs PRO receipt sync and the receipt has synced; without it the customer sees the email option only.

Getting back to the register is deliberately not a tap: the "Return to cashier" control needs a long-press, so a curious customer tapping around the screen cannot end up in the register.

Customer-Facing Display

Two-line customer displays show the running total while you scan, on the free tier. They attach to the printer, not the iPad: the Star SCD222U plugs into a Star printer's peripheral port, the Epson DM-D30 into an Epson TM-series printer, and the display commands ride the printer's existing connection. See customer displays for how each connects, and for the PRO paired-iPad display.

Where It Is Configured

What On the device In Magento (PRO) Which wins
Printers, paper, quality Settings → Printers - Always the device: hardware is per-terminal
Receipt content and layout Settings → Receipt Layout Hyvä POS → Store Setup → Locations, defaults under Stores → Configuration → Hyvä POS Magento on PRO; fields it enforces are read-only on the device
Auto-print toggles Settings → Receipt Layout Location's Checkout Auto-Print fields Magento on PRO
Drawer auto-open Settings → Payments - The device

On the free tier every setting is per-device. The full layout story - logo, store-info template, cashier line, QR, and how Magento management and enforcement work - is on the receipt layout page.

PRO

PRO receipt sync adds the central receipt archive in Magento, a public QR page per receipt, receipt emails with the rendered receipt attached, and per-location receipt branding pushed from Magento. The paired-iPad customer display, where a second iPad mirrors the cart and lets the customer type their own email, is PRO as well.