Go to primary content
Oracle® Retail EFTLink Core Configuration Guide
Release 18.0.1
F20716-02
  Go To Table Of Contents
Contents

Previous
Previous
 
Next
Next
 

10 TransaxEFT

This chapter describes the procedures to set up EFTLink to interface with FIS TransaxEFT.

EFTLink General

This document assumes static EFTLink configuration. When deploying with a POS that supports dynamic configuration, all property settings referred to below should be set on the POS, and not directly into local property files. It should be read in conjunction with the Oracle Retail EFTLink Framework Installation and Configuration Guide.

Minimum Version

The Transax interface requires a minimum EFTLink version of 1.1.125.

System Architecture

EFTLink connects to FIS TransaxEFT software running on the same PC as the POS via TCP/IP sockets as an OPI client.


Note:

This document does not cover installation of FIS TransaxEFT software.

Fileset

In addition to standard EFTLink files, TransaxEFT uses:

  • cores/TransaxEFT/transaxeftcore.jar – executable code for the TransaxEFT core.

  • TransaxEFT.properties – configuration settings to specify which features are enabled and to define communication parameters for the interface with the EFT payment system.

Language

The translation files for this core should not require alteration, but if necessary then this can accomplished by amending the relevant Lang<CC>_<Core>.properties within the base eftlink folder.

The language used will follow the language set in the EFTLink framework; see the Oracle Retail EFTLink Framework Installation and Configuration Guide, EFTLink General Information, Translation section.

EftlinkConfig.properties

DisplayLanguage = EN

Supported country codes are: CN, DE, EN, ES, FR, IT, JP, NL, PT, RU and SV.

Core Classname

The following should have been set in the EftlinkConfig.properties file by installcore.bat or installcore.sh.

EPSCore0 = manito.eft.transaxeft.TransaxEFTOPIClient

Configuration Settings

Settings are defined in TransaxEFT.properties.

Key Settings

These are no settings that must be set differently per POS.

Secondary Settings

These settings should not need adjustment, but are defined here.

Table 10-1 TransaxEFT - Secondary Settings

Setting Description Default Example

TransaxEFTChannel0

The TCP port on which the Core sends requests and device responses to TransaxEFT.

8900

TransaxEFTChannel0 = 8900

TransaxEFTChannel1

The TCP port on which the Core listens for responses and device requests from TransaxEFT.

9900

TransaxEFTChannel1 = 9900

ReceiptFormatFile

Name and path of the receipt XSLT translation file used to format the receipt text.

transaxeft\\AccreditationReceipt.xsl

ReceiptFormatFile = transaxeft\\AccreditationReceipt.xsl

BalanceEnquiryFormatFile

Name and path of the card balance enquiry XSLT translation file.

transaxeft\\Balance.xsl

BalanceEnquiryFormatFile = transaxeft\\Balance.xsl

ReconciliationFormatFile

Name and path of the reconciliation report XSLT translation file.

transaxeft\\Reconciliation.xsl

ReconciliationFormatFile = transaxeft\\Reconciliation.xsl

ReceiptTextPassThroughEnabled

Only enable when TransaxEFT provides pre-formatted plain text receipt lines rather than name/value pairs.

false

ReceiptTextPassThroughEnabled = false

TransaxEFTResponseTimeout

Extend the period we will wait for a CardServiceResponse message after sending our request.

120

TransaxEFTResponseTimeout = 120

TransaxEFTOperatorRecoverySupported

Do not allow the operator to specify the success or failure of a transaction.

false

TransaxEFTOperatorRecoverySupported = false

MaintenanceTimeout

Specifies the maximum number of seconds to wait for the operator to select an administration menu option. If no option is selected the maintenance function is completed and control passes back to the POS.

60

MaintenanceTimeout = 60

MaintMenuOptReceiptReprintEnabled

Enable/disable the maintenance menu option TXT_REPRINT. Set to false if, besides the maintenance menu, the POS has its own means of requesting a ticket reprint. Set to true for Power POS.

true

MaintMenuOptReceiptReprintEnabled = false

MaintMenuOptEODEnabled

Enable/disable the TXT_RECONCILIATION_WITH_CLOSURE menu option. Set to false if the POS has its own means of requesting reconciliation with closure.

true

MaintMenuOptEODEnabled = true

MaintMenuOptPEDTestEnabled

Enable/disable the menu option TXT_PED_TEST. Set to false for Power POS as it cannot display multiple lines of text received in cashier display and cashier input device requests.

false

MaintMenuOptPEDTestEnabled = false

MaintMenuOptPEDTestPrintedEnabled

Enable/disable the menu option TXT_PED_TEST_PRINTER_OUTPUT. Set to true for Power POS.

true

MaintMenuOptPEDTestPrintedEnabled = true

MaintMenuOptEODQueryEnabled

Enable/disable the menu option TXT_QUERY_LAST_RECONCILIATION. Set to false for Power POS as it cannot display multiple lines of text received in cashier display and cashier input device requests.

false

MaintMenuOptEODQueryEnabled = false

MaintMenuOptEODQueryPrintedEnabled

Enable/disable the menu option TXT_QUERY_LAST_RECONCILIATION_PRINTER_OUTPUT.

true

MaintMenuOptEODQueryPrintedEnabled = true


Fixed Settings

There are a small number of settings included in TransaxEFT.properties that should not be changed. All settings not documented here fall into that category.

Supported Functions

Below is a list of supported functionalities of the interface to Transax.

Table 10-2 Transax - Supported Functions

Function Description

Payment

EFTLink sends payment requests to Transax. Transax will return a response message with formatted receipt strings for customer and/or merchant receipts.

If successful, appropriate receipts will be printed at the end of transaction.

Refund

EFTLink sends refund requests to Transax. This will refund a transaction with specified amount.

Reconciliation / Settlement

Prints a settlement report at day end.

Receipt Reprint

Reprint merchant/customer receipt.

Loyalty Balance Enquiry

Check the balance of a loyalty card.


Maintenance Options

The Transax interface has some administration/maintenance operations. These are normally invoked from a dedicated EFT Maintenance button at the POS, though the content of the display screen then presented to the operator is controlled by MaintMenu options enabled above.

  • Reprint last receipts

  • Reconciliation with Closure (EFT EOD)

  • Test PED (Display results)

  • Test PED (Print results)

  • Test connection to Authorisation Host

  • Test printer

  • Query reconciliation figures (Display results)

  • Query reconciliation figures (Print results)