This chapter describes the procedures to set up EFTLink to interface with FIS TransaxEFT.
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.
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. |
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.
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.
The following should have been set in the EftlinkConfig.properties
file by installcore.bat
or installcore.sh
.
EPSCore0 = manito.eft.transaxeft.TransaxEFTOPIClient
Settings are defined in TransaxEFT.properties.
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 |
|
TransaxEFTChannel1 |
The TCP port on which the Core listens for responses and device requests from TransaxEFT. |
9900 |
|
ReceiptFormatFile |
Name and path of the receipt XSLT translation file used to format the receipt text. |
transaxeft\\AccreditationReceipt.xsl |
|
BalanceEnquiryFormatFile |
Name and path of the card balance enquiry XSLT translation file. |
transaxeft\\Balance.xsl |
|
ReconciliationFormatFile |
Name and path of the reconciliation report XSLT translation file. |
transaxeft\\Reconciliation.xsl |
|
ReceiptTextPassThroughEnabled |
Only enable when TransaxEFT provides pre-formatted plain text receipt lines rather than name/value pairs. |
false |
|
TransaxEFTResponseTimeout |
Extend the period we will wait for a CardServiceResponse message after sending our request. |
120 |
|
TransaxEFTOperatorRecoverySupported |
Do not allow the operator to specify the success or failure of a transaction. |
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 |
|
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 |
|
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 |
|
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 |
|
MaintMenuOptPEDTestPrintedEnabled |
Enable/disable the menu option TXT_PED_TEST_PRINTER_OUTPUT. Set to true for Power POS. |
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 |
|
MaintMenuOptEODQueryPrintedEnabled |
Enable/disable the menu option TXT_QUERY_LAST_RECONCILIATION_PRINTER_OUTPUT. |
true |
|
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. |
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)