3.1  Server Creation

Prev Next

3There are 2 vendor portals to support the coffee kiosk with Ultra payment

  • Coffee vendor portal: for managing coffee kiosk and viewing orders

  • Washboard portal: for managing the Ultra payment reader and viewing card payment transactions

The customer needs to prepare information for KioSoft tech team to build above 2 server portals

  • Mutual information between 2 vendor portals

  • Ultra payment reader portal  (washboard) special

  • Coffee vendor portal special

Here are the specifications of all info to create 2 severs

Mutual Info of 2 Servers

The info in blue are the info to be collected from the customer

*Company Name

*Address Line 1

 Address Line 2

*Country/Region

 Province/State

*City

*Timezone

*Postal/Zip Code

*Contact Name

 Contact Phone Number

*Contact Email Address

*Billing Email Address

 Privileges:

Empty

Installation: It is used to limit distributor. Whether you select “Installation” for a vendor or not, it has no influence to the vendor’s functions.

Billing: If vendors have the billing privilege, the “Monthly Fee” field of Location will be displayed. Staff belonging to these vendors with the billing privilege will need to bind the credit card to pay for the billing fee during their login.

For coffee vendor:

If payment reader portal => Billing

If coffee vendor portal => Empty

 Assign Distributor:  

If payment reader portal => KioSoft Express

If coffee vendor portal => Empty / Specified distributor belonged

*Vendor URL

If payment reader portal, the URL should be https://www.xxxx.kiosoft.com

If coffee vendor  portal, the URL should be https://www.xxxx.kiocafe.com:29000

*Alphabetical Prefix

Random English letters used to define SRC code (SRC: Smart Registration Code, used for identifying a location ). SRCs can only be 7 characters long and must contain 1 numeric digit.

For example: in SRC range LOCA000-LOCA255, the alphabetical prefix is LOCA

*Numeric Start

Random numbers used to define SRC code. The SRC code is consist of alphabetical prefix, numeric start and end which should be limited to 7 characters in total. For example: LOCA

*Numeric End

Random numbers used to define SRC code. The SRC code is consist of alphabetical prefix, numeric start and end which should be limited to 7 characters in total. For example:  255


Customize the vendor name which will be synchronically uploaded to DMS system.

DMS means “KioSoft Deployment Management System”. DMS is a service platform where users (KioSoft employee) can manage and generate various types of licenses and cards for the vendors.  

Name assigned to DMS must match DMS exactly

It can be the same “company name“.

RCP Port: 5000 by default

RCP means “Remote Card Programmer“. It is used to connect with Cloud Configuration Manager (CCM) to make, read and refill cards. KioSoft will allocate an RCP Port to each vendor.

It can leave 5000 by default.

*Role Group

If payment reader portal => Default Integration Role Group

If coffee vendor portal => Coffee Vendor


The role group options are created previously. Select one or more role group(s) for the vendor.

*Currency Symbol

Like $, SAR…etc

*Thousand Separator

“.“ / “,“

For example:  Using “.” will show values as 1.000.000;  while using “,” will show values as 1,000,000

*Decimal Point Display: Enabled/Disabled

Enabled: Display decimal points for the amounts in the reports.

Disabled: Not display decimal points for the amounts in the reports.

For coffee vendor, pls set it as ‘Enabled‘

 PowerBI Link

Tab (select the PowerBI report name)

PowerBI Link (attach the PowerBI report link developed)

Ultra Payment Reader Portal (Washboard) Creation Special

*Market => Integration

*Role Group => Default Integration Role Group

*LCMS License File

This is an edit field after company creation, coz it needs to send vendor ID to KioSoft Support team to generate the LCMS file in DMS and updated in the company detail in the KioCentral platform.

 VCG License File

This is an edit field after company creation, coz it needs KioSoft Support team to generate the VCG file in DMS and updated in the company detail in the KioCentral platform.

 Multiplier of Amount Display

When this value is set, the amounts displayed on Value Card Usage and Coin Collection page will be expanded by this multiplier. The maximum account balance, maximum refill amount and refill amount options will also be expanded by this multiplier. Only numbers are allowed and the max length is 10 digits.

For coffee vendor, pls set it as 1

 KioCentral Pro Access: Enabled/Disabled

Enabled: Users can directly access the KioCentral Pro platform through the navigation menu at the retail server’s side.

Disabled: Opposite

For coffee vendor, pls set it as ‘Disabled‘

Cash To App: Enabled/Disabled

Enabled: the cash recharge functionality will be supported on the LAVA PAY app.

Disabled: Opposite

For coffee vendor, pls set it as ‘Disabled‘

Show on Map: Enabled/Disabled

Enabled: the location will be shown on the LAVAPAY app for users to select.

Disabled: Opposite

For coffee vendor, pls set it as ‘Disabled‘

 Divisor of Amount Display

$ (NA) => set as 100

("cent" as smallest unit to save in database  => UI shows database value/divisor of amount display).

SAR (Saudi Arabia) => set as100  

("halala" as smallest unit to save in database  => UI shows database value/divisor of amount display).

The decimal point should still have a maximum of two digits.

For example: 3.45$ in UI, 345 cents in database, the divisor of amount display=100

 Mobile App Type: Default App by KioSoft / Custom App

  1. If ‘Default App by KioSoft’ => Nothing to fill in afterwards

  2. If the customer needs to have a custom app (in dependent apps to be downloaded from App Store / Google Play store), then the below info needs to be specified

  • App Name

  • Android Download Link

  • iOS Download Link

    For coffee vendor, pls set it as ‘Default App by KioSoft‘

Privilege => Billing

Coffee Vendor Portal Creation Special

*Market => Coffee

*Role Group  => Coffee Vendor

 Privilege => Empty