Buy Extra Data
When you’ve burned through your monthly cap and your speed has been throttled by FUP, the Buy Data tab lets you purchase extra GB on top of your plan. The GB are added immediately to your bonus quota — usage counts against bonus before it counts against the monthly cap — and your speed restores within 30 seconds.
The feature is optional. Your ISP has to set a price-per-GB in their settings; if they haven’t, the tab is hidden.
How to get here
Section titled “How to get here”After login, from the portal:
- Sidebar → Buy Data (cart icon)
- Direct URL:
/customer/topup - Mobile app: More → Buy Data
The tab is hidden when the system-wide topup_data_price_per_gb setting is 0 (no price configured = feature disabled).
Layout
Section titled “Layout”The Buy Data page shows four pieces of information stacked vertically:
| Section | What it shows |
|---|---|
| Price per GB | What it costs to buy 1 GB. Set by your ISP. |
| Your balance | Current wallet balance — what you have available to spend. |
| Bonus remaining | Bonus GB you’ve previously purchased that are still unused. |
| Quantity picker + buy button | Pick GB amount, tap Buy to confirm. |
Below the picker is a history list of your past data top-ups, newest first.
How bonus quota works
Section titled “How bonus quota works”Your monthly usage budget is the sum of two pools:
- Monthly quota — what your plan includes (e.g. 100 GB).
- Bonus quota — extra GB you’ve bought this month.
As you use data, the system fills the bonus pool first, then the monthly pool. When monthly_bonus_used >= monthly_bonus_quota, you’re back on the normal pool. When both are exhausted, FUP kicks in.
Both pools reset on the monthly reset day (typically the 1st of the month, or your renewal day depending on the operator’s configuration). Unused bonus GB are lost at reset — they don’t carry over.
The flow
Section titled “The flow”When you tap Buy 10 GB (for example), the system:
- Multiplies
10 × price_per_gbto get the cost (e.g.10 × $1.50 = $15). - Checks your balance is
≥ $15. If not, returns “Insufficient balance”. - In one transaction:
- Adds
10 GB(in bytes) to yourmonthly_bonus_quota. - Resets
monthly_bonus_usedto 0 — the new bonus pool starts fresh. - Subtracts
$15from your balance. - Resets your
monthly_fup_levelto 0 so you’re no longer throttled.
- Adds
- Writes a
bonus_topupsrow recording the purchase. - Writes a
data_topuptransaction in your history.
Within 30 seconds (the QuotaSync cycle), your speed restores. Your next router data transfer counts against the bonus pool.
Why monthly_bonus_used resets to 0
Section titled “Why monthly_bonus_used resets to 0”This is intentional. If you bought 10 GB last week and used 7 of them, then today you buy another 10 GB — the system doesn’t add to the leftover 3 GB. It resets the pool: bonus_quota becomes 10 GB, bonus_used becomes 0. You have 10 GB of bonus available, not 13.
The simplification is deliberate — managing a “bonus carryover” would require a per-purchase ledger and a more complex enforcement loop. Most customers buy bonus in response to a throttle, so the practical impact is small. If you have multiple unused topups, buy them at the same time (e.g. one purchase of 20 GB instead of two of 10 GB).
Balance check
Section titled “Balance check”If you don’t have enough money:
Insufficient balance. Need $15.00 for 10 GB. Current balance: $8.00.
You need to top up your wallet first. There are two ways:
- Through your ISP — pay them via their normal channels (cash, bank transfer, mobile money), they’ll add credit to your wallet.
- From a prepaid voucher card if your ISP sells them (separate from Buy Data, see your portal for a Voucher tab).
Bonus history
Section titled “Bonus history”Below the buy form, you see a history of every top-up you’ve made:
| Column | What it means |
|---|---|
| Date | When you bought it. |
| GB | How many GB you added. |
| Price/GB | What the rate was at the time. |
| Total | Amount charged from balance. |
| Source | customer (you bought it from the portal) or operator (your ISP gave you bonus as a goodwill credit). |
This is also where you’d verify a refund — if you accidentally bought too much and your ISP credits it back, you’ll see a balancing entry.
Common workflows
Section titled “Common workflows””I hit my monthly cap and my speed is slow”
Section titled “”I hit my monthly cap and my speed is slow””- Check the Dashboard — Monthly ring is red, FUP tier is 1+.
- Buy Data → see the price per GB and your balance.
- Estimate how much more data you’ll use until the end of the month. Conservative: 10 GB. Aggressive: 30 GB.
- Enter the amount and tap Buy.
- Within 30 seconds, your speed restores. Check the Dashboard — FUP tier should be 0 again.
”I want to pre-emptively buy some headroom”
Section titled “”I want to pre-emptively buy some headroom””- Buy a small amount (e.g. 5 GB) before you hit the cap.
- The new bonus pool sits unused — until you cross the monthly cap, the system uses the monthly quota first.
- Once monthly is exhausted, usage flows into bonus seamlessly. No throttle, no interruption.
- Unused bonus is wasted at month-end — don’t over-buy.
”I bought too much by mistake”
Section titled “”I bought too much by mistake””- Top-up purchases are not reversible from the portal.
- Open a Support Ticket explaining what happened.
- Your ISP can manually issue a refund — they’d add the dollar amount back to your wallet and you’d lose the bonus GB.
- Reversal is at the ISP’s discretion; some allow it, some don’t.
Edge cases
Section titled “Edge cases”| Case | Behavior |
|---|---|
| Price per GB = 0 | The feature is hidden entirely (tab not shown). |
| Tried to buy 0 GB | Rejected: “GB amount must be positive”. |
| Tried to buy fractional GB (e.g. 1.5) | Rejected — only whole GB are allowed. |
| Plan has unlimited quota (monthly_quota = 0) | Buy Data is still available but pointless — you have no cap to hit. The button works but the bonus pool is unused. |
| Speed isn’t restoring after purchase | Wait up to 30 seconds for QuotaSync. If still throttled, your service plan may have a daily cap too (not just monthly). The daily FUP isn’t bypassed by bonus GB — see the Dashboard’s FUP tier indicator. |
Daily FUP vs monthly cap
Section titled “Daily FUP vs monthly cap”This is an important distinction:
- Monthly cap → bonus GB help you. Buying 10 GB removes the throttle.
- Daily cap → bonus GB do not help. Daily throttling is reset at midnight (or your operator’s configured reset hour), not by purchase.
If your speed is slow but your monthly ring is green, you’ve hit a daily cap. Buying bonus GB won’t restore speed — wait until midnight for the daily reset.
Permissions
Section titled “Permissions”The Buy Data tab has no permission gates beyond:
| Condition | Effect |
|---|---|
System topup_data_price_per_gb > 0 | Tab is visible. Otherwise hidden. |
| Customer JWT is valid | Required to make the purchase. |
customer_username ownership | Bonus is added to the logged-in account only. |
Related pages
Section titled “Related pages”- Dashboard & Live Traffic — see the rings turn green after a buy.
- Usage History — confirm bonus GB are being used as expected.
- Change Plan — alternative: switch to a bigger plan permanently.
- Invoices & Receipts — the
data_topuptransaction shows up here. - Support Tickets — request a refund or report an issue.