Überblick

Kurzfassung

ZVTSIM ersetzt das Kartenterminal, solange du deine Kassensoftware entwickelst und testest. Du bekommst eine eigene Testinstanz, trägst sie in der Kasse als ZVT-Terminal ein und löst Zahlungen aus wie im Echtbetrieb – nur ohne Karte, ohne Geld und ohne Wartezeit am Gerät.

• Für wen: Hersteller und Integratoren von Kassensoftware, die per ZVT mit Zahlungsterminals sprechen.

• Was du siehst: jede Zahlung in der Live-Anzeige, Telegramm für Telegramm und mit lesbarer Deutung.

• Was du auslösen kannst: Ablehnung, Abbruch, Zeitüberschreitung und Kartenfehler als Fehlerszenarien – per Klick oder aus deiner Pipeline über die Steuer-API.

• Was du nachträglich auswerten kannst: einen Mitschnitt aus echtem Terminalbetrieb in der Mitschnitt-Analyse.

• Was es kostet: ab einem Tages-Pass für einen Tag bis zum Jahresabo – siehe Preise.

• Was auf dem Server bleibt: standardmäßig kein Betriebsprotokoll. Deine Instanz schreibt ihren Telegrammverkehr nur mit, wenn du die Protokollierung unter Einstellungen selbst einschaltest; dann wird das Protokoll 7 Tage nach dem Ende der Instanz gelöscht (0 bis höchstens 90 Tage wählbar, Löschknopf daneben) – siehe Daten und Sicherheit.

• Was du jederzeit selbst kannst: alle deine Daten unter Einstellungen als ZIP-Datei herunterladen und dein Konto dort endgültig löschen.

In drei Schritten zum ersten Test: Konto anlegen und Tarif wählen, Instanz starten, Terminal in der Kasse eintragen und zahlen.

Jetzt registrieren · Preise ansehen · Handbuch durchblättern

Ausführlich

Was ZVTSIM ist

Eine Kassensoftware, die per ZVT mit einem Kartenterminal spricht, muss gegen viele Situationen getestet werden: Zahlung genehmigt, Karte abgelehnt, Kunde bricht ab, das Terminal antwortet nicht mehr, Storno, Tagesabschluss. Mit einem echten Gerät und einer echten Karte lassen sich die meisten dieser Fälle kaum herbeiführen, und jeder Versuch kostet Zeit.

ZVTSIM nimmt dir das ab. Es verhält sich gegenüber deiner Kasse wie ein Zahlungsterminal und antwortet so, wie du es vorgibst. Du startest im Browser eine eigene Instanz, trägst IP-Adresse und Port in deine Kassenkonfiguration ein und arbeitest ab da wie an einem echten Gerät – nur schneller und vorhersagbar.

ZVTSIM ist ein Terminalsimulator und kein Zahlungssystem: Es wird kein Geld bewegt, es gibt keine Verbindung zu einem Zahlungsdienstleister, und es werden keine Karten gelesen. Das Verhalten folgt der ZVT-Spezifikation; wo Terminal-Hersteller davon abweichen, kann ein echtes Gerät anders antworten. Teste deshalb vor dem Produktivgang immer auch mit einem echten Terminal.

Für wen es gedacht ist

• Kassenhersteller, die ihre ZVT-Anbindung entwickeln oder umbauen und dafür nicht auf ein Leihgerät warten wollen.
• Integratoren und Dienstleister, die eine fremde Kasse an ein Terminal anbinden und das Zusammenspiel prüfen müssen.
• Test- und QA-Teams, die Fehlerfälle reproduzierbar brauchen: immer derselbe Ablauf, immer dasselbe Ergebnis.
• CI/CD-Pipelines, die bei jeder Codeänderung prüfen, ob die Kasse mit einer abgelehnten, abgebrochenen oder ausbleibenden Zahlung richtig umgeht.

Was du bekommst

Eine eigene Instanz. Ein Prozess, der nur für dich läuft und ZVT-Verbindungen nur von deinem Testsystem annimmt. IP-Adresse und Port dafür zeigt dir die Seite Simulator.

Ein Betriebsprotokoll nur auf Wunsch. Standardmäßig schreibt deine Instanz nichts mit. Brauchst du für eine gemeinsame Fehlersuche doch ein Protokoll des Telegrammverkehrs, schaltest du es auf der Seite Einstellungen ein – mit einem Bestätigungshäkchen, denn für den Inhalt deines Testverkehrs bist du verantwortlich. Es gilt ab der nächsten Instanz; eine laufende schreibt weiter wie gestartet. Kartennummern sind darin unkenntlich gemacht, und gelöscht wird nach einer Frist, die du dort ebenfalls festlegst: 7 Tage nach dem Ende der Instanz (Vorgabe), 0 Tage (löschen, sobald die Instanz endet), 1, 30 oder höchstens 90. Auf derselben Seite löschst du alle Protokolle deiner beendeten Instanzen sofort. Was genau protokolliert wird, steht unter Daten und Sicherheit.

Deine Daten in deiner Hand. Unter Einstellungen, Abschnitt „Meine Daten", lädst du alles herunter, was das Portal über dich gespeichert hat – Konto, Freischaltungen, Schlüssel, Einstellungen und die Protokolle deiner beendeten Instanzen – und dort löschst du dein Konto auch endgültig, samt deinem Kundenkonto bei Stripe. Was dabei gelöscht wird und was aus steuerlichen Gründen ohne deinen Namen bestehen bleibt, steht in Daten und Sicherheit.

Die Live-Anzeige. Jedes Telegramm zwischen Kasse und Instanz erscheint sofort im Browser, mit Bytefolge und lesbarer Deutung, nach Vorgängen gegliedert und mit markierten Protokollfehlern.

Fehlerszenarien. Du legst fest, wie die nächste Zahlung ausgeht: genehmigt, abgelehnt, abgebrochen, Kartenfehler – oder gar keine Antwort, damit du die Zeitüberschreitung deiner Kasse prüfen kannst.

Die Steuer-API. Fünf Aufrufe mit einem API-Schlüssel, damit eine Pipeline Instanz und Verhalten ohne Browser steuert.

Die Mitschnitt-Analyse. Du hast ein Problem an einem echten Terminal und einen Mitschnitt davon? Lade ihn maskiert hoch und lies ihn so aufbereitet, wie die Live-Anzeige den laufenden Verkehr zeigt.

In drei Schritten zum ersten Test

1. Konto anlegen und Tarif wählen. Registrieren, anmelden, auf Preise einen Tarif wählen. Die Bezahlung läuft über Stripe; Kartendaten erreichen dieses Portal nicht.
2. Instanz starten. Ein Klick auf der Simulator-Seite. Sie nennt dir danach IP-Adresse und Port – genau die beiden Werte, die deine Kasse braucht.
3. Terminal eintragen und zahlen. Beides in die Kassenkonfiguration übernehmen, eine Zahlung auslösen und im Browser mitlesen.

Wie das im Einzelnen aussieht, steht im Schnellstart: Er führt dich in wenigen Minuten bis zur ersten simulierten Zahlung.

Wie du dieses Handbuch benutzt

Jedes Kapitel beginnt mit einer Kurzfassung für alle, die ZVT und Zahlungsterminals kennen und nur die Eckdaten brauchen. Darunter steht die ausführliche Fassung für alle, die Schritt für Schritt vorgehen möchten oder bei einem Begriff unsicher sind. Beide stehen auf derselben Seite und lassen sich oben umschalten. Wo es sinnvoll ist, kannst du einen Aufruf direkt im Kapitel ausprobieren.

Die Schnellreferenz fasst Werte, Modi und Aufrufe auf einer Seite zusammen, und das Glossar erklärt die ZVT-Begriffe. Dieser Überblick, Tarife und Freischaltung, Daten und Sicherheit und das Glossar sind ohne Anmeldung lesbar; für die Anleitungskapitel brauchst du ein Konto – aber keine Freischaltung.