Wie kann ich ein PayTec ep2 Terminal in eine Kassenapplikation oder in einen Automaten integrieren?

Allgemein

Eine Integration des Terminals in die Kassenapplikation oder in einen Automaten bietet viele Vorteile. So kann zum Beispiel der Betrag automatisch an das Terminal gesendet werden oder die Kasse/der Automat  kann die Belegdaten zur weiteren Verarbeitung vom Terminal holen.

PayTec bietet unterschiedliche Schnittstellen für jeden Anwendungszweck an.

Übersicht

Terminal Simulator

Link: https://ecritf.paytec.ch/trmsim/

Der Terminal-Simulator ist ein webbasiertes Tool, das den Terminalteil unserer cloudbasierten Kassenoberfläche simuliert. Dies ermöglicht Ihnen, mit Ihrer Integration zu beginnen, ohne die Notwendigkeit eines physischen Terminals. Dieser Simulator verhält sich grösstenteils wie ein physisches Terminal mit folgenden Einschränkungen:

• Unterstützung nur für KIT via Cloud / KIT Rest Schnittstelle
• Der Simulator enthält nicht alle Funktionen, die in einem physischen Terminal vorhanden sind, einschliesslich, aber nicht beschränkt auf automatisch ausgelöste Aktionen, Trinkgeldeingabe, transaktionsbasierte Referenzen, Petrolanwendungsfälle.
• Das Zeitverhalten und die Statusbenachrichtigungen während der Operationen im Simulator können sich von denen eines physischen Terminals unterscheiden
• Der Inhalt des Belegs kann zwischen dem Simulator und einem tatsächlichen Terminal leicht variieren

Für die Fertigstellung und das Testen der Integration wird ein physisches Terminal benötigt.

KIT via Cloud

KIT via Cloud ist eine Javascript-basierte Web API, die in allen webbasierten Applikationen integriert werden kann. 

Dokumentation: https://ecritf.paytec.ch/doc/

Beispielapplikation: https://ecritf.paytec.ch/

GitHub Repository: https://github.com/PayTecAG/ecritf

KIT Rest

KIT Rest ist eine RESTful API um unsere Terminals anzubinden.

Landing Page: https://kitrest.paytec.ch
Dokumentation: https://kitrest.paytec.ch/doc
OpenAPI Spezifikation: https://kitrest.paytec.ch/openapi.yaml

KIT JSON und KIT TLV

KIT JSON und KIT TLV stellen die aktuellsten Terminalschnittstellenspezifikationen dar und bieten den vollständigen Funktionsumfang für die Integration der PayTec Zahlungsterminals. Beide Varianten sind unabhängig vom eingesetzten Technologie-Stack und die empfohlene Wahl für neue Integrationen, da keine Abhängigkeiten von Java, .NET, o.ä. besteht. Die Verbindung über KIT JSON / TLV bleibt auch im Fall eines Internetausfalls bestehen.

Dokumentation: EFT ECR Interface-v3.0

JSON Schema: https://github.com/PayTecAG/ecritf/blob/main/ecritf-schema.json

KIT JSON Tester Sourcecode (kann kompiliert werden für Windows, OSX und Linux):
https://github.com/PayTecAG/ecritf/tree/main/examples/node/kit-json-electron

KIT JSON Tester (Windows executable): https://github.com/PayTecAG/ecritf/releases

KIT API

Abkündigung: Die KIT API .NET Bibliothek hat per 1. Januar 2026 ihr End-of-Life erreicht und darf für neue Projekte nicht mehr verwendet werden. KIT API Java ist per 31. Dezember 2026 zur Abkündigung vorgesehen und sollte ebenfalls nicht mehr für neue Entwicklungen eingesetzt werden.

KIT API ist eine vollständige Implementation des KIT TLV Protokolls in Java/.NET und stellt dem Integrator eine komfortable API für die Integration des Terminals bereit. Die API ist ereignisgesteuert und kümmert sich selbstständig um die Kommunikation, Heartbeats, etc. Das Zielsystem muss eine Unterstützung für Java/.NET anbieten.

Dokumentation: KIT Spezifikation 5.03.00

Java JAR: KIT Java (neue Version bei Problemen mit Terminalsoftware androidep2_73-25.xx.xx. und neuer)

.NET DLL: KIT .NET (neue Version bei Problemen mit Terminalsoftware androidep2_73-25.xx.xx. und neuer)

Beispielapplikation: KIT Tester, Visual Studio Projekt

ZVT LAN

PayTec bietet bei ep2 Terminals auch eine ZVT Schnittstelle über LAN an. Dabei wird die ZVT Spezifikation v13.08 des Verbands der Terminal-Hersteller in Deutschland e.V. unterstützt. Diese Integration eignet sich besonders, wenn die Kasse bereits eine ZVT Unterstützung anbietet:

Unterstützt sind die Kommandos für Retail und Hospitality:

06 00 (Registration)
06 01 (Authorisation)
06 02 (Log Off)
06 03 (Account Balance Request)
06 04 (Activate Card)
06 21 (Telephonic Reservation)
06 22 (Reservation)
06 24 (Book Total)
06 30 (Reversal)
06 31 (Refund)
06 50 (End of Day)

Technische Parameter:
Protokoll: ZVT-LAN
TCP/IP Port: 20007
Passwort: keines erforderlich (falls gefragt: bitte „000000“ eingeben)

Dokumentation: https://www.terminalhersteller.de/Downloads.aspx?Seite=Downloads

 

O.P.I.

Wir unterstützen das Open Payment Initiative O.P.I. protokoll. Für weitere Informationen kontaktieren Sie uns unter integration@paytec.ch

Folgende Befehle sind implementiert:

CardServiceRequest:
 - CardPayment
 - CashAdvance
 - CardReservation
 - PaymentRefund
 - CardBalanceInquiry
 - PaymentReversal
 - Load
 - CancelReservation
 - AbortRequest
 - TicketReprint
 - RepeatLastMessage
 
ServiceRequest:
 - Login
 - Logoff
 - GetCardCircuits
 - ContactTMS (Konfiguration mit ep2 Service Center)
 - ContactAcq (Initialisierung ep2 Acquirer)
 - TransmitTrx (Dateneinlieferung Acquirer/PMS)
 - CloseDay/Reconciliation (Tagesabschluss)
 - RestartTerminal
 - Startup (Konfiguration mit ep2 Service Center plus Initialisierung ep2 Acquirer)

MDB

Einige Terminals bieten wir mit der MDB (Multi Drop Bus) Schnittstelle an. Unsere MDB Implementation unterstützt Cashless Device Level 3 mit Selection First, Credit First und Always Idle. PayTec besitzt eine ep2 MDB Referenzabnahme. Daher kann ein vereinfachtes Verfahren für die ep2 Konformitätsabnahme durchgeführt werden. 

GPIO

Kontaktgeschaltete Automaten können mittels zusätzlicher PayTec GPIO Box angeschlossen werden. Diese Art von Automaten besitzen einen potentialfreien Eingang (oder mehrere). Dieser Eingang steuert die Produktausgabe oder zählt auf dem Automaten einen Kredit hoch. Kontaktieren Sie unseren Support für weitere Information.

Unterstützung

Gerne unterstützen wir Sie bei der Integration von PayTec Terminals über integration@paytec.ch