Kiwire 2.0 Documentation

  1. Home
  2. Docs
  3. Kiwire 2.0 Documentation
  4. Configurations
  5. Settings



The Setting module provide the general configuration of the Kiwire platform. This defines the overall behavior of Kiwire functionality. This includes General Setting, Voucher Setting, Campaign Setting, SMTP Setting and Timezone Setting for Kiwire platform. To access the setting module click on Configurations > Settings from the navigation.

Settings > General

The General tab manage the overall Kiwire configuration.

The field and its function description is listed below.

Password SecurityLow : Allow user to use any form of password without check password secure level.High : Enforce user to secure password composition, which is made up of a minimum of 8 alphanumeric, containing at least 1 alphabet and 1 numeric character.* NOTE : Password security will also affect SMS OTP code generated, if set to HIGH the sms otp code generated will be alpha numeric , if set to low it will be only numeric code.
Password Display FormatClear Text : If set to text, administrator will be able to view the user’s password in the user account view page.
Hidden : set to encrypted if you do not wish administrator to be able view the user’s password in the page.
Default CurrencyDefault currency used for the system and display in financial reporting.
Volume Reporting MetricReporting metric for user bandwidth & volume usage either in Mb or GB format. To make it human readable.NOTE : Applicable to Report->Login only, bandwidth report are default in GB format due to high volume reporting.
Database ArchiveHow many days before trigger archive the transaction function.
Login Page ID: displayText that will be used to represent USER ID, example for hotel installation you may want to use “Room No” as username display or “Student ID” in education environment.
Voucher Page ID: displayText that will be used to represent Voucher ID during login and report display.
Join Insight NetworkEnable or disable join insight network. Insight Network is Kiwire network that provide you access to industry key reporting and other advance analytic reporting. By joining insight network, you will have the ability to access insight reporting that compare your overall performance metric with industry peer and region.
Default LanguageDefault Language setting for Kiwire.
Forgot Password MethodThe delivery mechanism of forgot password function, by Email or by SMS. Please configure either transport setting.
Forgot Password TemplateTemplate to use when forgot password function is triggered; please use template editor to create the templates.
NPS EnableEnable/Disable Network Policy Server (NPS).
NPS Email TemplateEmail template for the Network Policy Server (NPS).
Ask User for Web PushEnable / Disable the Web Push Notifications.* NOTE: Only work if the connection is HTTPS and end-user is using Android or Windows (Chrome or Firefox)
Use IP Address to Define TenantEnable / Disable the Use IP Address to Define Tenant.

Settings > Voucher

Voucher can be use for one time only. Account that uses voucher is valid until the expiry due date or credit minutes is exhausted. Voucher setting provide general configuration for the voucher behavior, the field and its function description is listed below.

The field and its function description is listed below.

Default PrefixDefault prefix for voucher to be generated,
e.g. : sync will be sync123456
Voucher Engine The format of voucher account generatedNumber in sequence
voucher generated will be serial sequence
e.g.: sync10001, sync10002 …. sync10099.Unique ID
Voucher generated will be unique but near random,
e.g. : SYNC5401AAE , SYNC5402FA1 , SYNC54032A4Random Engine
A random string of character, use together with random engine length limit.
e.g. : xasd4as2 , gfga23asd, dfasd21asd* NOTE : A longer length will prevent repeat of random character. 
Voucher TemplateTemplate for the voucher, use Template editor at configuration -> template to create the template for the voucher, you can personalize the look and feel of the voucher created.
Prevent Ambiguous CharacterEnable this to disable ambiguous character such as o , 0 ( zero ) , I and 1 ( one ) which create doubt on generated voucher.
Random Engine Length LimitDefault length for Random engine to use when generate prepaid account if Voucher engine selected is random. A short length will have repeat and thus limited max no quantity of prepaid account to be created, e.g. if limited to 4, the max voucher supported in the system will be 9999 voucher.
Default Suspension PasswordDefault suspended user password, that will be used to replace a user account  if a voucher is being suspended

Setting > Campaign

Kiwire has a built in smart campaign built, use the configuration tab to set the overall behaviour of Kiwire campaign modules.

The field and its function description is listed below.

Pre-login Waiting TimeThe waiting duration required for users to view running campaign or advertisement before accessing main login page.
Multiple AdsAllows multiple campaign to run at same time or single campaign only.
Autoplay VideoEnable or disable the Autoplay video.* NOTE : Only ads that does not contain sound will able to be auto play by mobile devices.
Enable PersonaEnable / Disable Persona.
Enable OverlayEnable / Disable Overlay.
Super CookiesEnable / Disable Super Cookies.

Settings > SMTP

Kiwire uses email to send marketing, notification and other function thus Kiwire will require an mail server connection to send outgoing emails, SMTP setting will let you configure your organisation mail server configuration.

* NOTE : Please remember to ensure your SMTP allow connection from Kiwire server IP address.

The field and its function description is listed below.

SMTP HostYour SMTP / Mail server hostname or IP Address.
SMTP PortSMTP Port for the SMTP / Mail server.
SMTP AuthenticationDoes your SMTP require authentication to send mail , if yes please select SSL or TLS.
SMTP Auth UsernameUsername for SMTP authentication.
SMTP Auth PasswordPassword for SMTP authentication.
Email From AddressThe email address that email generated will use as sender.
Sender NameThe name of the sender who sends the email.
CCWrite the email address if you are sending a copy for their information.

Important Readme

* NOTE : Any services related to mail services will need to use different ports from 587,465 and 25 due to Google Cloud blocking those ports.

Refer to this link:

Alternative workaround suggestion:
To use mail services on Kiwire Cloud, users can opt to use API connection with third-party services such as Mailgun. Its free for 5000 outgoing mail per month, but will have additional charges if its more than 5000 outgoing mail in a month.

Find out more about Mailgun here : Mailgun

Test SMTP configuration

You can use the Test SMTP function to test if Kiwire is able to connect to your SMTP server , To test the smtp config is working properly save your SMTP configuration first then follow by clicking the  “Test SMTP” button. you will be required to key in your email address to receive a test mail. Check your Inbox for email from Kiwire to ensure you successfully received the test mail.
In event of SMTP connection failure an error will be displayed.

Example configuration for GMAIL 

For gmail SMTP the following setting is being used.

  • Use Authentication: Yes : TLS
  • SMTP PORT : 587
  • SMTP Auth username :
  • SMTP Auth Password : yourpassword
  • Email from address :
* NOTE : For gmail, please set “Allow less secure apps: ON” under the gmail account.

Setting > Time Zone

The time zone setting screen let you set time zone configuration for the Kiwire platform.

  • Time Zone : Select the time zone for the Kiwire platform.
Was this article helpful to you? Yes No

How can we help?