Connect the card terminal to the POS

With a connected card terminal, the cashier no longer types the amount into the terminal by hand. When they choose Card on the Point of Sale, the amount appears on the terminal by itself, and the sale is completed in FitManager only once the bank approves the card. No typing mistakes, and no sale recorded for a card that was declined.

How it works#

The browser never talks to the terminal. FitManager Control, the Windows app on the reception PC, does:

1. The cashier clicks Checkout with Card selected. FitManager keeps the sale as Pending and puts the amount in a queue with a reference such as POS-000123.
2. Control on the reception PC asks FitManager for work about once a second, takes the sale and starts it on the terminal.
3. The customer taps or inserts the card. The terminal and the bank do the rest. No card data passes through Control or FitManager.
4. Control reports the result. On Approved, FitManager completes the sale: stock, membership, payment and, if you have one, the fiscal receipt. On Declined or Cancelled, the pending sale is dropped and the cart stays on the POS.

Nothing at the gym needs to be reachable from the internet.

What you need#

• The POS card terminal feature on your plan.
• A card terminal from your bank with a cash-register (ECR) connection, connected to the reception PC by cable or on the same network. Ask your bank for an ECR-capable terminal, and for a test terminal for the first days if they have one.
• FitManager Control installed and activated on the reception PC, with the POS System tab switched on. See Set up FitManager Control.
• A gym API key, made under Settings, Integrations, API integration.
• The Manage settings permission in FitManager.

Step 1: Set up the terminal in FitManager#

Settings, Point of sale holds what the sales screen at this location is wired to.

Under Card terminal, click Set up terminal.

Name it after where it stands, for example Reception desk.

Leave it Active. Disabled stops card sales from going to it.

Click Save.

The terminal card shows its state, reported problems and the Terminal id to copy.

Copy the Platform API address too. Both go into FitManager Control on the reception PC.

Every card sale sent to the terminal is listed here. An unknown result is resolved here too.

Next

Done

That is everything. You can replay it any time.

Start over

1. Settings, Point of sale holds what the sales screen at this location is wired to.

2. Under Card terminal, click Set up terminal.

3. Name it after where it stands, for example Reception desk.

4. Leave it Active. Disabled stops card sales from going to it.

5. Click Save.

6. The terminal card shows its state, reported problems and the Terminal id to copy.

7. Copy the Platform API address too. Both go into FitManager Control on the reception PC.

8. Every card sale sent to the terminal is listed here. An unknown result is resolved here too.

1. Step 1: Settings, Point of sale holds what the sales screen at this location is wired to.
2. Step 2: Under Card terminal, click Set up terminal.
3. Step 3: Name it after where it stands, for example Reception desk.
4. Step 4: Leave it Active. Disabled stops card sales from going to it.
5. Step 5: Click Save.
6. Step 6: The terminal card shows its state, reported problems and the Terminal id to copy.
7. Step 7: Copy the Platform API address too. Both go into FitManager Control on the reception PC.
8. Step 8: Every card sale sent to the terminal is listed here. An unknown result is resolved here too.

1. Open Settings, Facility settings, Point of sale. Make sure the right facility is selected at the top.
2. Under Card terminal, click Set up terminal. If one exists already, click Add another terminal.
3. Enter a Name, for example Reception desk, and leave Status on Active.
4. Click Save.
5. On the terminal's card, copy the Terminal id with the copy button.
6. In Connect FitManager Control on the right, copy the Platform API address.

Set up one terminal for every place that takes cards: the desk, a second till, or a kiosk.

Step 2: Connect the terminal in FitManager Control#

On the reception PC:

1. Open FitManager Control and click Settings. Paste the gym API key into Gym API bearer token if it is not there already, and save.
2. Open the POS System tab and click + Card terminal.
3. Give it a Name and tick This terminal is in use.
4. Under The web POS, tick Charge the gym's web POS card sales on this terminal.
5. Paste the Platform API address and the Terminal id from Step 1.
6. Under Card terminal, choose the Driver and fill in what it asks for: the DLL path for the Payten DLL, the Terminal address and port for a terminal on the network, or the Serial port for a cable.
7. Leave Currency on MKD unless your bank says otherwise. Card wait is how long the terminal waits for a card before it gives up.
8. Click Save, then Test sale (1.00) on the terminal's card to check the connection.

Within a minute, the terminal in FitManager shows Online with the driver name and Control's version.

Step 3: Take a card payment#

1. On the POS, add the items and choose Card.
2. Leave Send to payment terminal on and click Checkout.
3. The Waiting for the terminal window shows the amount and the reference. Ask the customer to tap or insert the card.
4. When the card is approved, the window closes, the cart clears and the sale is in Purchases as paid, with the terminal's authorisation code.

To stop a payment, click Cancel payment. If the terminal has not picked it up yet, it is cancelled at once. If the card is declined, the POS says The card was declined. and keeps the cart, so you can try another card or take cash.

To take a card on the terminal by hand for once, switch Send to payment terminal off before Checkout. The sale is then recorded as a card payment straight away.

The terminal card#

On Settings, Point of sale, each terminal shows:

• Active or Disabled, and Online or Offline. A terminal is online when Control has checked in within the last couple of minutes.
• Terminal state: when it was last seen, the driver and Control's version.
• Reported problems in the terminal's own words, or No problems reported.
• Edit and Remove terminal. A terminal with a sale in progress cannot be removed.

Recent card sales lists the last 15 card sales across your terminals with the reference, amount, state, auth code and a link to the sale.

When the terminal does not answer#

Rarely, the connection drops after the card was read, so nobody knows whether the bank took the money. Control first asks the bank. If it still does not know, the POS says The terminal did not answer for sale POS-000123. and the sale stays Pending.

1. Check the terminal's own receipt roll or its last transaction for that amount.
2. On Settings, Point of sale, find the sale under Recent card sales with the state Unknown.
3. Click Card was charged if the terminal shows the payment. The sale is completed as paid by card.
4. Click Not charged if it does not. The pending sale is dropped and you can sell again.

Troubleshooting#