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 |
|
The terminal has some administration/maintenance functions. These can only be invoked from a dedicated EFT Maintenance menu button.
EFTLink uses DeviceProxy messages to display input prompts on the POS to manage these functions.
Table 10-2 Transax - Administration Functions
Function | Description |
---|---|
Reprint last receipts |
Prints the last receipt. |
Reconciliation with Closure (EFT EOD) |
Print a day report and close the current day. |
Test PED (Display results) |
Check connectivity to the PED and prints the result on screen. |
Test PED (Print results) |
Check connectivity to the PED and prints the result to the receipt printer. |
Test connection to Authorization Host |
Check connectivity with the Authorization Host. |
Test printer |
Check connectivity with the printer. |
Query reconciliation figures (Display results) |
Shows the reconciliation figures on screen. |
Query reconciliation figures (Print results) |
Sends the reconciliation figures to a printer. |
Below is a list of supported functionalities of the interface to Transax.
Table 10-3 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. |