Collegare il terminale Freika alla cassa

Ecco come collegare un terminale di pagamento Freika (p. es. il Freika PAX IM30) al Suo terminale di cassa scango.ch. Ci sono due modi: in locale, la cassa comunica direttamente con il terminale attraverso la rete del Suo negozio, oppure tramite il cloud Freika, scango.ch gestisce il terminale via Internet attraverso il Suo account Freika.

Questo collegamento lo effettuiamo noi all'avvio, prima della spedizione dell'hardware. Questa guida Le serve solo se qualcosa cambia durante il funzionamento, p. es. quando un terminale di pagamento viene sostituito, riceve un nuovo indirizzo nella rete o se cambia il tipo di collegamento.

Locale o cloud?

Collegamento	Come funziona	Buono a sapersi
Terminale Freika (locale)	Il terminale e la cassa sono nella stessa rete. La cassa si rivolge direttamente al terminale tramite il suo indirizzo IP.	Il collegamento più rapido. Funziona anche quando la connessione Internet della rete è interrotta.
Terminale Freika (cloud)	La cassa gestisce il terminale via Internet e il cloud Freika, attraverso l'account Freika della Sua organizzazione.	Il terminale può trovarsi in un'altra rete. La cassa e il terminale hanno bisogno di Internet.

Preparazione

Il terminale di pagamento Freika e il terminale di cassa scango.ch sono collegati alla corrente e a Internet e l'app scango.ch sul terminale di cassa è avviata.
Ha effettuato l'accesso alla dashboard scango.ch come Admin o Proprietario. Solo questi ruoli possono configurare i pagamenti di una cassa.
Per il collegamento cloud ha accesso alla dashboard Freika del Suo account Freika.

1. Aprire i pagamenti della cassa

Nella dashboard apra Impostazioni, poi Organizzazione e a sinistra la sottopagina Dispositivi.
Nella riga della Sua cassa clicchi sull'icona della carta («Configura i pagamenti di …»). Si apre la finestra Pagamenti.
Clicchi su Aggiungi connessione e scelga Terminale Freika (locale) o Terminale Freika (cloud).

Per ogni tipo di collegamento la finestra riassume brevemente i passi.

2a. Collegare in locale

Colleghi il terminale di pagamento alla stessa rete della cassa (LAN o Wi-Fi). Idealmente assegni al terminale un indirizzo fisso nel router, così non cambia.
Nel riquadro Cerca il terminale nella rete clicchi su Cerca nella rete. La ricerca avviene sulla cassa stessa, perché solo la cassa raggiunge la rete del Suo negozio: riceve la richiesta entro un minuto, poi la ricerca dura qualche secondo.
I terminali trovati compaiono con indirizzo e porta, modello, numero del terminale, nome dell'esercente e numero di serie. Clicchi sul terminale giusto (Usa). Indirizzo IP, porta e numero del terminale vengono così compilati.
Se vuole, inserisca un nome in Nome (facoltativo), p. es. «terminale all'ingresso». È utile se salva più terminali.
Clicchi su Aggiungi e poi su Salva. La cassa usa il terminale dalla prossima sincronizzazione.

Può anche inserire i dati a mano: legga l'indirizzo IP sul terminale (Impostazioni → Rete) e lo inserisca in Indirizzo IP del terminale, solo l'indirizzo, senza «http://» e senza porta. Lasci la Porta su 50000 (predefinita). Il Numero del terminale (facoltativo) è indicato sul terminale o nell'account Freika.

La ricerca richiede una cassa accesa e online. Se la finestra mostra «L'apparecchio è offline», accenda la cassa e la colleghi alla rete. Se indica «L'app su questo apparecchio non può ancora cercare», inserisca l'indirizzo a mano o si rivolga al supporto per un aggiornamento dell'app.

2b. Collegare tramite il cloud Freika

Collegare l'account Freika (serve una sola volta per organizzazione): crei una chiave API nella dashboard Freika sotto «Sviluppatori». La inserisca nella finestra Pagamenti in Chiave API Freika e clicchi su Collega. La chiave inizia con «fk_live_» o «fk_test_». Viene salvata in modo sicuro sul server e non viene più mostrata; la finestra indica poi «Account Freika collegato» con gli ultimi quattro caratteri della chiave.
In Terminale scelga il terminale che appartiene a questa cassa. L'elenco mostra i terminali del Suo account Freika con nome, modello e numero di serie. Il terminale deve essere acceso e connesso a Internet.
Se vuole, inserisca un Nome (facoltativo). Senza un nome proprio, scango.ch riprende il nome del terminale dall'account Freika.
Clicchi su Aggiungi e poi su Salva. La cassa usa il terminale dalla prossima sincronizzazione.

Con una chiave di test («fk_test_») non si muove denaro reale; i terminali di test sono contrassegnati con «test» nell'elenco. Per l'esercizio Le serve una chiave live.

Con Scollega elimina di nuovo la chiave API. Da quel momento tutte le casse della Sua organizzazione con un terminale cloud Freika non possono più accettare pagamenti con carta finché non inserisce di nuovo una chiave.

3. Più terminali e cambio

Per ogni cassa può salvare più connessioni e cambiare rapidamente in caso di problemi:

La connessione usata dal pulsante carta della cassa è contrassegnata con In uso, le altre connessioni configurate con Pronta.
Con Usa per i pagamenti con carta stabilisce quale connessione usa la cassa.
Con l'interruttore attiva o disattiva una connessione, con Modifica e Rimuovi la adatta.

Le modifiche valgono solo quando clicca su Salva.

4. Senza Internet

Nella finestra Pagamenti, in Senza Internet, stabilisce cosa fa la cassa quando è offline (Quando la cassa è offline):

Usa l'impostazione del negozio: vale quanto impostato nel negozio per zahls.ch offline.
Mostra il codice QR zahls.ch: la cassa mostra il codice QR del negozio al posto del terminale. zahls.ch deve essere configurato per il negozio.
Nessun pagamento con carta: senza Internet la cassa non offre pagamenti con carta.

Un terminale locale resta utilizzabile anche senza Internet, a meno che abbia scelto «Mostra il codice QR zahls.ch». Un terminale cloud ha sempre bisogno di Internet.

5. Testare

Testi il collegamento con un breve acquisto: scansioni un prodotto e tocchi «Paga CHF … con carta / TWINT». Il terminale di pagamento deve attivarsi.

Cercare terminali Freika alla cassa

Può avviare la ricerca anche direttamente alla cassa, p. es. per verificare se la cassa trova il terminale nella rete e quale terminale sta usando:

Nella schermata del carrello della cassa tocchi 5 volte entro 3 secondi il titolo in alto («I tuoi acquisti»).
Nella finestra PIN admin inserisca il PIN a quattro cifre del Suo negozio e confermi con OK. Se non conosce il PIN, si rivolga a support@scango.ch.
Nel menu Amministrazione tocchi Cerca terminali Freika. La ricerca parte subito e mostra quanti indirizzi sono già stati controllati.
Ogni terminale trovato compare con indirizzo e porta, Modello, Numero terminale, Numero di serie, Esercente e Software. Il terminale che la cassa usa è contrassegnato con «Usato da questa cassa».
Con Cerca di nuovo ripete la ricerca, con Chiudi esce dal menu.

La cassa chiede a ogni terminale solo i suoi dati: non viene addebitato nulla e sul terminale non appare nulla. Quale terminale usa la cassa si stabilisce nella dashboard (vedi sopra). Le diciture seguono la lingua del dispositivo di cassa (p. es. «Freika-Terminals suchen» in tedesco).

Qualcosa non funziona?

Entrambi i dispositivi sono collegati alla corrente e tutti i cavi sono inseriti correttamente.
La connessione Internet funziona (modem in funzione, accesso possibile da un altro dispositivo). Attenzione: se la Sua rete dispone di un firewall o se l'accesso a Internet è limitato in altro modo, verifichi che il terminale di cassa e il terminale di pagamento siano autorizzati nella rete.
Se la ricerca indica «Nessun terminale trovato», verifichi che il terminale sia acceso e nella stessa rete della cassa e che l'interfaccia cassa (LTI) sia attiva sulla porta 50000.
Se un risultato indica «Porta aperta, ma nessuna risposta da terminale», il terminale è occupato in quel momento oppure si tratta di un altro apparecchio. Ripeta la ricerca più tardi.
Se l'indirizzo del terminale è cambiato, lo cerchi di nuovo e riprenda il nuovo indirizzo. Un indirizzo fisso nel router lo evita.
Se la dashboard indica «Freika ha rifiutato la chiave», verifichi che la chiave API sia completa e ancora valida.
Se in Terminale compare che il terminale salvato non esiste più nell'account Freika, scelga il nuovo terminale dall'elenco e salvi.

Continua a non funzionare?

Invii un'e-mail a support@scango.ch.
Descriva il più precisamente possibile cosa non funziona e, se possibile, alleghi delle immagini. Solo descrizioni precise degli errori possono essere trattate in modo efficiente.
Lasci i dispositivi collegati alla corrente e a Internet, così è possibile un accesso di manutenzione remota.

Domande frequenti

Devo collegare in locale o tramite il cloud?

Se il terminale è nella stessa rete della cassa, il collegamento locale è il più rapido e funziona anche durante un'interruzione di Internet. Il collegamento cloud è adatto se il terminale e la cassa non sono nella stessa rete.

Devo inserire la chiave API Freika per ogni cassa?

No. La chiave vale per tutta l'organizzazione. Poi per ogni cassa sceglie solo il suo terminale dall'elenco.

Posso scegliere un terminale alla cassa?

No. Alla cassa vede solo quali terminali trova e quale usa. Quale terminale usa per i pagamenti con carta si stabilisce nella dashboard in Dispositivi.

Per la messa in funzione dei dispositivi consulti Hardware. Per un terminale PayTec veda Collegare il terminale PayTec alla cassa.