Pagamento con carta tramite Stripe Terminal¶

Un lettore di carte Stripe accetta carte, smartphone e smartwatch in modalità contactless o con chip; DiKAS lo gestisce tramite il cloud di Stripe. La cassa invia l'importo a Stripe e Stripe lo mostra sul lettore. Non serve alcun agente hardware e nessuna abilitazione nel router del locale: il lettore ha bisogno solo di internet. Questa pagina mostra a cosa serve, come si configura il lettore e che cosa accade in cassa.

In sintesi¶


Tipo di terminale in DiKAS	Stripe Terminal
Come avviene il pagamento	Cassa → cloud di Stripe → lettore (nessun passaggio dalla rete del locale)
Ricevuta della carta	Il lettore non ha una stampante: DiKAS stampa la ricevuta della carta sullo scontrino
Mancia sul lettore	non viene comunicata alla cassa
Rimborso su carta	solo con riferimento al pagamento originale (storno del documento)
Chiusura di cassa sul lettore	non esiste: gli accrediti avvengono automaticamente tramite Stripe

Dispositivi e paesi supportati¶

Che cosa	Stato
Lettori di carte Stripe configurati come lettore nel Suo account Stripe e dotati di un ID lettore (inizia con `tmr_`)	✅ supportato
Quali modelli di lettore Stripe abilita per il controllo dal cloud	lo decide Stripe: verificare modello e disponibilità nel proprio account Stripe
Terminali di carte di altri fornitori	vedere la rispettiva guida, ad es. terminale ZVT

Valuta: l'addebito avviene nella valuta principale della Sua attività (ad es. euro o franco svizzero). In quali paesi Stripe offre lettori di carte e quali carte vengono accettate lo determina il Suo account Stripe, non DiKAS.

Prerequisiti¶

Un account Stripe in cui il lettore di carte è configurato come lettore e online.
L'ID lettore (tmr_…): si trova nel Suo account Stripe, nell'area Terminal.
La chiave segreta (Secret Key, inizia con sk_live_ o sk_test_) del Suo account Stripe: si trova nelle chiavi API del Suo account Stripe. La maschera accetta anche chiavi che iniziano con rk_.
Accesso a internet sul lettore e sul server DiKAS o sulla cassa nel cloud.
Un utente con accesso a Admin → Impostazioni.

Prima in modalità test

Con una chiave che inizia con sk_test_ Stripe lavora in modalità test: nessuna carta reale viene addebitata. Per l'uso reale inserire poi la chiave sk_live_.

Configurazione in 8 passaggi¶

Aprire le opzioni di pagamento: Admin → Impostazioni → Hardware → Opzioni di pagamento.
Fare clic su Aggiungi terminale (icona più) e assegnare un nome, ad es. «Lettore bancone».
In Tipo scegliere Stripe Terminal. Compare il campo per l'ID lettore (segnaposto tmr_xxx).
Inserire l'ID lettore.
Sotto l'elenco dei terminali compare la scheda Stripe. Inserire lì la Secret Key. DiKAS la salva cifrata e non la mostra mai più in chiaro; una chiave salvata appare come «•••• salvata (lasciare vuoto per mantenere)».
Fare clic in alto su Salva. Senza salvare, il server non conosce ancora il nuovo lettore.
Nella scheda Stripe fare clic su Prova connessione. Se compare Connessione riuscita, la chiave è corretta. In caso di errore DiKAS mostra il testo di Stripe.
Nella riga del lettore fare clic sull'icona Verifica stato (simbolo Wi-Fi). Un punto verde significa che il lettore è online presso Stripe. Altrimenti il tooltip mostra ad es. Reader-Status: offline.

Poi eseguire un pagamento di prova con un importo piccolo (vedere sotto) e stornarlo.

Altri campi nella scheda Stripe

La Publishable Key non serve per il pagamento con carta sul lettore; riguarda altre funzioni di Stripe che usano la stessa scheda (ad es. ordini online o pagamento con codice QR). DiKAS non valuta la Location-ID nei pagamenti sul lettore. Le credenziali valgono congiuntamente per tutte le funzioni Stripe dell'attività.

Come funziona il pagamento in cassa¶

Registrare gli articoli e scegliere Paga, poi Carta EC o Carta di credito.
Si apre la finestra Pagamento con carta con l'importo e il nome del lettore (Terminale: …).
L'importo compare sul lettore. Il cliente avvicina carta, smartphone o smartwatch al lettore oppure inserisce la carta.
Quando Stripe segnala il pagamento come concluso, DiKAS mostra Pagamento riuscito e registra il documento.

Se il pagamento resta non confermato¶

Se al momento della richiesta Stripe non ha ancora segnalato la conclusione, DiKAS mostra Pagamento non confermato con l'avviso NON incassare di nuovo — verificare il pagamento sul terminale. e il pulsante Chiudi.

Non ripetere alla cieca

Verificare prima sul lettore e nel Suo account Stripe (area Pagamenti) se la carta è stata addebitata. Poi avviare di nuovo il pagamento sullo stesso lettore: DiKAS riconcilia prima l'operazione aperta con Stripe invece di innescare un secondo addebito. Se è andata a buon fine e l'importo coincide, viene recepita. Se l'importo differisce, DiKAS segnala un caso da chiarire finché non viene risolto. Se nel frattempo il server DiKAS è stato riavviato, l'operazione aperta non vi è più annotata: vale allora solo la verifica nel Suo account Stripe.

Mancia¶

Il lettore non comunica alcuna mancia alla cassa. Registrare la mancia in cassa come per qualsiasi altro pagamento.

Ricevuta della carta: chi stampa?¶

Un lettore Stripe non ha una stampante propria. Alla creazione del tipo DiKAS imposta Il terminale ha una stampante propria automaticamente su disattivato: la ricevuta della carta viene stampata sullo scontrino, senza doppia stampa.

Storno e rimborso su carta¶

Caso	Come funziona
Stornare un documento	Lo storno avviene con riferimento al pagamento originale: DiKAS rimborsa sulla carta l'intero importo del pagamento tramite Stripe e crea poi il documento di storno. Lo storno è possibile solo alla cassa a cui è assegnato il lettore del pagamento e richiede il diritto Eseguire storno con carta (gli amministratori sempre).
Rimborso libero su carta (senza pagamento originale)	Non possibile. Stripe rimborsa solo su un pagamento esistente. DiKAS segnala: Stripe Terminal unterstützt keine referenzlose Karten-Gutschrift … Bitte mit Bezug auf den Ursprungsbeleg stornieren (funktioniert) oder bar erstatten. (Stripe Terminal non supporta un rimborso su carta senza riferimento; stornare sul documento originale, cosa che funziona, oppure rimborsare in contanti.)

Chiusura di cassa e chiusura giornaliera¶

Stripe non ha una chiusura di cassa come i terminali di carte classici. DiKAS mostra l'avviso Stripe Terminal kennt keinen Kassenschnitt — Auszahlungen laufen automatisch über Stripe (Dashboard → Auszahlungen). (Stripe Terminal non ha una chiusura di cassa: gli accrediti avvengono automaticamente tramite Stripe, Dashboard → Pagamenti in uscita) quando nelle opzioni di pagamento si fa clic sull'icona di chiusura del lettore. Nel menu della cassa (Menu → Terminale carta → Chiusura) DiKAS segnala per un lettore Stripe soltanto Chiusura di cassa OK, senza che sul lettore venga chiuso qualcosa. Se necessario, riconciliare gli incassi con carta nel Suo account Stripe. Un subtotale vendite dal lettore non esiste.

Limiti¶

Nessuna mancia sul lettore, nessun rimborso libero su carta, nessuna chiusura di cassa.
Internet è obbligatorio: senza connessione a Stripe non è possibile pagare con carta sul lettore.
Un lettore appartiene a un account Stripe: la chiave segreta vale congiuntamente per tutti i lettori Stripe dell'attività.

Errori e rimedi¶

Messaggio / Che cosa si vede	Causa e rimedio
Stripe Terminal ist nicht konfiguriert (Secret Key oder Reader-ID fehlt) (non configurato: mancano chiave segreta o ID lettore)	Inserire la Secret Key nella scheda Stripe e l'ID lettore nel terminale, poi Salva.
Stripe-Terminal … nicht gefunden (non trovato)	Il lettore non è ancora salvato oppure è stato eliminato. Creare il terminale o Salva.
Reader-Status: offline (o un altro stato al posto di «online»)	Accendere il lettore, verificarne la connessione a internet; nel Suo account Stripe deve risultare online. Poi Verifica stato.
Connessione fallita o testo di errore di Stripe con Prova connessione	Verificare la chiave segreta (formato `sk_…`) e reinserirla. La maschera mostra Formato previsto: sk_… se il formato è errato.
Zahlung unbestätigt — wird geprüft. Bitte NICHT erneut versuchen, sondern kurz warten. (pagamento non confermato, NON riprovare, attendere brevemente)	Vedere Se il pagamento resta non confermato.
Stripe-Terminal-Status nach Reader-Push unsicher. (stato incerto dopo l'invio al lettore)	La connessione a Stripe si è interrotta dopo l'invio; il pagamento può essere arrivato al lettore. Trattare come «non confermato»: verificare nell'account Stripe, non incassare subito di nuovo.
Unbestätigte frühere Zahlung über einen abweichenden Betrag gefunden — bitte klären (trovato un pagamento precedente non confermato con importo diverso)	Esiste un'operazione aperta con un altro importo. Chiarire nell'account Stripe (rimborsare se necessario) e solo poi incassare di nuovo.
Zahlung abgebrochen. / Zahlung abgelehnt oder abgebrochen. (annullato / rifiutato o annullato)	Cliente o personale hanno annullato sul lettore, oppure la carta è stata rifiutata. Provare un'altra carta o un altro metodo di pagamento.
Stripe Terminal unterstützt keine referenzlose Karten-Gutschrift …	Con Stripe un rimborso libero non è possibile. Stornare il documento oppure rimborsare in contanti.
Keine Transaktionsreferenz für das Storno vorhanden. (nessun riferimento di transazione per lo storno)	Al documento manca il riferimento Stripe. Un rimborso tramite DiKAS non è allora possibile: contattare l'assistenza.
Diese Kartenzahlung lief über … Stornieren ist nur an der Kasse mit diesem Terminal möglich. (storno possibile solo alla cassa con questo terminale)	Eseguire lo storno alla cassa a cui è assegnato questo lettore.
Keine Berechtigung für Karten-Erstattungen. (nessuna autorizzazione per rimborsi su carta)	Assegnare all'utente il diritto Eseguire storno con carta in Admin → Personale oppure far stornare da un amministratore.

Passo successivo¶

→ Metodi di pagamento e pagamento con carta in cassa: storno, rimborso e tipo di carta come metodo di pagamento → Hardware: terminali di carte: panoramica di tutti i tipi di terminale