Deploy your POS app (Sunmi)

Upload and version your POS APK on the Sunmi Partner Platform. Peach Payments manages the Payment App separately; you own your POS app lifecycle on Sunmi.

Who does what

ResponsibilityWho
Build, sign, and upload POS APKIntegrator
Payment App on terminalsPeach Payments
Sunmi channel binding so terminals can install your appPeach Payments coordinates with your Sunmi partner account
Integrated mode and terminal feature configurationPeach Payments
📘

Upload your app as public on the Sunmi Partner Platform so Peach Payments can push it to merchant terminals on your channel.

Partner account setup

  1. Register at partner.sunmi.com and complete company profile verification.
  2. If Development → App Publishing is missing, email [email protected] to request app-publishing access.

Upload a new app

  1. Sign in to partner.sunmi.com.
  2. Open Development → App Publishing (or My APP).
  3. Upload your signed release APK.
  4. Complete metadata:
    • App name and description
    • Supported device models (P2_SE and P2_LITE_SE)
    • Screenshots (minimum 3)
    • Region - select overseas / South Africa (not China-only)
    • Deploy method - Deploy all or Gray release (see below)
  5. Preview and submit for review.

Payment-series terminals may require manual verification before the app appears in the store. Confirm review timelines with Sunmi for your device series.

Version updates

  1. Select your app → Upgrade.
  2. Upload a new APK with a higher versionCode than the published build.
  3. Submit for review.

On Wi-Fi, devices may receive updates silently when the app is not in the foreground. Reboot the terminal to force a sync if needed.

Gray release (staged rollout)

Use gray release to pilot a version before fleet-wide rollout:

SettingOptions
Deployment methodDeploy all · Gray release deployment
TargetRegion or device serial number (SN) list

Recommended: upload → gray release to pilot SNs → verify end-to-end sales → widen to full channel.

APK requirements

RequirementDetail
SigningRelease APK signed with V1 + V2 signature schemes
versionCodeMust increment on every upload
Package nameMust match previous releases for upgrades
ABIInclude armeabi-v7a / arm64-v8a as required by target models

Sunmi SDKs

For printer, NFC, and other device hardware beyond the Intent API, see the Sunmi Get Started guide.

Peach Payments coordination

Before go-live:

  • Confirm Peach Payments has added your app to the terminal app list for merchant devices.
  • Verify Payment App version on pilot devices meets Intent API requirements - see Point of sale release notes.
  • Complete the test matrix on Test your integration.

Go-live checklist

  • Sunmi partner account audited and App Publishing enabled
  • Release APK signed (V1 + V2), versionCode set
  • Correct device models selected
  • Region set to overseas
  • Pilot via gray release on known serial numbers
  • End-to-end sale on pilot build before channel-wide Deploy all
  • Peach Payments Payment App version meets Intent API requirements

External resources

ResourceURL
Sunmi Partner Platformpartner.sunmi.com
Sunmi Get Started (SDKs)Sunmi Get Started guide
App publishing processdeveloper.sunmi.com