Reseller Guide
Balance Management
Your balance is the float you fund customers from. Running it dry is the most common reason a reseller's customers get suspended.
Last updated 2026-10-13
DigitalKey ERP — Docs · digital-key.co/docs/reseller/balance
How the money moves
Flow of funds
Platform admin
│ credits your reseller balance
▼
Reseller balance ──────────┐
│ you top up a user │ your balance decreases
▼ │ their balance increases
User balance ◄─────────────┘
│
▼ monthly deduction on their billing day
Platform revenueReseller — Balance screen

What consumes your balance
- Topping up an existing user.
- Creating a user with an opening balance.
NoteSubscribing a user to features does not touch your balance. Features are charged to the user on their own billing day, out of their own balance. Your float is only consumed when you move money into a user account.
The balance log
GET /api/v1/reseller/balance-log
| Parameter | Type | Required | Description |
|---|---|---|---|
amount | decimal | Optional | Amount of the movement, in IQD. |
notes | string | Optional | Reference or reason recorded with it. |
created_at | timestamp | Optional | When it happened. |
The log holds both directions: credits added by a platform administrator, and amounts you have passed on to customers.
TipUse the notes field consistently when topping customers up — a payment reference or an invoice number here is what lets you reconcile the log against what you have actually collected.
Getting more balance
You cannot credit yourself. Balance is added by a platform administrator, normally after you have paid for it under your commercial arrangement.
ImportantPlan ahead. With an empty float you cannot fund anyone, and a customer whose deduction fails is suspended after the first grace period and deactivated after the second — ten days on the default settings. Waiting until the balance is at zero puts your customers at risk, not just you.
How much to hold
A workable rule:
- Add up
total_monthly_costacross all your tenants — the tenants list shows this per business. - Hold at least one month of that as float.
- Hold two months if your own collection cycle is slow.
WarningRemember every user is billed separately. A business with four staff on paid features costs four times one user's subscription, not one. The per-tenant monthly cost figure already accounts for this — use it rather than estimating from the number of businesses.
Related
- Managing Users — topping up a customer.
- Lifecycle States — what happens when a customer runs out.
- Features & Pricing — working out monthly costs.