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¶

Terminal anschließen und mit dem Anbieter die ECR-Kassenanbindung über TCP/IP aktivieren lassen.
Zahlungsoptionen öffnen: Admin → Einstellungen → Hardware → Zahlungsoptionen.
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.
Bei Typ den Eintrag ZVT wählen und Name (z. B. „Terminal Theke"), IP-Adresse, Port und – falls vergeben – Passwort eintragen.
Prüfen, ob Terminal hat eigenen Drucker richtig gesetzt ist (Standard: an; siehe unten).
Oben Speichern klicken.
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.
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¶

Artikel buchen, Bezahlen wählen, EC-Karte oder Kreditkarte.
Der Dialog EC-Kartenzahlung zeigt Betrag und Terminal: . Der Betrag steht gleichzeitig auf dem Terminal.
Der Gast hält Karte, Handy oder Smartwatch an das Terminal oder steckt die Karte und gibt ggf. die PIN ein.
Gibt das Terminal während der Zahlung Texte aus (z. B. Trinkgeldauswahl), zeigt DiKAS sie im Wartefenster als Terminal zeigt: ….
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.

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.

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.
Im Dialog Karten-Gutschrift den Betrag (€), den Grund der Gutschrift (Pflichtfeld) und den Steuersatz der Gutschrift (Pflichtfeld) angeben.
Gutschrift durchführen wählen, der Gast hält seine Karte an das Terminal.
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, nachdem das Terminal ihn schon bekommen hatte. Am Terminal prüfen.
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. Bleibt es dauerhaft gelb, Status prüfen.
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