Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects...

58
Sunmi Partner platform User manual Shanghai Sunmi Technology Co., Ltd All rights reserved

Transcript of Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects...

Page 1: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner platform

User manual

Shanghai Sunmi Technology Co., Ltd

All rights reserved

Page 2: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Doc ver. 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

i

Getting Started

This manual for partners to introduce account registration, machine

debugging, Application publishing, Machine customization, machine

management and other related guidance of sunmi partner platform.

Shanghai Sunmi Technology Co., Ltd

Address: Songhu Road #388, 7 KIC, Room 605, Shanghai, China

Website: http://www.sunmi.com

Customer Service: 0086-400-902-1168

Page 3: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User manual Contents

Doc ver. 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

ii

Contents

1 Account Registration ................................................................................................................ 4

How to register to be a partner ................................................................................................................................. 4

2 Partner Roles................................................................................................................................ 7

3 Machine Debugging .................................................................................................................. 8

3.1 Debugger Access Control ..................................................................................................................................... 8

3.2 How to debug the device ..................................................................................................................................... 8

4 Application Deployment ....................................................................................................... 10

4.1 Application instaionlation method................................................................................................................... 10

4.2 Application deployment ...................................................................................................................................... 10

4.2.1 Gray Release (Deploy application to specified device)............................................................................. 13

4.2.2 Application deployment FAQ .......................................................................................................................... 14

4.3 Application Update deployment ...................................................................................................................... 14

4.3.1 Gray Upgrade (Deploy application to specified device) .......................................................................... 16

5 Manage your App Store ........................................................................................................ 20

5.1 Build your owen App Store ................................................................................................................................ 20

5.2 Auto install App ..................................................................................................................................................... 21

5.3 App Auto Startup .................................................................................................................................................. 21

5.4 App Protection ....................................................................................................................................................... 23

6 Machine customization .......................................................................................................... 24

6.1 Boot Animation customization.......................................................................................................................... 24

6.2 Launcher customization ...................................................................................................................................... 26

6.3 Wallpaper customization .................................................................................................................................... 27

6.4 Banner customization .......................................................................................................................................... 28

Page 4: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User manual Contents

Doc ver. 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

iii

6.5 iBeacon settings .................................................................................................................................................... 29

7 Machine Managment .............................................................................................................. 30

7.1 My Data Manager ................................................................................................................................................. 30

7.2 Active equipment .................................................................................................................................................. 30

7.3 Machine Position ................................................................................................................................................... 31

7.4 Machine Lifecycle .................................................................................................................................................. 32

7.5 Machine Application ............................................................................................................................................ 32

7.5 Machine Infomation ............................................................................................................................................. 33

8 Remote Assistance ................................................................................................................... 34

8.1 Remote Managment ............................................................................................................................................ 34

8.2 Remote Control ..................................................................................................................................................... 36

8.3 Remote Record ...................................................................................................................................................... 40

8.4 Machine Map ......................................................................................................................................................... 41

9 Operator Management .......................................................................................................... 42

9.1 User Role ................................................................................................................................................................. 42

9.2 Adding Operator ................................................................................................................................................... 42

9.3 Deleting Operator ................................................................................................................................................. 45

9.4 Transfer the administrator permission ............................................................................................................ 45

10 Subordinate Management .................................................................................................. 46

10.1 Control Subordinate .......................................................................................................................................... 47

10.2 Cooperation Subordinate ................................................................................................................................. 48

10.3 Sub account role conversion ........................................................................................................................... 51

10.4 Bingding device to subordinate ..................................................................................................................... 52

11 Common Settings .................................................................................................................. 53

12 Others ......................................................................................................................................... 55

12.1 My Message ......................................................................................................................................................... 55

12.2 My Order ............................................................................................................................................................... 55

12.3 Card Reader Settings (For T1) ......................................................................................................................... 56

12.4 My Account .......................................................................................................................................................... 56

Page 5: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 1 Account Registration

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

4

1 Account Registration

How to register to be a partner

1. Enter the http://partner.sunmi.com. Click “Register” to next step.

It is recommended to use Google Chrome browser to experience sunmi cloud function.

2. Enter the name, password and email. Once you have completed entering the information click

the “Register” button to next step.

Page 6: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 1 Account Registration

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

5

3. The “Check email immediately” dialog is displayed. Click this button to check the activation

mail from the mailbox which you submit in the previous step. (If you are using a free web mail and

you did not receive an email you may need to check your spam or trash folder to locate the email.)

4. Log in partner platform after the activation, and you need to fill in the full account

information including the Business Licence and submit it to SUNMI for account verification.

Page 7: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 1 Account Registration

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

6

5. SUNMI will assign the appropriate role for partner when the account verification process is

completed (about one working day), and you will receive the following email notification.

Page 8: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 2 Partner Roles

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

7

2 Partner Roles

Sunmi will assign role to each partner while they register, you can contact us to get more

information. We have 3 different types of partner right now:

Channel partner (Primary account)

You can invite your customer to become new partner and each Sunmi's device will binding a

partner account when it be sold out.

You can develop and adaptive your app to Sunmi's devices, maintains an apps store yourself,

choice apps what he wanted appear on Apps store, and upload apps, those apps their uploaded

no need to be verified by Sunmi.

Also, you can implement some customization features of your devices through sunmi partner

platform.

Subordinate (sub account)

Subordinate is an account set up under a primary account by Channel partner. There are two

types of sub account: Control subordinate and Cooperation subordinate. For details please refer

to 10. Subordinate Management.

App Developer

You can develop and adaptive your app to Sunmi's devices, upload app to Sunmi's apps library,

any user can download and install this app.

In principle, each Sunmi's device will binding a partner account when it be sold out, Sunmi will

manipulate those devices by partner.

Page 9: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 3 Machine Debugging

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

8

3 Machine Debugging

3.1 Debugger Access Control

(This function only affects to non-financial devices. If you want to debug Sunmi P Series device,

please contact our sales for getting debug permission.)

You can connect the device directly to the PC for debugging. In addition, we also provide the device

debugging permissions control function.

Steps:Tap 'Common Settings' - 'Debugger Access Control'.

If you turn on the 'Debugger Access Control' as the following arrow showing in Sunmi partner

platform, developers must get the access permission when debugging the device. If you can't debug

the device, please confirm that you have obtained permission to debug device.

Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your

company.

3.2 How to debug the device

If the 'Debugger Access Control' has been turned on, the developer should get permission to debug

through the mail authentication code. Here are the steps to debug the device:

Step1:Adding developer to debugger.

You can only debug the devices you own and the devices that have been bonded to your company.

First, you need to add developer to debugger on Sunmi partner platform by tap 'Debugger' - 'Add'.

Page 10: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 3 Machine Debugging

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

9

Step2. Connect the device to the PC through the USB connection.

It is recommended to debug in the Windows system environment. If the device has been

successfully identified by the PC, it will show 'Debugging’ pop-window prompt:

If your device didn't identify by the PC, please check the follow reason:

Connection failed, please plug out and insert the USB cable to reconnect device.

Cable fault, please change other USB cable.

The device driver is missing in the system, reinstall driver.

Step3. Get the veification code.

The 'Debugging' dialog is displayed, please click 'Debugging' button to enter the debugging

verification step, and the USB debugging mode will be automatic turned on. However, you can also

click 'I know' to cancel and the USB debugging mode will be turned off.

Step4. Verify permissions.

Enter your debugger account and click 'Get Code', Sunmi will sending a verification code to your

email, input the verification and press 'Authorize'.

Step5. Let’s debug.

Check the Logcat after you getting the debug permission. The debug permission is valid for 7 days.

Page 11: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 4 Application Deployment

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

10

4 Application Deployment

4.1 Application instaionlation method

There is an App store in SUNMI OS, all Sunmi devices can be download and install the application

from Sunmi App store. In addition, there is a 'Allow third party applications to install' option in

“Common Settings” page of Sunmi partner platform (as the following arrow showing). If this option

is turned on, all your devices are only to install apps from App store. Otherwis, you are allowed to

install applications in other ways. (For example, download and install from webpage, recevice and

install from Bluetooth)

(This function only affects to non-financial devices. Please note that Sunmi P Series device only

allows to be installed apps from App store.)

4.2 Application deployment

When the application development and test is completed, you can upload your app to Sunmi apps

store, allowing users to download and install the App directly from Sunmi App store. You can even

make the devices automatically install the specified application.

Here are the steps for uploading apps.

1) Tap ‘My App’, click or drag and drop the Apk which you want upload to the box below.

Page 12: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 4 Application Deployment

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

11

2) Waiting for a while, after upload successfully, the system will automatic parsing the apk and fill

in the content that the green green arrow showing, and please fill in the rest content completely.

Notice:*The length of the ‘APP introduction’ and ’Remark’ must be 10-1000 letters.

*Upload at least three real screenshots

3) When all fields are completed, the 'Next' button will turn blue and clickable, click it and set the

price of the App.

Page 13: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 4 Application Deployment

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

12

Sunmi AppStore pricing model can help you through Sunmi thousands of dealers to promote

terminal merchants.

Retail price refers to the payment price of the terminal merchant. Agency price refers to the last

month you and business meters final settlement price(The price is 1% off the bank charges)

For further information, please contact the sales agent or call 021 61079307-2044.

4) Click 'Preview' button to preview APP details and finish the process of upload app.

5) After the app has been submitted successfully, generally requires 1 working days for verification.

Tips:

Sunmi provide apps store to each partner, we assign different permissions to each partner's

apps store. During the audit period, all your devices can be downloaded and installed this App

which you upload directly in the App Store. But it will appear in other’s App store when the

audit is approved, and when the “Shelf area” option is chosen as “No limit”.

By default, the App developed for P series devices must go through security testing, and it

would appear in Sunmi App store after verification.

Page 14: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 4 Application Deployment

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

13

4.2.1 Gray Release (Deploy application to specified device)

When you submit the app to app store, you can also deploy apps to specified device by setting the

“Shelf area” and “Deploy” options.

Each device has a unique Serial number and it will be getting a location when it works, you could

deploy your app to the specified device by Region, Channel, or SN, this app will be shown in the

apps store of target devices.

Here are some examples of how to deploy application to specified device:

1. If you want to deploy the app to all sunmi devices, you can set ‘Shelf area’ to “No limit” and set

‘Deploy’ to “Deploy All”.

2. If you want to deploy the app to all your devices, you can set ‘Shelf area’ to “For this channel

only” and set ‘Deploy’ to “Deploy All”.

3. If you want to deploy the app to all your devices in Shanghai, you can set ‘Shelf area’ to “For this

channel only” and set ‘Deploy’ to “Gray Release”, click on ‘Add by Region’ to select “China

Shanghai city”, then click ‘OK’.

4. If you want to deploy the app to the devices of other channel in Shanghai, you can set ‘Shelf

area’ to “No limit” and set ‘Deploy’ to “Gray Release”, click on ‘Add by Region’ to select “China

Shanghai city”, and click on ‘Add by Channel’ to select “Channel Name”, then click ‘OK’.

5. If you want to deploy the app to the specified device and you have the serial number, you can

set ‘Shelf area’ to “No limit” and set ‘Deploy’ to “Gray Release”, and enter the SN to the box , then

click ‘OK’.

Page 15: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 4 Application Deployment

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

14

4.2.2 Application deployment FAQ

FAQ:

Q1:How to claim when I get ‘PackageName repeat!‘ message?

If it prompt ‘PackageName repeat!’, it means this apk has been released in the apps store, if this app

belongs to your company, please contact to Sunmi and claim it.

Email Subjest:App Store Content Dispute

Content:Application-App Name(package name),Rights Owner, Phone, company name, attach

the Business license and Software copyright certificate.

We will email both parties so that you can work directly with each other to resolve the dispute.

Q2: If prompt ‘Parsing failure’ error while uploading APK, how to fix?

There are several issues you should take into consideration:

Please check if ARM libraries are included in the libs file, it may casue installation failures.

If it prompt signature exception while uploading APK, please check if the signature is included

in the APK and the signature of the apk is the same as it was before.

If it prompt Unable to upgrade, please confirm if the uploaded version is higher than the

current version.

4.3 Application Update deployment

After the verification succeed, there will be a 'Update' button at the app list in My App options,

developer can deploy updated version of the application. The following is the process of APP update.

1) Tap ‘My App’, click the ‘Update’ button enter the APP updating page.

Page 16: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 4 Application Deployment

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

15

2) Click 'Upgrade', selecting the apk which you want upload. Upgrade and discontinue the last apk

version with newest version to all devices.

3) Waiting for a while, after APK upload successfully, fill the rest content and click ‘Update’.

Notice:*The length of the ‘Upgrade introduction’ and ’Memo’ must be 10-1000 letters.

Page 17: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 4 Application Deployment

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

16

4) After the app has been updated successfully, generally requires 1 working days for verification.

Tips:

Sunmi provide apps store to each partner, we assign different permissions to each partner's

apps store. During the audit period, all your devices can be downloaded and installed this App

which you upload directly in the App Store. But it will appear in other’s App store when the

audit is approved, and when the “Shelf area” option is chosen as “No limit”.

By default, the App developed for P series devices must go through security testing, and it

would appear in Sunmi App store after verification.

4.3.1 Gray Upgrade (Deploy application to specified device)

You can also deploy apps to specified device when you deploy updated version of the application.

Each device has a unique Serial number and it will be getting a location when it works, you could

deploy your updated version of the app to the specified device by Region, Channel, or SN, this

updated version will be shown in the apps store of target devices.

After a small-scale testing, then deploy the updated version of the app to all your devices.

The following is the process of gray upgrade.

1) Tap ‘My App’, click the ‘Update’ button enter the APP updating page.

Page 18: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 4 Application Deployment

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

17

2) Click the ‘Add Gray released’ button enter to grayscale deploy, and submit the updated version of

the application.

3) You could deploy the updated version of app to the specified device by Region, Channel, or SN,

this updated version will be shown in the apps store of target devices and the earlier version would

be deployed to other devices still. Refer to ‘Here are some examples of how to deploy application to

specified device’

Page 19: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 4 Application Deployment

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

18

4) Fill the rest content and click ‘OK’.

5) After the app has been updated successfully, generally requires 1 working days for verification.

Tips:

Sunmi provide apps store to each partner, we assign different permissions to each partner's

apps store. During the audit period, all your devices can be downloaded and installed this App

which you upload directly in the App Store. But it will appear in other’s App store when the

audit is approved, and when the “Shelf area” option is chosen as “No limit”.

By default, the App developed for P series devices must go through security testing, and it

would appear in Sunmi App store after verification.

6) If there is a user reporting bugs in the gray upgrade version, you can click ‘Pause’ to stop the

deployment and click ‘Upgrade’ to upload the new package instead,even during the pending

verification period.

Page 20: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 4 Application Deployment

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

19

7)After a small-scale testing, you can click ‘Adjust gray range’ to increase the range of deployment

over the original range of greyscale, it is suitable for small range trial without any problems.

Also, you can deploy the app to all your devices by clicking ‘Change to official version’. The gray

upgrade version would be swithed into a formal version, and the last formal version would be

discontinued.

Tips:As pictured above, only one grayscale version and one official version are allowed.

Page 21: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 5 Manage your App Store

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

20

5 Manage your App Store

Sunmi provide app store to each partner, you can build your owen App store, choice apps what you

wanted appear on App store, set the app as automatic installation app, and you can also specify that

the app starts automatically on all your devices.

5.1 Build your owen App Store

You can build your owen App store, choice apps what you wanted appear on App store, even could

set your app store not showing other's apps.

As shown below, on the left side is your owen App store, and the Sunmi’s App library is on the right

side. There are 2000+ commercial App in Sunmi App library, your can add apps what you wanted to

your App store, or you can click “Add all” to make all Apps on shelves.

Also, you can just click the “Recycle Bin Icon” to remove the App you don’t need.

Page 22: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 5 Manage your App Store

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

21

5.2 Auto install App

If you want the app you uploaded automatically installed on the device of all your devices, you can

set it as automatic installation app by enabling “Auto install”, all your devices will automatically

download and install this app when receive the push message.

5.3 App Auto Startup

You can let the devices automatically run an application on boot, one model can only set an auto

start application. It will work when the next boot of the device.

Page 23: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 5 Manage your App Store

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

22

How to cancel automatic start app? Just click the “Recycle Bin Icon” to cancel auto startup.

Page 24: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 5 Manage your App Store

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

23

5.4 App Protection

You can choose one application what you want to avoid be killed by system cleaner when the

system is out of memory. Please noted that manually press "□" button on device to clean up running

application will kill this APP.

How to cancel App Protection? Just click the “Recycle Bin Icon” to cancel protection.

Page 25: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 6 Machine customization

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

24

6 Machine customization

You can implement some customization features of your devices through sunmi partner platform, it

helps businesses enrich the customers experience by customizing boot animation, launcher, app

store banner and iBeacon.

6.1 Boot Animation customization

You can use the ‘Picture Making Rule’ or ‘Zip Making Rule’ to set up the boot animation, and apply

for your devices.

Notice:Sunmi P1 does not support this feature for the time being.

Picture Making Rule for V1:

• Picture Format: PNG

• Picture Size:540*960px;

Page 26: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 6 Machine customization

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

25

• Picture Size: single no more than 20K

• Picture Name: 001, 002...

• Picture NO: no more than 60

Picture Making Rule for M1:

• Picture Format: PNG

• Picture Size: 480*854px

• Picture Size: single no more than 20K

• Picture Name: 001, 002...

• Picture NO: no more than 60

Picture Making Rule for T1:

• Picture Format: PNG

• Picture Size:1920*1080px

• Picture Size: single no more than 20K

• Picture Name: 001, 002...

• Picture NO: no more than 60

How does it work?

First, reboot your device. This will not display the Boot animation you uploaded, but it will trigger

the request, download and configuration of the animation.

A moment later, reboots the device again. This time, you can see the boot animation you uploaded.

There will be a sunmi logo first, and the custom boot animation will appear on the next page.

Page 27: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 6 Machine customization

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

26

6.2 Launcher customization

You can customize the desktop of the machine through the "My Launcher" function of the partner

platform, so that the machine directly presents the applications that you want show on the

homepage and hides other applications that you don’t need.

You need to develop an Launcher Application for this, and upload it to replace the default Sunmi

launcher for your devices.

Steps: Tap ‘My Launcher’, click ‘Desktop DIY’, select Model and upload your launcher.

How does it work?

First, reboot your device. This will not display the launcher you uploaded, but it will trigger the

request, download and install the launcher.

A moment later, when the launcher installation is complete. It will not directly set as default home

screen, until you hit your home button, it'll bring up a list of the installed launchers, select the

custom launcher to set default home screen.

Page 28: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 6 Machine customization

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

27

6.3 Wallpaper customization

You can upload custom image to set as default wallpaper for your devices.

Steps: Tap ‘My Launcher’, click ‘Wallpaper DIY’, select Model and upload the image.

Requirements:

Vertical screen Wallpaper: Best visuals:720*1280; File size:<350KB; File type:PNG only;

Horizontal screen Wallpaper: Best visuals:1920*10280; File size:< 500KB; File type:PNG only;

Page 29: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 6 Machine customization

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

28

How does it work?

The device will check and download new wallpaper when it rebootable.

6.4 Banner customization

You can customize the banner of App store, delivering relevant mobile Ads on all your devices.

Step1: Tap ‘My App Store’, click ‘Custom Banner’, select Model and upload the image.

Vertical screen machine:Best visuals:720*290; File size:<100KB; File type:JPG;

Horizontal screen machine:Best visuals:1240*340; File size:<200KB; File type:JPG;

Step2: enter the banner URL, when user click on the banner, it will open this URL page.

Here's how it works:

Page 30: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 6 Machine customization

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

29

6.5 iBeacon settings

With an iBeacon network, any brand, retailer, app, or platform will be able to understand exactly

where a customer is in the brick and mortar environment. This provides an opportunity to send

customers highly contextual, hyper-local, meaningful messages and advertisements on their

smartphones.

The UUID, major and minor values provide the identifying information for the iBeacon. Generally

speaking, this information is hierarchical in nature with the major and minor fields allowing for

subdivision of the identity established by the UUID.

Page 31: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 7 Machine Managment

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

30

7 Machine Managment

To further manage the use of the machine, collect and analyze the usage data, we provide

functionality for partners to query machine usage.

7.1 My Data Manager

Data manager can help you collect APP Usage Data and view the mobile data usage of the device

under your company account.

Steps: Tap ‘Machine Data’, and click ’Data Manager ’

7.2 Active equipment

Active equipment: if the machine someday even over the net, and opened at least one software is

called the machine for the active equipment.

In the past 7 days, 30 days active machines: if a machine in the past 7 days /30 days active for more

than 1 days, then this machine in this data will only be calculated 1 times.

Page 32: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 7 Machine Managment

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

31

Steps: Tap ‘Machine Data’, and click ’Active Machine’

7.3 Machine Position

The machine can be positioned to the current geographical location by the network or GPS, and the

channel partner can check the distribution of their machines.

Steps: Tap ‘Machine Data’, and click ’Machine Position’

Page 33: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 7 Machine Managment

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

32

7.4 Machine Lifecycle

Click ’Machine Lifecycle’ to view the shipping data and the activation date of your machines.

7.5 Machine Application

Click ’Machine Application’ to view the current installed application information of the machine, click

on the right "current installed App", it provides the name of the specific application.

Page 34: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 7 Machine Managment

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

33

7.5 Machine Infomation

Click ‘Machine Information’ to veiw the current machine usage, such as Printing distance, each

machine cutter number and the cashbox opening number.

Page 35: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 8 Remote Assistance

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

34

8 Remote Assistance

You can remotely manage devices under your company's account through Remote assistance, check

the device information and provide support assistance for your machines, save travel time and cost.

Notice: In the following list, the number of online devices depends on whether the device is

upgraded to the latest system and whether the device uses a WiFi network!

8.1 Remote Managment

Click ‘Remote Management’ below ‘Remote Assistance’ option to browse configuration information

of the remote machine, as well as the device performance, network status information, installed

application and general settings of the machines.

Page 36: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 8 Remote Assistance

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

35

Page 37: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 8 Remote Assistance

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

36

8.2 Remote Control

You can view real-time using screen of the machine, and directly click ‘apply for remote control’

button for remote control, assist the other side to troubleshoot problems.

Remote control procedures:

1. Before applying for control the remote machine, please inform the other party to run ‘Remote

assistance’ APP. (If there is no ‘Remote assistance’ APP, it can be downloaded from app store.)

Page 38: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 8 Remote Assistance

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

37

2. Wait for the connection to be ready. When the status indicates that ‘The connection is ready!

Waiting for incoming call...’ The remote assistance is ready.

If it prompts ‘Network unavailable, Remote Assistance cannot be established.’ Please check the

connection failure of the remote machine.

3. Locate the remote machine that needs remote control, and when the remote machine connection

is ready, the remote-control button will be optional.

Page 39: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 8 Remote Assistance

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

38

4. Click ‘Apply for control’ connect to the remote machine.

5. It will show following pop-window prompt: ‘XXX apply to control your machine. Do you agree?’,

After the other side click "agree", the remote connection will be successfully established.

It is recommended to use Google Chrome browser to experience remote control function. If the

screen of remote machine can not be displayed, and prompting the error message, please refer the

following solution:

Issue 1:The screen of remote machine can not be displayed, if the flash plug-in is disabled in the

browser settings.

Solution:Enable Flash plugin in the browser settings.

Issue 2:The screen of remote machine can not be displayed, if the flash version is too low build in

the web browser.

Solution:Download and update the flash plugin, then reflash the web page.

Page 40: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 8 Remote Assistance

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

39

6. You can view real-time using screen of the machine, and remote control it.

7. The other side can also click on the red button in the lower right corner of the screen to interrupt

the connection.

Page 41: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 8 Remote Assistance

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

40

If the ‘Apply for connect’ button is not available, please check:

Check if the remote machine is switched on;

Check if remote assistance app is running;

8.3 Remote Record

The Remote Record provides detailed information of remote assistance, remote connection time,

connection length, connection mode (WiFi or 3G), and the amount of traffic consumed using the 3G

connection.

Page 42: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 8 Remote Assistance

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

41

8.4 Machine Map

You can always know the location information of your devices, and the number and Model of

machines in the current area will be displayed on the map.

Steps: Tap “Remote Assistance”, then click “Machine Map”, the location of the device can be searched

according to the "address" or "SN" search.

If you have device, but it is not located, please refer the following steps:

1、Please make sure the device is bound to your account.

2、Please ckeck if the device has been activated.

3、Get device location information delay, please try again later.

Page 43: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 9 Operator Management

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

42

9 Operator Management

The Operator Management page allows you to manage operators and permissions. The Channel

partner can add operator accounts and assign specific permissions to them, lets you work with a

team to distribute apps, maintain the apps store, and manage the devices. Operators are required to

Logon to the partner platform using a Logon ID and password.

9.1 User Role

The type of information you can see or edit in an account depends on what your user role is. There

are two types of users:

[Administrator]: Users who have access to all functions and can manage operators in the account.

[Operator]: Operators only have access to some features in the account, depending on their

permissions.

9.2 Adding Operator

The Admins in an account can view and edit operator info and permissions, as well as add and

delete operators.

To create a new operator, complete the following:

1) Log into partner platform as an administrator.

2) Go to the “My Operator” page, click “Add the operator” button.

Page 44: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 9 Operator Management

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

43

3)The Create Operator dialog is displayed. Enter the operator’s name and email. Once you have

completed entering the information click the ok button. (Once an operator has been added

modifications can not be made to the Logon Name of the operator.)

4)Select the “Select permissions” button to assign specific permissions to operator.

5)Active the operator account from the mailbox. Click the “acvive account” button and enter a

Password and re-enter it in the Confirm Password field. When finished creating the new operator,

click OK.

Page 45: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 9 Operator Management

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

44

6)When the operator first login to the partner platform, it will remind you to bind your mobile

phone number in order to protect your account security.

Page 46: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 9 Operator Management

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

45

9.3 Deleting Operator

Once you have identified the operator that you wish to delete select the “delete” button, a window

will pop up and ask if you wish to proceed with deleting the record. Select yes to confirm the

removal of the record.

9.4 Transfer the administrator permission

The Admins in an account also can transfer the administrator permission to the operator, let this

operator become the new administrator, and the original administrator account will lose

administrator privileges.

Page 47: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 10 Subordinate Management

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

46

10 Subordinate Management

A sub-account is an account set up under a primary account by Channel partner. There are two

types of sub account:

[Control subordinate]: A Control subordinate account is subordinate to a primary account. For

example, a company might set up sub accounts for each of its departments or branch offices for

grading management, the sub account shall be managed by the company's administrator (primary

account). The sub account could be created on “My Subordinate” page and does not require

registration.

[Cooperation subordinate]: The sub account is a cooperative relationship with the primary

account, cooperation subordinate manages the devices allocated to their channels independently.

For example, a distributor buys products from sunmi and resell them to other businesse partners in

their distribution channel. And the distributor can invite their customers (Software vendors, retailers)

to become new partners and the devices will be bound to their sub accounts when they sell.

Each Cooperation subordinate will have its own login ID and password.

Type Registration Account verification Sign in Functionssubordinatemanagement

Bingding device Account Convert

Primaryaccount

Register at the officialwebsite and

need to fill in the fullaccount informationincluding the Business

Licence and submit it toSUNMI for account

verification.

SUNMI will assign theappropriate role for partner

when the account verificationprocess is completed

Using accounts and passwordson the login partner platform

All functions support

Sunmi binds thedevices to the Primary

account when theyare shipped

/

Controlsubordinate

The control sub accountcould be created on “MySubordinate” page and

does not requireregistration.

does not require registration,assign the Channel role

The Control subordinateaccount does not have its ownlogin ID and password, it shallbe managed by the primary

account.You can add operators to

assist management.

does not havepermission to uploadApp, other functions

assigned by the primaryaccount;

/

Distributor binds thedevices to the

subordinate whenthey are shipped

can be convertedinto a cooperative

Subordinate

Cooperationsubordinate

Inviting registration by mainaccount.

need to fill in the fullaccount informationincluding the Business

Licence and submit it toSUNMI for account

verification.

Assign the Channel role forpartner when the account

verification process iscompleted

Each subordinate will have itsown login ID and password.

All functions /

Distributor binds thedevices to the

subordinate whenthey are shipped

/

Page 48: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 10 Subordinate Management

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

47

10.1 Control Subordinate

10.1.1 How to create a Control subordinate account?

The control sub account could be created on “My Subordinate” page and does not require

registration. To create a new sub account, complete the following:

1)Go to the “My Subordinate” page, click “Add Control Subordinate” button.

2)The Create Subordinate dialog is displayed. Enter the subordinate’s name, abbreviation and

email. Once you have completed entering the information click the “Save” button. (Once a sub

account has been added modifications can not be made to the Logon Name of the sub account.)

10.1.2 How to use the Control Subordinate for management?

The Control subordinate account does not have its own login ID and password, it shall be managed

by the primary account. If you want to authorise someone to access partner platform to manage

devices of their’s department or company. You can add operators to assist management.

1) Use the primary account login partner platform.

2) Go to the “My Subordinate” page, select the Control Subordinate and click “To manage” button.

Page 49: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 10 Subordinate Management

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

48

3) To create a new operator and assign specific permissions to operator. Refer to “9.2 Adding

Operator”

Noted:The control subordinate does not have permission to upload App. If the subordinate needs

this function, that he should register another partner account for uploading Apps, and the “Shelf

area” must be chosen as “No limit” when uploading apps.

Then login again with the operator (sub account) provided by the primary account, and add the

apps what he wanted to the App store of subordinate.

10.2 Cooperation Subordinate

How to create a Cooperation subordinate account?

You should use the prmary account login partner platform, and invite your customers to complete

sub account registration. Each Cooperation subordinate will have its own login ID and password.

1)Go to the “My Subordinate” page, click “Add Cooperation Subordinate” button.

2)The Create Subordinate dialog is displayed. Enter the subordinate’s name, abbreviation and

email. Once you have completed entering the information click the “Save” button. (Once a sub

account has been added modifications can not be made to the Logon Name of the sub account.)

Page 50: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 10 Subordinate Management

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

49

3)Inform the subordinate to complete sub account registration procedure. If the sub account

has been activated, the state will display "normal". If the sub account is not activated, the state will

display "Waiting for registration".

4) Active the sub account from the mailbox. Click the “Login” button to open partner platform

website, then use the sub account and initial password to login and modify the password.

5) The Cooperation subordinate needs to fill in the full account information including the Business

Licence and submit it to SUNMI for account verification.

Page 51: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 10 Subordinate Management

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

50

6) When the account verification process is completed (about one working day), and you will

receive the following email notification.

How to use the Cooperation Subordinate for management?

Login to the partner platform using the sub account, cooperation subordinate can manage all the

devices allocated to their channels independently. Also, you can add operators to assist

management.

Page 52: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 10 Subordinate Management

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

51

10.3 Sub account role conversion

A control Subordinate can be converted into a cooperative Subordinate, which returns management

to a Subordinate and will no longer be switched back to the control Subordinate after conversion.

1.Use the primary account login partner platform.

2.Go to the “My Subordinate” page, select the Control Subordinate and click “Convert” button.

3.Enter the manager mail and click the “Save” button.

4.Inform the subordinate to complete sub account registration procedure. Refer to “10.2

Cooperation Subordinate”.

Page 53: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 10 Subordinate Management

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

52

10.4 Bingding device to subordinate

You might set up sub accounts for each subordinate, and bingding the devices which was shipped to

the subordinate, so that they can manage their app store and devices through Sunmi partner

platform.

Page 54: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 11 Common Settings

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

53

11 Common Settings

You can change the relevant settings of your devices on the ‘common Settings‘ page.

1.Allows third party applications to install: It is allowed to install applications from non-app store

sources if it enable.

2.UserCenter: If user center is disable, part or all of APPs based on SUNMI account will be disabled.

3.User Feedback: Affect the content range which user can read.

4.Debugger Access Control: If partner turn on the 'Debugger Access Control', developers must get

the access permission while they debugging the device.

5.Google Settings: Google Mobile Service built-in app, this app in your channel’s devices will be

disable after off this switch.

Page 55: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 11 Common Settings

文档版本 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

54

Page 56: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 12 Others

Doc ver. 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

55

12 Others

12.1 My Message

Get the lastest info and everything about Sunmi partner platform.

12.2 My Order

If you have released paid apps to app store(refer to 4.2 Uploading APP), you can check the

purchased orders on ‘my order’ page.

Page 57: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 12 Others

Doc ver. 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

56

12.3 Card Reader Settings (For T1)

T1 device can be used to set the data output format of the Sunmi reader module. The data is output

in analogue keyboard input. Developers can also use the instructions to obtain the magnetic card

data, see docs.sunmi.com.

The track data on the page is analog data only to mask the functionality of this page.

12.4 My Account

Click ‘my account’ on the upper right corner of the page, you can modify the basic information of

your account, and the related security settings.

Page 58: Sunmi Partner Platform User Manual · Notice: “Debugger Access Control” feature only affects the devices that have been bonded to your company. 3.2 How to debug the device If

Sunmi Partner Platform User Manual 12 Others

Doc ver. 1.08 (2017-11-21) Copyright © 2017 Sunmi.co All Rights Reserved

57

Account Security