💳 What this article covers
This article explains how a bonus credit grant relates to a credit allocation, how to compare your own math with the balance shown in Search Atlas, and what to send if the numbers still do not match. It is for customers who were promised a percentage bonus on a specific grant and believe that bonus is missing or that unused credits were calculated incorrectly. A 10% bonus, such as 50 credits on a 500-credit allocation, is only an example of a promotion that was actually offered. It is not added to every allocation.
📊 How bonus credits are calculated
A qualifying allocation can include a 10% bonus. The bonus is based on the credits allocated in that grant, not on the credits you still have left later.
- Example: if a promotion adds 10% to a 500-credit plan base, the bonus grant is 50 credits. A different promotion, or a different plan base, produces a different bonus. The bonus is calculated once from the plan base for that quota at grant time and then stored as a fixed amount.
- The bonus is tied to that allocation. It is not recalculated from your remaining balance.
- Your visible balance is the total of your active credit grants minus usage in the current cycle. Monthly plan credits and purchased credits are shown separately. Monthly credits reset when the billing cycle renews, while purchased credits remain. A bonus is already included in the grant it was added to, so do not add it again to the number on screen.
- Using the example, 235 credits used from a 550-credit allowance (500 base plus a 50-credit bonus) leaves 315 credits in that allowance. If the screen shows only the 500 base credits, 235 used leaves 265 base credits, and the 50-credit bonus is not present. Do not add 50 to 265 unless you have confirmed that the bonus grant exists and was not already included.
If you exclude the bonus from your own total, your number will look lower than the platform even when the bonus was applied. If you expected the bonus on top of an already complete balance, confirm whether that balance already includes it.
🛠️ Check your balance before you dispute it
Open your account menu, select Billing, and write down the Universal Credits figures shown there: available credits, the monthly allowance, purchased credits, and credits used this cycle. If a Quota Log tab is shown, open it and write down the rows for the grant you are checking before comparing totals.
- Note the date and size of the latest allocation, for example 500 credits.
- In Quota Log, look for a Promotional row for the same quota and grant. Its amount is the bonus that was stored. For a 10% offer on a 500-credit plan base, that amount is 50 credits. There is no separate bonus line on the Universal Credits card. If no Promotional row exists, the bonus was not granted or was already included in the allowance.
- Add allocation and bonus to get the starting total for that grant.
- List every use of that same quota after the grant date. In Universal Credits mode, enabled tools share the Universal Credits balance, so include content, reports, and other Universal Credits actions. Usage of a different quota, such as Hyperdrive Credits, does not reduce this balance. Quota Log shows these rows as Used.
- In Quota Log, subtract Used rows recorded after the grant. Also account for any Reset, Refund, or new Allocated rows, including a monthly renewal reset and a plan change. The log does not use the labels expiration, reversal, or plan change.
- Compare that result with the balance shown today.
For one grant in the current cycle, check remaining balance = allocation + bonus − usage of that quota − other posted adjustments such as refunds and resets. If the on-screen balance already includes the bonus, do not add the bonus again. At renewal, unused monthly credits reset, so do not carry this result into the next cycle.
💡 Common reasons the math does not match
- Bonus already included: the on-screen balance contains the 10% bonus, while your notes count only base credits.
- Usage after the grant: credits spent between the allocation and today are easy to leave out of a manual total.
- More than one balance event: an earlier allocation, top-up, or partial grant can change the starting point.
- Shared or team usage: work started by another user on the same account still reduces the balance.
- Adjustments: refunds, corrections, expirations, or plan changes can add or remove credits outside the original 500 + 50 math.
- Timing: a bonus can post shortly after the base allocation, so a check made in between can look short.
🚀 What to send if it still looks wrong
If your recalculation still does not match the balance, gather these details so the review is faster:
- The allocation amount and date, such as 500 credits.
- The bonus you expected, such as 50 credits, and whether you see that line in history.
- Your expected remaining base credits, such as 265, and the total you believe should show after the bonus.
- The exact balance shown in the platform today.
- A short list of usage you already subtracted.
Our team can then compare your notes with the credit ledger and explain any line that is missing from a manual total. Do not start a second allocation or purchase solely to fix a suspected bonus until the ledger has been reviewed.
⚙️ Good to know
Bonus credits are part of the same usable balance unless your plan history shows a separate restriction. They are not a second balance that must be tracked in another screen. A dispute is appropriate when the ledger has no bonus line, the bonus is not 10% of that allocation, or usage and adjustments still do not explain the gap.
If you need further assistance, open the chat widget in the bottom-right corner of the platform and send your message. A member of our support team will reply in the chat.