Unity can be tested by accessing Swagger which is built into each instance of Unity. If you are able to access the Swagger page, it means that the Unity site is available but it doesn’t mean that Unity can communicate to the back-end POS. You have to login to authenticate into Unity and then manually run one of the API calls to verify communication to the back-end POS system.
Each customer typically has 2 instances of Unity and most are named, UnityTest and UnityProd however some customers have slightly different names (i.e. UnityPeakProd). The URL’s to access Unity/Swagger are located in LastPass under each customer’s account typically in a note that is labeled, ‘Unity’. For example, Copper’s is in the LP note, ‘Copper - Unity’. The username and password to login to Unity (also known as the ClientID and ClientSecret) are also in Last Pass under the note labeled, ‘Copper - Unity3.0 Client ID’. Below are instructions on how to login and test an API call.
Instructions
Using Aspenware QA in this example
Go to, https://unity.aspenwarecommerce.net/UnityQA/index.html
Change the ‘V1’ dropdown at the top to 'V3'
In LastPass, get ClientID and Secret from the note, ‘Aspenware - Unity3.0 ClientID’
In Swagger, click green ‘Authorize’ button on the right
Enter ClientID and Secret ClientSecret and check all the ‘access control service’ (first in the list) and ‘services’ (last in the list) Scopes and click Authorize at the bottom of the list.
If the credentials are valid, you should see this success message:
If you receive an ‘invalid scope’ error, typically uncheck the itinerary service , entitlements and retail services (service.itinerary). This scope can only be checked in our internal environments and also Boyne, service.entitlements, service.retail).
Test an API call to verify data is returned from the POS. For RTP, an easy one is the Access call (/api/Access/locations)
Click, ‘Get’ and then ‘Try it out’
Then click 'Execute
If you see POS data returned (like the access location list below), that means Unity can communicate to RTP
Another API call that can be used for RTP and SW is the User authenticate
Enter the credentials you use on the site. Replace ‘string’ in both places below w/ your actual username and password.
If the results show the RTP or SW customer ID number (RTP IPCode or SW guest_no), that means Unity can communicate to the POS system. If this works but you can’t login from the site, it’s typically an issue in Nop.
Related articles
| Filter by label (Content by label) | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
| hidden | true |
|---|
...
...