Self-service kiosk

The FitManager Kiosk is a full-screen touch app for a PC or tablet at your entrance. A member or a walk-in picks a membership, a product or a gift card, pays by card on the terminal beside the screen, and walks in with an active membership and a fiscal receipt or an emailed invoice. Nobody at reception has to do anything.

How it fits together#

The order is always card first, receipt second, so a receipt is never printed for a card that was declined.

What you need#

• The Self-service kiosk feature on your plan and the Manage settings permission in FitManager.
• A touch screen: a Windows 10 or 11 PC with a touch screen, or an Android 7.0+ tablet. A tablet still needs a Windows PC running Control on the same network.
• A card terminal from your bank, unattended and with a cash-register (ECR) connection. Ask for a test terminal for the first days.
• A fiscal printer (optional): the same Synergy or David models as at reception. Without one, the kiosk emails an invoice instead.
• FitManager Control installed on the PC, with the Kiosk tab switched on for your installation. The FitManager team switches it on: open a ticket if you do not see the tab. See Set up FitManager Control.
• A gym API key from Settings, Integrations, API integration.

Step 1: Register the kiosk in FitManager#

Under Settings, Integrations, Kiosk, click Add kiosk.

Name the kiosk after where it stands.

Choose the receipt, the fiscal printer on the kiosk PC or an invoice by email.

Tick the memberships the kiosk sells.

Tick more plans and put them in order with the arrows.

Leave codes on to let customers enter a coupon or gift card code before paying.

Click Save.

The kiosk card shows its receipt mode, terminal, last contact and what it sells.

Copy the Kiosk id and the Platform API into the Kiosk tab of FitManager Control.

Next

Done

That is everything. You can replay it any time.

Start over

1. Under Settings, Integrations, Kiosk, click Add kiosk.

2. Name the kiosk after where it stands.

3. Choose the receipt, the fiscal printer on the kiosk PC or an invoice by email.

4. Tick the memberships the kiosk sells.

5. Tick more plans and put them in order with the arrows.

6. Leave codes on to let customers enter a coupon or gift card code before paying.

7. Click Save.

8. The kiosk card shows its receipt mode, terminal, last contact and what it sells.

9. Copy the Kiosk id and the Platform API into the Kiosk tab of FitManager Control.

1. Step 1: Under Settings, Integrations, Kiosk, click Add kiosk.
2. Step 2: Name the kiosk after where it stands.
3. Step 3: Choose the receipt, the fiscal printer on the kiosk PC or an invoice by email.
4. Step 4: Tick the memberships the kiosk sells.
5. Step 5: Tick more plans and put them in order with the arrows.
6. Step 6: Leave codes on to let customers enter a coupon or gift card code before paying.
7. Step 7: Click Save.
8. Step 8: The kiosk card shows its receipt mode, terminal, last contact and what it sells.
9. Step 9: Copy the Kiosk id and the Platform API into the Kiosk tab of FitManager Control.

1. Open Settings, Integrations, Kiosk.
2. Click Add kiosk.
3. Fill in the form below and click Save.

A kiosk has to sell at least one thing: a membership, a product category or a gift card amount.

After saving, the kiosk's Connect FitManager Control box shows the Kiosk id and the Platform API address, each with a copy button.

Step 2: Set up FitManager Control on the kiosk PC#

1. Download FitManager Control from the Download FitManager Control and the Kiosk app link on the kiosk card, or from the Kiosk page on the FitManager website. Install and activate it as described in Set up FitManager Control.
2. In Control, click Settings and paste the API key into Gym API bearer token.
3. If the kiosk prints receipts, add the printer on the POS System tab first (+ Fiscal printer). Add the card terminal there too (+ Card terminal), so the kiosk can use it.
4. Open the Kiosk tab and click + Kiosk.
5. Fill in:
   • Name, and tick This kiosk is in use.
   • Platform API and Kiosk id: paste the two values from Step 1.
   • Fiscal step: the printer on this PC, or an email invoice from FitManager. With a printer, choose it under Fiscal printer, and choose If printing fails: Reverse the card payment (the default) or Complete the sale, print later.
   • Card terminal: the terminal beside the screen.
   • App folder: where the Kiosk app is installed, and tick Start the Kiosk app with Control and restart it if it closes.
   • Tick Local API enabled (the Kiosk app connects here), keep the port, and click Generate next to Kiosk token. Copy the token.
6. Optionally, set the look under Design of the Kiosk screen: colours, gym name, logo, welcome photos or video, language, text size and the idle time. Changes show on the screen within seconds.
7. Click Save, then Test sale to try the terminal.

Step 3: Install the Kiosk app#

Download the app from the Kiosk page on the FitManager website: a ZIP for Windows or an APK for Android.

On the PC:

1. Unzip it into a folder such as C:\FitManagerKiosk. This is the App folder in Control.
2. Start fitmanager_kiosk.exe. On its first start it opens the setup screen.
3. Paste the kiosk token, click Test connection, choose a staff PIN and save.

On an Android tablet:

1. Download the APK on the tablet, allow the install and open FitManager Kiosk.
2. On the setup screen, type the address of the PC running Control, for example http://192.168.1.10:7420/. The PC needs a fixed address on your network.
3. Paste the kiosk token, test the connection, set the staff PIN and save.

To open the setup screen later, tap the top-left corner of the welcome screen five times, or press Ctrl+Alt+S on a keyboard, and enter the staff PIN.

Your memberships appear on the screen within seconds. Within a minute the kiosk in FitManager shows Online.

What happens on a sale#

1. The customer picks what to buy and identifies themselves: an existing member by card number, email or phone, or a new customer by name, email and phone.
2. They can enter a coupon or gift card code, then pay on the terminal.
3. When the card is approved, FitManager creates the member if they are new, activates the membership, records the sale as a card payment, and issues any gift card.
4. The fiscal receipt prints on the kiosk's printer, or the invoice is emailed as a PDF with the number K-....

Kiosk sales appear in Purchases with a Kiosk badge, count in your earnings like any POS sale, and are split out under By Source in Reports. Their fiscal receipts appear in the printer's fiscal journal.

If the printer fails after the card was approved and Control is set to complete the sale anyway, the receipt is queued and prints when the printer is back.

The kiosk card and its orders#

Each kiosk on Settings, Integrations, Kiosk shows its state (Online, Offline, Not connected yet or Disabled), Facility, Receipt, Card terminal, Last contact with the Control version, and what it sells. Edit changes the settings. Delete removes the kiosk, and its orders are kept.

Recent kiosk orders lists the last ten orders with the time, reference, item, customer, amount and state, such as Completed, Declined, Unknown payment or Failed. A completed order links to its sale number.

Resolve an unknown payment#

If the terminal lost contact after the card was read, the order shows Unknown payment and a warning at the top of the page says how many need a look.

1. Check the terminal's receipt or your bank statement for that amount.
2. Click Card was charged if the money was taken. After you confirm, the sale is completed and the membership activated.
3. Click Not charged if it was not. The order is marked failed.

Resend an invoice#

For a kiosk in email mode, a completed order shows invoice emailed when the invoice went out. If it failed or the customer lost it, click Resend invoice. Invoices go through your gym's email settings and appear in the email log.

Troubleshooting#