This service is responsible for acquiring and maintaining authorization tokens. An authorization token is required by the POS2100.EXE to initiate a credit card payment request to the Poynt cloud. The database table "PoyntDefinitions" has a field "AppId" that is encrypted along with other data and sent via TCP/IP to the Poynt cloud to acquire an authorization token and a refresh token. The acquired tokens are stored in "PoyntDefinitions". The tokens are currently valid for 24 hours and if not refreshed prior to 24 hours, will expire. Poynt sets the tokens' expiration time. Two hours (120 minutes) prior to the tokens expiring, this service will use the refresh token to 'refresh' the authorization and refresh tokens for a subsequest 24 hours. This process continues as long as this service is running.

The encryption mentioned above is performed using a private key that is embedded in this service. The private key is tied to the AppID. Currently we have only one Android app, consequently only one private key. The Android app is the ComtrexRDP app running on the Poynt terminal that initiates the rdp session that POS2100.EXE runs in.

If we create more Android apps, we will have to make code changes in this service to accommodate. There currently is no plan to have additional Android apps.

1. This service is intended to be installed only by Comtrex installation and support personnel.
2. Acquire pre initialized Poynt terminal(s).
3. Acquire ApplicationID, BusinessID, StoreID, URL and one terminal DeviceID for each Poynt terminal.
4. Program these parameters into the database (PoyntDefinitions) with programming.exe.

1. These instructions are assuming you are logged on to, and performing this installation from the actual target machine.
2. Installation should be on the PC that is hosting the Odyssey databases.
3. If "Comtrex Poynt Auth Service" is already installed, perform the following steps.
   • Administrative Tools > Services > Stop "Comtrex Poynt Auth Service".
   • Control Panel > Add Remove Programs > Remove "Comtrex Poynt Auth Service".
4. 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.
5. If you downloaded "PoyntAuthServiceSetupxxx.msi", execute it to start the installation.

1. There are no registry settings.
2. Configuration file settings. Config. file location is listed below. These settings should never need updating.
    
   

   Value Name	Value Data	Description
   PEMFileName		This is FQPN of Private/Public key file. This is currently not used.
   PreExpirationRefreshMinutes	120	This should not be changed without direction from engineering. This is the time prior to the authorization token expiring that the service will attempt to update the authorization token.

3. Go to Administrative Tools --> Services. Find "Comtrex Poynt Auth Service" and start the service.
4. Wait a few seconds, then check the daily log file to see if any failures. Log file location is listed below.
5. That completes the installation.

1. Files and Folders created, installed or updated by this installation.
   • (32 bit) C:\Program Files\Comtrex Systems\PoyntAuthService
     (64 bit) C:\Program Files (x86)\Comtrex Systems\PoyntAuthService
     • PoyntAuthService.exe - Windows Service.
     • PoyntAuthService.exe.config - Configuration file.
   • C:\ProgramData\Comtrex Systems\PoyntAuthService
     • LogFiles - Folder with daily log files.

Click here to Run or Download. (Version 1.0.0.3 - Released 2-6-2020)