Pagamento con carta con SumUp Solo (tipo di terminale «SumUp Reader»)¶

Il SumUp Solo è un lettore di carte che si collega a Internet da solo tramite Wi-Fi o rete mobile. DiKAS lo controlla attraverso il cloud di SumUp: la cassa invia l'importo a SumUp, l'importo compare sul Solo, l'ospite paga – e DiKAS registra il pagamento non appena SumUp lo conferma. Non servono indirizzo IP, agente hardware né inoltro di porte sul router. Questa pagina accompagna dalle credenziali SumUp al primo pagamento di prova e spiega cosa osservare per storni, mance e chiusura giornaliera.

Alcuni testi compaiono in tedesco

La scheda SumUp, i nomi dei suoi campi e i messaggi che provengono dal server o da SumUp sono mostrati in tedesco in tutte le lingue. Qui sono riportati esattamente come appaiono, seguiti da una traduzione.

Dispositivi supportati¶

Dispositivo	Collegamento in DiKAS	Stato
SumUp Solo (Wi-Fi/rete mobile)	Tipo di terminale SumUp Reader, associato con un codice di associazione tramite il cloud SumUp	✅ Supportato
Più Solo per account SumUp	Un terminale proprio in DiKAS per dispositivo	✅ Supportato
SumUp Air (Bluetooth)	—	❌ Al momento non supportato
Smartphone o tablet come lettore (SumUp Tap to Pay)	—	❌ Al momento non supportato

Per lo smartphone o il tablet come lettore di carte DiKAS offre altri percorsi, ad esempio Softpay. La panoramica in Hardware → Terminali per carte mostra quale soluzione si adatta alla vostra attività.

Paesi e valuta

Se e dove SumUp offre e attiva il Solo lo decide SumUp. DiKAS registra nella valuta indicata nella scheda SumUp (ad esempio EUR o CHF). Se il campo è vuoto, vale la valuta principale dell'attività. Per le attività svizzere SumUp è elencato nella panoramica dei terminali di pagamento.

Requisiti¶

Un account esercente configurato e attivato da SumUp.
Un SumUp Solo con accesso a Internet (Wi-Fi, facoltativamente rete mobile – SumUp attiva la rete mobile separatamente).

Quattro dati dell'account SumUp:

Dato	Cos'è	Campo in DiKAS
API key	Chiave segreta, inizia con `sup_sk_`	API-Key
Merchant Code	Identificativo dell'account esercente, ad es. `MXXXXXXX`	Merchant Code
Affiliate Key	Chiave per l'assegnazione dell'applicazione	Affiliate Key
App-ID	L'identificativo dell'applicazione indicato presso SumUp alla creazione dell'Affiliate Key	Affiliate App-ID

Un utente con accesso ad Admin → Impostazioni.
Per mostrare lo stato del dispositivo in DiKAS: firmware del Solo 3.3.39.0 o successivo. Per terminare correttamente sul Solo un pagamento annullato: 3.3.28.0 o successivo. Il firmware più vecchio continua a funzionare, solo senza queste funzioni aggiuntive.

Affiliate Key e App-ID vanno insieme

Per i pagamenti sul Solo devono essere inseriti completi sia l'Affiliate Key sia l'Affiliate App-ID. L'App-ID non è il Merchant Code né un ID di terminale o di lettore, ma esattamente il valore con cui l'Affiliate Key è stato creato presso SumUp. Per associare il Solo l'Affiliate Key non serve, per ogni pagamento sì.

Dove nell'account SumUp?

API key e Affiliate Key si creano nell'area sviluppatori di SumUp (developer.sumup.com). Annotare subito l'App-ID.

Configurazione in 7 passaggi¶

Rispettare l'ordine

La scheda SumUp compare nelle impostazioni solo dopo aver salvato un terminale di tipo SumUp Reader. Per questo il terminale viene per primo. Se la scheda non compare subito, ricaricare la pagina una volta.

Creare il terminale: aprire Admin → Impostazioni → Hardware → Opzioni di pagamento e scegliere Aggiungi terminale.
Assegnare un Nome univoco (ad esempio «Solo Bancone 1»), scegliere SumUp Reader in Tipo e Salva. DiKAS disattiva da solo Il terminale ha una stampante propria: il Solo non stampa, la cassa stampa la ricevuta della carta.
Inserire le credenziali: aprire Admin → Impostazioni → Hardware → SumUp. Inserire API-Key, Merchant Code, Affiliate Key, Affiliate App-ID e Währung (valuta). In alto a destra fare clic su Speichern (Salva) e attendere il messaggio «SumUp-Konfiguration gespeichert» (configurazione SumUp salvata). L'API key viene salvata cifrata e non viene più mostrata; dopo il campo indica solo «(gesetzt)» (impostata).
Collegare il Solo al Wi-Fi: accendere il Solo. Se è ancora connesso a un account SumUp, disconnetterlo con Settings → About → Log out: un dispositivo connesso non può essere associato. Poi aprire nel menu superiore Connections → Wi-Fi, scegliere il Wi-Fi dell'attività e inserire la password.
Generare il codice di associazione: sul Solo scegliere nel menu superiore Connections → API → Connect. Il dispositivo mostra un codice di associazione valido solo circa 5 minuti. Ha 8 o 9 caratteri.
Associare in DiKAS: tornati in Hardware → Opzioni di pagamento, fare clic su Associa lettore (icona di collegamento) nella riga del terminale. Nella finestra «Associa lettore SumUp» inserire il codice e scegliere Associa. DiKAS salva il terminale prima dell'associazione, interroga SumUp e inserisce da solo il Reader-ID assegnato da SumUp nell'omonimo campo. Poi compare «Reader gekoppelt und gespeichert: …» (lettore associato e salvato).
Verificare: nella riga del terminale scegliere Verifica stato (icona Wi-Fi). Verde significa: associato e online. Poi eseguire un piccolo pagamento di prova – l'importo deve comparire sul Solo e, a pagamento riuscito, DiKAS chiude lo scontrino.

Dopo un aggiornamento

Se DiKAS è stato appena aggiornato o riavviato, ricaricare la pagina una volta e controllare i dati SumUp prima di provare un pagamento.

Rete

Il Solo stabilisce la connessione verso l'esterno (cifrata, porta 443). Un Wi-Fi ospiti basta, purché abbia Internet. Il Solo non funziona con una pagina di accesso (captive portal) né con un Wi-Fi che filtra in modo rigido – in tal caso usare un altro Wi-Fi o la rete mobile. Se sono disponibili sia Wi-Fi sia rete mobile, il Solo usa il Wi-Fi. Cassa e Solo non devono trovarsi nella stessa rete; entrambi hanno bisogno solo di Internet.

Solo già associato nell'account SumUp?

Se il Solo è già associato nell'account SumUp, il suo ID lettore può anche essere inserito direttamente nel campo Reader-ID della riga del terminale. DiKAS rimuove gli spazi ai bordi al salvataggio.

Più Solo e più casse¶

Un account SumUp può associare più Solo, e questi possono elaborare pagamenti contemporaneamente:

Inserire le credenziali una sola volta nella scheda SumUp: valgono per tutti i Solo dell'account.
Creare un terminale per ogni Solo in Hardware → Opzioni di pagamento (tipo SumUp Reader, nome univoco come «Solo Terrazza») e associare ogni Solo singolarmente. Generare sempre il codice di associazione nuovo sul rispettivo dispositivo.
Assegnare il terminale alla cassa:
- centralmente per postazione in Admin → Impostazioni → Attività → Postazioni di lavoro, campo EC-Terminal (la scheda compare solo se le postazioni sono attive), oppure
- direttamente sul dispositivo, nelle impostazioni della cassa, campo Terminale (scelte: Predefinito (nome), un terminale specifico oppure -- Nessun terminale --).
Scelta a ogni pagamento: se più addetti condividono su un dispositivo più terminali, Scegli il terminale a ogni pagamento con carta nelle impostazioni della cassa antepone una selezione al pagamento. Offri nella selezione definisce quali terminali offre questo dispositivo. L'impostazione vale solo per quel dispositivo.
Per ogni Solo eseguire Verifica stato e un piccolo pagamento di prova e controllare che l'importo compaia sul Solo giusto.

Senza scelta propria, un dispositivo incassa tramite il terminale predefinito dell'attività. Più casse possono condividere un Solo; un Solo accetta però sempre un solo pagamento alla volta. Dove si incassa contemporaneamente, ogni postazione ha bisogno di un proprio Solo.

Ogni Solo ha bisogno di un proprio Reader-ID

Se una voce di terminale viene copiata, riprende l'ID lettore dell'originale – due casse si rivolgerebbero allora allo stesso Solo. DiKAS salva comunque, ma dopo il salvataggio mostra l'avviso «Dieselbe SumUp-Reader-ID ist an mehreren Terminals hinterlegt …» (lo stesso ID lettore SumUp è memorizzato su più terminali), e Verifica stato mostra un'icona di avviso gialla con «Reader-ID auch an Terminal … hinterlegt». Sul terminale copiato associare di nuovo il Solo.

Come funziona un pagamento¶

Al pagamento scegliere il pagamento con carta. Con più terminali scegliere prima il terminale.
La finestra Pagamento con carta indica in alto il terminale e mostra «Elaborazione dell'operazione …» con l'indicazione «Avvicinare o inserire la carta nel terminale». Contemporaneamente l'importo compare sul Solo.
L'ospite avvicina o inserisce la carta oppure digita il PIN. DiKAS chiede a SumUp il risultato circa ogni 2 secondi, al massimo per 120 secondi.
In caso di successo la finestra mostra «Pagamento riuscito» con l'ID della transazione; DiKAS registra il pagamento e chiude lo scontrino. Se il pagamento viene rifiutato, la finestra segnala «Pagamento rifiutato».

Ricevuta della carta: il Solo non ha una stampante propria. Con Il terminale ha una stampante propria disattivato (come DiKAS lo imposta alla creazione del terminale), la cassa stampa la ricevuta della carta insieme allo scontrino.

Mancia: una mancia inserita sul Solo non viene comunicata da SumUp alla cassa. Registrare la mancia in cassa prima di avviare il pagamento con carta.

Annullamento o scadenza del tempo: se la cassa annulla il pagamento o il tempo di attesa scade, DiKAS termina l'operazione sul Solo (firmware 3.3.28.0 o successivo) e chiede a SumUp il risultato ancora una volta. Se il pagamento è andato a buon fine proprio in quel momento, DiKAS lo registra: la carta non viene mai addebitata senza che nasca una ricevuta. Se l'importo resta comunque sul Solo (ad esempio perché il Solo è offline), verificare nella dashboard SumUp se il pagamento è andato a buon fine.

Storno, accredito e chiusura giornaliera¶

Operazione	Come funziona con SumUp
Storno di uno scontrino con pagamento con carta	Stornare lo scontrino in Menu → Fatture. DiKAS rimborsa la carta con riferimento alla transazione SumUp originale. Senza tale riferimento il processo termina in un caso da chiarire visibile e non viene registrato nulla.
Accredito su carta senza pagamento originale	Non possibile. SumUp rimborsa solo un pagamento esistente. DiKAS segnala: «Eine referenzlose Karten-Gutschrift ist bei SumUp nicht möglich – bitte über die SumUp-App/das SumUp-Dashboard erstatten.» (un accredito senza riferimento non è possibile con SumUp: rimborsare tramite l'app o la dashboard SumUp). In alternativa stornare lo scontrino originale.
Chiusura giornaliera / chiusura di cassa sul terminale	Non prevista. DiKAS segnala: «SumUp kennt keinen Kassenschnitt – Auszahlungen laufen automatisch (SumUp-Dashboard).» (SumUp non ha una chiusura di cassa del terminale; i versamenti avvengono automaticamente.) I versamenti di SumUp compaiono nella dashboard SumUp.

Maggiori informazioni su storni e accrediti: Metodi di pagamento e Documenti.

Limiti¶

Solo il SumUp Solo tramite il cloud SumUp; i lettori Bluetooth e lo smartphone come lettore non fanno parte di questo percorso.
Servono Internet su cassa e Solo: senza Internet nessun pagamento con carta su questo terminale.
Nessun accredito su carta senza pagamento originale, nessuna chiusura di cassa sul dispositivo.
La mancia dal dispositivo non viene riportata in cassa.
Un pagamento attende il risultato al massimo 120 secondi.
L'importo viene arrotondato a due decimali (nessun decimale per CLP, COP e HUF) e deve essere maggiore di 0.

Errori e rimedi¶

Cosa si vede	Causa e rimedio
«SumUp-Zugang abgelehnt: Bitte einen aktiven API-Secret-Key (sup_sk_…) aus dem SumUp-Händlerkonto prüfen.» (accesso a SumUp rifiutato)	L'API key non è valida, è stata revocata o non è una chiave segreta. Controllare nell'area sviluppatori di SumUp una chiave attiva (`sup_sk_…`) e inserirla e salvarla di nuovo nella scheda SumUp.
«Der hinterlegte SumUp-API-Schlüssel enthält ein Zeichen, das nicht übertragen werden kann …» (la chiave salvata contiene un carattere non trasmissibile)	Copiando sono stati inclusi uno spazio non separabile o un carattere speciale. Incollare di nuovo la chiave nella scheda SumUp.
«SumUp Fehler: BadRequest» durante l'associazione	SumUp ha rifiutato la richiesta – di solito il codice di associazione è scaduto o errato. Sul Solo riavviare Connections → API → Connect e inserire subito il nuovo codice.
Il codice di associazione non viene accettato	Il codice vale solo circa 5 minuti, oppure il Solo è ancora connesso. Disconnettersi sul Solo con Settings → About → Log out, riavviare Connections → API → Connect e associare subito in DiKAS.
«SumUp-Terminal … ist nicht konfiguriert (API-Key/Merchant-Code in den Einstellungen oder Reader-ID am Terminal fehlt).»	Nella scheda SumUp mancano API key o Merchant Code, oppure il terminale non ha un Reader-ID perché non è ancora stato associato. Completare i dati, salvare e associare il Solo.
«SumUp Affiliate-Key und Affiliate App-ID fehlen …» (mancano Affiliate Key e App-ID)	Inserire entrambi i valori nella scheda SumUp, fare esplicitamente clic su Speichern (Salva) e solo dopo incassare.
«SumUp-Terminal … nicht gefunden.» (terminale non trovato)	Il terminale non è salvato o è stato eliminato. Controllare nome e tipo in Hardware → Opzioni di pagamento, salvare e associare di nuovo.
«Reader … nicht gefunden.» (Verifica stato)	L'ID lettore non appartiene all'account SumUp. Controllare l'ID inserito o associare di nuovo il Solo.
«Kopplung abgelaufen – Leser neu pairen …» (associazione scaduta)	Il codice di associazione è stato confermato troppo tardi. Generare un nuovo codice sul Solo e associare di nuovo in DiKAS con Associa lettore.
«Kopplung am Gerät noch nicht bestätigt – den Pairing-Code am Solo bestätigen, dann erneut prüfen.» (non ancora confermato sul dispositivo)	L'associazione è stata avviata ma non completata sul Solo. Confermare il codice sul dispositivo, poi Verifica stato.
«Leser ist offline – WLAN am Solo (Connections → Wi-Fi) prüfen.» (il lettore è offline)	Il Solo non ha connessione a Internet. Sul Solo controllare che il Wi-Fi sia connesso (Internet, non solo rete) e riavviare il dispositivo se necessario. Poi Verifica stato.
«SumUp Fehler: UnprocessableEntity» durante un pagamento	SumUp rifiuta la richiesta, ad esempio perché il Solo è offline. Verifica stato, controllare il Wi-Fi del Solo e riavviare il pagamento.
«SumUp: Timeout – keine Antwort vom Reader.» (nessuna risposta dal lettore)	Nessun risultato dopo 120 secondi. Controllare Solo e Internet. Se l'ospite ha comunque pagato, DiKAS registra il pagamento da solo nella verifica successiva; in caso di dubbio guardare nella dashboard SumUp prima di incassare di nuovo.
«SumUp Zahlung FAILED.» (anche EXPIRED, CANCELLED)	Il Solo ha terminato l'operazione, ad esempio perché la carta è stata rifiutata o il tempo è scaduto. Avviare di nuovo il pagamento, eventualmente con un'altra carta.
«SumUp: Zahlung abgebrochen.» (pagamento annullato)	La cassa ha annullato il pagamento. L'operazione viene terminata sul Solo; riavviare il pagamento se necessario.
L'importo compare sul Solo sbagliato	Alla postazione o al dispositivo è assegnato un altro terminale. Correggere in Attività → Postazioni di lavoro → EC-Terminal o nelle impostazioni della cassa, campo Terminale.
Icona di avviso gialla: «Reader-ID auch an Terminal … hinterlegt»	Due terminali condividono un Reader-ID. Associare di nuovo uno dei due con il proprio Solo.
Lo stato è verde ma senza dati su batteria o firmware	Il Solo ha un firmware precedente alla 3.3.39.0. Il pagamento funziona; mancano solo i dati aggiuntivi. Aggiornare il firmware del Solo.

Sicurezza

DiKAS salva cifrata l'API key segreta. Non trasmettere le credenziali per e-mail o messenger e revocare la chiave nell'account SumUp in caso di sospetta perdita.

Passo successivo¶

→ Metodi di pagamento e pagamento con carta – flusso in cassa, storni e accrediti → Hardware → Terminali per carte – tutte le soluzioni di pagamento con carta in sintesi