Skip to content

Connecting Your Store

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.

The guided setup walks you from an empty app to a register that is ready to sell. It starts with the store URL and authentication, then covers the settings a counter needs: store view, payments, tax, printer and receipts.

The Guided Setup

On the first screen, choose Connect Store. You can connect as many stores as you want, and add more later from settings. Try Demo Mode on the same screen explores the app against a sample catalog without connecting anything.

The wizard then walks these steps:

  1. Store URL - your Magento web address, for example https://www.example.com.
  2. Authentication - pick a method (below) and enter its credentials.
  3. Permission Check - the app authenticates and checks every resource it needs. Anything missing is listed with a hint on how to fix it, and setup continues either way.
  4. Store Settings - the store view to sell from, plus categories and inventory source. Products, categories and customers come straight from Magento; there is no import step.
  5. Payment Methods - which methods this register offers.
  6. Tax & Pricing - these should match your Magento tax configuration.
  7. Printer Setup - a receipt printer over Bluetooth or WiFi, or AirPrint.
  8. Receipt Settings - header, footer, logo and branding. The last button reads Start Selling.

Three further steps appear only when they apply. Two of them sit between the permission check and the store settings:

  • hyva.io Connection, when the PRO module is installed but the store is not linked to hyva.io yet. The app checks the connection, confirms it, and moves on by itself.
  • Terminal Activation, when the PRO module is present and this device is not a terminal yet. Activating here means the settings steps arrive already filled in from the terminal's location; see activating your device.

The third, Fiscal Compliance, follows the store settings in countries that require signed receipts (Germany, Austria, France, Italy).

Every settings step carries Skip for Now, so you can get to the register first and configure later from settings. Terminal activation is skippable unless your store requires terminal registration. The permission check offers Continue Anyway when something failed.

Pausing and Discarding

Closing the wizard asks what to do with the work so far:

  • Save for Later keeps your progress. The first screen then offers Resume Setup, which returns to the step you left and signs back in with the saved credentials.
  • Discard Setup deletes the store connection and any settings entered so far. This cannot be undone.

Authentication Methods

Integration Token

The recommended method for production. Create an integration in Magento (how), copy the access token, and paste it into the app. The token does not expire; you revoke it from the Magento admin whenever you want to cut off a device.

Requires the standalone Bearer token setting described in Magento configuration.

OAuth 1.0a

The strictest option: the app signs every request with the consumer key and secret, so a captured request cannot be replayed or tampered with. Enter all four credentials from the integration (consumer key, consumer secret, access token, access token secret). No extra Magento settings needed.

Admin Login

Enter the username and password of a Magento admin account and the app requests a token for you. Tokens expire (four hours by default); with stay signed in enabled (the default), the app stores the credentials in the device keychain and renews the token automatically, so you only notice if the password changes. Without it, the session expires after a few hours and the register stops until someone signs in again.

Admin tokens are tied to the account: signing in on a second device with the same admin account may invalidate the first device's session. Give each device its own admin account, or use an integration token.

Use this to evaluate quickly. For production, prefer an integration token: it survives password rotations, does not depend on 2FA settings, and can be revoked independently.

Multiple Stores

Add as many Magento stores as you like from Settings → Connection. Each store has its own authentication, catalog, and settings, and you switch between them from the store picker in the header. One store can run PRO while another runs free.

Working on the road

The same setup works on an iPhone. With a mobile payment terminal, a market stall or a pop-up store gets a fully functional register in your pocket.