User Guide for MULTI VEND

Prev Next

Release Date

Market

Country

Payment Gateways

Ultra Transaction Type

Payment Types

Ultra Work Mode

Minimum Terminal

Version Requirement

04/21/2026

Integration (Vending)

USA

Canada Europe

TSYS

Everlink/Moneris

AIB

Single Auth

Pre-Auth

Credit/Debit Card

Cloud Cards/Transact Card KioSoft Mobile APP

Retail

UltraVQM/VQFM_GLOBAL_V2500.003.004.007

The Multi-Vend (shopping cart) feature is supported when the TCN vending machine is equipped with Ultra VQ-FM/VQ-M. With this feature, end users can select multiple products from the machine and complete the payment for all selected items in a single transaction. This document provides step-by-step instructions to activate this feature.

For now, the vending machines supporting Multi-Vend are TSD60, TSD54E and TSD48.

Reader Set Up

Software info:  

VQ_PRO_PATCH_5.1.0.36 reference number: 82708

VQ_GLOBAL_V2500.003.004.007 reference number: 85981

Country: USA/Canada/Europe

  1. General Steps for Creating a CCM Profile

Use your account information to log in to the KioCentral. Create Location, Room, Branch, and Staff information for the terminal.

1. The location information is required when you create the profile in CCM.

2. For transactions on vending machine by using Transact Card, you should click on the “Campus Solution” tab and select “Transact” in Supported Campus Solution. The related parameters should be configured as required and based on the actual needs. For detailed instructions on the fields’ configuration of Transact Card, please refer to the section of Campus Solution (Transact) in the user guide Vendor Portal - Location Management - Locations.

  1. Create Site Data + Machine Data profile

Click CCM to enter the Profile Builder.

Typically, there are two types of profiles:

  • Site Data + Machine Data + Ultra Data: compatible with a specific machine model.

  • Universal: universally applicable to a wide range of machines (not applicable for Multi-Vend feature).

As the Multi-Vend feature is only applicable to KioSoft MDB vending machine. You should configure the profile as the “Site Data + Machine Data + Ultra Data.”

  • Site Data

Site data includes location and room information, display customization, and payment type configurations, etc.

  • Machine Data

Please select Machine Data → KioSoft → MDB → Vending, shown below, because the Multi-Vend feature is only supported by this specific machine model.

  • Save the Profile

After completing all the configurations of the terminal, click the drop-down menu in the top right corner and select “Save Profile.”

The main body of the profile name is generated automatically, marking the information like profile type and generating time, etc. Input the customized part of the profile name and descriptions if necessary.

Note: This custom profile name will facilitate quick location of the profile when using KLM to inject it into the reader.

Click “Save,” and then the profile is created successfully.

Create Ultra Data

For Ultra Series Terminals, if you created the Site + Machine Data profile, you should also create the Ultra Data profile.

Navigate to CCM → (CleanReader) Ultra Data, then click “Add” to open the configuration page.

  • For Ultra Transaction Type, it’s suggested to select Single Authorization.

  • For Ultra Work Mode, it’s suggested to select Retail.

  • For the payment gateway, select the payment processor based on the country. Multi-Vend applies to TSYS/Everlink/Moneris/AIB users.

You can refer to the enclosed table for detailed instructions on filling out the form.

Instructions on Ultra Data Configuration

Field Name

Value Needed

Description

Location Code

Numeric

This parameter is assigned to you when you create a location and should be the same as the Location ID set previously.

Room#

Numeric

It is the Room # when you create the room, and should be the same as the room number set previously.

Work Mode

Fixed Value

This parameter is determined by the “Ultra Work Mode” field. It is displayed the same as the selection of the “Ultra Work Mode”.

Custom text

Alpha-Numeric

This field is designated for identifying profiles specifically and should include details such as location name, room number, etc.

Server Address

Alpha-Numeric

The URL of the Server.

Terminal ID

Numeric

For vendors using the AIB Payment Gateway only.

The POS ID for the transaction.

Payment Gateway

Drop-down Choice

The supported payment gateway is applied in the target market(s) and countries.

Note: Multi-Vend applies to TSYS/Everlink/Moneris/AIB users.

Ultra Transaction Type

Drop-down list

Single Authorization: A separate fee is deducted for each transaction.

Note: It’s suggested to select “Single Authorization” as the Ultra Transaction Type.

HCS POS

Numeric

The POS ID for the transaction. Will not display for vendors using the AIB Payment Gateway.

HCS Auth Code

Alpha-Numeric

The Auth Code for POS ID. Will not display for vendors using the AIB Payment Gateway.

HCS Auth Factor

Numeric

The Zip Code of the vendor. Will not display for vendors using the AIB Payment Gateway.

Pre-Authorization Amount

Numeric

The amount of the Pre-Authorization type of transaction. Will not display for vendors using the AIB Payment Gateway.

Reboot Time

Drop-down choice

Choose a time for the daily reboot of readers.

Server Upload Port

Numeric

The port of the Report Server.

Server Upload Time

Drop-down choice

The settlement time of the reader.

Ultra Work Mode

Drop-down choice

(Master, Backup, Normal, Retail)

Normally, when you have multiple machines in a room to share one POS ID for bank card transactions, you need to define one machine as the Master machine to own the POS ID, and other machines will go through this one for bank communication. For security purposes, one Backup machine shall also be configured just in case the Master machine goes down. And all other remaining machines can be defined as Normal machines.

If only one machine uses the POS ID for bank card transactions in this room, you can define it as Retail mode.

Note: It’s suggested to select “Retail”.

Ultra Coin Support

Drop-down choice (ON / OFF)

If the reader supports payment by coin, choose ON. If not, choose OFF.

Ultra Coin Timeout

Numeric

This parameter means the valid time after inserting a coin, from 1 to 9. The unit is minutes.

Ultra Offline Mode

Drop-down choice (ON / OFF)

If you choose ON, the reader will still work after it is offline. When the reader is reconnected to the network, it will upload the offline transaction data.

Offline Washer Use

Numeric

The maximum number of times a card can be used on the washer in offline mode is from 0 to 9.

Offline Dryer Use

Numeric

The maximum number of times a card can be used on the dryer in offline mode is from 0 to 9.

Max Card Use Offline

Numeric

The maximum number of times a card can be used in this room is from 0 to 9.

WIFI SSID

Alpha-Numeric

The WIFI SSID of the router. It must be totally the same as the WLAN WIFI SSID in the router’s setup.

Label ID

Numeric

Should be the same as the Label ID while doing the KLM setup.

Install Reader

After setting up the CCM profile, you can follow the steps to install the reader on the vending machine.

1) Find the installation position.

2) Remove the cover plate.

3) Prepare the mounting plate.

4) Install the mounting plate with M4*12 nuts.

5) Insert the reader into the opening from outside.

6) Fasten four screws to secure the installation.

7) Plug one male end of the MDB cable to the reader and another end to the machine.

Transaction Report

  1. View Transaction Report in VMS

In VMS → Reports → Online Reporting → Sales Details/Card Report, you can filter the date, machine name, machine number, reader SN, etc., to check the details of each transaction.

  1. View  Transaction Report in KioCentral

You can also view the transaction details in KioCentrol → Reports → Pay at Machine.  

Configuration on PayRange Vending Machine

For now, the vending machines supporting Multi-Vend are TSD60, TSD54E and TSD48.

Upgrade Machine Firmware Version

Follow the steps to download the file and update the firmware version for each machine type.

PayRange Vending Machine TSD60 and TSD48

  1. Update the Android System

KIOVEND_SD_05_V03.02.20251222.01
57.99 MB
  1. Update the MDB Board

ys_updata_drive_5inch_TCN201024_0100_CSC52023081629TCN_MDB4V3PO_V34P08
412.98 KB

PayRange Vending Machine TSD54E

  1. Update the Device Driver

YS-DRIVES-LIFT-V1.0.0.1-20250917.01
13.08 MB
  1. Update the Android System

KIOVEND_LIFT_05_V03.02.20260324.01
58.05 MB
  1. Update the MDB Board

ys_updata_drive_5inch_TCN201024_0100_CSC52023081629TCN_MDB4V3PO_V34P08
412.98 KB

For upgrade procedures, please refer to the video: How to upgrade vending machine VMC & android APP.mp4

Enable Multi-Vend Option

On the vending machine tablet, follow the steps to enable Multi-Vend.

  1. Enter the back-end of the vending machine tablet. In Payment setting → Common payment methods, enable cash payment.

  1. In Other payment methods, enable PAX card payment.

  1. Navigate to Product management→Set purchasing, and enable Shopping cart.

  1. Navigate to System Settings → Android system → Quick Setup Guide. Then choose "8-New Foreign Trade UI" as the UI type.

    Click the button to save the settings and reboot. The change will take effect upon restart.