Skip to content
background-image background-image

Terminal protocol REVO Refund Connector

[ | version 3.1]

Connector

The connector is forbidden for use by the platform background agent.

Connector processing type: Row by row!

The connector that helps connect external cash register systems (ECR) and a payment terminal when processing refunds from a merchant's account to a cardholder's account. The connector can convert requests from cash register systems entered in a user-friendly format (e.g., CZK 100) into a format the payment terminal understands. Subsequently, it can transform the transaction processing results returned by the terminal into a format comprehensible to the POS system.

Transfer of an amount from the account of the merchant to the cardholder’s account. This transaction is very risky for fraud, so please handle it carefully.


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 REVO Settings

ECR confirmation

All supplementary confirmations (such as signature verification and printing of copies) are handled by the ECR (Electronic Cash Register) system. This includes verifying whether the signature matches and printing a copy of the receipt for the customer.

Confirm signature match

If an additional confirmation is performed by the ECR, automatically verify whether the signature matches (true or false).

If an additional confirmation is conducted by the ECR, print a copy of the receipt for the customer.


Input & Output Schema

Input

POS REVO Refund Input Schema (ver. 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
Currency String Yes Currency of a transaction. It is important for transaction receipt, but currency has no impact on the Totals where in FID L is clear total of all transaction amounts. If this field is not included in the message, the terminal will use its default currency. Format: numeric Length: fix 3 Example of supported codes: 203 = CZK, 978 = EUR, 840 = USD, 826 = GBP
IpAddress String Yes Destination IP address of terminal
IpPort Integer Yes Destination port of terminal

Output

POS REVO Refund Output Schema (ver. 1.0.0)

Column Data type Allow null Description
TerminalId String Yes Terminal logical identifier on which the transaction will be made.
TransactionTimestamp Datetime No Expiration date of a payment card in the month and year form. Format: yyyy. MM. dd HH: mm: ss
IsTransactionApproved Bool No Flag identifies that the transaction has been approved.
TransactionId String Yes Numeric unique identifier of the financial transaction.
AuthorizationCode String Yes Authorization Code. 0-8 characters.
ResponseCode String Yes This field informs about processing results (of transaction or message). Defined codes are in the chapter Transaction result codes.
Message String Yes Terminal text message or error message. 0-64 characters.
CardBrand String Yes Brand name of the card used in the transaction.
Transaction result codes

Codes of accepted transactions

Code Description
0 Transaction accepted
1 Transaction refused
2 No connection
7 Transaction interrupted by the user
9 Card is blacklisted

Release notes

3.1.0

  • Extended input schema for IpAddress and IpPort

3.0.0

  • First release