Kartenzahlung mit Stripe Terminal¶

Ein Stripe-Kartenleser nimmt Karten, Handys und Smartwatches kontaktlos oder per Chip entgegen; DiKAS steuert ihn über die Stripe-Cloud. Die Kasse schickt den Betrag an Stripe, Stripe zeigt ihn auf dem Leser an. Es ist kein Hardware-Agent und keine Freigabe im Laden-Router nötig — der Leser braucht nur Internet. Diese Seite zeigt, wofür sich das eignet, wie der Leser eingerichtet wird und was an der Kasse passiert.

Auf einen Blick¶


Terminal-Typ in DiKAS	Stripe Terminal
Wie die Zahlung läuft	Kasse → Stripe-Cloud → Leser (kein Weg über das Laden-Netz)
Kartenbeleg	Der Leser hat keinen Drucker — DiKAS druckt den Kartenbeleg auf den Kassenbon
Trinkgeld am Leser	wird nicht an die Kasse gemeldet
Karten-Gutschrift	nur mit Bezug auf die ursprüngliche Zahlung (Beleg-Storno)
Kassenschnitt am Leser	gibt es nicht — Auszahlungen laufen automatisch über Stripe

Unterstützte Geräte und Länder¶

Was	Stand
Stripe-Kartenleser, die in Ihrem Stripe-Konto als Leser (Reader) eingerichtet sind und eine Reader-ID haben (beginnt mit `tmr_`)	✅ unterstützt
Welche Lesermodelle Stripe für die Steuerung über die Cloud freigibt	legt Stripe fest — Modellauswahl und Verfügbarkeit im Stripe-Konto prüfen
Karten-Terminals anderer Anbieter	über die jeweilige eigene Anleitung, z. B. ZVT-Terminal

Währung: Belastet wird in der Hauptwährung Ihres Betriebs (z. B. Euro oder Schweizer Franken). In welchen Ländern Stripe Kartenleser anbietet und welche Karten er annimmt, bestimmt Ihr Stripe-Konto, nicht DiKAS.

Voraussetzungen¶

Ein Stripe-Konto, in dem der Kartenleser als Leser eingerichtet und online ist.
Die Reader-ID des Lesers (tmr_…) — sie steht in Ihrem Stripe-Konto im Bereich Terminal.
Der geheime Schlüssel (Secret Key, beginnt mit sk_live_ oder sk_test_) Ihres Stripe-Kontos — zu finden in Ihrem Stripe-Konto bei den API-Schlüsseln. Die Maske akzeptiert auch Schlüssel mit dem Anfang rk_.
Internetzugang am Leser und am DiKAS-Server bzw. an der Cloud-Kasse.
Ein Benutzer mit Zugriff auf Admin → Einstellungen.

Erst im Testmodus

Mit einem Schlüssel, der mit sk_test_ beginnt, arbeitet Stripe im Testmodus — dabei wird keine echte Karte belastet. Für den Echtbetrieb tragen Sie danach den sk_live_-Schlüssel ein.

Einrichten in 8 Schritten¶

Zahlungsoptionen öffnen: Admin → Einstellungen → Hardware → Zahlungsoptionen.
Auf Terminal hinzufügen klicken (Plus-Symbol) und einen Namen vergeben, z. B. „Leser Theke".
Bei Typ den Eintrag Stripe Terminal wählen. Das Feld für die Reader-ID erscheint (Platzhalter tmr_xxx).
Die Reader-ID des Lesers eintragen.
Unterhalb der Terminalliste erscheint der Reiter Stripe. Dort den Secret Key eintragen. DiKAS speichert ihn verschlüsselt und zeigt ihn nie wieder im Klartext an; ein gespeicherter Schlüssel erscheint als „•••• gespeichert (leer lassen um beizubehalten)".
Oben auf Speichern klicken. Ohne Speichern kennt der Server den neuen Leser noch nicht.
Im Reiter Stripe auf Verbindung testen klicken. Erscheint Verbindung erfolgreich, ist der Schlüssel in Ordnung. Bei einem Fehler zeigt DiKAS den Text von Stripe.
In der Zeile des Lesers das Status prüfen-Symbol (WLAN-Zeichen) anklicken. Ein grüner Punkt heißt: Der Leser ist bei Stripe online. Sonst steht im Tooltip z. B. Reader-Status: offline.

Danach eine Testzahlung mit kleinem Betrag durchführen (siehe unten) und sie wieder stornieren.

Weitere Felder im Reiter Stripe

Der Publishable Key wird für die Kartenzahlung am Leser nicht gebraucht; er betrifft andere Stripe-Funktionen, die denselben Reiter nutzen (z. B. Online-Bestellung oder Bezahlen per QR-Code). Die Location-ID wertet DiKAS bei Zahlungen am Leser nicht aus. Die Zugangsdaten gelten für alle Stripe-Funktionen des Betriebs gemeinsam.

Mehrere Leser und mehrere Kassen¶

Je Leser ein eigener Terminal-Eintrag mit eigenem Namen und eigener Reader-ID.
Welcher Leser an welcher Kasse benutzt wird, legen Sie über das Standard-Terminal (Auswahl unter der Terminalliste) oder je Arbeitsplatz bzw. Gerät fest — siehe Hardware: EC-/Kartenterminals.
Im Zahlungsdialog steht immer der Name des Lesers, damit ein falsches Gerät sofort auffällt.

So funktioniert die Zahlung an der Kasse¶

Artikel buchen und Bezahlen wählen, dann EC-Karte oder Kreditkarte.
Es öffnet sich der Dialog EC-Kartenzahlung mit Betrag und dem Namen des Lesers (Terminal: …).
Der Betrag erscheint auf dem Leser. Der Gast hält Karte, Handy oder Smartwatch an den Leser bzw. steckt die Karte.
Meldet Stripe die Zahlung als abgeschlossen, zeigt DiKAS Zahlung erfolgreich und bucht den Beleg.

Wenn die Zahlung unbestätigt bleibt¶

Hat Stripe im Moment der Abfrage noch keinen Abschluss gemeldet, zeigt DiKAS Zahlung unbestätigt mit dem Hinweis NICHT erneut kassieren — Zahlung am Terminal prüfen. und der Schaltfläche Schließen.

Nicht blind wiederholen

Prüfen Sie zuerst am Leser und im Stripe-Konto (Bereich Zahlungen), ob die Karte belastet wurde. Starten Sie danach die Zahlung am selben Leser noch einmal: DiKAS gleicht dann zuerst den offenen Vorgang bei Stripe ab, statt eine zweite Belastung anzustoßen. War er erfolgreich und der Betrag passt, wird er übernommen. Weicht der Betrag ab, meldet DiKAS einen Klärfall, bis Sie ihn geklärt haben. Wurde der DiKAS-Server zwischendurch neu gestartet, ist der offene Vorgang dort nicht mehr vermerkt — dann gilt allein die Prüfung im Stripe-Konto.

Trinkgeld¶

Der Leser meldet kein Trinkgeld an die Kasse zurück. Trinkgeld erfassen Sie wie bei jeder anderen Zahlung in der Kasse.

Kartenbeleg — wer druckt?¶

Ein Stripe-Leser hat keinen eigenen Drucker. Beim Anlegen des Typs stellt DiKAS Terminal hat eigenen Drucker automatisch auf aus: Der Kartenbeleg wird auf den Kassenbon gedruckt, es entsteht kein Doppeldruck.

Storno und Karten-Gutschrift¶

Fall	So geht es
Beleg stornieren	Der Storno läuft mit Bezug auf die ursprüngliche Zahlung: DiKAS erstattet den vollen Betrag der Zahlung über Stripe auf die Karte zurück und erzeugt danach den Storno-Beleg. Stornieren geht nur an der Kasse, der der Leser der Zahlung zugeordnet ist, und erfordert das Recht EC-Gutschrift ausführen (Administratoren immer).
Freie Karten-Gutschrift (ohne Original-Zahlung)	Nicht möglich. Stripe erstattet nur auf eine vorhandene Zahlung. DiKAS meldet: Stripe Terminal unterstützt keine referenzlose Karten-Gutschrift … Bitte mit Bezug auf den Ursprungsbeleg stornieren (funktioniert) oder bar erstatten.

Kassenschnitt und Tagesabschluss¶

Einen Kassenschnitt wie bei klassischen EC-Terminals gibt es bei Stripe nicht. Den Hinweis Stripe Terminal kennt keinen Kassenschnitt — Auszahlungen laufen automatisch über Stripe (Dashboard → Auszahlungen). zeigt DiKAS, wenn Sie in den Zahlungsoptionen das Kassenschnitt-Symbol des Lesers anklicken. Im Kassenmenü (Menü → EC Terminal → Abschluss) meldet DiKAS bei einem Stripe-Leser lediglich Kassenschnitt OK, ohne dass am Leser etwas abgeschlossen wird. Die Kartenumsätze gleichen Sie bei Bedarf im Stripe-Konto ab. Eine Umsatz-Zwischensumme vom Leser gibt es nicht.

Grenzen¶

Kein Trinkgeld am Leser, keine freie Karten-Gutschrift, kein Kassenschnitt.
Internet ist Pflicht — ohne Verbindung zu Stripe ist keine Kartenzahlung am Leser möglich.
Ein Leser gehört zu einem Stripe-Konto — der Secret Key gilt für alle Stripe-Leser des Betriebs gemeinsam.

Fehler und Abhilfe¶

Meldung / Was Sie sehen	Ursache und Abhilfe
Stripe Terminal ist nicht konfiguriert (Secret Key oder Reader-ID fehlt)	Secret Key im Reiter Stripe und Reader-ID am Terminal eintragen und Speichern.
Stripe-Terminal … nicht gefunden	Der Leser ist noch nicht gespeichert oder wurde gelöscht. Terminal anlegen bzw. Speichern.
Reader-Status: offline (oder anderer Status statt „online")	Leser einschalten, Internetverbindung des Lesers prüfen; im Stripe-Konto muss er als online erscheinen. Danach Status prüfen.
Verbindung fehlgeschlagen oder Fehlertext von Stripe bei Verbindung testen	Secret Key prüfen (Format `sk_…`) und neu eintragen. Die Mask zeigt bei falschem Format den Hinweis Erwartetes Format: sk_….
Zahlung unbestätigt — wird geprüft. Bitte NICHT erneut versuchen, sondern kurz warten.	Siehe Wenn die Zahlung unbestätigt bleibt.
Stripe-Terminal-Status nach Reader-Push unsicher.	Die Verbindung zu Stripe brach nach dem Senden ab; die Zahlung kann am Leser angekommen sein. Wie „unbestätigt" behandeln: im Stripe-Konto prüfen, nicht sofort erneut kassieren.
Unbestätigte frühere Zahlung über einen abweichenden Betrag gefunden — bitte klären	Ein offener Vorgang mit anderem Betrag liegt vor. Im Stripe-Konto klären (ggf. erstatten), erst danach neu kassieren.
Zahlung abgebrochen. / Zahlung abgelehnt oder abgebrochen.	Gast oder Personal hat am Leser abgebrochen bzw. die Karte wurde abgelehnt. Mit anderer Karte oder Zahlart erneut versuchen.
Stripe Terminal unterstützt keine referenzlose Karten-Gutschrift …	Freie Gutschrift ist bei Stripe nicht möglich. Beleg stornieren oder bar erstatten.
Keine Transaktionsreferenz für das Storno vorhanden.	Dem Beleg fehlt der Stripe-Bezug. Eine Erstattung über DiKAS ist dann nicht möglich — bitte den Support kontaktieren.
Diese Kartenzahlung lief über … Stornieren ist nur an der Kasse mit diesem Terminal möglich.	Den Storno an der Kasse durchführen, der dieser Leser zugeordnet ist.
Keine Berechtigung für Karten-Erstattungen.	Dem Benutzer unter Admin → Personal das Recht EC-Gutschrift ausführen geben oder einen Administrator stornieren lassen.

Nächster Schritt¶

→ Zahlungsarten und Kartenzahlung an der Kasse — Storno, Gutschrift und Kartenart als Zahlungsart → Hardware: EC-/Kartenterminals — Überblick über alle Terminal-Typen