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
| Responsibility | Who |
|---|---|
| Build, sign, and upload POS APK | Integrator |
| Payment App on terminals | Peach Payments |
| Sunmi channel binding so terminals can install your app | Peach Payments coordinates with your Sunmi partner account |
| Integrated mode and terminal feature configuration | Peach 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
- Register at partner.sunmi.com and complete company profile verification.
- If Development → App Publishing is missing, email [email protected] to request app-publishing access.
Upload a new app
- Sign in to partner.sunmi.com.
- Open Development → App Publishing (or My APP).
- Upload your signed release APK.
- Complete metadata:
- App name and description
- Supported device models (
P2_SEandP2_LITE_SE) - Screenshots (minimum 3)
- Region - select overseas / South Africa (not China-only)
- Deploy method - Deploy all or Gray release (see below)
- 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
- Select your app → Upgrade.
- Upload a new APK with a higher
versionCodethan the published build. - 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:
| Setting | Options |
|---|---|
| Deployment method | Deploy all · Gray release deployment |
| Target | Region or device serial number (SN) list |
Recommended: upload → gray release to pilot SNs → verify end-to-end sales → widen to full channel.
APK requirements
| Requirement | Detail |
|---|---|
| Signing | Release APK signed with V1 + V2 signature schemes |
versionCode | Must increment on every upload |
| Package name | Must match previous releases for upgrades |
| ABI | Include 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),
versionCodeset - 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
| Resource | URL |
|---|---|
| Sunmi Partner Platform | partner.sunmi.com |
| Sunmi Get Started (SDKs) | Sunmi Get Started guide |
| App publishing process | developer.sunmi.com |