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
Resellers list
Resellers list — Partners with their balance, commission rate, tenant count and user count.

Creating a reseller

POST /api/v1/admin/resellers
ParameterTypeRequiredDescription
usernamestringRequiredSign-in name. Must be unique.
passwordstringRequiredInitial password.
full_namestringRequiredContact name.
business_namestringOptionalTheir own trading name.
emailstringOptionalContact email.
phonestringOptionalContact phone.
addressstringOptionalAddress.
commission_pctdecimalOptionalCommission percentage on their business.
opening_balancedecimalOptionalBalance to start them with, in IQD.

What the list shows

ParameterTypeRequiredDescription
reseller_idintegerOptionalIdentifier.
balancedecimalOptionalTheir remaining balance, in IQD.
commission_pctdecimalOptionalTheir commission rate.
tenant_countintegerOptionalHow many businesses they manage.
user_countintegerOptionalHow many users across those businesses.
is_activebooleanOptionalWhether the account is enabled.

Crediting a reseller

POST /api/v1/admin/resellers/{id}/topup
ParameterTypeRequiredDescription
amountdecimalRequiredAmount to credit, in IQD.
notesstringOptionalPayment 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

ParameterTypeRequiredDescription
PUT /admin/resellers/{id}/toggleendpointOptionalEnable 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

Notecommission_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