After completing the installation process, review the following configuration details to complete the setup for using TriPOS with the Element Payment Service.
The system stores the TriPOS configuration details in an XML file named TriPOS.config in the TriPOS/conf directory. After configuring TriPOS, this file needs no further modification. However, before using the TriPOS application, some configuration items need to be set to their proper values.
The following XML data elements are grouped in various sections:
Note: All elements are alphanumeric unless otherwise indicated. Bold text indicates a value that must be changed during installation.
The TriPOS.config file can be edited using any text editor. Notepad++ is a good option.
ServerPort (Integer): TCP port used by TriPOS to accept requests from the client application. Any non-assigned TCP port value can be used. By default, Eclipse is configured to communicate with TriPOS on port 8080. This is the port on the PC, not the Eclipse server.
Port conflicts on the PC are unlikely, but an override port option in Eclipse is available by setting a value in the Element TriPOS Application Port (Chip & PIN) control maintenance record. The value in the TriPOS.config file should be set to 8080, or match what is specified in this control maintenance record.
ArchivePath: Directory path where archived receipts are stored. Defaults to the TriPOS/archive directory, if omitted from the config file.
TORRetryDelay (Integer): Delay in seconds before a failed TOR is retried. Defaults to 30 seconds if omitted from the config file.
Url: URL of the Express platform. The defaults is https://certtransaction.elementexpress.com. However, when moving to live processing, the URL must be modified to https://transaction.elementexpress.com.
MerchantID: Host merchant identifier (number), provided by Element Payment Services.
TerminalID: Host terminal identifier (number), provided by Element Payment Services. This number is unique to each PC or device.
Name: Merchant name as it appears on receipts.
AddressLine1: Merchant first address line as it appears on receipts.
AddressLine2: Merchant second address line as it appears on receipts.
Phone: Merchant phone as it appears on receipts.
Language: ISO 639-1 language code for merchant receipts (“en” for English, “fr” for French).
CurrencyCode: Merchant’s default ISO 3166-1 currency code (e.g. “124” for CAD).
MerchantCategoryCode: Visa/MasterCard Merchant category code.
TerminalCategoryCode: Terminal category code (e.g. “R” for retail).
ComPort: Name of the communications port on which the PINpad is connected. For example, COM4 for Windows machines and /dev/ttyS4 or /dev/ttyUSB4 for Unix machines.
BaudRate (Integer): Communication speed for the port (defaults to 9600).
DataBits (Integer): Number of data bits for the port (7 for even parity, 8 for no parity - default).
FlowControl: By default, TriPOS implements the RTS/CTS flow control to communicate with the serial PINpad device. This is optional. You can also use XONXOFF for configuration item or Xon/Xoff for flow control. Use NONE for no flow control support.
IsAttended: “true” if terminal is attended (default), “false” otherwise
IsCashbackAllowed (Boolean): Defaults to false. Set to true if cash back is allowed, or leave as false. If true, TriPOS offers the cardholder to enter a cash back amount on the PINpad during debit transactions.
Note: This feature is not currently supported by Eclipse. Leave it as false.
SurchargeAmount (Double): Optional fee added to debit transactions, such as 0.25.
Note: This feature is not currently supported by Eclipse. Leave it as 0.00.
After updating the TriPOS.config file, restart the TriPOS service, if it has already been started, to apply your new configuration settings.
Also note that the TriPOS application updates the TriPOS.config file, inserting some encrypted information, so when you edit the file in the future (not common), parsing the XML to modify the values may be different than when you first updated the configuration file.
See Also: