Thanks to Resellers Center For WHMCS, your resellers will be allowed to collect dedicated customers and select for them specific products, services and domains.
Moreover, the module enables end clients to perform convenient orders of services straight from your WHMCS.
What is more, they will be able to log in to their own WHMCS account with regard to handle their services, formulate tickets and pay invoices.

No worries, we will guide you step by step through the entire installation process.

Note: If you still use any of Resellers Center For WHMCS previous versions prior to v3.x, read about it here.

In the most recent versions of the module, you will find only one package that supports PHP 7.1 and later.
If you need a package for the previous versions of PHP, please contact our support.

The first one that supports PHP 5.6 up to PHP 7.0, and the second one addressed to PHP 7.1 up to PHP 7.3.
Note: Keep in mind that PHP versions 5.6 up to 7.0 are no longer officially supported and their security issues are not fixed or released any more. Find more info here.

The content of the chosen PHP version files to upload should look like this.

The file is located in 'modules/addons/ResellersCenter/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'.

Enter your license key between quotation marks as presented on the following screen.
You can find your license key in our client area → 'My Products'.

They are located in: 'your_whmcs/modules/addons/ResellersCenter/'.

Log in to your WHMCS admin area. Click 'Setup' then choose 'Addon Modules'.
Afterward, find 'Resellers Center' and press the 'Activate' button.

To do so, select the admin roles which should have access to the module.
You might as well enable hooks to ensure that all the module's functions work as intended (recommended).
Optionally, choose whether you want to allow your reseller's end-clients to perform orders in your main store or to make them purchase products only through the reseller's store.
Finally, decide whether the services ordered by clients via the reseller's store should be shown or hidden when a client logs in to the administrator's main store instead of to the branded reseller's store.

Press 'Save Changes' when ready.

Note: Please keep in mind that WHMCS versions prior to V7.7 are no longer officially supported by the module.

What is more, the module extends possibilities of both your resellers and their customers.
Let us find out what our product can do!

Additionally, here you can also read about the details of migration.

Please note that these settings are default for all resellers. Read this section through to find the details of configuration per each reseller.

• Enable Store Branding - Allows resellers to set up a custom logo, company name and domain.
• Allow Products - If enabled, resellers will be able to sell properly configured products in their own stores.
• Allow Domains - Gives resellers possibility to sell domains in their own stores.
• Allow CNAME - It enables the support for CNAME record pointing from the customer's domain. A new field named 'Domain' should appear in the 'Configuration' section of the 'Reseller Area'
• Allow Promotions - If enabled, the reseller's end-clients will be able to the use promo codes in the reseller's store configured by the resellers in the 'Promotions' section.
• Show Hidden - If enabled, the hidden products and groups will be visible to resellers' clients.
  Thanks to that functionality, there is a chance to configure special products destined for resellers exclusively. These will not be accessible in the main Administrator's store.
  
• Default Reseller Documentation - Select the default documentation to show for new resellers.
• Ticket Departments - Allows you to choose ticket departments available for end clients as they will contact resellers.
• Templates - Allows you to select client area templates of the reseller store.
• Order Templates - Allows you to select order templates set for a cart view in the reseller store.

• PayPal Auto Transfer - Enables automatic transfers to a reseller's account.
• Invoice Branding - If enabled, resellers can brand the number and basic information on the invoice.
• Reseller Invoice
  • When the 'Reseller Invoice' option is off:
    When end clients place orders in the reseller store, the invoice will be created by WHMCS with the admin details (provided earlier in 'General Settings' ).
    Once the invoice is paid, the module calculates the profit in accordance with the product configuration in the reseller group.
    The calculated amount goes to 'Payouts' where the admin can transfer it via PayPal or credits to the reseller account.
    Find out more about calculation and pricing methods here.
    
  • When the 'Reseller Invoice' option is on:
    There are two invoices generated after placing an order in the reseller store. The first invoice is created by the reseller and sent to the client
    while the other one is generated by the admin and delivered to the reseller. The amount invoiced is taken directly from the admin charge for the product (reseller group configuration).
    In this case, calculation methods are not included and the reseller earns on price differences between invoices.
    Moreover, this option also permits resellers to use their own configuration data in payment gateways settings.
    Once they do it, end clients are able to make payments directly to the reseller account and the reseller settles debts with the administrator using prepaid WHMCS credits.
    Important: When you enable this option and any invoice is created in the meantime, you will not be able to disable it anymore!

• Sequential Invoice Number Format - Required if 'Reseller Invoice' is enabled.
• Gateways - Allows you to select gateways that resellers can enable in their own stores. This option is only available if 'Reseller Invoice' is disabled.

• General
• Product
• Domain
• Support
• Invoice

• Turn Off End Client Invoices - If this option is set to enabled, the end client will not receive the created invoices.
• Credit Payment - This option, when enabled, gives the reseller's clients the possibility to pay using credits.

• Turn Off Login To Main Brand - If this option is enabled, the reseller's clients will not be able to log into the main WHMCS store.
• Turn Off KnowledgeBase - This option allows you to disable access to the KnowledgeBase for the reseller's clients.
• Allow Promotions - This option enables the promotions in the reseller's store.
• Allow Mail Wrappers Change - If this option is enabled your resellers will be able to change a global mail header, footer and CSS for their email messages.
  Important: If enabled, please inform the reseller that the fields are obligatory. If left empty or filled in incorrectly issues with emial templates formatting are bound to occur.
  Exemplary settings can be found in 'WHMCS Setup' → 'General Settings' → 'Mail'.
  
• Hide Login As Client action - if enabled, the reseller has no access to the 'Client Details' page in the Reseller Area.
• Hide Client Details action - if enabled, the reseller has no access to the 'Login As Client' feature in the Reseller Area.

We will show you how to set up key options to ease the module's handling processes.

To do so, proceed to the 'Pricing Groups' tab and click the button as shown below.

To add a new product press the button as presented below.

• Edit Pricing (1)
• Edit Calculation Method (2)
• Delete Product (3)

You can define pricing using the below options:

• Admin Price - price set for a product (it may be lower than what reseller sets when this difference will be the basis to calculate a profit)
• Highest Price - maximum price which can be set for a product
• Lowest Price - minimum price which can be set for a product

To confirm settings, press 'Save' .

• Fixed Rate - profit that your reseller always gets
• Difference - between reseller's and admin's price
• Percent Rate - percentage of reseller's price
• Percent From Difference - a sum of reseller's price percentage and a difference between reseller's and admin's price
• Admin Percent With Fixed Rate - a sum of admin's price percentage and a fixed rate
• Reseller Percent With Fixed Rate - a sum of reseller's price percentage and a fixed rate

To confirm settings press 'Save' next to the product you have configured.

Click the right button to add a new addon.

You can use it to assign any client to a reseller's group, that will activate them as resellers.
Click the button as shown below to create a new reseller.

Apart from clients, you can manage also invoices, transactions and services.

Please note - this tab is only used if the 'Reseller Invoice' configuration is set to 'Disabled'.
Otherwise, the resellers settle debts with the administrator using prepaid WHMCS credits and payments made by end clients are credited to the reseller's account directly.

In the 'Payouts' section, apart from looking at the details it is also possible to perform the following actions: pay by PayPal (1) or WHMCS Credits (2) and mark the transaction as completed (3).
The 'Mass Payments' section enables you to make mass payouts to all selected resellers at once. You can choose from PayPal Payment (4), WHMCS Credits Payment (5) and set up proper
PayPal Configuration by providing PayPal Application Key and Secret - both found within your PayPal account.

Note: Please keep in mind that WHMCS versions prior to V7.6 are no longer officially supported by the module.

The 'Reseller Documentation' tab enables you to create and modify the documentation visible to specified resellers. The documentation provides guidelines to help resellers handle their panels with ease.
You can create the documentation in multiple versions - to add a new one, simply click the '+' button. Press the appropriate button located in the 'Actions' column to manage already formed documentation:

Choose the resellers to whom the documentation will be visible, enter the name of the documentation and its content.
You can use HTML tags as well as attach a PDF version of your documentation.
Once ready, click 'Save' to save your documentation.

From now on, our resellers will be encouraged to read the documentation from the welcome page, when they enter the 'Reseller Area' for the first time.
Reseller can hide the welcome page by pressing "Do not show again". Even then, the documentation is accessible from the menu:

Access to the 'Reseller Area' is granted only to those clients, to whom reseller's groups are assigned in the Resellers Center For WHMCS module.

It is possible to log in as a client (1), make an order for a client (2), view client's details (3) and delete a client (4).

Remember to save changes.

Remember, you can define prices only within limits shown as placeholders.
If pricing is not provided, product, addon or domain will not be available for your clients.
You can also get here a direct cart URL to products group that you can share directly with your customers.

Please notice, that the available reseller configuration options may vary depending on the options you selected in the addon configuration and whether the 'Reseller Invoice' option was enabled for the reseller.

Note: Once the configuration of your brand is complete, your reseller will still need to set up a CNAME DNS record if domain is used.
This record will point from the branded domain towards the reseller main domain used by WHMCS.

• For example: if 'Reseller Invoice' is disabled there will be an option to provide reseller PayPal emails but resellers will not be able to configure available payment gateways on their own:

• However if 'Reseller Invoice' is enabled there will be an option to configure payment gateways by resellers or enable 'Auto WHMCS Invoice Payments' .

• Should you decide to enter the URL to your 'Terms of Service' page, an additional field will appear during the ordering process.

Provided the option 'Allow Mail Wrappers Change' has been enabled for the reseller, empty fields to edit the CSS Styling, Header and Footer will appear.
Important: If this option is available, you must fill in these three fields correctly or otherwise issues with email formatting are sure to occur.
You may use and alter general WHMCS settings available under: 'WHMCS Setup' → 'General Settings' → 'Mail'.
To edit an email template, press the 'Edit' button next to the template you wish to alter.

Note: During this step you can easily add merge fields using dropdown menus marked on the following screen.

In this section, the reseller can set up their own payment gateway ('PayPal', 'Stripe', 'Bank Transfer', '2Checkout, Authorize.Net Aim', 'Checkout.com', 'Payflow Pro', 'Billplz'
and 'WePay' gateways are currently available).
Thanks to this, all payments made by end clients are transferred directly to the reseller's PayPal account or bank institution.
The payments between the reseller and the administrator are settled through the reseller's previously supplied credit balance.

• If the 'Reseller Invoice' option in the admin area is 'Disabled' , the listed invoices are generated between the end client and the site administrator.
• If the 'Reseller Invoice' option in the admin area is 'Enabled' , the listed invoices are issued between the end client and the reseller directly.

• Create - press to create the invoice draft, the invoice will not be available for the end client yet
• Publish - an invoice is created, it is available for the end client instantly
• Publish and Send Email - an invoice is created and an additional email is sent to the client

Note: You must first enable them in your 'Configuration' section of a specific reseller.
Resellers can use the promo codes created only via the module itself, default WHMCS promotions cannot be applied.

• Promotion Code - You need to create a new code, your customers will need it to receive a discount.
• Type - Choose one of the available promotion types.
• Recurring - Once set, a discount will apply to renewal invoices. If the field's value is set to 0, all future renewals will be discounted.
  Enter a different number to specify the exact sum of cycles the discount will last for.
• Value - Provide the amount of the discount.
• Start Date - Optional. In case a date is selected, the promotion will start working after the set date.
• Expiry Date - Optional. The promotion will stop working at the end of the chosen day.
• Max Uses - Optional. By proving a number you can define the number of allowed uses.
• Uses - Current usage of the promo code.
• Applies To - Select what products/addons/domains are eligible for the promotion.
• Requires - Choose products/addons/domains that are required for the promotion to be applicable.
• Billing Cycles / Periods - Decide which billing cycles and periods are required for the promotion to apply.
• Lifetime - In that scenario, a discount will be preserved even if clients upgrades/downgrades their service in future.
• Apply Once - In case of ordering multiple qualifying products, a discount will be applied once.
• New Sign Ups - The promotion can be used by new clients only.
• Once Per Client - When a client has already an existing active order a second use of the code will not be possible.
• Existing Client - The promotion can be used only by existing clients with 1 or more active orders.

• Upgrade Type - Select a suitable type of the upgrade the promotion applies to.
• Discount Type - Choose a type of the upgrade promotion.
• Discount Value - Enter a rate of the discount.
• Upgrades Of Configurable Options - Provide an amount of the discount.
• Notes - Any notes will be visible for you and for administrators exclusively.

Afterward, when an end client logs in to the WHMCS client area, he/she will be able to view and manage previously ordered products.
End clients can also list and pay invoices or create tickets (if these options are checked in the addon module).

Therefore, your reseller's clients can place orders on their own, using order forms in the client area.

It is only available for tickets department set in the Resellers Center For WHMCS configuration.

Since the version 3.x of the module end clients are treated as regular WHMCS clients.

In general, Reseller receives a product from the Provider and then provides it further to the End Client.
Since the release of v3.0.0 the payment between the Reseller and Provider will be regulated by WHMCS credits but it can be also regulated manually or automatically to the Reseller's PayPal account.

• If the 'Reseller Invoice' option in the admin area is Disabled, the invoices are generated between the end client and the site administrator.
• If the 'Reseller Invoice' option in the admin area is Enabled, the invoices are issued between the end client and the reseller directly.

For instance, if a reseller's branded domain is 'reseller.com' and the domain with your WHMCS is 'whmcs.domain.com' , the CNAME needs to be 'www.reseller.com. CNAME whmcs.domain.com.'.
Note 1: As you can see above, each domain has to be closed with a full stop.
Note 2: To learn more about certificate requirements, visit the SSL Certificate section.

Only when you have parked your domains can you move to setting the CNAME records on your panels. See the tips below.

Note: This step is required only if you own more than one domain.

Note: To define the record's TTL, you have to use 'Advanced DNS Zone Editor' .

Note: Do not forget to place a full stop at the end.

Afterward, proceed to the 'Websites & Domains' tab and press 'DNS Settings' .

Finish by pressing 'OK'.
Note: The changes will take between 4 to 8 hours to update worldwide.

The supported types of certificates:

• Dedicated SSL Certificate - handled separately for each domain.
• Wildcard - if all brands and main WHMCS use the same domain.
• SAN - if your brands and main WHMCS use different domains.

This is the way WHMCS works. It is not the limitation of our module which uses the 'WHMCS System URL' scheme.

Note: AutoSSL function will rather not work for CNAME entries so you should use virtual hosts (vhosts) instead.

For example, reseller.com/main-whmcs-directory instead of reseller.com..
You can change that behavior through adding the below code to .htaccess file:

RewriteEngine on
RewriteCond %{HTTP_HOST} !^main-whmcs-domain.com$ [NC]
RewriteCond %{REQUEST_URI} !^/whmcs-directory/
RewriteRule ^(.*)$ /whmcs-directory/$1 [R=301,L]

Result: If hostname is not main-whmcs-domain.com and path is not whmcs-directory', then redirect to resellers domain with /whmcs-directory.

When you upgrade the module from the version older than 3.5.0 to 3.5.0 or newer, please remember to set writable permissions to the 'config' directory, as described in step 6. of the installation guide.

Please keep in mind that there is a quick and easy option in our client area to upgrade the license of your module to an open source version at any time - and at a lower price!
To take advantage of it, simply use the License Upgrade button located on the product page and the discounted invoice will be generated automatically.

Note: Version 3.x currently supports migration from the version 2.5.x of the module and it will only transfer data on resellers, resellers' clients and resellers' groups.
Therefore, the other settings of the module need to be reconfigured manually.

To perform the migration simply overwrite old files to the latest version of the module and refresh the addon page in the admin area.

Otherwise, WHMCS will route visitors to the main WHMCS and not the reseller store. Keep in mind that when WHMCS creates the redirection, the domain is changed as well.

• Multibrand For WHMCS
• SMS Center For WHMCS (due to e.g. separate email templates used)
• Discount Center For WHMCS (due to e.g. not branded invoices)
• Quotes Automation For WHMCS (due to e.g. not branded emails or invoices)
• Hosting Quota Notifications For WHMCS (due to e.g. not branded emails)
• Zendesk For WHMCS, Freshdesk For WHMCS and Kayako For WHMCS (due to e.g. not branded ticket messages)
• CRM For WHMCS (due to e.g. not branded emails)
  

Integration between these modules is hampered due to specific features of each one of them and their individual work flow.
That is: separate email templates used or common hooks that override one another (Multibrand and Discount Center), etc.
We are continually working on eliminating these limitations wherever possible.