Zum Inhalt
v26.3

Kartenzahlung mit ZVT-Terminal

Das ZVT-Terminal ist das klassische EC-Terminal mit Standfuß oder Handteil, wie es die meisten Banken und Zahlungsdienstleister in Deutschland und Österreich liefern — zum Beispiel von Ingenico, CCV, Verifone oder PAX. DiKAS spricht über das Netzwerk (TCP/IP) mit dem Terminal: Der Betrag erscheint automatisch auf dem Terminal, ohne Abtippen und ohne Tippfehler. Das Terminal läuft über Ihren eigenen Vertrag mit Ihrer Bank bzw. Ihrem Netzbetreiber; DiKAS erhebt keinen Aufschlag pro Buchung.


Auf einen Blick

Terminal-Typ in DiKAS ZVT
Anbindung Netzwerk (LAN-Kabel), TCP/IP, Port laut Terminal (meist 20007)
Trinkgeld am Terminal wird von der Kasse übernommen
Kartenbeleg Terminal druckt selbst oder DiKAS druckt ihn auf den Bon (Schalter Terminal hat eigenen Drucker)
Storno am Terminal der ursprünglichen Zahlung
Freie Karten-Gutschrift ✅ möglich
Kassenschnitt, Umsatz-Zwischensumme, Belegwiederholung ✅ aus DiKAS heraus

Unterstützte Geräte und Länder

Jedes Terminal, das das ZVT-Protokoll über TCP/IP spricht und dessen Kassenanbindung (ECR) freigeschaltet ist. Die Übersicht zeigt typische Einstellungen — maßgeblich ist immer die Einstellung am Terminal:

Geräte / Familie Häufiger Port
Allgemeiner ZVT-Standard, CCV (Base Next, Mobile Premium, PAD Next), viele hobex-Terminals 20007
Ingenico-Terminals 5577
Verifone, z. B. V200, V400, P400 22000
Alternative Konfigurationen 20008

Bei Worldline, Valina, PAX, PAYONE, VR Payment und Sparkassen-/Bank-Terminals hängt der Port von der installierten Terminalsoftware und dem Netzbetreiber ab; dort kommen unter anderem 20007, 20011, 5577 und 25690 vor. Übernehmen Sie den Wert, den das Gerät oder Ihr Anbieter nennt.

Port 20002 nicht auf Verdacht eintragen

20002 ist in OPI-Konfigurationen meist der Rückkanal (Kassenport) und nicht der ZVT-Port des Terminals. Tragen Sie ihn nur ein, wenn der Terminal-Anbieter ihn ausdrücklich als ZVT-Port nennt.

Länder: ZVT ist der Terminalstandard in Deutschland und Österreich. In der Schweiz lassen sich PayTec-Terminals über ZVT im LAN anbinden; weitere Informationen zu Schweizer Terminals unter Zahlungsterminals Schweiz. Bei Betrieben in Spanien bietet DiKAS den Typ ZVT nicht zur Auswahl an.


Voraussetzungen

  • Kassenanbindung am Terminal aktiv: Die ECR-/Kassenanbindung über TCP/IP muss am Terminal eingeschaltet sein. Das übernimmt bei Bedarf der Terminal-Anbieter oder Netzbetreiber. Ein offenes Netzwerkkabel allein genügt nicht.
  • Dasselbe Netzwerk wie die Kasse: Terminal per LAN-Kabel an Router oder Switch. Empfehlung: dem Terminal im Router eine feste IP-Adresse reservieren — ändert sie sich, erreicht die Kasse das Terminal nicht mehr.
  • IP-Adresse und Port des Terminals (siehe Tabelle oben).
  • Falls vergeben: das Terminal-Passwort (ECR-Passwort) — erfragen Sie es bei Ihrem Terminal-Anbieter.
  • Firewall/Router: Die Kasse baut die Verbindung zum Terminal auf (ausgehend, TCP zur Terminal-IP und zum eingestellten Port). Blockiert eine Firewall oder eine Gäste-/VLAN-Trennung diesen Weg, kommt keine Verbindung zustande.
  • Cloud-Kasse: Läuft die Kasse in der Cloud, erreicht sie das Terminal über den Hardware-Agenten im Laden-Netz — siehe Hardware-Agent. Das Terminal selbst bleibt im lokalen Netz.
  • Terminal-ID (TID), Händler-/VU-Nummer und Vertragsdaten bereithalten — der Anbieter fragt sie bei Rückfragen.
  • Ein Benutzer mit Zugriff auf Admin → Einstellungen.

Einrichten in 8 Schritten

  1. Terminal anschließen und mit dem Anbieter die ECR-Kassenanbindung über TCP/IP aktivieren lassen.
  2. Zahlungsoptionen öffnen: Admin → Einstellungen → Hardware → Zahlungsoptionen.
  3. Terminal hinzufügen (Plus-Symbol) — oder oben auf Geräte suchen klicken, den lokalen IP-Bereich eingeben und gefundene Terminals übernehmen. Die Suche prüft die Ports 20007 → 5577 → 22000 → 20008. Ein offener Port allein wird nicht übernommen: DiKAS sendet zusätzlich eine ZVT-Abfrage und zeigt nur Geräte mit erkennbarer ZVT-Antwort. Die Suche bleibt auf den eingegebenen Bereich beschränkt.
  4. Bei Typ den Eintrag ZVT wählen und Name (z. B. „Terminal Theke"), IP-Adresse, Port und – falls vergeben – Passwort eintragen.
  5. Prüfen, ob Terminal hat eigenen Drucker richtig gesetzt ist (Standard: an; siehe unten).
  6. Oben Speichern klicken.
  7. In der Zeile das Status prüfen-Symbol (WLAN-Zeichen) anklicken. Unter der Terminalliste erscheint die Karte Terminal-Diagnose mit Verbindung, Port/Hersteller, den Ergebnissen beider Abfragen sowie – je nach Terminalmodell – Terminal-ID (TID), Händler-/VU-Nr., Software-Version, Gerät / Modell, Seriennummer, Terminalstatus und Gerätezustand. Liefert das Gerät einzelne Angaben nicht, steht dort „nicht geliefert"; das allein verhindert keine Zahlung.
  8. Bei mehreren Terminals unter der Liste das Standard-Terminal wählen. Dann eine Testzahlung durchführen.

Woran eine vollständige Einrichtung erkennbar ist

Status prüfen darf nicht nur „TCP verbunden" melden: Auch die ZVT-Abfrage muss erfolgreich sein. Ein gelbes Warnsymbol bedeutet: Das Terminal ist im Netz erreichbar, lehnt die Abfrage aber ab — dann stimmt meist die Kassenanbindung am Terminal nicht (siehe Fehler und Abhilfe).

Mehrere Terminals und mehrere Kassen

  • Mehrere Terminals: Je Terminal ein eigener Eintrag mit eigenem Namen. Welches Terminal ein Gerät benutzt, legen Sie je Arbeitsplatz oder am Gerät in den Kassen-Einstellungen → Terminal fest; sonst gilt das Standard-Terminal. Teilen sich mehrere Bedienungen mehrere Terminals, kann die Kasse vor jeder Kartenzahlung nach dem Terminal fragen (Kassen-Einstellungen → EC-Terminal → Terminal bei jeder EC-Zahlung wählen). Im Zahlungsdialog steht immer der Name des Terminals.
  • Mehrere Kassen an einem Terminal: Ein ZVT-Terminal bedient nur einen Vorgang zur Zeit. Arbeiten mehrere Kassen im Verbund mit einer gemeinsamen TSE, schicken die weiteren Kassen ihre Befehle automatisch über die Kasse mit der TSE ans Terminal. Zahlen zwei Kassen gleichzeitig am selben Terminal, meldet die zweite nach wenigen Sekunden „Terminal belegt, bitte warten.", statt ohne Antwort hängen zu bleiben.

Kartenzahlung klappt an einer weiteren Kasse nicht?

Kassieren Sie den Vorgang an der Kasse mit der TSE. Dort geht der Befehl direkt ans Terminal.


So funktioniert die Zahlung an der Kasse

  1. Artikel buchen, Bezahlen wählen, EC-Karte oder Kreditkarte.
  2. Der Dialog EC-Kartenzahlung zeigt Betrag und Terminal: . Der Betrag steht gleichzeitig auf dem Terminal.
  3. Der Gast hält Karte, Handy oder Smartwatch an das Terminal oder steckt die Karte und gibt ggf. die PIN ein.
  4. Gibt das Terminal während der Zahlung Texte aus (z. B. Trinkgeldauswahl), zeigt DiKAS sie im Wartefenster als Terminal zeigt: ….
  5. Bestätigt das Terminal die Zahlung, zeigt DiKAS Zahlung erfolgreich mit Karteninfo und Transaktionsnummer; der Beleg wird gebucht.

Mit Abbrechen im Dialog wird der Vorgang am Terminal aktiv abgebrochen — das Gerät wartet dann nicht weiter auf die Karte.

Abbrechen während der Zahlung

Abbrechen fordert den Abbruch am Terminal an und wartet dann auf dessen Antwort — das Fenster zeigt solange Abbruch angefordert — warte auf das Terminal. Je nach Antwort:

Was passiert Was DiKAS tut Was Sie tun
Das Terminal bestätigt den Abbruch (es meldet den Abbruch zurück und hatte vorher keine Freigabe gemeldet) Das Fenster schließt sofort, DiKAS bucht nichts. Die Karte wurde nicht belastet. Neu kassieren oder andere Zahlart wählen.
Das Terminal quittiert den Abbruch nur oder antwortet nicht innerhalb von 10 Sekunden, oder die Verbindung bricht ab DiKAS zeigt Zahlung unbestätigt — an der Kasse abgebrochen und bucht nichts. Ohne Bestätigung des Terminals ist ein Abbruch an der Kasse kein Beweis, dass nichts abgebucht wurde. Am Terminal kurz prüfen (kein Zahlungsbeleg = nichts abgebucht), dann Schließen und neu kassieren oder andere Zahlart wählen.
Das Terminal hatte im selben Moment schon freigegeben DiKAS zeigt Zahlung erfolgreich und bucht den Vorgang ganz normal — die Karte ist belastet, der Beleg passt dazu. Nichts — nicht erneut kassieren.
Das Terminal hatte schon eine Freigabe gemeldet, der Abschluss fehlt Zahlung unbestätigt — das Terminal meldete eine Freigabe … Karte ist vermutlich belastet: Beleg am Terminal prüfen, nicht erneut kassieren; ggf. mit Zahlart EC nachbuchen.
Das Terminal reagiert nicht auf den Abbruch Hinweis bitte am Terminal abbrechen (Stopp-Taste); das Fenster wartet weiter. Am Terminal mit der Stopp-Taste abbrechen; DiKAS übernimmt dann dessen Ergebnis.

Terminal über den Hardware-Agent oder an einer zweiten Kasse

Ist das Terminal über einen Hardware-Agent angebunden (Cloud-Kasse ohne eigenen Kassenserver vor Ort) oder zahlt eine zweite Kasse über die Hauptkasse (Kassenverbund), gibt DiKAS Abbrechen an den Agenten bzw. die Hauptkasse weiter. Das Terminal bricht ab, und es gilt dieselbe Tabelle wie oben, auch der sofort schließende bestätigte Abbruch.

Was passiert Was DiKAS tut Was Sie tun
Hardware-Agent bzw. Hauptkasse sind auf dem aktuellen Stand Wie in der Tabelle oben. Wartete der Vorgang am Agenten noch auf das Terminal, startet er nicht mehr: An der Kasse abgebrochen, bevor das Terminal den Vorgang erhielt — nichts abgebucht. Neu kassieren oder andere Zahlart wählen.
Der Hardware-Agent ist älter (App bzw. Kassen-Box noch nicht aktualisiert) Zahlungsausgang unbestätigt — an der Kasse abgebrochen, der Hardware-Agent konnte den Abbruch nicht an das Terminal weitergeben. Das Terminal wartet weiter auf die Karte. Am Terminal mit der Stopp-Taste abbrechen und dort prüfen, ob gebucht wurde; nicht erneut kassieren. Den Hardware-Agent aktualisieren.
Der Agent meldet nach dem Abbruch 20 Sekunden lang nichts Zahlungsausgang unbestätigt — der Hardware-Agent hat nach dem Abbruch kein Ergebnis gemeldet. Am Terminal prüfen, nicht erneut kassieren.
Die Hauptkasse ist älter Zahlung unbestätigt — keine verlässliche Antwort vom Kassen-Host (an der Kasse abgebrochen). In der Regel erreicht der Abbruch das Terminal trotzdem. Am Terminal prüfen und dort ggf. mit der Stopp-Taste abbrechen; nicht erneut kassieren.

An der Kasse schließt Escape den Zahl-Dialog nicht, solange darin die Kartenzahlung läuft.

Fenster nicht durch Neuladen schließen

Solange eine Kartenzahlung läuft, die Seite nicht neu laden und die Maske nicht wechseln. Gibt das Terminal dann noch frei, erreicht das Ergebnis die Kasse nicht; DiKAS vermerkt es im Kassenprotokoll als ZVT_ZAHLUNG_OHNE_KASSE (Terminal, Beleg, Transaktion) — den Vorgang dann von Hand mit Zahlart EC nachbuchen, nicht erneut kassieren. Das gilt auch an der Android-Kasse (mit aktueller App-Version), wenn dort während der Zahlung die Seite neu geladen wird. Ältere Android-Apps vermerken diesen Fall nicht — dort Terminalbeleg und Kassenbelege vergleichen.

Wann gilt eine Zahlung als erfolgreich?

Nur wenn das Terminal sie mit Beleg-/Tracenummer bestätigt. Fehlt die Bestätigung, bucht DiKAS nicht und meldet die Zahlung als unbestätigt.

Unbestätigte Zahlung

Ist unklar, ob ein Zahlungsbefehl am Terminal angekommen ist oder ausgeführt wurde, zeigt DiKAS Zahlung unbestätigt und den Hinweis NICHT erneut kassieren — Zahlung am Terminal prüfen. DiKAS schickt den Befehl nicht ein zweites Mal. Prüfen Sie den Beleg am Terminal (oder die Kartensumme, siehe unten), bevor Sie erneut kassieren — so wird keine Karte doppelt belastet. Bei ZVT gibt es hier keine Schaltfläche „Status prüfen", denn ein erneuter Zahlungsaufruf wäre eine neue Belastung.

Trinkgeld am Terminal

Gibt der Gast am Terminal Trinkgeld ein, belastet das Terminal mehr als angefordert. Die Kasse übernimmt die Differenz als Trinkgeld und setzt die Kartenzahlung auf den tatsächlich belasteten Betrag. Der Beleg bleibt dadurch stimmig.

Kartenbeleg — wer druckt?

Der Schalter Terminal hat eigenen Drucker (unter jeder ZVT-Zeile) entscheidet:

  • An (Standard): Das Terminal druckt Kundenbeleg und Kassenschnitt selbst. DiKAS druckt den Kartenbeleg nicht zusätzlich — kein Doppeldruck.
  • Aus: DiKAS druckt den Kartenbeleg mit auf den Kassenbon und den EC-Tagesabschluss über den Bondrucker.

Falsch gesetzt = doppelter oder fehlender Kartenbeleg

Hat Ihr Terminal Papier und druckt, lassen Sie den Schalter an. Hat es keinen Drucker (z. B. ein reines Handteil), schalten Sie ihn aus.

Storno einer Kartenzahlung

Menü → Rechnungen, Beleg suchen, Stornieren, Grund eingeben. DiKAS bucht die Kartenzahlung zuerst am Terminal zurück (Rückbuchung) und erzeugt erst danach den Storno-Beleg.

  • Der Storno läuft nur an der Kasse, die das Terminal der Zahlung bedient. An einer anderen Kasse meldet DiKAS: Diese Kartenzahlung lief über … Stornieren ist nur an der Kasse mit diesem Terminal möglich.
  • Das Recht EC-Gutschrift ausführen ist nötig (Administratoren immer).
  • Enthält ein Beleg mehrere Kartenzahlungen, ist ein Gesamt-Storno nicht möglich; jede Zahlung wird einzeln erstattet.

Freie Karten-Gutschrift (Erstattung ohne Original-Beleg)

Anders als der Storno ist die Gutschrift eine eigenständige Erstattung auf die Karte — z. B. für eine Retoure an einem anderen Tag oder einen Teilbetrag.

  1. Menü → EC Terminal (sichtbar, wenn ein Terminal eingerichtet ist und der Benutzer das Recht EC-Gutschrift ausführen hat) und beim Terminal Geld zurück wählen. Alternativ in den Zahlungsoptionen (Tabellenansicht) das Symbol Karten-Gutschrift in der Terminalzeile.
  2. Im Dialog Karten-Gutschrift den Betrag (€), den Grund der Gutschrift (Pflichtfeld) und den Steuersatz der Gutschrift (Pflichtfeld) angeben.
  3. Gutschrift durchführen wählen, der Gast hält seine Karte an das Terminal.
  4. DiKAS zeigt Gutschrift erfolgreich und den Kundenbeleg. Die Gutschrift wird als eigener negativer, TSE-signierter Beleg gebucht.

Bleibt eine Gutschrift unbestätigt, erscheint NICHT erneut erstatten — sonst droht eine doppelte Gutschrift. Mit Status prüfen gleicht DiKAS sicher ab.

Kassenschnitt, Umsatz-Zwischensumme, Tagesabschluss

  • Kassenschnitt (EC-Tagesabschluss): Menü → EC Terminal → beim Terminal Abschluss. Danach erscheint Kassenschnitt OK. Alternativ das Kassenschnitt-Symbol in den Zahlungsoptionen. Der Kassenschnitt läuft nicht automatisch mit dem Tagesabschluss der Kasse, sondern wird je Terminal ausgelöst. Hat das Terminal keinen eigenen Drucker, druckt DiKAS den Abschlusstext auf dem Standard-Bondrucker.
  • Umsatz-Zwischensumme (Kartensumme): In den Zahlungsoptionen (Tabellenansicht) das Symbol Umsatz-Zwischensumme (Kartensumme) — nützlich, um die Kartensumme des Terminals mit dem Kartenumsatz der Kasse abzugleichen.
  • Letzten Beleg erneut drucken: Symbol in der Terminalzeile der Zahlungsoptionen (Tabellenansicht); das Terminal druckt den letzten Beleg noch einmal.

Grenzen

  • Das Terminal bedient nur einen Vorgang zur Zeit; parallele Zugriffe werden mit Terminal belegt, bitte warten. abgefangen.
  • Ohne Kassenanbindung (ECR/TCP-IP) am Terminal geht nichts, auch bei erreichbarer IP.
  • Stornos laufen nur am Terminal der Originalzahlung.
  • Terminals trennen im Leerlauf oder nachts die Verbindung; die Kasse verbindet sich bei der nächsten Zahlung selbst neu. Eine Anzeige „nicht erreichbar" in der Geräteübersicht ist ein gelber Hinweis, kein Fehler; sie zeigt den zuletzt gemessenen Stand und fragt das Terminal nicht selbst ab.

Fehler und Abhilfe

Meldung / Was Sie sehen Ursache und Abhilfe
Verbindung fehlgeschlagen Terminal nicht erreichbar. Netzwerkkabel, Stromversorgung, IP-Adresse und Port prüfen; Port-Wert am Terminal ablesen. Kasse und Terminal im selben Netz?
NotSupported (Terminal erreichbar, lehnt aber Befehle ab) Manche Geräte — etwa Ingenico — nehmen Befehle erst nach einer Anmeldung der Kasse an. DiKAS erledigt das automatisch und wiederholt den Befehl; am Terminal ist nichts umzustellen. Bleibt die Meldung, das Terminal-Passwort prüfen und beim Netzbetreiber bzw. Terminal-Anbieter die Kassenanbindung über TCP/IP prüfen lassen (TID, Händler-/VU-Nummer, Vertragsdaten bereithalten). Ein Wechsel von IP-Adresse oder Port hilft hier nicht.
Terminal belegt, bitte warten. Das Terminal bedient gerade einen anderen Vorgang (andere Kasse, Statusabfrage, wartende Trinkgeldauswahl). Kurz warten und erneut versuchen.
Zahlung unbestätigt — keine sichere Terminalantwort … Bitte am Terminal prüfen und nicht erneut ausführen. DiKAS weiß nicht, ob die Karte belastet wurde. Beleg am Terminal prüfen; nicht erneut kassieren, bevor das geklärt ist.
Zahlung unbestätigt — an der Kasse abgebrochen. Bitte am Terminal prüfen und nicht erneut kassieren. Der Vorgang wurde an der Kasse abgebrochen, das Terminal hat den Abbruch aber nicht bestätigt. Am Terminal prüfen.
Zahlungsausgang unbestätigt — an der Kasse abgebrochen, der Hardware-Agent konnte den Abbruch nicht an das Terminal weitergeben. Der Hardware-Agent ist zu alt für den Abbruch. Am Terminal mit der Stopp-Taste abbrechen und prüfen; Hardware-Agent aktualisieren.
Zahlungsausgang unbestätigt — genehmigter Status, aber kein sicherer Abschluss … Das Terminal hat genehmigt, aber den Abschluss nicht sauber gemeldet. Am Terminal prüfen und nicht erneut ausführen.
Zahlung abgelehnt Die Karte wurde vom Terminal bzw. der Bank abgelehnt. Andere Karte oder Zahlart versuchen.
Status prüfen zeigt ein gelbes Symbol / Port offen, Diagnose abgelehnt Das Terminal ist erreichbar, aber die ZVT-Kassenanbindung ist nicht (richtig) aktiv. Bei Terminal-Anbieter bzw. Netzbetreiber nachfragen; Port prüfen.
Terminal in der Geräteübersicht gelb („nicht erreichbar") Hinweis, kein Fehler: Das Terminal hat im Leerlauf die Verbindung getrennt. Bei der nächsten Zahlung verbindet DiKAS neu. Im Leerlauf versucht DiKAS es zunächst alle 5 Minuten; bleibt das Terminal weg, nur noch alle 15, 30 und dann 60 Minuten (eine Zahlung oder Status prüfen versucht es sofort). Bleibt es dauerhaft gelb: IP-Adresse und Port in den Einstellungen gegen das Terminal prüfen, Terminal eingeschaltet und im selben Netz? Lehnt das Terminal die Anmeldung ab, stimmt meist das Passwort des Terminals nicht.
Kartenbeleg doppelt oder fehlt Schalter Terminal hat eigenen Drucker prüfen (siehe Kartenbeleg).
Diese Kartenzahlung lief über … Stornieren ist nur an der Kasse mit diesem Terminal möglich. Den Storno an der Kasse durchführen, die dieses Terminal bedient.
Der Beleg enthält mehrere Kartenzahlungen. Bitte jede Zahlung referenzbezogen erstatten. Pro Kartenzahlung einzeln erstatten.
Keine Berechtigung für Karten-Erstattungen. Dem Benutzer das Recht EC-Gutschrift ausführen geben (siehe Berechtigungen).
Karten-Erstattung fehlgeschlagen: … Die Rückbuchung am Terminal ist gescheitert; der Beleg bleibt unverändert. Terminal prüfen und neu versuchen.

Nächster Schritt

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