Support

The reader has switched itself off

Quick Balance shows a card offering to open the settings whenever this happens. Tap it, or go to Settings → Accessibility → Quick Balance reader and switch it on.

There are two common reasons it goes off:

• You force-stopped the app. Android switches an app's accessibility services off when it is force-stopped, and does not turn them back on by itself. This also happens if you clear the app from Settings rather than the recents list.
• Advanced Protection Mode is on. On Android 17, turning on Advanced Protection Mode revokes accessibility access for apps that are not accessibility tools. Quick Balance is not one, so the reader will not stay switched on while that mode is enabled. The app fails softly and shows the same card, but switching the reader on will not stick until Advanced Protection Mode is off.

A popup is stuck on screen and nothing is happening

If the app was force-stopped or reinstalled in the middle of a check, the network's session is left open and your phone app's popup stays on screen with nothing driving it. Dismiss it yourself and check again.

The reader deliberately will not touch a popup that Quick Balance did not start. A reader that closed popups it had not asked for would be reaching into something that was never its business, so it leaves it to you.

Why the screen flashes when you check

There is no silent way to run *100# on this network. Android's quiet method refuses, because every reply keeps the session open. So the app dials the code, the phone app shows its own popup, and Quick Balance covers it with a "Checking with your network" screen, reads the answer, and closes it.

Why the reader has to be on at all

The popup belongs to the phone app, not to Quick Balance. The only way to read it is Android's accessibility service, which is why the app asks to be switched on there. It reads that popup, and when you browse your network's menus it types your choice into it. Nothing else. The full detail is in the privacy policy.

The warning cards, and why there is only one reminder

Home shows a card when your last check found credit or data running low, when a bundle is about to expire, or when the figures have got old. You can move the credit line in Settings.

These are always about your last check, never a live reading. The app cannot check your balance on its own in the background — Android only lets it dial *100# when you tap something — so it can never tell you the moment your credit drops. The one thing it can notice without checking is that a while has gone by, so the only notification it ever sends is a reminder to check again after a week.

Why a menu sometimes offers to reconnect

Your network hangs up on an idle menu, and does it silently — the popup stays on screen and your phone does not notice, so you only find out when you send a choice and get an error back. That is how USSD works on every network.

The app remembers where you were and offers a Reconnect button that opens the same screen again. It never does that by itself, because reopening a screen means re-sending the choices that got you there, and one of those could be a confirmation you only meant once.

The home screen tile, and why it waits for you

Settings can put your airtime and data on the home screen. The button on it runs a real check without opening the app, and the tile turns red when your credit is under your warning line.

It never checks on its own, and it cannot. Android only allows the app to dial *100# when you tap something, so there is no way to refresh in the background — which is why the tile always tells you how old its figures are. If it shows "--" it means the last check did not come back, not that you have nothing left.

How the data ring knows your plan size

Your network tells the app what you have left, never what your plan started with. So the app takes the biggest figure it has seen for the bundle you are on and measures against that. If you used some data before your first check on a new bundle, the ring reads a little too full until the next bundle. You can force a size in Settings.

When your network answers with an error

Your network's gateway sometimes replies "An error occurred while processing your request". The app retries once and then shows you exactly what it said, rather than translating it into something friendlier that might be wrong.

Does it work on Digicel?

No. Quick Balance is built around *100# and the menus behind it. Digicel's codes are different and have not been tested.

Still stuck

Email support@quickbalance.app. It helps to say which phone you have, which Android version, and what the app showed you.