Summary: Qashier POS tells you when a new version of the app, or of the QashierPay card-payment app, is ready. This article explains each update prompt, how to install the update, and why you should update only when no customer is paying.
Applies to: All markets · Qashier POS on QashierX2, QashierXS, QashierXL, Sunmi devices and your own Android phone or tablet · the QashierPay app on terminals that take card payments through it · no PIN needed. The black QashierXS (Adyen S1F2) in Singapore does not show these prompts: see [SG] How to Update the Software on Your Adyen Card Terminal.
Before you start
Finish the current sale. Make sure no card payment is in progress on this terminal.
Pick a quiet moment, for example before you open or after you close. The app says an update "takes only approx. 1 min and won't affect the data", but you cannot take sales or card payments while it runs.
Check that the terminal is online (Wi-Fi or mobile data) and charged or plugged in. The update is downloaded first.
The update prompts you may see
What you see | What it means |
A pop-up Update Available: "New Update Available, would you like to update now? (takes only approx. 1 min and won't affect the data)" with Yes and Later | An optional Qashier POS update. Tap Later if a customer is waiting. |
A pop-up Update Available: "Please update to the latest version to continue" with only Update | A required update. The pop-up cannot be closed until you update. |
A banner on the home screen: "Update available. Please click here to update. ▶" | A Qashier POS update is waiting. Tap the banner when you are ready. |
A banner on the order screen: "Update available. Please return to main page to update." | Go back to the home screen to start the update. |
QashierPay Update Available: "New QashierPay Update Available, would you like to update now?" | An optional update of the QashierPay card-payment app. |
Update Required: "Please update the QashierPay app to continue accepting payments." with Update Now | A required QashierPay update. |
Qashier POS checks for a new version when it starts and loads your store.
Steps: update Qashier POS
Finish or cancel the current sale, and make sure no customer is tapping or inserting a card.
On the home screen, tap the banner "Update available. Please click here to update. ▶", or tap Yes (or Update) in the pop-up.
If you see "To get our app updates, you will need to provide our app the permission to install to your phone", tap Allow install from this source, switch the permission on in the Android screen that opens, then go back to Qashier POS and tap the update banner again. This permission is only for Qashier's own updates.
Wait while Downloading Update shows the progress. Do not turn off the terminal or leave the app.
Install the update:
QashierX2, QashierXS and QashierXL: the update installs by itself. You see "Installing update..." and the app closes while it installs.
Other devices, including Sunmi devices and your own phone or tablet: Android's install screen opens. Confirm the install. Until you do, Qashier POS shows "Please complete the update process."
Open Qashier POS again if it does not reopen by itself.
Steps: update the QashierPay app
When QashierPay Update Available appears, make sure no card payment is in progress.
Tap Yes (or Update Now for a required update), or Later to be asked again next time.
Wait while Downloading Update shows the progress, then follow the install prompt on screen.
Why you should not update during a payment
Installing an update restarts the app. If that happens while a card is being charged, the customer can be charged without the sale being recorded in Qashier. Qashier POS guards against this:
While a Qashier POS update is downloading or installing, the terminal does not start new QashierPay card payments. A card terminal on Standby for payment shows "Updating, please wait…". If a payment does not go through, send it again from the POS after the update.
If a card payment is already in progress when the download finishes, the update is not installed. The payment completes normally and the update is offered again the next time the app opens.
These guards reduce the risk but cannot cover every case, for example the terminal losing power. Update only when no one is paying.
What you should see
When Qashier POS opens after the update, you see the home screen and the update banner is gone.
To check the version, tap the menu icon (☰) at the top right, then Support. The window shows the Version Code:.
If something goes wrong
Symptom | Cause | Fix |
"Download stopped, please try again." | The connection dropped or the download failed | Check the internet connection, then tap the update banner again. |
Nothing happens after you tap the banner, or you see the install permission message | Qashier POS is not allowed to install its updates | Tap Allow install from this source, switch the permission on, go back and tap the banner again. |
The screen stays on "Please complete the update process." | Android's install screen was closed before the install was confirmed | Close and reopen Qashier POS, then tap the update banner or pop-up again. |
The required-update pop-up will not go away | Your version is below the minimum Qashier supports | Tap Update at a quiet moment. |
A card terminal shows "Updating, please wait…" | That terminal is installing a Qashier POS update | Wait for it to finish, then send the payment again from the POS. |
"QashierPay Not Available" when you try to update QashierPay | No QashierPay download is set up for this terminal | Contact support. |
The terminal restarted during a card payment | The payment may have gone through without being recorded | Check Transaction Record before you charge the customer again. If you are not sure, contact support with the time and amount. |
Related articles
Last verified: 25 Sep 2026 · Markets: All markets
