Terminal Apps (Software)
Push signed software from the Developer Portal to your terminals, see which versions are configured where, and uninstall apps from one terminal or a whole merchant.
Overview
Terminal apps in the sidebar opens the Software page. It is the bridge between the Developer Portal, where software is uploaded and signed, and your terminal fleet.
| Stage | Where | What you do |
|---|---|---|
| Build | Developer Portal | Create and upload your application |
| Sign | Developer Portal | Sign the package so it can be installed |
| Push | Partner Portal | Send it to your terminals, a merchant, or one terminal |
| Install | Terminal | The terminal downloads the app and installs it on restart |
The Software page has two tabs: Available Apps and Configured Software.
Available Apps
Lists every signed software package available to your account, one row per software ID, with its type and the number of versions (“3 versions · latest 1.5.27”). Expand a row to see every version, newest first.
Search by ID, type, or version. A package that doesn’t appear here has not been signed in the Developer Portal yet.
Configured Software
Shows which software versions are configured to be installed, and at which level. Choose a scope, Merchant, Store, or Terminal ID, find the merchant, store, or terminal, and click Search.
Each row lists the software ID, version, type, device type, terminal type, whether it is a POS app, and the Override Level: the level the entry was set at (partner, merchant, store, or terminal). A more specific level wins: terminal beats store, store beats merchant, merchant beats partner.
Pushing software
You can push from three places. The form is the same; only the reach differs.
| Where | Reaches |
|---|---|
| Software page → Push Software | All terminals on your partner account |
| Merchant → Terminals tab → Push Software | All of that merchant’s terminals |
| Terminal page → More actions → Push app to terminal | That one terminal |
- Select the Software and the Version. Versions are labelled with their platform, for example “1.5.27 · Android”. iOS builds are listed last.
- Optionally pick a Terminal Type to limit the push to one model: SurfprintPro, SurftouchPro, Surftouch, Surfprint, or Surfpad. Leave it on All terminals to reach every model. (Not shown when pushing to a single terminal.)
- Switch on Is this a POS app? if the software is a point-of-sale application.
- Click Review & Push, check the summary, and click Confirm & Push.
Note: An iOS build won’t install on Android card terminals such as Surfprint and Surftouch. The form blocks it and asks you to pick an Android version.
After you confirm, the dialog follows the download for about 30 seconds (Software pushed, then Downloading onto the devices, then Restart to install). You can Skip the wait. The app installs when the terminal restarts, so restart the devices once the download is done.
If the app doesn’t appear after a restart, check that the terminal has internet, try switching it to Wi-Fi, keep it switched on, wait a minute, and restart again. If it still doesn’t install, use Create a ticket to contact support.
Uninstalling an app
Uninstall is not on the Software page. You start it from:
- Merchant → Terminals tab → Uninstall Software, for some or all of the merchant’s terminals
- Terminal page → More actions → Uninstall app, for one terminal
- Terminal Info → Uninstall App, for one terminal
- Select the app or apps to remove.
- When starting from the merchant, choose Uninstall from: All terminals under the merchant, or Select terminals and pick them.
- Review the confirmation. If an app is still configured for these terminals, it is flagged as Still configured, meaning it will be reinstalled. Tick an entry to also remove it from the configuration, otherwise the app comes back on the next configuration sync.
- Type
UNINSTALLand click Uninstall.
The app is removed without a restart. Terminals that are offline apply the uninstall when they reconnect. You can push the app again later.
Note: Configuration entries set at store or terminal level can only be removed when uninstalling from a single terminal. Removing an entry set at partner level affects every terminal on your account, and the dialog warns you before you do.
Checking what a terminal has installed
Open the terminal and choose the Apps tab. It lists the partner apps the terminal reports, each marked Installed, Assigned, or Removed, with how fresh the report is. Switch on History to see when each app was registered, confirmed as installed, changed version, or removed. A newly registered terminal shows its apps after its next check-in.