Set Up Store Commerce POS for Dynamics 365

Description: The installation file for the Store Commerce (POS) application containing all of the required components of the Shift4 connector is contained within the Shift4 Store Commerce found in the Retail self-service packages. The following steps will guide you through the process of setting up an instance of Store Commerce.

• Prerequisites for Store Commerce App Installation
• Installing the Store Commerce Application & Shift4 Extension
• Activating Store Commerce

---

Prerequisites for Store Commerce App Installation 

1. Before installing the Store Commerce application, the following prerequisites must be met first. 
   • List of Prerequisites 
     • Install Microsoft Edge WebView2
     • Install .Net framework runtime 4.8  
     • Enable TLS 1.2 & Registry Changes
     • Install .Net Hosting Bundle
     • SQL SSEI & SSMS (For Offline Support)
2. Once you’ve completed these prerequisite steps, you can move on to installing the Store Commerce Application & Shift4 Extension.

Installing the Store Commerce Application & Shift4 Extension

1. Download the latest version of the Shift4 Store Commerce (Extension) package from Shift4 and the corresponding Store Commerce (Base) package from Microsoft from your project Asset Library’s Retail self-service package. Use the Retail version to determine which one you need. Select the hyperlinked name to download the package.
   
2. Store these files in a folder of your preference.
   
3. Open a command prompt window and run the following command to install the StoreCommerce.Installer.
   Note: When debugging Store Commerce to get more information about errors, we encourage adding the command –--enablewebviewdevtools to see the errors directly from the Console logs & Network traffic (by pressing F12 like you would on a browser).
   • Command (without offline): .\StoreCommerce.Installer install 
   • Command (with offline support):.\StoreCommerce.Installer.exe install --installoffline --sqlservername {Enter SQL Server Name Here} --trustsqlservercertificate
     
     Important: –trustsqlservercertificate should ONLY be used whenever in a test environment, NEVER in production.
     
     Important: The Base StoreCommerce installer must be installed before the Shift4 extension package.
4. You can also pass other parameters to the above command, as listed here by Microsoft.
5. Once the installer is complete, you may proceed to install the Shift4 Extension package using the following command:
   • Command: .\Shift4.Commerce.StoreCommerce.XXXX install
     
     Important: If you are upgrading your Store Commerce application, you must uninstall the existing version and install the new one. This must be done in sequential order: You MUST uninstall the Shift4 Extension first, then uninstall the Base package by running the .packagename uninstall command. After they are uninstalled, you may proceed to install the Base package first, followed by the Shift4 extension.

Activating Store Commerce

1. Once the installers are complete, you can select the Store Commerce application to launch it.
   
2. The application will launch on the Activate Store Commerce Screen. Select Next.
   
3. You’ll be asked to enter your Store Commerce URL. You can get this from the Commerce Engine URL from LCS by performing the following steps:
   
   1. Navigate to your Environment.
   2. Select on Manage under Commerce.
   3. Select on Commerce Engine URL.
   4. Copy the URL.
4. Come back to the Store Commerce application, paste your Commerce Engine URL, and append /commerce at the end of the URL, then select Next.
   
   Note: Your URL should look like this: https://{YourCSU}-rs.su.retail.dynamics.com/commerce.
5. If asked to log in, do so using the Azure credentials associated with this POS setup. Once logged in, you’ll be taken to the following screen, select Next.
   
6. When you’re finished logging in, choose the Store name using the location that you set up the Hardware profile to, then select Next.
   
   
7. Select the desired Register, then select Activate.
   
8. This will complete the process of setting up Store Commerce. At this point, you may log in using the Worker ID and password created in the Back Office.
   
9. Once you select Sign in, you will be prompted with the following screen; make sure you select Perform a non-drawer operation.
   
   Note: If a session was already running in the past, you must terminate it by selecting Close shift, then log back in and select Perform a non-drawer operation.
    
10. Upon logging into the POS, select the option to Select hardware station.
    
11. Upon doing so, a prompt will appear to manage the Hardware station. From here, select Manage.
    
12. Switch the Hardware station to On and then select OK at the bottom of the page.
    
13. This will bring you back to the previous prompt, and the Hardware profile you configured in the Back Office for this store/register will be displayed here. From here, you may select Close, and the employee can begin/unsuspend their shift by logging in again.
    
14. This completes the installation and configuration of the Store Commerce application.