The KVMS is the backend driven by reader data, with all data originating from the card readers on vending machines. Proper configuration of these readers is essential to ensure normal operation.
To set up a card reader, you should log in to KioCentral to create the CCM profile, which requires configuring both site data and machine data.
Note: After the parameters under Site Data + Machine Data are configured, don’t forget to save the profile with the following steps otherwise the configurations will be lost.
Site Data Configuration
1. Input the URL of KioCentral, enter your Email & Password and click “Sign in” on the landing page as shown below to log in to the retail server system.
Find CCM on the navigation menu and click “Profile Builder” under CCM.
Click “Site Data” then all fields to configure will be displayed. Please define the fields one by one and you can refer to table below for descriptions of the fields.
Field Name | Value Needed | Description |
Location ID | Alpha-Numeric | To select a certain location that is created in Locations > Create Location. You can enter keyword of the location name to narrow down the display list. |
Room# | Numeric | To enter the room number that is created in Locations-View Location-Rooms. |
Double Tap Timeout | Numeric | This value is set for the laundry cards that require double taps to make transactions when starting a machine. If the time interval between the two taps exceeds the value defined here, the transaction will be terminated. The default value 0 means double tap is not required to start a machine. |
Site Code | Numeric | When a certain location is selected, the corresponding Site Code will be automatically matched. |
Machine # | Numeric | Keep the default settings here. When the reader profile is set up in KLM, the Machine# will be filled out. |
Screen Rotation | Dropdown Choice (0/90/180/270 degrees) | This field applies to Ultra LX Series only. When the Ultra LX Series reader is installed in a rotated position other than the default upright one, this parameter should be defined accordingly so the screen display is readable to users. |
Ignore Site Code | Check Box | It decides whether to verify the site code of the cloud-based card/value card used by customers. If it is checked, then the cards mentioned can be used across different sites under the same Vendor. If it is not checked, the site code of the card has to be consistent with that of the reader equipped for the machine. |
Non-Network Mode | Check Box | This field applies to Prime Connect Select and Elevate Card Connect reader. When it is checked, WiFi based functions will be disabled so the reader won’t upload any report. |
Card Holder Mode | Check Box | This field applies to Prime Connect Select and Elevate Card Connect reader of laundry market only. When it is checked, unlike the single-tap or double-tap cards, customers need to hold the laundry card to the reader until the machine is started. |
Hide Machine # | Check Box | This field applies to Elevate Card Connect readers. When it is checked, the reader will not display Label ID. |
Payment Options | Check Box | Select the payment options to be supported. |
CR/DR Card Type | Check Box | Select the card icons to be displayed on readers. This field is required when “Credit Card/Debit Card” is selected as the “Payment Options”. |
Converter Reader Type | Dropdown Choice | This field is required only when Converter reader is used. Select from the dropdown list (Disable/ ESD reader / Heartland reader / Greenwald reader / Blackboard) |
Machine Data Configuration
Click the tab KioSoft-> MDB -> Vending in sequence then all parameters relating to MDB Vending machines will be displayed. Define the parameters as needed and you can refer to table below for descriptions of the fields required.
Field Name | Value Needed | Description |
Reporting | ||
Upload Reports | Dropdown choice (Enabled / Disabled) | This parameter is used to control if the terminal should upload report to the server. If Disabled is selected, the terminal won’t upload reports to database and vice versa. The default value is Enabled. |
KSD Report | Dropdown choice (Enabled / Disabled) | Currently despite of the settings here, reader will upload transaction data to the VMS platform that stores the KSD data. KSD data will be created for 2 scenarios: 1) for transactions paid with card/app on the reader, both successful and failed good dispensing will create KSD data; 2) for cash payment, only successful good dispensing will create KSD data. |
Machine Type | Dropdown choice | Please keep the default setting. |
Level 1 Press “O” to Start | Dropdown choice (Enabled / Disabled) | This feature applies to vending machines of MDB level 1 only. When it’s enabled, users need to firstly press the O button on Ultra VQ-M as indicated on its screen in order to start the machine. If it’s disabled, no such step is required. It’s enabled by default. |
Vendor Logo | Uploaded image | The vendor logo image that will be displayed on the top bar of the reader’s idle screen. Image standard 23x110 px (no greater than 34x160); Image Format: .png; Image Orientation: Horizontal Image. |
Customer Logo | Uploaded image | The customer logo image will be displayed on the middle screen of the reader’s idle screen. Image standard: 320*207; Format: .png. |
Reader Display | ||
Background Theme | Dropdown choice (Light / Dark) | The background theme for the reader. |
Idle Screen Line 1 | Text | The 1st line of the text will be displayed on the idle screen of the reader. Text can’t exceed 18 characters. |
Idle Screen Line 2 | Text | The 2nd line of the text will be displayed on the idle screen of the reader. Text can’t exceed 18 characters. |
Idle Screen Line 3 | Text | The 3rd line of the text will be displayed on the idle screen of the reader. Text can’t exceed 18 characters. |
Completion Line 1 | Text | The 1st line of the text is displayed when the ordered item is dispensed. Text can’t exceed 18 characters. |
Completion Line 2 | Text | The 2nd line of the text displayed when the ordered item is dispensed. Text can’t exceed 18 characters. |