Whitelabel Reseller Manager - Knowledge Base
Welcome to the Knowledge Base for the Whitelabel Reseller Manager module. Here you will find answers to common questions and troubleshooting tips.
General Questions
What is the Reseller Manager?
The Reseller Manager module allows you to turn your WHMCS clients into Resellers. They can manage their own sub-clients, set their own prices for your products, and operate under their own brand name and logo.
How does the White Label functionality work?
The module uses "Theme Overrides" and "Email Hijacking" to ensure your sub-clients see your Reseller's branding instead of the main Admin branding.
- Client Area: When a sub-client logs in, the Reseller's Logo and Company Name are dynamically injected into the template.
- Emails: Emails sent to sub-clients are intercepted and sent via the Reseller's configured SMTP server, ensuring the "From" address and signature match the Reseller's identity.
Does the module support custom domains (CNAME)?
Currently, the module overrides the branding elements (Logo, Company Name) on your existing domain. Sub-clients will still visit your main WHMCS URL, but the interface will appear branded as the Reseller. (Note: Custom Domain mapping requires additional server-side configuration not covered by this module out-of-the-box).
Troubleshooting
My sub-clients are receiving emails from the Main Company, not the Reseller.
This usually happens if the Reseller has not configured their SMTP settings correctly.
- Check SMTP Settings: Have the Reseller log in and go to the Branding tab in their dashboard. Ensure SMTP Host, User, Pass, and Port are correct.
- Test Connection: If the SMTP credentials are invalid, the system may fall back to the default PHPMailer to ensure delivery.
- Check Client Mapping: Ensure the sub-client is correctly listed in the Reseller's Clients list.
I get an "Access Denied" error when trying to access the Reseller Dashboard.
Only clients assigned to the "Reseller" Client Group can access the dashboard.
- Go to WHMCS Admin > Clients > View Client.
- Click on the Profile tab.
- Change Client Group to Reseller.
- Save Changes.
Why can't I see the "Download Invoice" button as a sub-client?
The "Download Invoice" button is intentionally hidden for sub-clients. This is because the generated PDF invoice would default to the Main Admin's branding (which breaks white-labeling). The web view of the invoice, however, is fully branded with the Reseller's details.
"Insufficient Credits" error when provisioning.
Resellers must have a positive Credit Balance to provision services. The cost of the service (Wholesale Price) is deducted immediately.
- Solution: The Reseller should "Add Funds" to their account via the standard client area billing page.
Billing & Finance
How do I set the wholesale price?
The "Wholesale Price" is the price defined in WHMCS Admin > Setup > Products/Services. This is the cost the Reseller pays you. The Reseller then sets their own Selling Price in their Dashboard.
Who collects the payment from the sub-client?
The Reseller is responsible for collecting payments from their sub-clients (off-platform or via their own means).
- Your Relationship: You bill the Reseller (via Credit Balance deduction).
- Reseller's Relationship: The Reseller bills the Sub-Client. The module generates an invoice for the Sub-Client showing the Selling Price, but it does not process the payment gateway for them. The Reseller usually marks the invoice as Paid manually or manages it externally.
Can I refund a provisioned service?
If you refund a transaction in WHMCS Admin, you must manually adjust the Reseller's credit balance if you wish to return the funds. The module does not automatically refund credits upon termination.
