Resellers
Let other people sell and manage keys for you, with exactly the access you give them and a stock they cannot exceed.
Open it now:Resellers
What a reseller is
A reseller is another Atlas account that you give access to one application. They work in their own dashboard, see only that application and only what you allowed, and what they create appears in your Users list. They never see your API key or your other applications.
Stock, limits, balance keys, invite links, the price sheet and the history are for the owner only. A reseller who holds the Resellers permission can add and remove resellers but cannot hand out stock.
Add a reseller
| Way | How | Starts as |
|---|---|---|
| Invite a reseller | Pick what they can do (Sell keys: see licenses and generate them; Sell and support: also reset a machine, add time, edit and see bans; or Choose permissions one by one), whether to limit them by balance, an optional starting stock and a note for yourself. Send them the link. It works once and expires after 24 hours, and whoever opens it while signed in becomes the reseller, so send it only to them. | The access you chose. Limited by balance unless you turn that off. |
| Add reseller | They give you the organization ID from their Account, Overview page, which looks like xxxxx-xxxxx-xxxxx-xxxxx-xxxxx. Add it, then set their permissions. | No access, and no balance limit until you switch Limit by balance on. A reseller added by another reseller starts limited, with no stock. |
The Resellers permission is never part of an invite: add the person, then grant it from their permissions if you want them to add others. An unknown ID returns No organization with that ID.
The list
Each reseller is a row with their name and email, how much access they hold (Full access, N of 28 permissions or No access yet), when they were last seen and, for you, their balance: Frozen, their stock such as 5 x 1 month, 2 x 1 year, Limited, no stock or No balance limit, and how many keys they made today against their daily limit. The buttons are Balance, Permissions and Remove.
Permissions
Permissions opens a checklist of 28 permissions in groups, each group with an enable-all switch, and Grant all at the top. The same names appear everywhere a page is hidden or a button is missing.
| Group | Permissions |
|---|---|
| Licenses | View, Generate, Delete, Edit (pause, note, level, expiry), Reset license (clears the hardware and IP binding), Modify time, Export. |
| Bans | View, Add, Remove. |
| Logs | View, Clear. |
| Sessions | View, Terminate, Message. |
| Analytics | View. |
| Settings: general | App status, Webhooks, Files, File auth, Resellers. |
| Settings: security | Locks, App hashes, Reset hashes, Alert rules, Geofencing. |
| Settings: other | Messages, Variables. |
A reseller can only grant permissions they hold and cannot edit their own entry. Give the least that lets them sell: usually Licenses View and Generate, plus Reset license for support. Pages the reseller lacks the permission for are greyed out in their sidebar; Getting around lists which permission each page needs.
Balance
Balance on a reseller opens their controls. With Limit by balance on, every license or account they create spends one from their stock, counted by exact validity: a reseller with five 30-day licenses in stock cannot make a 7-day key. With it off they are unlimited.
| Control | What it does |
|---|---|
| Limit by balance | Turns the stock limit on or off. |
| Freeze | Blocks all of their access to the application until you unfreeze. Generating keys is refused with Your access to generate licenses on this application is frozen. Contact the owner. |
| Daily limit | The most keys they can create in 24 hours, limited or not. Empty means no limit. At the limit they are told how many are left. |
| Alert me at | Notifies you once when their total stock falls to this number. Empty means never. |
| Save limits | Applies the four controls above. |
| Add stock, Take back | Changes the stock of one length by hand, with a reason kept in the history. Lengths are 1 day, 1 week, 1 month, 3 months, 6 months, 1 year, lifetime, and any length on your price sheet. |
| Send a balance key | Makes one single-use code that only this reseller can redeem. |
A limited reseller without enough stock is told Not enough stock: you have N licenses of D days left.
Balance keys
A balance key tops a reseller up without you opening their entry: a single-use code that adds a bundle of stock. Generate balance keys asks for:
- What each key adds: how many of each length, up to 20 lines.
- How many keys: 1 to 100, each one used once.
- Valid for: 7, 30 or 90 days.
- Who can redeem: any reseller of the application, or one reseller only. Whoever holds the code can use it, so send an open key only to resellers.
- Label: optional, for your own list.
The codes look like ATLAS- followed by 20 characters. They are shown once and Atlas keeps only a fingerprint, so copy them at once: Copy all keys, Download .txt or Copy as a message, which writes a note for the reseller. Closing without copying asks first.
The reseller redeems a key on their Users page: Redeem a balance key. After 8 failed attempts in 15 minutes they must wait before trying again; successful redemptions never count. The page also shows their balance, daily use, price sheet and history.
Under your list, Balance keys shows each key with its label, who it is for and the end of the code, and its state: Waiting, Redeemed, Withdrawn or Expired. Withdraw stops a waiting key at once; a batch has a Withdraw N shortcut. Keys already redeemed stay redeemed. Invite links beside it lists invites the same way, with Accepted for one that was used.
Price sheet and history
Price sheet sets what each license length costs your resellers, with an optional label and a price in dollars. Resellers see it on their Users page. It is a reference only: Atlas charges nobody.
History on a reseller, or History of all resellers, lists every change to stock, newest first: Added, Key redeemed, Created, Returned, Adjusted and Taken back, with the amount, the time, who did it, the reason and the first three keys involved.
Remove a reseller
Remove cuts their access to the application after a confirmation. The licenses and accounts they created stay. Remove All Resellers in the application's actions menu does it for everyone. What a reseller creates counts against your plan's limits like any other key.