How can I integrate a PayTec ep2 Terminal in a ECR or vending machine

General

Integrating a payment terminal in an ECR (electronic cash register) or a vending machine has many advantages such as: the payment amount is transmitted to the terminal and the ECR is able to receive information about the transaction and retrieve a receipt for printing or further processing. 

PayTec offers various integration protocols and drivers.

Overview

Protocol	Programming Language	Use Case	Remark
KIT via Cloud	Javascript	Web- and cloudbased systems	4G/LAN/WLAN, with autonomous handover from 4G to LAN/WLAN
KIT API	Java/.NET	Systems which offer Java/.NET support	LAN/WLAN
KIT JSON	independent	Systems with no support of Java/.NET	LAN/WLAN/RS232
KIT TLV	independent low-level	Systems which do not offer Javascript/Java/.NET support.  ECR has a Pepper driver	LAN/WLAN/RS232 Pepper TrmType52 (deprecated)
ZVT-LAN	independent	System has ZVT support (Retail and Hospitality Only)	WLAN/LAN TCP/IP Port: 20007 Pepper TrmType 121
MDB	independent	Vending machine runs a compatible VMC	MDB Version 4.2, Cashless Device, Credit First,  Selection First, Always Idle
GPIO	independent	Vending machines driven by a dry contact	Product dispensing or credit

KIT via Cloud

KIT via Cloud is a javascript based Web API, which can be integrated in all projects.

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

Sample application: https://ecritf.paytec.ch/

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

KIT API

KIT API is a complete implementation of the KIT TLV protocol in Java/.NET und offers a simple API to the user. The API is eventdriven and handles all the communication, heartbeats etc. Your system needs Java/.NET support.

Documentation: KIT Spezifikation 5.02.00

Java JAR: KIT Java

.NET DLL: KIT .NET

Sample Application: KIT Tester, Visual Studio Project

KIT JSON und KIT TLV

You can integrate the terminal by implementing the KIT JSON or KIT TLV protocol. Data can be transmitted in TLV or JSON format. This is needed when you have no Java/.NET/Javascript/ZVT-LAN support on your system.

Documentation: EFT ECR Interface v2.17.pdf

ZVT LAN

We support the german ZVT interface over LAN on our ep2 Terminals . Specification version 13.08 of the "Verband der Terminal-Hersteller in Deutschland e.V." is supported. This integration is suited if your system already supports ZVT terminals. 

Please note, only following retail and hospitality commands are supported:

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)

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

MDB

Some of our Terminals offer a MDB interface (Multi Drop Bus). Our MDB implementation supports the cashless device level 3 properties with Selection First, Credit First and Always Idle. PayTec has acquired an ep2 reference MDB certification. Therefore a simplified ep2 conformity certification can be done.

GPIO

Vending machines with dry contacts can be interfaced with our additional GPIO Box. This sort of vending machine dispense a product or add a credit to counter after triggering the contact. Please contact our support for more information.

Support

We will help you with your integration, please contact us here: [e-mail]