Static & Dynamic QR Sound BOX Product Solution
Static & Dynamic QR Sound BOX Product Solution
V1.0
Table of Contents
Chapture 1 Summary ...........................................................................................................................................1
Chapture 2 Business Architecture Diagram ..........................................................................................................2
2.1 IoT cloud platform+SoundBox business process diagram ............................................................................... 2
2.1.1 Process description .......................................................................................................................................................... 2
2.2 QR code business process diagram .................................................................................................................. 3
2.2.1 Static QR code flowchart .................................................................................................................................................. 3
2.2.1.1 Process description .............................................................................................................................................. 3
2.2.2 Dynamic QR code flowchart .............................................................................................................................................4
2.2.2.1 Process description .............................................................................................................................................. 4
Chapture 1 Summary
With the popularization and convenience of mobile payments, more and more businesses are starting to use
QR code payments. In order to provide a better payment experience, payment SoundBox have emerged.
The payment SoundBox is a device that integrates payment QR code, audio playback, and voice prompt
functions. It connects to the IoT platform through 4G/WiFi, making it convenient for merchants to receive
consumer payments and listen to voice broadcast prompts.
Feitian has a variety of SoundBox products that support dynamic and static payment code display, and
support multiple customized language audio broadcast. Combined with Feitian self-developed IoT cloud message
push platform, it realizes a complete solution for message push broadcasting from the platform to terminal
devices.
The Feitian IoT cloud platform has functions such as message push, device management, application
integration, merchant management, OTA upgrade, voice template management and audit logs. The Feitian IoT
cloud platform supports three deployment and delivery modes: 1. It can seamlessly support the deployment of
international mainstream cloud services such as AWS, Microsoft Azure, and Alibaba Cloud; 2. It supports the
installation and deployment of local Linux/Windows server environment for customers; 3. Feitian independently
develops an IoT cloud platform all-in-one server, which is pre-installed with a complete set of Feitian IoT platform
software products. Customers can purchase and use it immediately, without the hassle of installation and
debugging.
This document combines the Feitian IoT cloud platform and payment SoundBox to introduce product
business processes, customer integration interconnection solutions, IoT cloud platform deployment solutions,
product usage, etc., facilitating rapid deploy and use SoundBoxs.
The SoundBox is distributed to the final merchant for use, and the merchant also has a payment QR code.
1. The SoundBox is linked to the merchant's payment code, and the Feitian IoT management platform
provides binding devices’ support.
3. After the user completes the payment, the acquiring system or payment center sends a broadcast request
of the payment result to the Feitian IoT cloud platform.
4. The Feitian IoT cloud platform finds the corresponding SoundBox and timely pushes messages based on
the device number of the sending SoundBox.
5. The SoundBox make voice broadcasting after receiving successful payment messages.
1、 The consumer scans the payment QR code on the static SoundBox code plate;
2、 The consumer enters the payment amount and the payment is successful;
3、 After the acquiring system or payment center completes the payment, it notifies the Feitian IoT platform
of the transaction results;
4、 The Feitian IoT platform pushes broadcast information to the static static SoundBox bound to the
acquiring merchant;
The process includes two parts: displaying the payment QR code and scanning the code for payment:
Display of payment QR code
3、 Feitian IoT platform obtain the payment QR code request information of the corresponding merchant for
the device;
5、 The acquiring system or payment center returns the payment QR code information after processing the
request;
6、 The acquiring system or payment center returns the payment QR code information;
7、 The Feitian IoT platform returns the payment QR code information to the dynamic SoundBox;
4、 Notify the Feitian IoT platform of the transaction results after completing the transaction by the
acquiring system or payment center;
5、 The Feitian IoT platform pushes broadcast information to the dynamic SoundBox bound to the receiving
merchant;
6、 The dynamic SoundBox of the receiving merchant makes the voice broadcast.
The Feitian IoT cloud platform adopts a distributed micro-service architecture design, which has the
characteristics of high throughput, high concurrency, low latency and high availability:
High throughput, capable of carrying a large number of intelligent terminal devices for long-term connection
use simultaneously.
High concurrency, capable of processing tens of thousands of message push broadcast request tasks in
parallel.
Low latency, it only takes an average of 0.6 seconds to push broadcast messages from the cloud platform to
terminal devices for broadcasting.
High availability, distributed cluster deployment architecture to ensure important services not interrupted
and broadcast message data not lost.
1、 Message service: receive transaction broadcast notification messages from the acquiring bank system or
payment center.
3、 Message data service: store SoundBox broadcast data and provide query functions.
4、 Management platform: centralized management of the terminal devices, message push queries, voice
template configuration, OTA upgrade and other management functions.
MQTT (Message Queuing Telemetry Transport) is a lightweight communication protocol based on the
publish/subscribe mode, which built on the TCP/IP protocol and released by IBM in 1999.
The MQTT protocol is lightweight, simple, open, and easy to implement. These characteristics makes it
widely applicable. In many cases, including limited environments, such as machine to machine (M2M)
communication and IoT. It has been widely used in Satellite link communication sensor, occasional dial-up
medical devices, smart home and some miniaturized devices.
As an IoT product, SoundBoxs utilize the reliable and compact characteristics of the MQTT
communication protocol, making them very suitable for scenarios such as GPRS with low traffic overhead and
low network signal requirements. They can stably and reliably deliver messages in a timely manner.
The Feitian IoT management platform with management functions such as centralized management of
terminal devices, message push queries, voice template configuration and OTA upgrade etc. It supports the
settings of terminal device features, which makes it convenient for customers to customize their devices and
product experience more user-friendly.
The "Organization Management" function supports adding multi-level organizational structures. Each level of
organizational structure can add administrators, import terminal devices, achieve hierarchical management,
maintenance, log auditing, and customize broadcast voice templates for terminal devices.
The Feitian IoT management platform supports uploading multiple sets of audio templates in different
languages simultaneously, such as English, Spanish and Urdu etc. Terminal devices can download audios in
different languages for corresponding voice broadcast.
This feature can meet the demand of customers for both official language and local language for broadcasting
in their respective regions.
The voice announcements for device startup and shutdown can be set uniformly, such as: Welcome, thank
you for your patronage. Personalized broadcast can also be set separately for each device.
The platform's advantages and capabilities are the value-added services of Feitian IoT cloud platform, which
can be purchased according to the business needs.
The Feitian IoT monitoring platform is one of the important service components of the Feitian IoT cloud
platform. The IoT monitoring platform uses data burying technology to add buried point monitoring in the core
message push service and business code fragments. The IoT monitoring platform collects data values reported by
each buried point and can respond to various abnormal states in real time according to preset monitoring
strategies, including email, SMS, direct dial call, etc, Initiate platform emergency alarms through these
communication methods and notify management and operation personnel.
If the concurrency of the message server reaches over 50% of the preset threshold, there will be Email & SMS
alarms. If over 70%, SMS & direct dial phone alarms.
The Feitian IoT monitoring platform has found that key indicators such as CPU, memory, disk space, and
maximum server connections have exceeded the normal load capacity of the server based on the alarm strategy
and the alarm level. It will schedule the function that triggers the elastic expansion of the server. The entire
expansion process doesn’t need manual involvement. The Feitian IoT automated operation platform will create
new server instances, start service programs, perform self-checks on service programs, and conduct service
program self-test and business function integrity self-test. After verification is completed and passed, business
services will be provided to the external parties to alleviate the pressure on other server resources in the cluster.
The Feitian IoT cloud platform is delivered in the form of the software installation packages, without any
source code.
The Feitian IoT cloud platform can be installed and deployed on cloud servers such as AWS, Microsoft Azure,
Alibaba Cloud, etc. Customers purchase the required cloud servers, traffic, etc. Feitian only provides software
installation packages, remote installation deployment and guidance (negotiable).
The Feitian IoT cloud platform can also be installed and deployed in privatized environment such as
customers’ local computer machine rooms, data centers and servers. Customers need to provide remote access
accounts and permissions such as VPN for remote installation, deployment and guidance (negotiable).
Feitian provides an IoT cloud platform all-in-one server, pre-installed with a complete set of Feitian IoT
platform software products. Customers can use it by Initial configuration on startup after purchase, eliminating
the installation and commissioning work.
Taking Alibaba Cloud certain node in China as an example, the following configuration can meet the usage of
10000 real-time online devices. If the online volume of terminal devices continues to grow, it is necessary to
consider server resource expansion.
Alibaba Cloud has nodes worldwide, and the actual expenses are based on the local purchase price.
2. Message service
4. Management Platform
The following are server specifications and configurations that support load balancing for the private
deployment of Feitian IoT cloud platform. This configuration can meet the needs of 10000 real-time online devices.
If the online volume of terminal devices continues to grow, it is necessary to consider server capacity expansion.
CentOS server 4C/8G/200G disk 2 units Used to deploy the following services
and make them highly available:
1. Push service
2. Message service
4. Management Platform
CentOS server 4C/8G/4T disks 1 unit Deploy MySQL database and Redis
The Feitian IoT cloud platform all-in-one server adopts a 2U rack server, pre-installed with CentOS, Ubuntu
and other operating systems, a complete set of Feitian IoT cloud platform software products, with a 5-inch touch
screen, supports one click initialization configuration for the first startup, is simple and easy to operate, and can be
used immediately at startup, eliminating the hassle of installation and debugging.
1. The panel is designed with independent structure, and the logo on the panel can be customized according
to the customers’ needs.
3. Support the insertion of encryption cards for storing core keys, saving the cost of purchasing additional
encryption machines.
4. We can flexibly match CPU, memory, disk, gigabit optical ports, etc. according to the customers’
requirements and expected online amounts of the terminal devices, to reduce customers’ purchase costs.
5. The Feitian IoT cloud platform all-in-one server supports zero trust port hiding protection technology.
Terminal devices need to establish a secure connection with the IoT platform through single "knock" technology.
The zero trust "port hiding, single packet knocking" technology effectively protect IoT platforms from being
attacked.
Suggest purchasing 3 Feitian IoT platform all-in-one servers according to the "4.2.2 Resource Allocation
List", which can quickly complete the deployment & implementation of the Feitian IoT platform.
The IoT platform provides an HTTPS POST interface. The message encoding format is UTF-8, and
the message body parameters and return results are in JSON format.
Note: You need to obtain Appkey and Appsecret before using the API. Appkey is the Customer ID. AppSecret
is used to sign transmitted packets when data is transmitted.
The first step is to sort the non-empty parameters on each interface according to the ascii
code of the parameter name from smallest to largest, and use URL key-value pairs to concatenate
them into a string to be signed, that is:
appkey:9A0A8659F005D6984697E2CA0A9CF3B7,
timestamp:20181221162001,
nonce :dpRxkhjbauiclpKoqt
Data to be signed A=
appkey=9A0A8659F005D6984697E2CA0A9CF3B7&nonce=dpRxkhjbauiclpKoqt×tamp=20181
221162001
Step 2: apisecret is used as the signature key to sign A and get the signature result B:
B=HmacSHA256(A, appsecret);
Step 3: Add B to the parameter list to get the final data sent as follows:
appkey:9A0A8659F005D6984697E2CA0A9CF3B7,
timestamp:20181221162001,
nonce:dpRxkhjbauiclpKoqt,
sign:base64(B)
Request parameters:
Response result:
can call this interface and we will maintain this binding relationship. In this way, the merchant
number can be used to push the message.
Request parameters:
Response result:
6.1 Introduction
The Feitian IoT management platform mainly includes nine functional modules: “Application management,
Organizational structure management, Administrator, Device management, Template management, Message
management, Upgrade management, Configuration management, and Log management”. The platform adopts
the currently popular adaptive and configurable web structure, supporting various mainstream browsers such as
Chrome, IE11+, Firefox, etc.
6.1.1 Login
Enter the administrator email and password to log in to the platform. If you forget your login password, you
can click the “Forget password” button to proceed.
After the user successfully login, they can view data such as "Device total number", "Messages total number",
"Total amount of broadcast", "Trend chart of payment amount in the past week", "Trend chart of message
broadcast in the past week", and "Trend of device increment in the past month" on the homepage.
This module is mainly used by super administrators for development or system adjustment. This module
mainly includes two functional menus: application list and adding applications.
The application list mainly displays the relevant information of various application systems connected to the
platform in the form of a list, which can be modified, deleted, and locked for each application
system.
When adding an application, enter the application name and then click “save”. The system will automatically
generate the application ID, application security key, and message service address, which can be viewed in the
application list. These data can be used as interface parameters for platform docking. Following the interface
instructions provided by Feitian.
Note: For the operation method, please refer to the description in the “Iot Platform API interface”.
To facilitate hierarchical management of devices, multi-level organizational structures can be added. And set
up different administrators for different branch offices.
Right click on the corresponding organizational structure to perform corresponding operations, including:
view organizational detail, add sub-organization, delete organization, set the switch template, delete organization,
add administrators etc.
6.1.5 Administrators
Manage and maintain administrators under the enterprise. Administrators can add subordinate
administrators in this module and set permissions for them to ensure that newly added administrators can log in
to the management platform and manage their specific data.
The list displays administrator information on separate pages, and can search for eligible administrator data
based on information such as "Email" and "Phone". Simultaneously supports modifying and deleting administrator
information. If you need to add an administrator, you can click on the “add administrator” button.
When adding an administrator, fill in the required information such as Email, Name, Password, Phoner, etc.
Note that menu permissions need to be set at the bottom. Turn on the switch to allow the administrator to view
and manage the data of the module, otherwise turn off it.
This module is mainly used to view and manage all device information within the enterprise, including
“Device number, Use status, Product type, Running status, Offline duration, Version number, etc.
Use status : check whether the device has interacted with the platform, including used and unused;
The platform allows customers to add customized templates, and devices can download this template to
achieve customized broadcasting. This module can manage users' customized templates. Including the following
functions:
Custom message template: used for broadcasting payment and other types of messages;
Switch template: used to customize the voice broadcast when the device is turned on or off.
Click “Add template” button, select the “type, name, and voice content” of the template to be added. The
audio file can be generated online or upload with your own recorded file.
List displays device broadcast message, including “message serial number, device code, response time,
broadcast result, broadcast content”, etc. Click on the “Message serial number” to display the detailed
information of the record in a pop-up window. You can search for match data based on "Device ID", "Message
serial number", "Push time", "Application" and "Broadcast result". Meanwhile, it supports batch export for easy
statistical analysis.
This page displays a list of firmware on separate pages and can be queried and filtered by product model; The
information displayed in the list includes “firmware name, version number, product type, file name, file size, audio
type and upgrade method”.
The firmware upgrade method refers to the type of upgrade package downloaded during firmware upgrade:
Full upgrade - requires downloading the complete firmware package for full package replacement; Differential
upgrade - requires differential packaging for the current version and template version, extracting only the
modified parts. This can greatly reduce the size of the upgrade package.
Click on “Add firmware” button, enter related firmware information, upload the corresponding file, and then
add the firmware.
If the firmware upgrade method is differential upgrade, click the “upload” button after the firmware list
to upload the corresponding differential package.
This module can add upgrade tasks to devices. The information displayed on the list page includes “Task ID,
Task name, Product type, Target version, Upgrade scope, Status, Create time and Execute time”.
Upgrade tasks can be set to be executed at a specified time, and can be set to individual device or batch
devices. When executed, if the device is online, an upgrade message will be immediately pushed to the device,
which will trigger automatic download updates. If the current device is offline, it will be pushed after the next
After adding the task, click on the “thunder” icon to publish the task. When publishing a task, you need to
select the execution time for the upgrade task. The prompt box will display the detailed information about the
current task. After confirm the information, click “OK” to publish.
Login session validity period: set for administrators who log out of the session without operating for a
long time;
Limit on the retry number of consecutive failed logins : Set up account lockout for administrators who
Auto lock time: Set for the time when the administrator will automatically unlock after automatic lock.
Log management mainly manages the logs of administrators on the platform, including "their login, logout,
device management, application management, and the time& results of the related operations". It is displayed in
a paginated list format and can be searched by "Admin name, Results, Time interval", etc.
6.2.1 Login
Open the browser to visit https://iotdemo.cloudentify.com, supporting various mainstream browsers such as
Chrome, Microsoft Edge, IE11+, Firefox.
Enter the following “Username and Password” info to log in to the platform:
Username: [email protected]
Password: demo1234
Click the "Message Mgmt" menu and select "Broadcast record" to see all broadcast message. Enter a device
serial number in the “Device code” text box and click “Search” button to quickly find the broadcast message of a
device.
In the Device list, select “Add device” or “Import device” to add a new device or import devices in batches.
The following picture shows “device import” function. Please download the “Device excel import template” first.
And then add “Device code &Device secret” info into the table.
After completing filling the template information, choose to upload the template file, and then select model
“M20” , enter the “Organization” info, such as “FEITIAN Technologies”, finally click “OK” button to finish
import