Pagamento con carta tramite SoftPOS (RS2 Beyond)¶

Con SoftPOS il dispositivo Android su cui gira DiKAS diventa esso stesso un terminale per carte: l'ospite avvicina carta, smartphone o smartwatch al dispositivo e il pagamento viene elaborato in modalità contactless. Non servono un terminale separato, né cavi, né accoppiamento. La carta viene elaborata dall'app certificata RS2 Beyond SoftPOS del nostro partner RS2; DiKAS le consegna solo l'importo e riceve il risultato. Questa pagina mostra quali dispositivi lo consentono, cosa va chiarito in anticipo e come configurarlo passo per passo.

Nell'elenco dei terminali questo tipo si chiama SoftPOS.

A chi si rivolge SoftPOS?¶

SoftPOS è adatto alle attività che vogliono incassare in modalità contactless senza dispositivo aggiuntivo, ad esempio con un tablet al banco o un palmare in sala. Un terminale ZVT, un lettore Stripe o SumUp già presente non viene toccato: si possono configurare più tipi di terminale in parallelo. Una panoramica di tutte le soluzioni per carte è in Pagamenti e Hardware → Terminali EC/carta.

Dispositivi e modalità di funzionamento supportati¶

Dispositivo o modalità	SoftPOS	Nota
Dispositivo Android con NFC, app DiKAS come cassa completa (con licenza propria)	✅ Supportato	La carta viene letta direttamente sul dispositivo.
Cassa cloud nel browser insieme a un dispositivo Android collegato (agente dispositivo)	✅ Supportato	Il dispositivo collegato legge la carta. Senza dispositivo collegato DiKAS segnala «Kein SoftPOS-Gerät gekoppelt.» (nessun dispositivo SoftPOS collegato). Approfondimento: Hardware in modalità cloud.
iPhone / iPad	❌ Non possibile	SoftPOS esiste solo per Android.
PC Windows, server Linux, box DiKAS	❌ Non possibile	Questi dispositivi non hanno NFC. DiKAS segnala «SoftPOS auf diesem Host nicht verfügbar.» (SoftPOS non disponibile su questo host).

Euro e paesi

SoftPOS regola esclusivamente in euro. In quali paesi sia possibile un conto esercente presso RS2 o il vostro fornitore di pagamenti lo stabilisce il contratto con il fornitore, non DiKAS.

Requisiti¶

Requisito	A cosa serve
Contratto o accesso esercente presso RS2 (o il fornitore di pagamenti che vi mette a disposizione SoftPOS)	Da qui derivano l'ID terminale (es. `RS2001C5`), il codice di attivazione e l'e-mail dell'esercente. Li assegna il fornitore, non DiKAS.
RS2 Beyond SoftPOS installata e attivata sul dispositivo	L'app legge la carta. Esiste una variante di produzione e una di test (QA). Per i pagamenti reali serve quella di produzione.
NFC attivo	Lettura contactless di carta, smartphone e smartwatch.
Opzioni sviluppatore di Android disattivate	Per motivi di sicurezza (certificazione PCI) SoftPOS non si avvia finché le opzioni sviluppatore sono attive.
Connessione a Internet	Il pagamento viene autorizzato online.
App DiKAS aggiornata sul dispositivo	Download e scelta della modalità: DiKAS su Android.
Un utente con accesso a Admin → Impostazioni	Per configurare il terminale.

Opzioni sviluppatore

Le opzioni sviluppatore si trovano nelle impostazioni di Android in Sistema → Opzioni sviluppatore (il nome varia a seconda del produttore). Disattivatele prima di incassare.

Configurazione in 8 passaggi¶

Configurare sul dispositivo

Configurate SoftPOS direttamente sul dispositivo Android che deve incassare. Solo questo dispositivo conosce l'app RS2 installata e può verificare la disponibilità (passaggio 8).

Installare e attivare RS2 Beyond SoftPOS — secondo la documentazione di RS2, con ID terminale, codice di attivazione e indirizzo e-mail. Questa attivazione avviene nell'app RS2, non in DiKAS.
Preparare Android: attivare NFC, disattivare le opzioni sviluppatore.
Aprire l'app DiKAS ed effettuare l'accesso, come descritto in DiKAS su Android.
Aprire le opzioni di pagamento: Admin → Impostazioni → Hardware → Opzioni di pagamento.
Toccare Aggiungi terminale, assegnare un nome (es. «Tablet banco») e scegliere SoftPOS in Tipo. DiKAS imposta Ambiente inizialmente su QA (test) e disattiva la stampa propria del terminale, perché SoftPOS non ha una stampante per scontrini.

Compilare i campi:

Campo	Inserimento
RS2-Terminal-ID	L'ID terminale dell'attivazione RS2, es. `RS2001C5`. Se il campo resta vuoto, DiKAS usa l'ID interno della voce.
Ambiente	Produzione per pagamenti reali. QA (test) solo per provare con la variante di test di RS2.
E-mail dell'esercente	L'indirizzo e-mail del vostro conto esercente presso RS2.

Salva. Un terminale salvato compare nell'elenco e può poi essere selezionato.
Toccare Verifica stato. Se il punto nella colonna di stato diventa verde, l'app RS2 è installata e pronta. Se è rosso o giallo, aiutano il testo al passaggio del mouse e la tabella Errori e rimedi.

Stampante propria disattivata

Nella vista a scheda sullo smartphone il terminale SoftPOS ha inoltre l'interruttore Il terminale stampa la ricevuta da solo. Lasciatelo disattivato: così DiKAS stampa la ricevuta della carta sullo scontrino.

Terminale predefinito e più dispositivi

In Terminale predefinito si stabilisce quale terminale DiKAS usa per i pagamenti con carta quando non vale un'altra assegnazione. Ogni dispositivo che incassa con SoftPOS richiede una propria voce di terminale con un proprio ID terminale RS2. La finestra di pagamento mostra il nome del terminale durante l'incasso, così si nota se si incassa sul dispositivo sbagliato.

Come si incassa¶

Registrare la vendita come al solito e scegliere Pagare.
Scegliere Carta di debito oppure Carta di credito.
DiKAS mostra la finestra Pagamento con carta con l'importo e il nome del terminale. Subito dopo si apre la schermata di pagamento dell'app RS2 con lo stesso importo.
L'ospite avvicina carta, smartphone o smartwatch al dispositivo. Se la carta richiede un PIN, viene inserito nella schermata RS2.
A pagamento riuscito DiKAS mostra Pagamento riuscito con marca e numero mascherato della carta. Poco dopo la cassa torna alla vendita e viene creato lo scontrino.

Annullare¶

Nella schermata di pagamento RS2 annullano l'ospite o il personale. DiKAS segnala «Zahlung abgebrochen.» (pagamento annullato); non è stato addebitato nulla.
Annulla nella finestra DiKAS chiude soltanto la finestra DiKAS. Una schermata RS2 già aperta non può essere chiusa da DiKAS; continua fino a due minuti. Chiudetela sul dispositivo prima di iniziare un nuovo tentativo.

Quando l'esito resta incerto¶

Se la schermata RS2 non risponde entro due minuti (ad esempio perché Android ha chiuso l'app) o cade la connessione con un dispositivo collegato, DiKAS mostra Pagamento non confermato:

Non incassare di nuovo

La carta potrebbe essere stata addebitata comunque. La finestra offre perciò solo Chiudi. Chiedete all'ospite se ha visto un addebito prima di proseguire. Al tentativo successivo su questo terminale DiKAS interroga prima RS2 su cosa sia accaduto all'operazione precedente e non addebita alla cieca una seconda volta:

Se il pagamento precedente è ancora aperto, DiKAS segnala «Zahlung unbestätigt — wird geprüft. Bitte NICHT erneut versuchen, sondern kurz warten.» (pagamento non confermato, in verifica; NON riprovare, attendere un momento).
Se è andato a buon fine e l'importo coincide, viene assegnato alla vendita corrente.
Se è andato a buon fine ma l'importo non coincide, DiKAS segnala «Unbestätigte frühere Zahlung über … gefunden — bitte klären (Storno/Abgleich), bevor der Vorgang wiederholt wird.» (trovato un pagamento precedente non confermato; chiarire con storno o riconciliazione prima di ripetere). È un caso da chiarire: il pagamento precedente va stornato o assegnato alla vendita giusta.
Se è stato rifiutato o annullato, è possibile un nuovo tentativo pulito.

Questa verifica automatica vale solo finché l'app DiKAS non viene riavviata. Dopo un riavvio controllate l'operazione con l'ospite e nei vostri movimenti carta.

Mancia¶

SoftPOS non chiede la mancia sul dispositivo e non ne riporta mai una. Viene registrato l'importo mostrato nella finestra di pagamento.

Ricevuta, storno e accredito¶

Ricevuta della carta¶

SoftPOS non ha una stampante propria. Con l'impostazione predefinita (Il terminale stampa la ricevuta da solo disattivato) DiKAS stampa la ricevuta cliente della carta sullo scontrino, tramite la stampante configurata per gli scontrini (vedere Articoli e stampanti). Le vendite con carta compaiono nei report come pagamenti con carta; una panoramica è nella Chiusura giornaliera.

Chiusura giornaliera¶

A differenza di un terminale ZVT, SoftPOS non ha una chiusura di cassa sul dispositivo. Il pulsante Chiusura di cassa manca di proposito nell'elenco dei terminali e dal terminale non viene richiesta alcuna chiusura carte.

Storno¶

Uno scontrino con pagamento con carta si storna come ogni scontrino, dalla panoramica degli scontrini (vedere Pagamenti → Storno di un pagamento con carta). DiKAS storna prima la carta presso RS2 e solo dopo crea lo scontrino di storno.

Solo sul dispositivo originale

Uno storno carta è possibile solo alla cassa con il terminale con cui si è pagato. A un'altra cassa DiKAS mostra: «Questo pagamento con carta è stato effettuato sul terminale …. Lo storno è possibile solo alla cassa con questo terminale.» Con SoftPOS il terminale è il dispositivo stesso, quindi lo storno va fatto sullo stesso dispositivo.

Se RS2 rifiuta lo storno, DiKAS mostra il messaggio di RS2 e lo scontrino resta invariato.

Accredito su carta¶

Un accredito è un rimborso indipendente su una carta, senza riferimento a uno scontrino specifico. Si avvia alla cassa con Menu → Accredito carta oppure, nelle opzioni di pagamento, con Accredito su carta sul terminale; l'ospite avvicina la carta al dispositivo. Se RS2 consenta un rimborso senza riferimento al pagamento originale dipende dal vostro accordo con RS2. Se viene rifiutato, DiKAS mostra il messaggio di RS2. La via consueta resta lo storno dello scontrino originale.

Limiti¶

Argomento	Comportamento
Valuta	Solo euro.
Pagamenti simultanei	Un pagamento alla volta per dispositivo. Un secondo avvio segnala «Es läuft bereits ein SoftPOS-Vorgang.» (è già in corso un'operazione SoftPOS).
Primo piano	L'app DiKAS deve essere in primo piano durante il pagamento, altrimenti segnala «Keine aktive Android-Activity für SoftPOS.» (nessuna activity Android attiva per SoftPOS).
Offline	Non possibile, il pagamento richiede Internet. Il pagamento in contanti funziona comunque senza Internet.
Mancia sul dispositivo	Non richiesta.
Chiusura di cassa	Non prevista.
Più dispositivi	Ogni dispositivo richiede una propria attivazione dell'app RS2 e una propria voce di terminale.
iOS	Non possibile.

Errori e rimedi¶

Cosa vedete	Causa e rimedio
«Beyond SoftPOS-App nicht gefunden. Ist sie installiert und aktiviert?» (app Beyond SoftPOS non trovata, è installata e attivata?)	L'app RS2 manca o è disattivata, oppure l'Ambiente nel terminale non corrisponde alla variante installata (impostato su Produzione ma installata solo la variante di test, o viceversa). Installare l'app RS2 o correggere Ambiente, Salva, riprovare.
«Beyond SoftPOS-App ist nicht installiert.» (con Verifica stato)	Come sopra. Verificate inoltre che il terminale sia salvato e che stiate lavorando sul dispositivo stesso.
«SoftPOS-Terminal ist nicht bereit.» (il terminale SoftPOS non è pronto)	L'app RS2 è installata ma non ancora attivata o non segnala di essere pronta. Aprire l'app RS2, completare l'attivazione, poi Verifica stato di nuovo.
«SoftPOS-Terminal '…' nicht gefunden.» (terminale non trovato)	Il terminale non è ancora stato salvato o è stato eliminato. Salva nelle opzioni di pagamento.
«Kein SoftPOS-Gerät gekoppelt.» (nessun dispositivo SoftPOS collegato)	La cassa gira nel cloud, ma nessun dispositivo Android con DiKAS è collegato e online. Collegare e connettere un dispositivo, vedere Hardware in modalità cloud.
«SoftPOS auf diesem Host nicht verfügbar.» (SoftPOS non disponibile su questo host)	Il pagamento viene eseguito su una macchina che non può leggere carte (server, PC, box). Incassate su un dispositivo Android che funziona come cassa completa oppure collegate un dispositivo Android alla cassa cloud.
«Keine aktive Android-Activity für SoftPOS.»	L'app DiKAS non è in primo piano. Aprire l'app e riavviare il pagamento.
«Es läuft bereits ein SoftPOS-Vorgang.»	Una schermata RS2 è ancora aperta. Chiuderla sul dispositivo o attendere fino a due minuti, poi riprovare.
La schermata di pagamento RS2 non si apre o si chiude subito	Disattivare le opzioni sviluppatore, controllare NFC, riavviare l'app.
«Zahlung abgebrochen.»	Annullato nella schermata RS2. Nulla addebitato; riavviare il pagamento.
Pagamento rifiutato con testo di RS2 oppure «Kartenzahlung fehlgeschlagen.» (pagamento con carta non riuscito)	La carta è stata rifiutata. Offrire un'altra carta o contanti. Nulla è stato addebitato.
Pagamento non confermato, «Zeitüberschreitung an der RS2-Maske — Ergebnis wird geprüft.» (timeout nella schermata RS2) oppure «Zeitüberschreitung: keine Antwort vom SoftPOS-Gerät.» (timeout: nessuna risposta dal dispositivo SoftPOS)	Esito sconosciuto. Non incassare di nuovo; procedura in Quando l'esito resta incerto.
«Unbestätigte frühere Zahlung über … gefunden …»	Esiste un pagamento precedente incerto con importo diverso. Chiarire (stornare o assegnare) prima di pagare di nuovo la vendita.
«Questo pagamento con carta è stato effettuato sul terminale …. Lo storno è possibile solo alla cassa con questo terminale.»	Stornare sul dispositivo con cui si è pagato.

Passo successivo¶

→ Pagamenti — pagamento con carta nell'uso quotidiano, storno e accredito → Impostazioni → Terminali — tutti i tipi di terminale in sintesi