The Comtrex PSCloud Interface Service is intended to be installed only by Comtrex installation and support personnel.
-
One service will be installed by this installer:
-
Comtrex supplied "PSCloud Interface Service"
Receives payments from the PaymentSense Cloud and subsequently adds the appropriate media to the target guest check.
Mandatory Installation Prerequisites
- Acquire a server address to the PaymentSense Cloud.
- Acquire an authorization token for the PaymentSense Cloud.
Installation Instructions
Important: Read this section before starting installation.
- These instructions are assuming you are logged on to, and performing this installation from the actual target machine.
- Installation should be on the PC that is hosting the Odyssey databases.
- If "Comtrex INetOrder Service" is already installed and running, stop the service temporarily.
-
If "Comtrex PSCloud Interface Service" is already installed, perform the following steps.
- Administrative Tools > Services > Stop "Comtrex PSCloud Interface Service".
- Control Panel > Add Remove Programs > Remove "Comtrex PSCloud Interface Service".
-
Click on the installation link below to run or download (ftp) the installation program.
- If downloading, download it to any temporary directory on your C: drive.
- If running directly, ignore the security warning.
- If you downloaded "PSCloudInterfaceServiceSetupxxx.msi", execute it to start the installation.
- If "Comtrex INetOrder Service" was stopped, restart it.
Installation Followup
Important: Make sure you complete the following steps right away.
Cautionary Note!
Support personel will take note that this installation could be performed on a (32 bit) or (64 bit) version of Microsoft Windows. Please pay special attention to the instructions below as the correct choice has to be made. If you are unsure, go to "Control Panel > System" and check the system type.
If you do not see a reference to 64 bit, it is probably 32 bit.
-
Update the registry using regedit.exe. Registry entries required are listed below. The entries in yellow are provided by PaymentSense. You will find the registry entries under one of the following registry keys depending on whether your server is (32 bit) or (64 bit).
- (32 bit) [HKEY_LOCAL_MACHINE\SOFTWARE\Comtrex Systems\PSCloudInterfaceService]
-
(64 bit) [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Comtrex Systems\PSCloudInterfaceService]
Value Name | Value Data | Description |
AccessDatabasePath | C:\icom\database | This should not be edited normally. |
ComtrexLogFlag | 7 | This should not be changed without direction from engineering. It will generate the most verbose PSCloudInterfaceService.exe log entries. |
InactivityTimeoutMinutes | 10 | Unlock checks left inadvertently locked. Set to 0 to disable. |
APIVersion | v0 | Preprogrammed in registry. This should rarely, if at all, change. |
Host | ????.connect.paymentsense.cloud | Previously acquired from PaymentSense. Remove any leading "wss://" protocol etc.. |
Token | | Previously acquired from PaymentSense. |
- Go to Administrative Tools --> Services. Find "Comtrex PSCloud Interface Service" and start the service.
-
Check the daily log file to see if any failures. Log file location is listed below. Failures will be obvious. If everything is ok, every minute
the log will show "OnTimer()" and "CRemoteSettle is running"
- That completes the installation.
Installation Reference
-
Files and Folders created, installed or updated by this installation.
-
(32 bit) C:\Program Files\Comtrex Systems\PSCloudInterfaceService
(64 bit) C:\Program Files (x86)\Comtrex Systems\PSCloudInterfaceService
- PSCloudInterfaceService.exe - Windows Service.
- Misc. install/uninstall support files.
-
C:\ProgramData\Comtrex Systems\PSCloudInterfaceService
- LogFiles - Folder with daily log files.
- Reports - Folder with daily EOD report files from PDQs.
- Printing support files.
-
C:\icom\pos2100\support\PSCloudInterfaceService
- PSCloudInterfaceServiceBkup.reg - Registry backup file.
-
Versions included in this installation. "PSCloudInterfaceServiceSetup109.msi"
- Comtrex - PSCloudInterfaceService.exe Version 1.0.0.9
Version History (PSCloudInterfaceService.exe)
-
Version 1.0.0.1 10-31-2018
- New - using websocket json interface.
-
Version 1.0.0.2 1-30-2019
-
On FD_RECV do not do multiple recv() calls.
Multiple recv() web socket messages were being received with recv() loop
and last recv() processing by web socket was overwriting previous
message in send buffer, since actual send() only happened after FD_RECV
loop exited.
-
Updated table list queries to only return checks that are not already locked.
-
Version 1.0.0.3 4-4-2019
-
Version 1.0.0.4 2-5-2020
- Updated to use alternate sql server params.
-
Version 1.0.0.5 11-19-2020
-
Updated lock request response to return an amount value of zero if
unable to lock guest check. Was previously sending uninitialized amount.
PS request through Charlie. PS is also updating their side.
-
Version 1.0.0.6 08-08-2022
-
Added handler to send guest check print data on 'dojo' PDQ when requested by PS.
Interface to POS2100AUX.DLL was added to load and calc check as well as to call PrintCheck.dll.
PrintCheck.dll was also updated to handle 24 character print lines on 'dojo'.
-
Version 1.0.0.7 10-18-2022
-
Added inactivity timer with default 10 minutes to unlock check.
Start returning PING message notification to user from tcpip engine in callback
as a 1 minute timer for the inactivity code. This prevents necessity of critical section.
-
Version 1.0.0.8 03-15-2023
-
Updated to send "server" terminal number in dojo print request. Was using terminal
number from guest check causing printcheck.dll to use incorrect print options.
-
Version 1.0.0.9 03-6-2024
-
Created a backup of the registry settings at startup.
Downloads
Click here to Download.