Connecter le terminal Freika à la caisse

Voici comment connecter un terminal de paiement Freika (p. ex. le Freika PAX IM30) à votre terminal de caisse scango.ch. Il existe deux manières : en local, la caisse communique alors directement avec le terminal via le réseau de votre magasin, ou via le cloud Freika, scango.ch pilote alors le terminal par Internet au moyen de votre compte Freika.

Nous établissons cette connexion pour vous au démarrage, avant l'envoi du matériel. Vous n'avez besoin de ce guide que si quelque chose change en cours d'exploitation, p. ex. lorsqu'un terminal de paiement est remplacé, reçoit une nouvelle adresse dans le réseau ou si vous changez de type de connexion.

Local ou cloud ?

Connexion	Fonctionnement	Bon à savoir
Terminal Freika (local)	Le terminal et la caisse sont dans le même réseau. La caisse s'adresse directement au terminal par son adresse IP.	Connexion la plus rapide. Fonctionne aussi lorsque la connexion Internet du réseau est interrompue.
Terminal Freika (cloud)	La caisse pilote le terminal via Internet et le cloud Freika, au moyen du compte Freika de votre organisation.	Le terminal peut se trouver dans un autre réseau. La caisse et le terminal ont besoin d'Internet.

Préparation

Le terminal de paiement Freika et le terminal de caisse scango.ch sont branchés au courant et à Internet, et l'application scango.ch est démarrée sur le terminal de caisse.
Vous êtes connecté au tableau de bord scango.ch en tant qu'Admin ou Propriétaire. Seuls ces rôles peuvent configurer les paiements d'une caisse.
Pour la connexion cloud, vous avez accès au tableau de bord Freika de votre compte Freika.

1. Ouvrir les paiements de la caisse

Dans le tableau de bord, ouvrez Paramètres, puis Organisation et à gauche la sous-page Appareils.
Dans la ligne de votre caisse, cliquez sur l'icône de carte (« Configurer les paiements de … »). La fenêtre Paiements s'ouvre.
Cliquez sur Ajouter une connexion et choisissez Terminal Freika (local) ou Terminal Freika (cloud).

Pour chaque type de connexion, la fenêtre rappelle brièvement les étapes.

2a. Connecter en local

Connectez le terminal de paiement au même réseau que la caisse (LAN ou Wi-Fi). Idéalement, attribuez au terminal une adresse fixe dans le routeur pour qu'elle ne change pas.
Dans l'encadré Rechercher le terminal dans le réseau, cliquez sur Rechercher dans le réseau. La recherche s'effectue sur la caisse elle-même, car elle seule atteint le réseau de votre magasin : elle prend la demande en charge en une minute, la recherche dure ensuite quelques secondes.
Les terminaux trouvés s'affichent avec adresse et port, modèle, numéro de terminal, nom du commerçant et numéro de série. Cliquez sur le bon terminal (Reprendre). L'adresse IP, le port et le numéro du terminal sont alors remplis.
Si vous le souhaitez, saisissez un nom sous Désignation (facultatif), p. ex. « terminal à l'entrée ». Cela aide si vous enregistrez plusieurs terminaux.
Cliquez sur Ajouter, puis sur Enregistrer. La caisse utilise le terminal dès la prochaine synchronisation.

Vous pouvez aussi saisir les données à la main : relevez l'adresse IP sur le terminal (Réglages → Réseau) et saisissez-la sous Adresse IP du terminal, uniquement l'adresse, sans « http:// » ni port. Laissez le Port sur 50000 (par défaut). Le Numéro du terminal (facultatif) figure sur le terminal ou dans le compte Freika.

La recherche nécessite une caisse allumée et en ligne. Si la fenêtre affiche « L'appareil est hors ligne », allumez la caisse et connectez-la au réseau. Si elle indique « L'app de cet appareil ne peut pas encore rechercher », saisissez l'adresse à la main ou contactez le support pour une mise à jour de l'application.

2b. Connecter via le cloud Freika

Connecter le compte Freika (une seule fois par organisation) : créez une clé API dans le tableau de bord Freika sous « Développeurs ». Saisissez-la dans la fenêtre Paiements sous Clé API Freika et cliquez sur Connecter. La clé commence par « fk_live_ » ou « fk_test_ ». Elle est stockée en sécurité sur le serveur et n'est plus jamais affichée ; la fenêtre indique ensuite « Compte Freika connecté » avec les quatre derniers caractères de la clé.
Sous Terminal, choisissez le terminal qui appartient à cette caisse. La liste affiche les terminaux de votre compte Freika avec nom, modèle et numéro de série. Le terminal doit être allumé et connecté à Internet.
Si vous le souhaitez, saisissez une Désignation (facultatif). Sans désignation propre, scango.ch reprend le nom du terminal enregistré dans le compte Freika.
Cliquez sur Ajouter, puis sur Enregistrer. La caisse utilise le terminal dès la prochaine synchronisation.

Avec une clé de test (« fk_test_ »), aucun argent réel ne circule ; les terminaux de test sont signalés par « test » dans la liste. Pour l'exploitation, il vous faut une clé live.

Déconnecter supprime à nouveau la clé API. Ensuite, toutes les caisses de votre organisation avec un terminal cloud Freika ne peuvent plus accepter de paiements par carte jusqu'à ce que vous saisissiez une nouvelle clé.

3. Plusieurs terminaux et changement

Vous pouvez enregistrer plusieurs connexions par caisse et changer rapidement en cas de problème :

La connexion utilisée par le bouton carte de la caisse est signalée par Utilisée, les autres connexions configurées par Prête.
Utiliser pour les paiements par carte définit la connexion que prend la caisse.
L'interrupteur active ou désactive une connexion, Modifier et Supprimer permettent de l'adapter.

Les modifications ne s'appliquent qu'une fois que vous avez cliqué sur Enregistrer.

4. Sans Internet

Dans la fenêtre Paiements, sous Sans Internet, vous définissez ce que fait la caisse lorsqu'elle est hors ligne (Quand la caisse est hors ligne) :

Utiliser le réglage du magasin : le réglage zahls.ch hors ligne du magasin s'applique.
Afficher le code QR zahls.ch : la caisse affiche le code QR du magasin à la place du terminal. zahls.ch doit être configuré pour le magasin.
Pas de paiement par carte : sans Internet, la caisse ne propose pas de paiement par carte.

Un terminal local reste utilisable sans Internet, sauf si vous avez choisi « Afficher le code QR zahls.ch ». Un terminal cloud a toujours besoin d'Internet.

5. Tester

Testez la connexion avec un court achat : scannez un produit et touchez « Payer CHF … par carte / TWINT ». Le terminal de paiement doit s'activer.

Rechercher des terminaux Freika à la caisse

Vous pouvez aussi lancer la recherche directement à la caisse, p. ex. pour vérifier si la caisse trouve le terminal dans le réseau et quel terminal elle utilise :

Sur l'écran du panier de la caisse, touchez 5 fois en 3 secondes le titre en haut (« Vos achats »).
Dans la fenêtre PIN admin, saisissez le code PIN à quatre chiffres de votre magasin et confirmez avec OK. Si vous ne connaissez pas le PIN, contactez support@scango.ch.
Dans le menu Administration, touchez Rechercher des terminaux Freika. La recherche démarre aussitôt et indique combien d'adresses ont déjà été vérifiées.
Chaque terminal trouvé s'affiche avec adresse et port, Modèle, Numéro de terminal, Numéro de série, Commerçant et Logiciel. Le terminal que la caisse utilise est signalé par « Utilisé par cette caisse ».
Rechercher à nouveau relance la recherche, Fermer quitte le menu.

La caisse demande seulement ses informations à chaque terminal : rien n'est débité et rien ne s'affiche sur le terminal. Le terminal que la caisse utilise se définit dans le tableau de bord (voir plus haut). Les libellés suivent la langue de l'appareil de caisse (p. ex. « Freika-Terminals suchen » en allemand).

Quelque chose ne fonctionne pas ?

Les deux appareils sont alimentés et tous les câbles sont correctement branchés.
La connexion Internet fonctionne (modem en marche, accès possible depuis un autre appareil). Attention : si votre réseau dispose d'un pare-feu ou si l'accès à Internet est restreint d'une autre manière, vérifiez que le terminal de caisse et le terminal de paiement sont autorisés sur le réseau.
Si la recherche indique « Aucun terminal trouvé », vérifiez que le terminal est allumé et dans le même réseau que la caisse, et que l'interface caisse (LTI) est active sur le port 50000.
Si un résultat indique « Port ouvert, mais pas de réponse de terminal », le terminal est occupé pour l'instant ou il s'agit d'un autre appareil. Relancez la recherche plus tard.
Si l'adresse du terminal a changé, recherchez-le à nouveau et reprenez la nouvelle adresse. Une adresse fixe dans le routeur l'évite.
Si le tableau de bord indique « Freika a refusé la clé », vérifiez que la clé API est complète et encore valide.
Si Terminal indique que le terminal enregistré n'existe plus dans le compte Freika, choisissez le nouveau terminal dans la liste et enregistrez.

Cela ne fonctionne toujours pas ?

Envoyez un e-mail à support@scango.ch.
Décrivez aussi précisément que possible ce qui ne fonctionne pas et joignez si possible des photos. Seules des descriptions d'erreur précises peuvent être traitées efficacement.
Laissez les appareils branchés au courant et à Internet afin qu'un accès de maintenance à distance soit possible.

Questions fréquentes

Dois-je connecter en local ou via le cloud ?

Si le terminal est dans le même réseau que la caisse, la connexion locale est la plus rapide et fonctionne aussi pendant une coupure d'Internet. La connexion cloud convient si le terminal et la caisse ne sont pas dans le même réseau.

Dois-je saisir la clé API Freika pour chaque caisse ?

Non. La clé vaut pour toute l'organisation. Ensuite, vous choisissez seulement le terminal de chaque caisse dans la liste.

Puis-je choisir un terminal à la caisse ?

Non. À la caisse, vous voyez seulement les terminaux qu'elle trouve et celui qu'elle utilise. Le terminal qu'elle prend pour les paiements par carte se définit dans le tableau de bord sous Appareils.

Pour la mise en service des appareils, consultez Matériel. Pour un terminal PayTec, voir Connecter le terminal PayTec à la caisse.