Balance and ledger
Path: /org/billing
The enterprise balance is one shared pot
Members and enterprise shared keys both draw on the same shared balance. This is not “each member tops up their own wallet” — a member quota is an extra personal constraint layered on top of the shared balance, not a separate wallet.
What gets charged first
- If the caller is a member and enterprise billing is on for members → the enterprise balance.
- If the enterprise balance is insufficient:
- “personal wallet fallback” allowed → the member’s own balance;
- not allowed → the request is rejected (
403).
- Shared keys skip step 2: they only draw on the enterprise balance, and are rejected when it is short — never charged to the caller’s personal balance.
The ledger
Every balance movement, in two entry types:
| Type | Meaning |
|---|---|
| Platform adjustment | Quota changes made by the platform operator (credit, debit, or set balance) |
| Online top-up | Credits through the console’s online top-up flow |
Each entry records the balance before and after, plus a note, and the ledger exports to CSV.
Overdraft
The enterprise balance may go negative. This matches how personal wallets behave, and it exists so that pre-authorised amounts reconcile with post-settlement balance movements: when the settled amount exceeds the pre-authorised one, the difference is charged. Member period counters never go negative as a result.
How topping up works
These docs commit to no particular top-up method. Whether online top-up is open, which channels exist, settlement timing, refunds and invoicing are all governed by what the billing page in the console actually offers. If the page does not offer it, it is not currently available.
The platform has not published unified rules for refunds, invoicing, balance validity or contract settlement. Before making a purchasing decision, read the main site’s Service and data processing page and confirm what applies.
To be completed: top-up channels, settlement timing, invoicing process, balance validity, refund rules. All require an official position from the business first.
Export
The ledger exports to CSV, preserving the current type filter.
Related
- Settings — enterprise billing and personal-wallet fallback switches
- Usage — consumption aggregates
- Request logs — individual calls