This document describes the settings available for the different EFTPOS services and processes that are used with integrated Point Of Sale applicaitons
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.
| 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 |
| EnableNonPaymentCards | Reserved. Default setting: 1 |
| 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. |
| 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 |
Several registry settings are read by PXPP. All Subkeys are registered in the path:
KEY_LOCAL_MACHINE\SOFTWARE\DirectPaymentSolutions\PXPP\
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.
| 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 |
| 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. |
Several registry settings are read by PXPP. All Subkeys are registered in the path:
HKEY_LOCAL_MACHINE\SOFTWARE\DirectPaymentSolutions\PxEftP\
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]
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.
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
| 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. |
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.
| 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. |
