Page Comparison

...

1. Has the scanner been working or has it never worked?

   1. If it has been working, has anything in the environment changed, or are you currently having any network issues?

   2. Has there been an RTP upgrade recently? RTP 2022.2 introduced a change to the stored procedure, proc_publicGetPrepaidAccessProfileWithHistory that required a change in Unity. Customers running RTP 2022.2 or greater will need to upgrade Unity to v3.27.

   3. If it has never worked, all settings on the scanner need to be checked (refer to documentation).

2. What is the Unity URL being used by the scanner? The Unity URL can be found by scanning a barcode of the word, ‘SETTINGS’ on the Login page of the app (or ‘settings’ can be typed in). This will then show a page where the WebServiceURL, ClientID and ClientSecret are entered. Once the URL is known, check the log file on the server which is typically located in C:\inetpub\wwwroot\UnityProd\Logs (or whatever the application directory is named, (UnityProd, UnityProdScanning, etc).

3. Can the Unity URL be entered into a browser on the device to show the API page or does an error page show? If an error page shows, it’s likely the Unity URL cannot be reached on the wireless network the device is connected to. This is likely a network issue that the customer needs to look into.

   1. The format of the URL in SETTINGS should look like this WITH the trailing slash: https://unity.aspenwarecommerce.net/UnityQA/

   2. To test entering the URL into a browser on the device, it must be entered like this: https://unity.aspenwarecommerce.net/UnityQA/index.html

   3. If the URL shows the API page (not an error page), enter the ClientID and Client Secret to make sure they are valid. Click the ‘Authorize’ button:

      

      1. Then enter the ClientID and ClientSecret being used

         

      2. Then check the following scopes (the checkboxes)

         1. service.access / access control service (usually the first one in the list)

         2. services / services (usually the last one in the list)

      3. Then click ‘Authorize’. If the credentials worked, you should see this message. If you don’t, it’s possible the wrong ClientID and ClientSecret were entered.

         

   4. Then to verify Unity can communicate to the RTP db, try the ‘get access locations' api call

      1. Change dropdown in upper right corner from V1 to V3

         

      2. Click the entry, GET - /api/Access/locations

      3. Click ‘Try it out’ and then the blue Execute button

         
   5. 

      If Unity can communicate to the RTP db, you should see a list of RTP Access Locations returned. This is one of the calls the scanner makes so if this works, the communication to RTP is working.

      

   6. If you see anything other than a list of Access Locations returned, it’s possible Unity can’t communicate to RTP.

   7. If the above is working as expected but the scanners are still experiencing issues, emulate a scan in Swagger using the /api/access/process call. Click ‘Try it out’ and replace the default JSON with the example below.

...