Terminal protocol Tatrabank Payment Connector

• Version

  3.1

• Agent restriction

  Remote Only

• Processing type

  Row by row

• Multi-input step

  Not Supported

The connector that helps connect external cash register systems (ECR) with the payment terminal. The connector is capable of transforming the request from the cash register system, entered in a format understood by the user (e.g., 100 CZK), into a format understood by the payment terminal. Subsequently, it can convert the transaction processing results returned by the terminal into a format the cash register system understands.

Purchase operation - Transfer of an amount from the cardholder’s account to the terminal operator’s account (merchant) as a payment for goods, services or cash.

Supported card brands

• VISA
• AMEX
• MC
• Maestro
• Diners
• JCB

---

Configuration

POS Connection

IP Address

Destination IP address of terminal (e.g. 10.0.0.5)

IP Port

Destination port of terminal (e.g. 2050)

POS Settings

Protocol version

Version of ECR protocol (e.g., 1.00)

ECR info data

ECR integrator specific data sent by the cash register (e.g., IGS)

Currency Code

Currency code used in transaction (e.g., 978 for Euro)

Print on POS flag

Print the receipt on the terminal (e.g., 0 or 1)

Send formatted receipt flag

Send the receipt to ECR (e.g., 0 or 1)

---

Input & Output Schema

Input

Pos Tatrabank Payment Input Schema (1.1.0)

Column	Data type	Allow null	Description
Amount	Double	No	Transaction amount defines the value of a transaction. The amount is given without decimal point. Example: the amount "2000" is given for the amount 2000 HUF or 20,00 CZK
Transaction Id	String	Yes	Alphanumeric identification used for transaction identification
Meal amount	Double	Yes	Meal amount to be authorized by ESL host
CardNumber	String	Yes	Track2 record if magstripe was read by ECR
TerminalId	String	Yes	Terminal logical identifier on which the transaction will be made
VariableSymbol	String	Yes	Unique transaction identification generated by ECR for matching transaction in accounting
IpAddress	String	Yes	Destination IP address of terminal
IpPort	Integer	Yes	Destination port of terminal

Output

Pos Tatrabank Payment Output Schema (1.0.0)

Column	Data type	Allow null	Description
IsTransactionApproved	Bool	No	Flag identifies that the transaction has been approved
TransactionId	String	Yes	Alphanumeric identification used for transaction identification
PrimaryAccountNumber	String	Yes	PAN and expiry date of card separated by “=” character. Some parts of card number should be masked by “*” character
TerminalId	String	Yes	Terminal logical identifier on which the transaction will be made
AuthorizationCode	String	Yes	Field value depends on card brand and issuer AC. The only permitted special symbol is „ “ (space ASCII 0x20).
PinIndicator	String	Yes	Cardholder verification method. Possible values are: Y – PIN, N – None, S - Signature
CardType	String	Yes	Alphanumeric string which identifies the type of card (see Supported card brands)
ResponseCode	String	Yes	Alphanumeric response code from host
EcrVersion	String	Yes	Version of ECR protocol (e.g., 1.00)
ReceiptEncoding	String	Yes	Encoding of receipt data. Possible encodings are UTF-8 (default), ASCII, CP1250 and ISO-8859-2
ResponseCodeDescription	String	Yes	Response code description from host. Text is encoded using the same encoding scheme as specified in field “e”
LocalTextResponse	String	Yes	Description of locally declined transaction
HashCard	String	Yes	PAN hashed with SHA1 function
ApplicationId	String	Yes	Application identifier
AuthorizedAmount	Double	Yes	Amount that was authorized by the AC
Amount	Double	No	Total transaction amount
TransactionTimestamp	DateTime	Yes	Timestamp of transaction in format: yyyy-mm-dd HH:MM:SS
DedicatedFileName	String	Yes	Dedicated File Name (EMV Tag: 84)
ApplicationLabel	String	Yes	Application Label (EMV Tag: 50) + ‚contactless‘ (if applicable)
VariableSymbol	String	Yes	Unique transaction identification generated by ECR for matching transaction in accounting
CustomerReceipt	String	Yes	Formatted customer receipt data for ECR printer
MerchantReceipt	String	Yes	Formatted customer receipt data for ECR printer

---

Release notes

3.1.0

• Extended input scheme for IpAddress and IpPort

3.0.0

• First release

---

Was this page helpful?

×

Yes No

What is the reason for your feedback?

Tell us more:

Submit Privacy Policy