Feature Request: Reseller plans, so reseller accounts can be sold and provisioned automatically through billing systems (WHMCS, WiseCP, FOSSBilling, Blesta)

[justiceakorede]

Summary

Add Reseller Plans (packages), so that a reseller account can be created from a template with preset limits, in the same way User Packages work for normal users. Expose these through the API, so billing systems can sell and provision reseller hosting automatically.

Problem

Normal hosting accounts can be fully automated. A customer buys a plan in WHMCS or WiseCP, the billing system calls the API with the plan name, and OpenPanel creates the user with the limits from that plan.

Reseller accounts can't be sold the same way. Looking at the Resellers documentation, a reseller is created from Accounts > Resellers > Create New with only a username and a password. The limits (Max Accounts, Max Disk Usage, and which Hosting Plans the reseller can assign) are set afterwards, per reseller, in Edit Plans & Limits.

This means an administrator has to:

1. Wait for the order in the billing system.
2. Manually create the reseller in OpenAdmin.
3. Manually set the limits to match what the customer paid for.
4. Copy the details back into the billing system.

This makes selling reseller hosting a manual process, which doesn't scale and delays delivery to customers. It also means the reseller limits can drift out of sync with the product the customer actually bought.

Proposed solution

1. Reseller plans

A new section, for example Hosting Plans > Reseller Plans, where the administrator can create named plans that define:

• Max accounts (or unlimited).
• Max disk usage.
• Which user hosting plans resellers on this plan may assign to their customers.
• Any other reseller-level limits that exist now or later (for example bandwidth, domains in total, whether branding is allowed).

2. Create a reseller from a plan

When creating a reseller, whether through OpenAdmin or the API, the administrator or billing system can choose a reseller plan. The limits are applied automatically.

3. API support

The API should allow:

• Creating a reseller with a username, password, email and reseller plan.
• Changing a reseller's plan (upgrade or downgrade), which updates their limits.
• Suspending, unsuspending and terminating a reseller.
• Reading a reseller's current usage (accounts and disk), so billing systems can show it to customers.

With this in place, existing billing modules could add reseller product support, and a customer could buy a reseller plan and have an account ready within seconds.

4. Behaviour on plan change

When a reseller's plan changes, the new limits should apply to the reseller. If the new limits are lower than current usage (for example fewer allowed accounts than the reseller already has), the system should either block the downgrade with a clear message or leave existing accounts as they are and prevent new ones from being created.

Why this matters

• Reseller hosting is a common, recurring-revenue product for hosting providers, and many want to sell it automatically.
• Automation is what billing integrations are for, and reseller accounts are currently the one account type that can't use it.
• It reduces manual work and the mistakes that come with it, such as setting the wrong limits.
• It's consistent with how User Packages already work.

[stefanpejcic]

Currently this file is used for all new resellers /etc/openpanel/openadmin/config/reseller_template.json so edit limits in that. I'll check docs and update if not mentioned.

Regarding multiple plans for resellers, I'll add it on TODO