Pagamento con carta tramite Softpay¶

Con Softpay il dispositivo Android su cui gira DiKAS diventa un terminale per carte contactless: l'ospite avvicina carta, smartphone o smartwatch al dispositivo. Non servono un terminale separato, né cavi, né accoppiamento. Il pagamento avviene nell'app Softpay sullo stesso dispositivo. DiKAS le consegna l'importo (cambio di app), l'app Softpay legge la carta e torna a DiKAS con il risultato. Questa pagina mostra i requisiti, come configurare Softpay passo per passo e cosa fare in caso di problemi.

Nell'elenco dei terminali questo tipo si chiama Softpay.

A chi si rivolge Softpay?¶

Softpay è adatto alle attività che vogliono incassare in modalità contactless con smartphone o tablet e hanno un conto esercente presso Softpay. Più dispositivi sullo stesso server DiKAS possono incassare in modo indipendente: ogni dispositivo legge la carta da sé. Accanto si possono configurare altre soluzioni (terminale ZVT, SoftPOS, Stripe, SumUp). La panoramica è in Pagamenti e Hardware → Terminali EC/carta.

Dispositivi e modalità di funzionamento supportati¶

Dispositivo o modalità	Softpay	Nota
Dispositivo Android con NFC, app DiKAS come cassa completa (con licenza propria)	✅ Supportato	Il dispositivo legge la carta da sé.
Dispositivo Android come client di un server DiKAS	✅ Supportato	Anche qui la carta la legge il dispositivo che avete in mano, non il server. Scontrino e registrazione continuano a passare dal server.
Cassa cloud nel browser con un dispositivo Android collegato (agente dispositivo)	✅ Supportato	Senza dispositivo collegato DiKAS segnala cosa manca. Approfondimento: Hardware in modalità cloud.
iPhone / iPad	❌ Non possibile	Softpay tramite DiKAS esiste solo per Android.
PC Windows, server Linux, box DiKAS	❌ Non possibile	Questi dispositivi non hanno NFC. DiKAS segnala «Softpay auf diesem Host nicht verfügbar.» (Softpay non disponibile su questo host).

L'app DiKAS viene fornita per dispositivi ARM a 64 bit (arm64), cioè praticamente tutti i tablet e palmari attuali.

Euro e paesi

I pagamenti Softpay avvengono in euro. Un importo in un'altra valuta non viene registrato ma segnalato come caso da chiarire. In quali paesi sia possibile un conto esercente Softpay lo stabilisce il contratto con Softpay, non DiKAS.

Requisiti¶

Requisito	A cosa serve
Conto esercente presso Softpay con dati di accesso e almeno un negozio	L'accesso avviene una sola volta nell'app Softpay. Conto e negozi li assegna Softpay, non DiKAS.
App Softpay sullo stesso dispositivo	Legge la carta. Per pagamenti reali la variante di produzione, per provare la variante sandbox.
Credenziali di DiKAS per Softpay	DiKAS si identifica presso Softpay con un proprio ID per l'ambiente scelto (sandbox o produzione). Non dovete inserirlo da nessuna parte. Se manca per l'ambiente scelto, DiKAS segnala «Softpay ist nicht eingerichtet: …» (Softpay non è configurato). In tal caso contattate l'assistenza DiKAS.
NFC attivo	Lettura contactless.
Autorizzazioni per l'app Softpay	Softpay richiede sul dispositivo diverse autorizzazioni Android: servizio di accessibilità, notifiche, fotocamera e posizione. Se ne manca una, DiKAS la indica nel controllo di disponibilità.
Connessione a Internet	Il pagamento viene autorizzato online.
App DiKAS aggiornata	Download e scelta della modalità: DiKAS su Android.
Un utente con accesso a Admin → Impostazioni	Per configurare il terminale.

Configurazione in 9 passaggi¶

Configurare sul dispositivo

Eseguite la configurazione direttamente sul dispositivo Android che deve incassare con Softpay. Solo lì l'app Softpay è installata e connessa.

Installare l'app Softpay — nel modo previsto da Softpay per il vostro conto esercente.
Accedere nell'app Softpay: aprire Softpay, accedere con le credenziali dell'esercente e concedere le autorizzazioni richieste. DiKAS non memorizza queste credenziali e non accede da nessuna parte al posto vostro.
Attivare NFC (impostazioni di Android).
Aprire l'app DiKAS ed effettuare l'accesso, poi aprire Admin → Impostazioni → Hardware → Opzioni di pagamento.
Toccare Aggiungi terminale, assegnare un nome (es. «Smartphone servizio») e scegliere Softpay in Tipo. DiKAS imposta Ambiente di proposito inizialmente su Sandbox (test), perché un nuovo terminale non muova mai denaro reale per errore, e disattiva la stampa propria del terminale.
Impostare Ambiente su Produzione (per pagamenti reali).
Nella sezione Softpay (compare appena nell'elenco c'è un terminale Softpay) inserire il Nome dell'esercente: il nome con cui Softpay registra la vostra azienda, non il nome di una filiale. Poi Salva.
Sul terminale toccare Scegli negozio e scegliere il vostro negozio dall'elenco (vengono mostrati nome, città e numero). Softpay configura da esso il terminale virtuale per questo dispositivo, il che può richiedere un momento. DiKAS conferma con «Store konfiguriert. Das Terminal ist jetzt einsatzbereit.» (negozio configurato, il terminale è pronto).
Toccare Verifica disponibilità. In caso di successo DiKAS segnala «Bereit. Terminal …, Softpay ….» (pronto). Altrimenti il messaggio dice cosa manca (vedere Errori e rimedi).

Senza negozio nessun pagamento

Finché sul terminale non è scelto un negozio (indicazione Nessun negozio), il dispositivo non può incassare con Softpay. Salvate assolutamente prima del passaggio 8, perché la scelta del negozio funziona solo per un terminale Softpay già salvato.

Cambiare dispositivo

Libera terminale scioglie l'assegnazione del dispositivo (dopo una conferma). Il dispositivo potrà incassare di nuovo solo dopo una nuova scelta del negozio. L'accesso nell'app Softpay resta.

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 con Softpay richiede una propria voce di terminale e una propria scelta del negozio. La finestra di pagamento nomina il terminale durante l'incasso, così si nota se si incassa sul dispositivo sbagliato.

Come si incassa¶

Registrare la vendita e scegliere Pagare.
Scegliere Carta di debito oppure Carta di credito.
DiKAS mostra la finestra Pagamento con carta con importo e nome del terminale e passa all'app Softpay con l'importo.
L'ospite avvicina carta, smartphone o smartwatch al dispositivo e, se serve, digita il PIN.
L'app Softpay torna automaticamente a DiKAS. DiKAS mostra Pagamento riuscito con marca e numero mascherato della carta; poi viene creato lo scontrino.

Annullare¶

Annulla nella finestra DiKAS chiude solo questa finestra. La cassa non può terminare un'operazione in corso nell'app Softpay; per questo è determinante l'app Softpay. Terminatela sul dispositivo. L'operazione può proseguire fino a tre minuti. Se in questo tempo il pagamento va comunque a buon fine, DiKAS lo segnala con «Kartenzahlung nachträglich eingetroffen» (pagamento con carta arrivato in seguito): Il pagamento con carta sul terminale … è comunque andato a buon fine — controllare e registrare lo scontrino a posteriori. La carta risulta allora addebitata senza che esista uno scontrino.

Quando l'esito resta incerto¶

Se l'operazione resta aperta o dopo tre minuti non arriva risposta, DiKAS mostra Pagamento non confermato. Se Softpay segnala l'operazione come «ancora in elaborazione», DiKAS prima chiede da sé per circa dieci secondi, perché di solito il pagamento viene registrato solo pochi secondi dopo.

Non incassare di nuovo

La carta potrebbe essere stata addebitata. Toccate Verifica stato nella finestra: DiKAS chiede a Softpay cosa sia accaduto al pagamento senza addebitare di nuovo. Solo quando è confermato come rifiutato o annullato, un nuovo tentativo è sicuro. In caso di dubbio controllate prima nell'app Softpay se il pagamento vi compare.

Ancora aperto: «Zahlung unbestätigt — wird geprüft. Bitte NICHT erneut versuchen, sondern kurz warten.» (pagamento non confermato, in verifica; NON riprovare, attendere un momento). Ripetere Verifica stato più tardi.
Andato a buon fine, importo coincidente: il pagamento viene assegnato alla vendita.
Andato a buon fine, importo non coincidente: «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).

Questa verifica automatica vale solo finché l'app DiKAS non viene riavviata. Dopo, controllate l'operazione nell'app Softpay e con l'ospite.

Mancia e importo diverso¶

DiKAS non richiede a Softpay né mancia, né supplemento, né conversione di valuta. Se il terminale addebita comunque un altro importo, l'operazione non viene registrata. DiKAS segnala: «Das Terminal hat einen anderen Betrag belastet (… statt …). Der Vorgang wurde NICHT gebucht — bitte am Terminal stornieren und erneut kassieren (Referenz: …).» (il terminale ha addebitato un altro importo; l'operazione NON è stata registrata; stornare sul terminale e incassare di nuovo). In questo caso la carta è addebitata. Annotate il riferimento e stornate il pagamento (vedere sotto).

Ricevuta, storno e accredito¶

Ricevuta della carta¶

Il dispositivo 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 per scontrini configurata (vedere Articoli e stampanti). Softpay comunica inoltre la marca della carta (es. girocard, Visa, Mastercard). Su richiesta DiKAS la espone come metodo di pagamento a sé (opzione Usa il tipo di carta come metodo di pagamento, vedere Pagamenti).

Chiusura giornaliera¶

Softpay non ha una chiusura di cassa: il regolamento lo chiude l'acquirer secondo il proprio calendario. Per questo manca il pulsante Chiusura di cassa nei terminali Softpay. Potete riconciliare le vendite con carta tramite i report e la Chiusura giornaliera.

Storno¶

Uno scontrino con pagamento Softpay si storna come ogni scontrino (vedere Pagamenti → Storno di un pagamento con carta). DiKAS storna la carta prima presso Softpay, senza che l'ospite debba avvicinare di nuovo la carta, e poi crea lo scontrino di storno.

Se il regolamento è già chiuso, DiKAS segnala: «Storno nicht mehr möglich — der Abrechnungslauf ist bereits abgeschlossen. Bitte stattdessen eine Karten-Gutschrift durchführen (Karte des Gastes wird benötigt).» (storno non più possibile, regolamento chiuso; eseguire invece un accredito su carta, serve la carta dell'ospite).
Se manca il riferimento Softpay del pagamento, DiKAS segnala: «Storno nicht möglich: Zu dieser Zahlung ist keine Softpay-Referenz hinterlegt.» (storno non possibile, nessun riferimento Softpay).

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.»

Accredito su carta¶

Un accredito è un rimborso indipendente sulla carta, ad esempio quando uno storno non è più possibile. Si avvia alla cassa con Menu → Accredito carta oppure, nelle opzioni di pagamento, con Accredito su carta sul terminale. Inserire l'importo, Eseguire rimborso; l'ospite avvicina la carta al dispositivo. Con Softpay è un rimborso di importo libero con contatto della carta. Anche qui DiKAS protegge dal doppio rimborso: se l'esito resta incerto, non rimborsa alla cieca una seconda volta.

Limiti¶

Argomento	Comportamento
Valuta	Solo euro.
Pagamenti simultanei	Un pagamento alla volta per dispositivo. Un secondo avvio segnala «Es läuft bereits eine Kartenzahlung auf diesem Gerät.» (è già in corso un pagamento con carta su questo dispositivo).
Tempo di attesa	Fino a tre minuti per il risultato, poi «non confermato».
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, il regolamento lo chiude l'acquirer.
Annullamento dalla cassa	Non possibile. L'operazione si termina nell'app Softpay.
Più dispositivi	Ogni dispositivo ha una propria voce di terminale e una propria scelta del negozio; tutti incassano in modo indipendente.
iOS	Non possibile.

Errori e rimedi¶

Cosa vedete	Causa e rimedio
«Softpay ist nicht eingerichtet: Es sind keine Produktions-Zugangsdaten hinterlegt.» (oppure «… Sandbox-Zugangsdaten …») — Softpay non è configurato: nessuna credenziale di produzione (o sandbox)	Per l'Ambiente scelto il dispositivo non ha un ID DiKAS per Softpay. Contattate l'assistenza DiKAS. Per provare si può scegliere Sandbox (test).
«Softpay ist nicht eingerichtet: Es fehlt der Händler-Name in den Einstellungen.» (manca il nome dell'esercente)	Inserire il Nome dell'esercente nella sezione Softpay e Salva.
«Softpay ist noch nicht konfiguriert: Bitte in den Terminal-Einstellungen einen Store wählen.» (scegliere un negozio)	Scegli negozio (passaggio 8).
«Softpay hat keine Stores geliefert. Mögliche Gründe: in der Softpay-App ist noch kein Händler angemeldet, dem Konto sind keine Stores zugeordnet, oder die hinterlegte Integrator-Kennung passt nicht zur gewählten Umgebung (Sandbox/Produktion).» (Softpay non ha restituito negozi; possibili motivi: nessun esercente connesso nell'app Softpay, nessun negozio assegnato al conto, oppure l'ID memorizzato non corrisponde all'ambiente scelto)	Accedere nell'app Softpay. Verificare presso il conto Softpay se sono assegnati negozi. Scegliere l'Ambiente corrispondente all'app Softpay installata (produzione o sandbox).
«Terminal '…' ist noch nicht gespeichert. Bitte die Terminal-Liste zuerst speichern …» (terminale non ancora salvato)	Salva, poi riavviare la scelta del negozio. Lo stesso vale se il tipo non è salvato come Softpay.
«Softpay kennt den gewählten Store (…) nicht mehr. Bitte die Store-Liste erneut öffnen und neu wählen.» (Softpay non conosce più il negozio scelto)	Riaprire l'elenco dei negozi e scegliere di nuovo il negozio.
«Die Softpay-App ist auf diesem Gerät nicht installiert.» (l'app Softpay non è installata su questo dispositivo)	Installare l'app Softpay (corrispondente all'Ambiente scelto).
«NFC ist ausgeschaltet — bitte in den Android-Einstellungen aktivieren.» (NFC è disattivato)	Attivare NFC.
«Der Softpay-App fehlen noch Freigaben auf diesem Gerät: …» (all'app Softpay mancano autorizzazioni)	Concedere le autorizzazioni indicate: attivare il servizio di accessibilità per Softpay (impostazioni di Android → Accessibilità), consentire notifiche, fotocamera o posizione all'app Softpay. Poi Verifica disponibilità.
«Es ist noch kein Store konfiguriert — bitte in den Terminal-Einstellungen einen Store wählen.»	Come sopra: Scegli negozio.
«Das Softpay-Terminal ist nicht bereit.» (il terminale Softpay non è pronto)	Accedere nell'app Softpay o controllarne lo stato lì, poi Verifica disponibilità.
«Softpay ist auf diesem Gerät nicht verfügbar.» (Softpay non è disponibile su questo dispositivo)	La cassa gira in un ambiente senza collegamento a Softpay (es. un browser su PC). Incassare sul dispositivo Android con l'app DiKAS.
«Softpay auf diesem Host nicht verfügbar.»	Il pagamento viene eseguito su una macchina senza NFC (server, PC, box). Incassare sul dispositivo Android o collegare un dispositivo Android alla cassa cloud.
«Es läuft bereits eine Kartenzahlung auf diesem Gerät.»	Un pagamento precedente è ancora aperto. Terminarlo nell'app Softpay, attendere fino a tre minuti, poi riprovare.
«Zahlung abgebrochen.»	Annullato nell'app Softpay. Nulla addebitato; riavviare.
Pagamento rifiutato (testo di errore di Softpay, «Kartenzahlung fehlgeschlagen.»)	La carta è stata rifiutata. Offrire un'altra carta o contanti. Il testo di errore inizia con un numero che l'assistenza richiede per l'analisi.
Pagamento non confermato, «Softpay hat den Vorgang noch nicht abgeschlossen — der Ausgang ist unbestätigt und wird geprüft. Bitte NICHT erneut kassieren.» (Softpay non ha ancora concluso l'operazione; esito non confermato, in verifica; NON incassare di nuovo)	Esito sconosciuto. Non incassare di nuovo: Verifica stato, vedere Quando l'esito resta incerto.
«Das Terminal hat einen anderen Betrag belastet …»	La carta è addebitata, l'operazione non è registrata. Stornare il pagamento con il riferimento indicato, poi incassare di nuovo.
«Kartenzahlung nachträglich eingetroffen»	Un pagamento annullato è comunque andato a buon fine. Controllare e registrare lo scontrino a posteriori (oppure stornare).
«Kartenzahlung ohne Zuordnung» (pagamento con carta senza assegnazione)	È arrivato un risultato che non appartiene ad alcun pagamento di questo dispositivo. Verificate nell'app Softpay se una carta è stata addebitata prima di incassare di nuovo.
«Storno nicht mehr möglich — der Abrechnungslauf ist bereits abgeschlossen. …»	Eseguire invece un accredito su carta.
«Ein laufender Softpay-Vorgang kann von der Kasse nicht abgebrochen werden — die Softpay-App ist die maßgebliche Stelle. Bitte den Vorgang am Gerät beenden.» (un'operazione Softpay in corso non può essere annullata dalla cassa)	Terminare l'operazione nell'app Softpay sul dispositivo.

Passo successivo¶

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