Top-up and bonus
Top-ups and bonuses are wallet-side ledger entries. When either appears in your ledger, the wallet's micro-credit balance goes up by the delta on the row.
Top-ups are not self-serve from the dashboard today — contact support to add credits to a wallet.
The two ledger reasons
| Reason | Sign | What it means |
|---|---|---|
purchase | positive | A paid top-up landed in the wallet. |
bonus | positive | Extra credits credited to the wallet — typically tied to a purchase row via the linked-pair grouping in Money Audit. |
Both rows touch only the wallet — neither column on any project budget changes until you allocate the new balance.
What you see in Money Audit
Open /account and switch to the Money Audit tab. It has two surfaces:
- Money Journey chart — clicking the Wallet node (or specifically the Top-ups or Bonuses inflow node) narrows the table below to those rows.
- Audit table — one row per ledger event, with the columns documented on the Money Audit page.
Each purchase / bonus row carries:
| Column | Notes |
|---|---|
| At | When the credit landed (UTC). |
| Reason | Purchase or Bonus. |
| Delta | Positive micro-credit delta credited to the wallet. |
| Amount (fiat) | The fiat value snapshotted on the row, when one applies. null for adjustments that are credits-only. |
| Currency | Three-letter currency code. |
| Notes | Free-text annotation attached by the row's creator. |
| Linked | For a bonus row tied to a purchase, the Linked column points at the partner row so Money Audit can render them as a single grouped transaction. |
Reconciling the wallet
At any point in time:
Wallet balance =
sum(purchase deltas)
+ sum(bonus deltas)
+ sum(entitlement deltas)
+ sum(wallet-side Allocation deltas) // negative when moving out
Allocation rows leave the wallet (negative delta) and enter the
target project (positive delta) — both rows share a
LinkedLedgerId so the chart can render them as one transfer.