IP EFTPOS - Configuration Settings

This document describes the settings available for the different EFTPOS services and processes that are used with integrated Point Of Sale applicaitons

Pinpad Client (PXPP.exe)

The configuration file will be in your installation directory and the file is named 'PXPP_CFG.TXT'. It is in XML format and the elements and default settings are displayed below.

< Server >

Setting Description
Address Address to listen for connections from the Active X control. Compulsory setting: 127.0.0.1
Port TCP/IP Port used to listen for connections from the Active X control. Compulsory setting: 3009
ComPort Com/USB Port that the PinPad is connected to. If it cannot find the PinPad on this port it will search the rest of the ports. Default setting: 1
Currency Specifies the currency & symbol in the receipt and Journal View.
PrinterName Windows Printer Device Name that will be used to do the printing. Can also be set in the ActiveX. Not needed if your POS is handling the printing.
EnableExtendedData Default: 1
EnableAlwaysPrint Default: 0
EnableAutoSelectCreditAccount Will automatically select the credit account for refund transactions. Default setting: 0
EnableUseDefaultPrinter Uses the default printer of the Windows Print Queue. Default setting: 0
EnableEmv Enables EMV. Default setting: 0
EnableManualPan Reserved. Default setting: 0
EnableServerTraceAll Enable for tracing of PXPP sending and receive data. Default setting: 0
EnableTerminalTraceAll Enable for tracing of PXPP sending and receive data. Default setting: 0
EnableVendingMode Enable for Kiosk and Vending environments. Uses forced signature so no dialog will display to either accept or decline. Default setting: 0
EnableForceAcceptSignature Force signature so no dialog will display to either accept or decline. Used only in special cases. Default setting: 0
EnableForceOnline Reserved. Default setting: 0
EnableMultiMerchant Enable Multi merchant capability so that you can pick which account you would like to process transactions into. Options are 1-8 in the Account property. Default setting: 0
EnableRefundMerchantCard Enables Refunds on the terminal. Default setting: 1
EnableIgnoreCardReadError Ignore card read errors. Default setting: 1
EnableSelectAccount Reserved for future use. Default setting: 0
EnableDuplicateCashOutReceipt Enable a duplicate receipt to be printed for CashOut type transactions. Default setting: 0
EnableDuplicateReceipt Enable a duplicate receipt to be printed. Default setting: 0
EnablePrintReceiptPause Reserved. Default setting: 0
EnableReceiptFormatLines Reserved. Default setting: 0
EnableAddTipPrompt Reserved. Default setting: 0
EnableDisplayTimer If disabled final dialogs with declined responses will disappear without user interaction so that the POS can interpret the results quicker. Default setting: 1
EnableAutoSelectCreditAccount The flag is used to skip the account selection and use Credit account when the card number and expiry date are supplied by the POS. Default: 1
EnableCheckPrinter The printer checking is controlled by EnablePrinter flag in the registry. The printer is checked for each transaction when EnableCheckPrinter is set to true regardless of the EnablePrinter flag. Default: 0.
EnableAcceptedDisplayTimer If disabled final dialogs with accepted responses will disappear without user interaction so that the POS can interpret the results quicker. Default setting: 0
EnableEOV Reserved. Enables terminal for Electronic Offline Vouchers mode. Default setting: 0
EnableAuth Reserved. Enables Authorisation type transactions which you must be set up at your bank for. Default setting: 0
EnableBalance Reserved. Enables Balance type transactions which you must be set up at your bank for. Default setting: 0
EnableCheque Reserved. Default setting: 0
EnableCreditCardTipping Reserved. Enables Tipping type transactions which you must be set up at your bank for. Default setting: 0
EnableHeartBeat Reserved. Default setting: 0
EnableLocatePinPad This will look at all COM/USB ports to find the pinpad. If this is set to false it will look only at the COM/USB port set in the field . Default setting: 1
EnableNonPaymentCards Reserved. Default setting: 1

< Server >

Setting Description
Port COM/USB Port that the Pinpad is using.
UnitId ID of the Pinpad in the config file. You can have multiple Pinpads connecting to the same service.
Slots Card Reading slots that are available to be used on the Pinpad.

< Host >

Setting Description
Name PX Host
Priority Default setting: 1
Address IP address to connect to that has the PxEftP Service running
Port TCP/IP Port to use to connect to the PxEftP Service. Default setting: 62

PXPP Registry Settings

Several registry settings are read by PXPP. All Subkeys are registered in the path:

KEY_LOCAL_MACHINE\SOFTWARE\DirectPaymentSolutions\PXPP\

Eftpos Communication Server (PxEftP.exe)

The configuration file will be in your installation directory and the file is named 'PXEFTP_CFG.TXT'. It is in XML format and the elements and default settings are displayed below.

< Server >

Setting Description
Name Name of the Communication Server Configuration that is used.
Address Address of the machine PxEftP is listening on for connections from PXPP connections. Default setting:
Port TCP/IP Port of the machine PxEftP is listening on for connections from PXPP Services. Default setting: 62
EnableSSL Communicate using SSL encryption. Default setting: 1
EnableCaidMatch Default setting: 1

< Interface >

Setting Description
Id ID for this Interface connection. You can setup multiple Interface connections with different "Interface Type" for redundancy.
Name Name of this Interface connection
Type Type of connection the Interface uses. Types available are "sync" "x25" "gprs" "schannel". Default setting: schannel
Priority The priority of this specific Interface connection in the list of Interfaces. Default setting: 1 (If only 1 possible connection). The priority level needs to be set to a higher number for the primary connection over the redundant connections.
Enabled Used to turn on this type of interface connection. Default setting: 1
Address Address of the Payment Express Host to connect to. eft6.paymentexpress.com eft7.paymentexpress.com and eft2.paymentexpress.com on port 61 for the primary IP connections and eft3.paymentexpress.com port 61 for any GPRS connections.
Port Port 61 for standard & GPRS connections to DPS. Default setting: 61
EnableSSL Communicate using SSL encryption. Default setting: 1.
EnableHelloTimer Enable HelloTimeout to be specified. Default setting: 0
HelloTimerInterval Timeout period for establishing a connection. Default setting: 10. Note: Shouldn't be set below 5 seconds.

PxEftP Registry Settings

Several registry settings are read by PXPP. All Subkeys are registered in the path:

HKEY_LOCAL_MACHINE\SOFTWARE\DirectPaymentSolutions\PxEftP\

PxEftP Registry Settings

Installing Two Communication Servers for Redundancy

If you would like to install 2 communication servers for redundancy on one machine you can create a 2nd service by doing the following -

- Copy pxeftp.exe and relabel it pxeftp_GPRS.exe for example (pxeftp_[name].exe).

- Copy pxeftp_cfg.txt and relabel it pxeftp_GPRS_cfg.txt (pxeftp_[name]_cfg.txt)and configure it to use the redundant communication device. You will also need to point the original configuration's redundant interface to this service.

Use the following install and service start switches from a command prompt -

pxeftp_GPRS.exe install

net start paymentexpressPxEftpGPRS

or if using a different name -

pxeftp_[name].exe install

net start paymentexpressPxEftp[name]

EFTPOS Tray application (DpsEftTray.exe)

This should be installed in your Eftpos installation directory and is configured with the file "dpsefttray_cfg.txt", which is documented below. This tray process gives access to control panels of the ActiveX, such as Config/Setup and Maintenance and access to the Payment Express EFTPOS client.

The Tray process also monitors folders for *.req files if a merchant is wanting to interact with the EFTPOS system by submitting our file format.

< Monitor >

Setting, Description

InName, Name of the file types to monitor and read. Default: *.req

OutName, Name of the file type to output for the result. Default: %n.evt

Dir, Directory to monitor for the input files and to place the output files. Default: C:\Program Files\DPS\EFTPOS\FileInterface

< HotKeys >

Setting Description
Enabled You can enable hotkeys by setting to true (1) or set to false to disable (0). Default: 1
Action This describes what happens when a hotkey is pressed. Values can be "Client" "Maint" &"Setup" which open up the corresponding applications or dialogs.
Key Key to press in conjunction with the Modifier key to access the HotKey. Usually F1-F12. Default: F9
Modifier Service Key to press in conjunction with the "Key" to access the HotKey. Values can be "Win" "Alt" or "Ctrl" and can have multiple modifiers per HotKey.

XML Listener (PxEftXML.exe)

The configuration file will be in your installation directory and the file is named 'PXEFTXML_CFG.TXT'. It is in XML format and the elements and default settings are displayed below.

< HotKeys >

Setting Description
Port TCP/IP port the XML Listner application should open for connection & communication with your client application. For Flash/AS 2.0 the port will need to be greater than or equal to 1024. Default: 63.
EnableTestMode Set to true (1) to enable test mode which will give a simulated Pinpad environment for testing. Set to false (0) to use a real Pinpad device in a live environment. Default: 0.