Freika-Terminal mit Kasse verbinden

So verbindest du ein Freika-Zahlterminal (z. B. das Freika PAX IM30) mit deinem scango.ch-Kassenterminal. Es gibt zwei Arten: lokal, dann spricht die Kasse über das Netzwerk deines Ladens direkt mit dem Terminal, oder über die Freika-Cloud, dann steuert scango.ch das Terminal über dein Freika-Konto im Internet an.

Beim Start bzw. vor dem Versand der Hardware nehmen wir diese Verbindung für dich vor. Diese Anleitung brauchst du nur, wenn sich im Betrieb etwas ändert, z. B. wenn ein Zahlterminal ersetzt wird, eine neue Adresse im Netzwerk erhält oder du die Verbindungsart wechselst.

Lokal oder Cloud?

Vorbereitung

• Freika-Zahlterminal und scango.ch-Kassenterminal sind an Strom und Internet angeschlossen, die scango.ch-App am Kassenterminal ist gestartet.
• Du bist im scango.ch-Dashboard als Admin oder Eigentümer angemeldet. Nur diese Rollen können die Zahlungen einer Kasse einrichten.
• Für die Cloud-Verbindung hast du Zugang zum Freika-Dashboard deines Freika-Kontos.

1. Zahlungen der Kasse öffnen

1. Öffne im Dashboard Einstellungen, dann Organisation und links die Unterseite Geräte.
2. Klick in der Zeile deiner Kasse auf das Kartensymbol («Zahlungen von … einrichten»). Es öffnet sich das Fenster Zahlungen.
3. Klick auf Verbindung hinzufügen und wähl Freika Terminal (lokal) oder Freika Terminal (Cloud).

Das Fenster zeigt dir bei jeder Verbindungsart die Schritte nochmals kurz an.

2a. Lokal verbinden

1. Verbinde das Zahlterminal mit demselben Netzwerk wie die Kasse (LAN oder WLAN). Am besten vergibst du dem Terminal im Router eine feste Adresse, damit sie sich nicht ändert.
2. Klick im Kasten Terminal im Netzwerk suchen auf Im Netzwerk suchen. Die Suche läuft auf der Kasse selbst, weil nur sie das Netzwerk deines Ladens erreicht: Sie meldet sich innert einer Minute, die Suche dauert danach einige Sekunden.
3. Die gefundenen Terminals erscheinen mit Adresse und Port, Modell, Terminal-Nummer, Händlername und Seriennummer. Klick auf das richtige Terminal (Übernehmen). IP-Adresse, Port und Terminal-Nummer werden damit ausgefüllt.
4. Gib bei Bedarf unter Bezeichnung (optional) einen Namen ein, z. B. «Terminal beim Eingang». Das hilft, wenn du mehrere Terminals hinterlegst.
5. Klick auf Hinzufügen und danach auf Speichern. Die Kasse verwendet das Terminal ab der nächsten Synchronisation.

Du kannst die Angaben auch von Hand eintragen: Lies die IP-Adresse am Terminal ab (Einstellungen → Netzwerk) und trag sie unter IP-Adresse des Terminals ein, nur die Adresse, ohne «http://» und ohne Port. Den Port lässt du auf 50000 (Standard). Die Terminal-Nummer (optional) steht auf dem Terminal oder im Freika-Konto.

Die Suche braucht eine eingeschaltete Kasse mit Internet. Zeigt das Fenster «Das Gerät ist offline», schalt die Kasse ein und verbinde sie mit dem Netzwerk. Steht dort «Die App auf diesem Gerät kann noch nicht suchen», trag die Adresse von Hand ein oder melde dich beim Support für ein Update der App.

2b. Über die Freika-Cloud verbinden

1. Freika-Konto verbinden (nur einmal pro Organisation nötig): Erstelle im Freika-Dashboard unter «Entwickler» einen API-Schlüssel. Trag ihn im Fenster Zahlungen unter Freika-API-Schlüssel ein und klick auf Verbinden. Der Schlüssel beginnt mit «fk_live_» oder «fk_test_». Er wird sicher auf dem Server gespeichert und nie wieder angezeigt; im Fenster steht danach «Freika-Konto verbunden» mit den letzten vier Zeichen des Schlüssels.
2. Wähl unter Terminal das Terminal, das zu dieser Kasse gehört. Die Liste zeigt die Terminals deines Freika-Kontos mit Name, Modell und Seriennummer. Das Terminal muss eingeschaltet und mit dem Internet verbunden sein.
3. Gib bei Bedarf eine Bezeichnung (optional) ein. Ohne eigene Bezeichnung übernimmt scango.ch den Namen des Terminals aus dem Freika-Konto.
4. Klick auf Hinzufügen und danach auf Speichern. Die Kasse verwendet das Terminal ab der nächsten Synchronisation.

Mit einem Test-Schlüssel («fk_test_») fliesst kein echtes Geld; Testterminals sind in der Liste mit «Test» markiert. Für den Betrieb brauchst du einen Live-Schlüssel.

Mit Trennen löschst du den API-Schlüssel wieder. Danach können alle Kassen deiner Organisation mit einem Freika-Cloud-Terminal keine Kartenzahlungen mehr annehmen, bis du wieder einen Schlüssel einträgst.

3. Mehrere Terminals und Wechsel

Pro Kasse kannst du mehrere Verbindungen hinterlegen und bei einem Problem rasch wechseln:

• Die Verbindung, die der Kartenbutton der Kasse verwendet, ist mit In Verwendung markiert, weitere eingerichtete Verbindungen mit Bereit.
• Mit Für Kartenzahlung verwenden legst du fest, welche Verbindung die Kasse nimmt.
• Mit dem Schalter aktivierst oder deaktivierst du eine Verbindung, mit Bearbeiten und Entfernen passt du sie an.

Die Änderungen gelten erst, wenn du auf Speichern klickst.

4. Ohne Internet

Im Fenster Zahlungen legst du unter Ohne Internet fest, was die Kasse tut, wenn sie offline ist (Wenn die Kasse offline ist):

• Einstellung der Filiale verwenden: Es gilt, was bei der Filiale für zahls.ch offline eingestellt ist.
• zahls.ch-QR-Code anzeigen: Die Kasse zeigt statt des Terminals den QR-Code der Filiale. zahls.ch muss bei der Filiale eingerichtet sein.
• Keine Kartenzahlung: Ohne Internet bietet die Kasse keine Kartenzahlung an.

Ein lokales Terminal bleibt auch ohne Internet nutzbar, ausser du hast «zahls.ch-QR-Code anzeigen» gewählt. Ein Cloud-Terminal braucht immer Internet.

5. Testen

Teste die Verbindung mit einem kurzen Einkauf: Scann ein Produkt und tipp auf «CHF … mit Karte / TWINT bezahlen». Das Zahlterminal muss sich aktivieren.

Freika-Terminals an der Kasse suchen

Du kannst die Suche auch direkt an der Kasse starten, z. B. um zu prüfen, ob die Kasse das Terminal im Netzwerk findet und welches Terminal sie gerade verwendet:

1. Tipp auf dem Warenkorb-Bildschirm der Kasse innerhalb von 3 Sekunden 5-mal auf den Titel oben («dein Einkauf»).
2. Gib im Fenster Admin-PIN die vierstellige PIN deiner Filiale ein und bestätige mit OK. Kennst du die PIN nicht, wende dich an support@scango.ch.
3. Tipp im Menü Administration auf Freika-Terminals suchen. Die Suche startet sofort und zeigt, wie viele Adressen schon geprüft sind.
4. Jedes gefundene Terminal erscheint mit Adresse und Port, Modell, Terminal-Nummer, Seriennummer, Händler und Software. Das Terminal, das die Kasse verwendet, ist mit «Von dieser Kasse verwendet» markiert.
5. Mit Erneut suchen startest du die Suche nochmals, mit Schliessen verlässt du das Menü.

Die Kasse fragt dabei jedes Terminal nur nach seinen Angaben: Es wird nichts gebucht und am Terminal nichts angezeigt. Welches Terminal die Kasse verwendet, legst du im Dashboard fest (siehe oben). Die Beschriftung richtet sich nach der Gerätesprache der Kasse (z. B. «Find Freika terminals» auf Englisch).

Etwas klappt nicht?

• Beide Geräte sind am Strom und alle Kabel sind korrekt eingesteckt.
• Die Internetverbindung funktioniert (Modem in Betrieb, Zugang über ein anderes Gerät möglich). Achtung: Verfügt dein Netzwerk über eine Firewall oder ist der Internetzugang anderweitig eingeschränkt, prüf, ob Kassen- und Zahlterminal im Netzwerk zugelassen sind.
• Meldet die Suche «Kein Terminal gefunden», prüf, ob das Terminal eingeschaltet und im selben Netzwerk wie die Kasse ist und ob die Kassenschnittstelle (LTI) auf Port 50000 aktiv ist.
• Steht bei einem Treffer «Port offen, aber keine Antwort als Terminal», ist das Terminal gerade beschäftigt oder es ist ein anderes Gerät. Such später nochmals.
• Hat sich die Adresse des Terminals geändert, such es erneut und übernimm die neue Adresse. Eine feste Adresse im Router verhindert das.
• Meldet das Dashboard «Freika hat den Schlüssel abgelehnt», prüf, ob der API-Schlüssel vollständig und noch gültig ist.
• Steht unter Terminal, dass es das gespeicherte Terminal im Freika-Konto nicht mehr gibt, wähl das neue Terminal aus der Liste und speichere.

Klappt es trotzdem nicht?

• Sende eine E-Mail an support@scango.ch.
• Schildere möglichst genau, was nicht funktioniert, und sende wenn möglich Bilder mit. Nur genaue Fehlerbeschriebe können wir effizient bearbeiten.
• Lass die Geräte an Strom und Internet, damit ein Fernwartungszugriff möglich ist.

Häufige Fragen

Mehr zur Inbetriebnahme der Geräte findest du unter Hardware. Für ein PayTec-Terminal siehe PayTec-Terminal mit Kasse verbinden.