Setting Up Customer-Facing bLoyal POS Snippet™️ for Korona

This article describes the steps required to configure your Korona account to be able to use the bLoyal Customer-Facing POS Snippet™️ on your Korona POS system(s). We recommend your Korona partners performing the below configuration in conjunction with assistance from your bLoyal project manager or bLoyal Support.

Prerequisites: You will need to be running the Korona-recommended Java version. As of June 2023, this is the Azul 17 JDK FX, (please check with the Korona Support Team for the latest guidance). Below is the link where you can find this Java version. However, you should contact Korona for assistance in getting this installed.

https://www.azul.com/downloads/?version=java-17-lts&os=windows&architecture=x86-64-bit&package=jdk-fx#zulu

1) Set up the new bLoyal Customer-Facing POS Snippet external system calls.

• Head to the external system calls page:

     1.1) Add a new external system call for launching the bLoyal Customer-Facing POS Snippet™️:

• Name: Launch bLoyal Customer-Facing Snippet
• Customer Display URL: Use the following structure for the URL:

https://{POSSnippetsUrl}/POS/CustomerFacing/Korona/{ClientAccessKey}-{LoginDomain}

• Contact your bLoyal project manager or our support team for assistance to obtain the following:
  • POS Snippets URL for your account.
  • Client Access Key which can be generated by our Support Team for you.
  • Login Domain is the same you use to log in to your Director Account (Company field).

All of these combined will provide the Customer Display URL. Usually, we will directly provide this final URL to the Korona team to save you trouble. Below is an example of a properly formatted end result URL. This particular URL is non-working and  is provided just as an example:

 https://POSSnippets2.bLoyal.io/POS/CustomerFacing/Korona/28343432b58923901c39f638f4da9c35fd8dcadef24f7fc2e8e23668682fffcc9b23ea5556deff89ea0845cb-MyCompany

     1.2) Add another system call for clearing the bLoyal Customer-Facing POS Snippet™️:

• Name: Clear bLoyal Customer-Facing Snippet
• Customer Display URL: Use the following structure for the URL: https://bloyal.com

2) Add the new Customer Facing external system call to the POS profile.

2.1) Go to the Settings => POS Profiles page:

2.2) Select your POS Profile. Scroll down to the External System Calls and add the new bLoyal External calls in the specific order shown below. They may be reordered automatically upon save, but don't worry as long as the bLoyal Approve action is prior to the bLoyal Commit, it should be all good:

3) Go to Settings => Customer Displays and apply the following settings, as desired.

Suggested to be configured as shown below:

• Feel free to tweak the font settings as desired.
   

4) Go to Sales => Points of Sale and select the appropriate Customer Display for your POS register.

• For the more recent Linux-based Korona POS: Display 2 should be selected as there is normally a dedicated second monitor for the customer display.
• For Windows-based Korona systems: Display 1 should be typically selected.

If you have any questions, please contact our Support Team for assistance.