Admin Guide
Resellers
Partners who sell and support DigitalKey to their own customers, funded from a balance you credit.
Last updated 2026-10-13
DigitalKey ERP — Docs · digital-key.co/docs/admin/resellers
Overview
A reseller sits between the platform and a group of businesses. They create tenants and users, and they fund those users from their own balance. Their accounts live in a separate table and are not attached to any tenant.
Admin — Resellers list

Creating a reseller
POST /api/v1/admin/resellers
| Parameter | Type | Required | Description |
|---|---|---|---|
username | string | Required | Sign-in name. Must be unique. |
password | string | Required | Initial password. |
full_name | string | Required | Contact name. |
business_name | string | Optional | Their own trading name. |
email | string | Optional | Contact email. |
phone | string | Optional | Contact phone. |
address | string | Optional | Address. |
commission_pct | decimal | Optional | Commission percentage on their business. |
opening_balance | decimal | Optional | Balance to start them with, in IQD. |
What the list shows
| Parameter | Type | Required | Description |
|---|---|---|---|
reseller_id | integer | Optional | Identifier. |
balance | decimal | Optional | Their remaining balance, in IQD. |
commission_pct | decimal | Optional | Their commission rate. |
tenant_count | integer | Optional | How many businesses they manage. |
user_count | integer | Optional | How many users across those businesses. |
is_active | boolean | Optional | Whether the account is enabled. |
Crediting a reseller
POST /api/v1/admin/resellers/{id}/topup
| Parameter | Type | Required | Description |
|---|---|---|---|
amount | decimal | Required | Amount to credit, in IQD. |
notes | string | Optional | Payment reference or reason. |
NoteReseller balance is the float they draw on. When a reseller tops up one of their users, the amount comes out of their balance and lands in the user's — money moves between the two rather than being created.
WarningA reseller with an empty balance cannot fund their customers. If a partner reports being unable to top anyone up, check their balance first — the cause is usually here rather than on the customer's account.
Disabling a reseller
| Parameter | Type | Required | Description |
|---|---|---|---|
PUT /admin/resellers/{id}/toggle | endpoint | Optional | Enable or disable the reseller account. |
ImportantDisabling a reseller stops them signing in. It does not disable the tenants or users they manage — those businesses keep trading and keep being billed. To stop a whole customer base you have to disable the tenants as well.
Commission
Note
commission_pct is recorded on the reseller record for your own commercial arrangements. It does not change how end users are billed and does not alter deduction amounts.Related
- Reseller Guide — what a partner sees.
- Balance Management — how their float is consumed.
- Managing Tenants — assigning a business to a partner.