Personal tools
Namespaces

Variants
Actions

Products Reseller For WHMCS

From ModulesGarden Wiki
(Difference between revisions)
Jump to: navigation, search
(Created page with ":)")
 
Line 1: Line 1:
−
:)
+
<meta name="keywords" content="products reseller for whmcs, products reseller configuration, whmcs products reseller management, whmcs products reseller installation, whmcs products reseller common problems, about whmcs products reseller, whmcs products reseller documentation, whmcs products reseller faq, whmcs products reseller help, whmcs products reseller guide, whmcs products reseller wiki, whmcs products reseller tutorial, whmcs products reseller tips, whmcs products reseller wiki"></meta>
 +
<meta name="description" content="ModulesGarden Wiki Contains All The Information You Need About The Domains Reseller For WHMCS Module."></meta>
 +
 
 +
=About [https://www.modulesgarden.com/products/whmcs/products-reseller Products Reseller For WHMCS]=
 +
{|
 +
|style="padding: 10px 0px 5px 0px;"|'''Products Reseller For WHMCS''' brings you automation and comfort into reselling your products, following income as well as managing the reseller groups. <br />
 +
As a provider, you are able to handle all details of your reseller groups and set up pricing rates for each product in a particular group effortlessly.<br />
 +
Moreover, your resellers grant all crucial information about placed orders along with API documentation. As for end clients, they are able to buy preferred products and perform basic actions on them later.
 +
|}
 +
<!--a comment maybe? -->
 +
*'''Provider:'''
 +
{|
 +
|style="padding: 10px 0px 0px 30px;"|✔ View Resellers And TLDs Income Statistics
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ View Most Profitable Resellers And Latest Invoices
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Create And Manage Resellers:
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Assign To Dedicated Group
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Assign Client's Account
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Generate Access API Key
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Restrict Access To Specific IP Addresses
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Allow API Access
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Define API Limits Interval And Requests
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ View Reseller's Orders And Income
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Create And Manage Groups:
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Allow API Access With Defined Permissions
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Allow Access To API Documentation
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Send Low Credit Notification
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Define Payment Collection Type:
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 60px;"|✔ After Domain Registration
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 60px;"|✔ After Order Placement
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Define Refund Policy Upon Unsuccessful Domain Registration:
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 60px;"|✔ Disabled
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 60px;"|✔ Via Credits Only
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 60px;"|✔ Via Invoice Refund
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Define Default Domain Registrant
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Define Tech/Admin/Billing Domain Contact Details
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Define Domain Contacts To Be Edited By End Clients
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Create Domain Registrar Integration Modules For Resellers:
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 60px;"|✔ Choose Dedicated Platform:
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 75px;"|✔ WHMCS
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 75px;"|✔ Blesta
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 60px;"|✔ Define Name And Description
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 60px;"|✔ Provide Logo
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 60px;"|✔ Attach Additional Fields Integration File
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 60px;"|✔ Attach Documentation
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Assign Offered TLDs For Resellers
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Define Pricing For Each TLD Extension:
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 60px;"|✔ For Register, Transfer And Renew Action
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 60px;"|✔ For Each Year Period
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 60px;"|✔ For Each Currency
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Create Response Templates To Overwrite Registrars Messages Displayed To End Clients
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Configure Default Settings:
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Toggle Global API Status
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Toggle Global API IP Restriction
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Toggle Global API Requests Restriction
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Define Default Group Settings
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ View API Request And Response Logs
 +
|}
 +
{|
 +
|style="padding: 0px 0px 10px 30px;"|✔ View API Documentation
 +
|}
 +
 
 +
*'''Resellers:'''
 +
{|
 +
|style="padding: 10px 0px 0px 30px;"|✔ Access Dedicated Reseller Area
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ View Domains Orders
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ View TLDs Pricing
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Access Reseller Settings:
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ View Available Account Credits
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Access API Details:
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 60px;"|✔ View Available Credentials
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 60px;"|✔ View/Generate API Key
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 60px;"|✔ View/Modify IP Addresses Restrictions
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Download Domain Registrar Integration Module
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Download Provider Documentation
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 45px;"|✔ Download Additional Fields Integration File
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ View API Request And Response Logs
 +
|}
 +
{|
 +
|style="padding: 0px 0px 10px 30px;"|✔ View API Documentation
 +
|}
 +
 
 +
*'''End Clients:'''
 +
{|
 +
|style="padding: 10px 0px 0px 30px;"|✔ Manage Contact Information
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Manage Email Forwarders
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Manage DNS Records
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Register/Manage Private Nameservers
 +
|}
 +
{|
 +
|style="padding: 0px 0px 10px 30px;"|✔ Enable/Disable ID Protection
 +
|}
 +
 
 +
*'''API Functionality:'''
 +
{|
 +
|style="padding: 10px 0px 0px 30px;"|✔ Register/Transfer/Renew Domain
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Release/Delete Domain
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Get/Modify Contact Details
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Get EPP Code
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Get/Modify Registrar Lock Status
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Get/Save DNS Records
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Get/Register/Modify/Delete Nameservers
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Get/Save Email Forwarding
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Modify ID Protection
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Enable/Disable ID Protection
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Check Domain And Transfer Synchronization
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Check Domain Availability
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Get Available TLDs
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Get Available Credits
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Get Version
 +
|}
 +
 
 +
*'''General Info:'''
 +
{|
 +
|style="padding: 10px 0px 0px 30px;"|✔ Transactions Between Resellers And Provider Settled With Credits
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Integrated With <u>Domain Orders Extended For WHMCS</u> - Innovative Way Of Selling TLDs & gTLDS [https://www.modulesgarden.com/products/whmcs/domain-orders-extended (read more)]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Multi-Language Support
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Supports PHP 5.6 Up To PHP 7.3
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Supports WHMCS Template Six
 +
|}
 +
{|
 +
|style="padding: 0px 0px 0px 30px;"|✔ Supports WHMCS V7.5 And Later
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 30px;"|✔ Easy Module Upgrade To [https://www.modulesgarden.com/products/whmcs/domains-reseller#open-source-version Open Source Version]
 +
|}
 +
 
 +
=Installation=
 +
{|
 +
|style="padding: 10px 0px 15px 0px;"|'''This tutorial will show you how to successfully install and configure [https://www.modulesgarden.com/products/whmcs/products-reseller Products Reseller For WHMCS.]''' <br />
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 15px;"|'''1. Log in to our client area and download the module.'''
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_1.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|'''2. In the downloaded file you might find one or two packages that support different PHP versions.'''<br/>
 +
In the most recent versions of the module, you will find only one package that supports PHP 7.1 and later.<br/> If you need a package for the previous versions of PHP, please [https://www.modulesgarden.com/support/ticket/general-support contact our support].
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PHP71_73.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|'''Previous updates of the module may contain two packages dedicated to various PHP versions.'''<br/>
 +
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.<br/>
 +
'''''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 [http://php.net/supported-versions.php here].''
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PHP56_73.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 10px 15px;"|'' '''Important''': This situation does not affect [https://www.modulesgarden.com/products/whmcs/products-reseller#open-source-version '''the open source version'''] of this module which can be applied to any PHP from version 5.6 and later.''<br/>'' '''Note''': You can check the current PHP version in your WHMCS. To do so, proceed to ''' 'Utilities' → 'System' → 'PHP Info'.'''
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|'''3. Once you have chosen the package with the right PHP version, extract it and upload its content into the main WHMCS directory.'''<br />
 +
The content of the chosen PHP version files to upload should look like this.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_2.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|'''4. When you install Products Reseller For WHMCS for the first time you have to rename '' 'license_RENAME.php' '' file.'''<br />
 +
File is located in '' 'modules/addons/ProductsReseller/license_RENAME.php'. '' Rename it from '' 'license_RENAME.php' '' to '' 'license.php'. ''
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_3.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|'''5. In order to configure your license key, you have to edit a previously renamed '' 'license.php' file.' '' '''<br />
 +
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'. ''
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_4.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|'''6. In the next step, set up the  '' 'storage' '' folder as recursively writable.'''<br />
 +
This folder is available at '' 'yourWHMCS/modules/addons/products_reseller/'. ''
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:PR2_5.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|'''7. Now you have to activate the module in your WHMCS system. '''<br />
 +
Log in to your WHMCS admin area. Go to '' 'Setup' '' → '' 'Addon Modules'. '' Afterwards, find '' 'Products Reseller' '' and press the '' 'Activate' '' button.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_6.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|'''8. In the next step you need to permit access to this module.'''<br />
 +
To do so click on '' 'Configure' '' button, tick '' 'Full Administrator' '' and press '' 'Save Changes'. ''
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_7.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|'''9. You have just successfully installed Products Reseller!'''<br />
 +
You can access your module at '' 'Addons' '' → '' 'Products Reseller'. ''<br />
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:PR2_8.png]]
 +
|}
 +
 
 +
=Configuration and Management=
 +
{|
 +
|style="padding: 10px 0px 30px 15px;"|'''Products Reseller For WHMCS allows your customers to resell products on their own WHMCS.'''
 +
|}
 +
 
 +
==Dashboard==
 +
{|
 +
|style="padding: 10px 0px 20px 15px;"|Dashboard page presents some useful graphs and summaries on income generated from reselling products.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_9.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 15px;"|You may easily change the graph settings by changing the time scope and choosing products you are interested in.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_10.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 15px;"|Most profitable Resellers & Latest invoices summary:
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:PR2_11.png]]
 +
|}
 +
 
 +
==General Settings==
 +
{|
 +
|style="padding: 10px 0px 15px 15px;"|'' 'Settings' '' tab allows you to access general settings of your Products Reseller API. <br/>
 +
Here you may set up general options but still, you will be able to change them per single group. If you skip group settings, these configuration will be taken into account.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_12.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|We will describe these options below.<br />
 +
'''Global API''' related section:<br/>
 +
*'' 'API Status'' ' - enable/disable Domains Reseller API.<br />
 +
*'' 'IP Addresses Restriction' '' - enable/disable restricting connection to Products Reseller API only for IP addresses specified in the '' 'Allowed IP Addresses' '' field.<br />
 +
*'' 'API Requests Restriction' '' - enable option to restrict the number of API requests.<br />
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_13.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|'''Miscellaneous:'''<br />
 +
*'' 'Low Credit Notification' '' - a notification to your client will be sent when credit balance on client's account falls below entered value.<br /> You may view and edit the '' "Low Credit Notification" '' custom email template sent to clients at '' 'WHMCS' → 'Setup' → 'Email Templates'.'' This email message is sent with the main WHMCS cron job.
 +
 
 +
*'' 'Low Credit Amount' '' - amount of credits, when reached a notification will be sent.<br/>
 +
 
 +
*'' 'Payment Type' ''options:
 +
**'' 'Pay After Registration' '' - resellers must have sufficient credits amount, but he is charged only after a domain has been successfully registered.
 +
**'' 'Pay After Order' '' - resellers must settle the payment just after the order, the amount due is taken from his account instantly.<br />
 +
 
 +
*'' 'Refund Type' '' - defines behavior of the module upon unsuccessful domain registration.<br />
 +
**'' 'Credits Only' '' - if selected, refunds are granted in form of credits only.
 +
**'' 'Refund Invoice' '' - if selected, refunds are delivered with  in form of credits only.
 +
**'' 'Disabled' '' - if selected, refunds are not accepted.
 +
 
 +
Remember to submit the changes, once you have finished.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:PR2_14.png]]
 +
|}
 +
 
 +
==Groups==
 +
{|
 +
|style="padding: 10px 0px 15px 15px;"|Let's start by creating the first group for your resellers. Use either of the buttons marked on the screen below.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_15.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|Then, simply type in a unique name of your group. <br/>Create as many groups as you will need and set up different configuration to adjust them and then assign resellers to adequate groups.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:PR2_16.png]]
 +
|}
 +
===Configuration Per Group===
 +
{|
 +
|style="padding: 10px 0px 15px 15px;"|You can set up configuration for resellers who are assigned to this very group only.<br/> These settings will overwrite the general [[#General Settings|settings]] defined in the previous step.
 +
*'' 'API Status' '' - enable/disable Products Reseller API for Resellers assigned to this very group only<br />
 +
*'' 'IP Address Restriction' '' - enable/disable restricting connection to Products Reseller API only for IP addresses specified in the 'Allowed IP Addresses' field.
 +
*'' 'API Requests Restriction' '' - enable option to restrict the number of API requests.
 +
*'' 'Show API Documentation' '' - toggle to allow resellers access to API documentation directly from their Reseller Area.
 +
*'' 'Low Credit Notification' '' - turn on sending notifications to your client when credit balance on client's account falls below entered value.<br/>You may view and edit the '' "Low Credit Notification" '' custom email template sent to clients at '' 'WHMCS' → 'Setup' → 'Email Templates'.'' This email message is sent with the main WHMCS cron job.
 +
*'' 'Low Credit Amount' '' -  amount of credits, when reached a notification will be sent
 +
*'' 'Payment Type' '' options:
 +
**'' 'Pay After Registration' - resellers must have sufficient credits amount, but he is charged only after a domain has been successfully registered.
 +
**'' 'Pay After Order' - resellers must settle the payment just after the order, the amount due is taken from his account instantly.
 +
*'' 'Refund Type' '' - defines behavior of the module upon unsuccessful domain registration.
 +
**'' 'Credits Only' '' - if selected, refunds are granted in form of credits only
 +
**'' 'Refund Invoice' '' - if selected, refunds are delivered with in form of credits only
 +
**'' 'Disabled' '' - if selected, refunds are not accepted
 +
 
 +
Save the changes when ready.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:PR2_17.png]]
 +
|}
 +
 
 +
===API Permissions===
 +
{|
 +
|style="padding: 10px 0px 20px 15px;"|Toggle options that resellers will be allowed to use via API.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:PR2_18.png]]
 +
|}
 +
 
 +
===Integrations===
 +
{|
 +
|style="padding: 10px 0px 15px 15px;"|In this section you can create and manage integration modules which resellers will need to upload and activate to be able to resell domains you offer them.<br/>
 +
Press '' 'Add Integration' '' to begin.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_19.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|To generate a new integration module you need to provide following data:
 +
 
 +
*Enter your module unique name
 +
 
 +
*Type in a short description of the module, it will be visible on the activation page of the registrar
 +
 
 +
*Upload file with documentation if you have prepared any - you may use any format. 
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_20.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|Newly created Integration will appear on the list. You may:
 +
#Edit its details (change name, description, or file) at any time
 +
#Download the integration package
 +
#Delete the integration
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_21.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 15px;"|In order to delete numerous integration at once, use the mass action button.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:PR2_22.png]]
 +
|}
 +
 
 +
===Products===
 +
{|
 +
|style="padding: 10px 0px 15px 15px;"| Here you can create a list of products along with their custom pricing details that resellers assigned to this group will be allowed to offer to their clients.<br/>
 +
Press '' 'Assign Product' '' button to begin.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_23.png]]
 +
|}
 +
 
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"| Select products from the available and press '' 'Confirm'. '' <br/>
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_24.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"| Assigned products will appear on the list where the following options are available:
 +
*'''Settings
 +
*'''Set Pricing
 +
*'''Unassign Product
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_25.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"| Under the '' 'Settings'' ' section, the '' 'Start'' ', '' 'Stop'' ', '' 'Reboot'' ','' 'Details'' ','' 'Graphs'' ' actions can be enabled.<br/> '''Note:''' ''These options are available only for Proxmox VPS products.''
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_26.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"| Then, set pricing for a particular item.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_27.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"| Moreover, there is the possibility to set pricing for a few selected products. Simply, use the mass action button to do it with one click.<br/> In the same way, you may also unassign the preferred products.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_28.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"| Now, your group configuration is ready. If you have more groups, simply repeat these steps for each of them. <br/> Remember that you are always able to edit the single group name or delete if no longer needed. Just click on adequate buttons to do so.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_29.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"| Keep in mind that you may never delete a group if there are any resellers assigned to the group.<br/> Before deleting it, you must choose an alternative group to which the resellers will be reassigned.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:PR2_30.png]]
 +
|}
 +
 
 +
==Resellers==
 +
{|
 +
|style="padding: 10px 0px 20px 15px;"|In this section you will find a list of your active Resellers. Press '' 'Add Reseller' '' to make one of your clients a reseller.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_31.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|
 +
*Select one of your previously created '''groups''', to which the reseller should be assigned.
 +
 
 +
*Then select one of your '''clients''' from the dropdown, start typing to see a list of clients
 +
 
 +
*Generate an '''API Key''' for the Reseller, it will be necessary when configuring the integration module with the Reseller's platform
 +
 
 +
*Prepare a list of '''allowed IP addresses''', use comma or a space to separate - note that this option must have been enabled previously in the module general settings [[#General Settings|here]]
 +
 
 +
*'''API Status''' - toggle to allow reseller generate the API key in the Reseller area
 +
 +
*'''API Limits''' - toggle to be able to define precise limits
 +
**'''API Interval [Min]''' - enter a time interval in minutes in which a provided below number of API requests can be called
 +
**'''API Requests Limit''' - maximum number of API requests in the time interval
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:PR2_32.png]]
 +
|}
 +
===Reseller Details===
 +
====API Configuration====
 +
{|
 +
|style="padding: 10px 0px 15px 15px;"|Here you may easily alter the settings that you have defined when creating the reseller.<br/>
 +
Apart from them, you may preview the '''API Email Address''' and '''API Key''' required to activate and configure the integration module.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:PR2_33.png]]
 +
|}
 +
 
 +
====Orders====
 +
{|
 +
|style="padding: 10px 0px 15px 25px;"|This section includes a list of all bought products which are offered by this reseller. <br/> Take a look at any crucial details on the orders.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:PR2_34.png]]
 +
|}
 +
 
 +
====Income====
 +
{|
 +
|style="padding: 10px 0px 15px 25px;"|'' 'Income' '' tab contains a current list of invoices that generate any income for the reseller.<br/> Press the invoice ID and you will be redirected to the invoice summary.
 +
|}
 +
 
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:PR2_35.png]]
 +
|}
 +
 
 +
==Response Templates==
 +
{|
 +
|style="padding: 10px 0px 15px 15px;"|In '' 'Response Templates' '' section you may add and edit new templates with text messages/information that are sent to clients instead of defined here system responses.<br/>
 +
In order to add a new response template press '' 'Crate Template' '' button and then follow the below instructions.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_36.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|Provide the pattern for search and replace in the system response depending on the type.<br>
 +
*For '''Text''' type, simply provide a string like '' 'Error Response'. ''<br/>
 +
*For '''Regular Expression''' type, you need to provide a regular expression which will be replaced.<br/> ''For example, if you want to replace any dollar price in the response provide'' '\$\d+\.\d+', ''in this case it will replace strings like'' '$8.25'.<br/>
 +
*If you want to replace '''any response,''' simply type '.+' in here.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_37.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|In the second step '''Replace With''' you need to enter a text message that will be sent to a client when the above entered pattern is found.<br/> The two messages will be replaced with one another.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_38.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|Define '''Priority'''. The higher number you enter, the higher priority will be assigned.<br/> Important! Only the first occurrence with the highest priority will be replaced.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_39.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|Finally,
 +
*choose '' 'Text' '' or '' 'Regular Expression' '' from '''Type''' dropdown menu.<br/> 
 +
''It will specify if provided text in the first field should be treated as a text or a regular expression while searching for a pattern.''
 +
*''' Registrar Action''' -'' must be chosen from dropdown menu as well to specify upon which action provided patterns will be searched for.''
 +
Remember, to finish successfully you need to press '' 'Confirm' '' button.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_40.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|Now you can see a newly configured response is visible on the list. You may edit the added response or remove it any time you need.<br/> To do so, just simply click on the appropriate action button.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:PR2_41.png]]
 +
|}
 +
 
 +
==Module Logs==
 +
{|
 +
|style="padding: 10px 0px 20px 15px;"|In '' 'Logs' '' section you may preview a list of API requests and responses, including errors with the most important details on them.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_42.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 15px;"|Use action buttons to delete all logs or just single entries.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:PR2_43.png]]
 +
|}
 +
 
 +
==Documentation==
 +
 
 +
===API Documentation===
 +
{|
 +
|style="padding: 10px 0px 15px 15px;"|Under '' 'Documentation' '' tab you will find two subsection. The first one is dedicated to API.<br/>
 +
This API documentation has been prepared to allow you to write your own integration modules for platforms other than WHMCS.<br/>
 +
 
 +
'' 'Information' '' subtab contains:
 +
*'''Endpoint''' - URL to which all the API requests are directed
 +
 
 +
*'''Authorization''' - Username and token parameters to authenticate the client in the API request
 +
 
 +
*'''Example''' - exemplary request to API to renew a domain
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_44.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|'' 'Calls' '' subtab contains information about actions supported by the API.<br/>
 +
'''''Note:''' The screen below does not capture all the supported functions.<br/>Full API functionality can be found on the module features list at the top of this documentation.''
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_45.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 15px;"|The last section includes '' 'Models' '' details.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:PR2_46.png]]
 +
|}
 +
 
 +
===Module Documentation===
 +
{|
 +
|style="padding: 10px 0px 20px 15px;"|'' 'Module Documentation'' ' is a hyperlink. It leads to the '' 'Products Reseller For WHMCS' '' wiki article you are currently reading.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:DR3_52.png]]
 +
|}
 +
 
 +
==Reseller Area==
 +
{|
 +
|style="padding: 10px 0px 15px 15px;"|Resellers can manage API connection credentials directly from the provider WHMCS client area as well as see any details on its products offer.<br />
 +
Go to '' 'Domains' '' → '' 'Reseller Area' '' to access them.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:PR2_53.png]]
 +
|}
 +
===Orders===
 +
{|
 +
|style="padding: 10px 0px 15px 15px;"|As you can see, '' 'Orders' '' section includes a detailed list of orders placed on products along with any payment details and date.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:PR2_54.png]]
 +
|}
 +
 
 +
===Pricing===
 +
{|
 +
|style="padding: 10px 0px 20px 15px;"|'' 'Pricing' '' section includes a list of the Reseller's products with the option to preview its pricing set up by the provider.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 10px 25px;"|[[File:PR2_55.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:PR2_56.png]]
 +
|}
 +
 
 +
===Settings===
 +
{|
 +
|style="padding: 10px 0px 20px 15px;"|Under '' 'Settings' '' section you will find any API details necessary to install and activate the integration module.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_57.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|Underneath the API details you will find a list of generated integrations.<br/> Depending on the provider, you may download the packages, download the additional fields and documentation per Integration.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:PR2_58.png]]
 +
|}
 +
 
 +
===Logs===
 +
{|
 +
|style="padding: 10px 0px 20px 15px;"|Preview a list of logs on API requests and responses, including errors stored in the module.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:PR2_59.png]]
 +
|}
 +
 
 +
===API Documentation===
 +
{|
 +
|style="padding: 10px 0px 15px 15px;"|Access API documentation details with basic information and API Calls and Models.<br/>
 +
This API documentation has been prepared to allow you to write your own integration modules for platforms other than WHMCS.<br/>
 +
 
 +
'' 'Information' '' tab contains:
 +
*'''Endpoint''' - URL to which all the API requests are directed
 +
 
 +
*'''Authorization''' - Username and token parameters to authenticate the client in the API request
 +
 
 +
*'''Example''' - exemplary request to API to renew a domain
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_60.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 25px;"|Available '' 'Calls' '' list:<br/>
 +
'''''Note:''' The screen below does not capture all the supported functions.''
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_61.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|Available '' 'API Models' '' list:
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:PR2_62.png]]
 +
|}
 +
 
 +
==Products Reselling Workflow==
 +
===Installation Of Integration Module===
 +
{|
 +
|style="padding: 10px 0px 5px 15px;"|'''Below you can find instructions for installation of the integration module on the reseller's WHMCS.'''<br/>
 +
Please refer to section [[#Integrations|Integrations]] to learn how to generate an integration module for your resellers.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|'''1. Extract and upload the integration module into the reseller's main WHMCS directory.'''<br/>
 +
Once you have uploaded the integration module, you should find a new folder with this module in '' 'resellerWHMCS/modules/servers/' '' directory as presented below.<br/>
 +
'''''Important:''' The folder and module name as well as description of the extracted integration module is customized by the provider and will be different that the one presented in the example below.''
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_63.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 15px;"|'''2. Now, go to '' 'Setup' '' → '' 'Products/Services' '' → '' 'Products/Services' '' and create a new group.'''
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_64.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|'''3. Enter a product group name and press '' 'Save Changes' ''.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_65.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|'''4. When you have a product group, you can assign your product to it.'''<br />
 +
To create a product, click on '' 'Create a New Product'.''
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_66.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|'''5. Afterwards, choose a product type, then select the previously created product group from the dropdown menu and provide a product name. <br /> Finally, find the '' uploaded integration module'' in the dropdown menu. Do not forget to save changes. 
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_67.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 15px;"|'''6. Set up the pricing for your product'''
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_68.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 15px;"|'''7. Finally, after saving previous changes, go to the '' 'Module Settings' '' and follow these steps:<br /> Provide API Username and API Key which were generated [[#API_Configuration|here]] and save changes.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_69.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 15px;"|'''Now you have the possibility to choose the product from the dropdown menu. When selected, save changes again.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_70.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 15px;"|'''At the end, new actions will show up. You can now decide which ones should be enabled. Simply, tick the preferred actions.<br /> Note:''' ''Please remember that these actions are available only for Proxmox VPS products.''
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_71.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 15px;"|'''8. After placing an order, the client area looks as presented here: '''<br /> As you can see, the enabled options appear in the side menu and additional information about the product at the bottom of the page.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:PR2_72.png]]
 +
|}
 +
 
 +
===Sample Workflow===
 +
{|
 +
|style="padding: 10px 0px 30px 15px;"|In this section we will present to you a sample workflow of the module.<br />
 +
 
 +
In a basic workflow 3 users take part:<br />
 +
'''Provider''' – a person with Products Reseller For WHMCS installed on the WHMCS system.<br />
 +
'''Reseller''' - a provider's client who aims at reselling products offered to him by the provider.<br />
 +
The reseller must own a system with integration module generated for him by the provider with Products Reseller For WHMCS.<br />
 +
'''End Client''' – a person with a client account in the Reseller's WHMCS.<br />
 +
<br />
 +
'''Provider's Part'''<br />
 +
Let us start from the beginning. Provider installs Products Reseller For WHMCS in the system.<br />
 +
He already has some products in the offer and wishes to allow the reseller to resell them.<br />
 +
Now, the provider configures Products Reseller For WHMCS,  creates groups, configures them and assigns products and defines their pricing for the reseller who is assigned to one of the groups.<br />
 +
Finally, selects which of the clients will become resellers, assigns them to previously created groups and generates access details.<br />
 +
<br />
 +
'''Reseller Part'''<br />
 +
The  Reseller has access to the Reseller Area once logged into the provider's client area. <br />
 +
There, he can download both the integration module and its documentation as well as generate and copy any API details required to activate the integration module in his own system.<br/>
 +
Then, the reseller needs to set up products that the provider allows him to resell with the integration module delivered by the provider.  Defines the pricing (prices must be higher than the ones the provider has set up to generate any income). <br />
 +
There is one step that separates the reseller from offering the domain from his system.<br />
 +
The reseller must [https://docs.whmcs.com/Add_Funds add funds] to his credit balance in the provider system to be able to pay off the charges and settle the amounts  owed to the provider for his resold products .<br />
 +
Provider creates an '' 'add funds invoice' '' for the Reseller, the Reseller pays the invoice and then again the Provider adds the same amount to Reseller's credit balance.<br />
 +
From now on, any domain can be ordered.<br />
 +
<br/>
 +
'''End Client'''<br />
 +
End Client orders a domain from his client area in the Reseller's system.<br />
 +
<br />
 +
'''Last Word About Payment'''<br />
 +
Now, that the End-Client has ordered and paid the reseller for the domain, at the provider's system a new invoice for that domain is created automatically (on behalf of the reseller).<br/>
 +
Depending on the selected "Payment Type" configuration the invoice will be paid with credits and domain attempted to be registered or attempt to register the domain and if successful, the invoice will be paid with credits. <br/>
 +
In case the reseller does not have sufficient credits on his account to pay for the domain registration the process is stopped until the invoice is manually paid by the reseller.<br/>
 +
The reseller's income is the difference between the price of the sold domain to the End-Client and the price he paid to the provider.
 +
|}
 +
 
 +
=Update Instructions=
 +
{|
 +
|style="padding: 10px 0px 30px 15px;"|Essential guidance through the process of updating the module is offered '''[https://www.docs.modulesgarden.com/How_To_Update_WHMCS_Module here]'''.<br/>
 +
 
 +
Keep in mind there is a quick and easy option in our client area that will let you upgrade the license of your module to an open source version at any time - and at a lower price!<br/>
 +
To take advantage of it, simply use the '''License Upgrade''' button located on the product's page and a discounted invoice will be generated automatically.<br/>
 +
|}
 +
 
 +
=Common Problems=
 +
{|
 +
|style="padding: 10px 0px 10px 15px;"|'''1. When you have problems with connection, check whether your SELinux or firewall does not block ports.'''
 +
|}

Revision as of 14:31, 4 March 2020

Contents

About Products Reseller For WHMCS

Products Reseller For WHMCS brings you automation and comfort into reselling your products, following income as well as managing the reseller groups.

As a provider, you are able to handle all details of your reseller groups and set up pricing rates for each product in a particular group effortlessly.
Moreover, your resellers grant all crucial information about placed orders along with API documentation. As for end clients, they are able to buy preferred products and perform basic actions on them later.

  • Provider:
✔ View Resellers And TLDs Income Statistics
✔ View Most Profitable Resellers And Latest Invoices
✔ Create And Manage Resellers:
✔ Assign To Dedicated Group
✔ Assign Client's Account
✔ Generate Access API Key
✔ Restrict Access To Specific IP Addresses
✔ Allow API Access
✔ Define API Limits Interval And Requests
✔ View Reseller's Orders And Income
✔ Create And Manage Groups:
✔ Allow API Access With Defined Permissions
✔ Allow Access To API Documentation
✔ Send Low Credit Notification
✔ Define Payment Collection Type:
✔ After Domain Registration
✔ After Order Placement
✔ Define Refund Policy Upon Unsuccessful Domain Registration:
✔ Disabled
✔ Via Credits Only
✔ Via Invoice Refund
✔ Define Default Domain Registrant
✔ Define Tech/Admin/Billing Domain Contact Details
✔ Define Domain Contacts To Be Edited By End Clients
✔ Create Domain Registrar Integration Modules For Resellers:
✔ Choose Dedicated Platform:
✔ WHMCS
✔ Blesta
✔ Define Name And Description
✔ Provide Logo
✔ Attach Additional Fields Integration File
✔ Attach Documentation
✔ Assign Offered TLDs For Resellers
✔ Define Pricing For Each TLD Extension:
✔ For Register, Transfer And Renew Action
✔ For Each Year Period
✔ For Each Currency
✔ Create Response Templates To Overwrite Registrars Messages Displayed To End Clients
✔ Configure Default Settings:
✔ Toggle Global API Status
✔ Toggle Global API IP Restriction
✔ Toggle Global API Requests Restriction
✔ Define Default Group Settings
✔ View API Request And Response Logs
✔ View API Documentation
  • Resellers:
✔ Access Dedicated Reseller Area
✔ View Domains Orders
✔ View TLDs Pricing
✔ Access Reseller Settings:
✔ View Available Account Credits
✔ Access API Details:
✔ View Available Credentials
✔ View/Generate API Key
✔ View/Modify IP Addresses Restrictions
✔ Download Domain Registrar Integration Module
✔ Download Provider Documentation
✔ Download Additional Fields Integration File
✔ View API Request And Response Logs
✔ View API Documentation
  • End Clients:
✔ Manage Contact Information
✔ Manage Email Forwarders
✔ Manage DNS Records
✔ Register/Manage Private Nameservers
✔ Enable/Disable ID Protection
  • API Functionality:
✔ Register/Transfer/Renew Domain
✔ Release/Delete Domain
✔ Get/Modify Contact Details
✔ Get EPP Code
✔ Get/Modify Registrar Lock Status
✔ Get/Save DNS Records
✔ Get/Register/Modify/Delete Nameservers
✔ Get/Save Email Forwarding
✔ Modify ID Protection
✔ Enable/Disable ID Protection
✔ Check Domain And Transfer Synchronization
✔ Check Domain Availability
✔ Get Available TLDs
✔ Get Available Credits
✔ Get Version
  • General Info:
✔ Transactions Between Resellers And Provider Settled With Credits
✔ Integrated With Domain Orders Extended For WHMCS - Innovative Way Of Selling TLDs & gTLDS (read more)
✔ Multi-Language Support
✔ Supports PHP 5.6 Up To PHP 7.3
✔ Supports WHMCS Template Six
✔ Supports WHMCS V7.5 And Later
✔ Easy Module Upgrade To Open Source Version

Installation

This tutorial will show you how to successfully install and configure Products Reseller For WHMCS.
1. Log in to our client area and download the module.
PR2 1.png
2. In the downloaded file you might find one or two packages that support different PHP versions.

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.

PHP71 73.png
Previous updates of the module may contain two packages dedicated to various PHP versions.

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.

PHP56 73.png
Important: This situation does not affect the open source version of this module which can be applied to any PHP from version 5.6 and later.
Note: You can check the current PHP version in your WHMCS. To do so, proceed to 'Utilities' → 'System' → 'PHP Info'.
3. Once you have chosen the package with the right PHP version, extract it and upload its content into the main WHMCS directory.

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

PR2 2.png
4. When you install Products Reseller For WHMCS for the first time you have to rename 'license_RENAME.php' file.

File is located in 'modules/addons/ProductsReseller/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'.

PR2 3.png
5. In order to configure your license key, you have to edit a previously renamed 'license.php' file.'

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'.

PR2 4.png
6. In the next step, set up the 'storage' folder as recursively writable.

This folder is available at 'yourWHMCS/modules/addons/products_reseller/'.

PR2 5.png
7. Now you have to activate the module in your WHMCS system.

Log in to your WHMCS admin area. Go to 'Setup' → 'Addon Modules'. Afterwards, find 'Products Reseller' and press the 'Activate' button.

PR2 6.png
8. In the next step you need to permit access to this module.

To do so click on 'Configure' button, tick 'Full Administrator' and press 'Save Changes'.

PR2 7.png
9. You have just successfully installed Products Reseller!

You can access your module at 'Addons' → 'Products Reseller'.

PR2 8.png

Configuration and Management

Products Reseller For WHMCS allows your customers to resell products on their own WHMCS.

Dashboard

Dashboard page presents some useful graphs and summaries on income generated from reselling products.
PR2 9.png
You may easily change the graph settings by changing the time scope and choosing products you are interested in.
PR2 10.png
Most profitable Resellers & Latest invoices summary:
PR2 11.png

General Settings

'Settings' tab allows you to access general settings of your Products Reseller API.

Here you may set up general options but still, you will be able to change them per single group. If you skip group settings, these configuration will be taken into account.

PR2 12.png
We will describe these options below.

Global API related section:

  • 'API Status ' - enable/disable Domains Reseller API.
  • 'IP Addresses Restriction' - enable/disable restricting connection to Products Reseller API only for IP addresses specified in the 'Allowed IP Addresses' field.
  • 'API Requests Restriction' - enable option to restrict the number of API requests.
PR2 13.png
Miscellaneous:
  • 'Low Credit Notification' - a notification to your client will be sent when credit balance on client's account falls below entered value.
    You may view and edit the "Low Credit Notification" custom email template sent to clients at 'WHMCS' → 'Setup' → 'Email Templates'. This email message is sent with the main WHMCS cron job.
  • 'Low Credit Amount' - amount of credits, when reached a notification will be sent.
  • 'Payment Type' options:
    • 'Pay After Registration' - resellers must have sufficient credits amount, but he is charged only after a domain has been successfully registered.
    • 'Pay After Order' - resellers must settle the payment just after the order, the amount due is taken from his account instantly.
  • 'Refund Type' - defines behavior of the module upon unsuccessful domain registration.
    • 'Credits Only' - if selected, refunds are granted in form of credits only.
    • 'Refund Invoice' - if selected, refunds are delivered with in form of credits only.
    • 'Disabled' - if selected, refunds are not accepted.

Remember to submit the changes, once you have finished.

PR2 14.png

Groups

Let's start by creating the first group for your resellers. Use either of the buttons marked on the screen below.
PR2 15.png
Then, simply type in a unique name of your group.
Create as many groups as you will need and set up different configuration to adjust them and then assign resellers to adequate groups.
PR2 16.png

Configuration Per Group

You can set up configuration for resellers who are assigned to this very group only.
These settings will overwrite the general settings defined in the previous step.
  • 'API Status' - enable/disable Products Reseller API for Resellers assigned to this very group only
  • 'IP Address Restriction' - enable/disable restricting connection to Products Reseller API only for IP addresses specified in the 'Allowed IP Addresses' field.
  • 'API Requests Restriction' - enable option to restrict the number of API requests.
  • 'Show API Documentation' - toggle to allow resellers access to API documentation directly from their Reseller Area.
  • 'Low Credit Notification' - turn on sending notifications to your client when credit balance on client's account falls below entered value.
    You may view and edit the "Low Credit Notification" custom email template sent to clients at 'WHMCS' → 'Setup' → 'Email Templates'. This email message is sent with the main WHMCS cron job.
  • 'Low Credit Amount' - amount of credits, when reached a notification will be sent
  • 'Payment Type' options:
    • 'Pay After Registration' - resellers must have sufficient credits amount, but he is charged only after a domain has been successfully registered.
    • 'Pay After Order' - resellers must settle the payment just after the order, the amount due is taken from his account instantly.
  • 'Refund Type' - defines behavior of the module upon unsuccessful domain registration.
    • 'Credits Only' - if selected, refunds are granted in form of credits only
    • 'Refund Invoice' - if selected, refunds are delivered with in form of credits only
    • 'Disabled' - if selected, refunds are not accepted

Save the changes when ready.

PR2 17.png

API Permissions

Toggle options that resellers will be allowed to use via API.
PR2 18.png

Integrations

In this section you can create and manage integration modules which resellers will need to upload and activate to be able to resell domains you offer them.

Press 'Add Integration' to begin.

PR2 19.png
To generate a new integration module you need to provide following data:
  • Enter your module unique name
  • Type in a short description of the module, it will be visible on the activation page of the registrar
  • Upload file with documentation if you have prepared any - you may use any format.
PR2 20.png
Newly created Integration will appear on the list. You may:
  1. Edit its details (change name, description, or file) at any time
  2. Download the integration package
  3. Delete the integration
PR2 21.png
In order to delete numerous integration at once, use the mass action button.
PR2 22.png

Products

Here you can create a list of products along with their custom pricing details that resellers assigned to this group will be allowed to offer to their clients.

Press 'Assign Product' button to begin.

PR2 23.png
Select products from the available and press 'Confirm'.
PR2 24.png
Assigned products will appear on the list where the following options are available:
  • Settings
  • Set Pricing
  • Unassign Product
PR2 25.png
Under the 'Settings ' section, the 'Start ', 'Stop ', 'Reboot ', 'Details ', 'Graphs ' actions can be enabled.
Note: These options are available only for Proxmox VPS products.
PR2 26.png
Then, set pricing for a particular item.
PR2 27.png
Moreover, there is the possibility to set pricing for a few selected products. Simply, use the mass action button to do it with one click.
In the same way, you may also unassign the preferred products.
PR2 28.png
Now, your group configuration is ready. If you have more groups, simply repeat these steps for each of them.
Remember that you are always able to edit the single group name or delete if no longer needed. Just click on adequate buttons to do so.
PR2 29.png
Keep in mind that you may never delete a group if there are any resellers assigned to the group.
Before deleting it, you must choose an alternative group to which the resellers will be reassigned.
PR2 30.png

Resellers

In this section you will find a list of your active Resellers. Press 'Add Reseller' to make one of your clients a reseller.
PR2 31.png
  • Select one of your previously created groups, to which the reseller should be assigned.
  • Then select one of your clients from the dropdown, start typing to see a list of clients
  • Generate an API Key for the Reseller, it will be necessary when configuring the integration module with the Reseller's platform
  • Prepare a list of allowed IP addresses, use comma or a space to separate - note that this option must have been enabled previously in the module general settings here
  • API Status - toggle to allow reseller generate the API key in the Reseller area
  • API Limits - toggle to be able to define precise limits
    • API Interval [Min] - enter a time interval in minutes in which a provided below number of API requests can be called
    • API Requests Limit - maximum number of API requests in the time interval
PR2 32.png

Reseller Details

API Configuration

Here you may easily alter the settings that you have defined when creating the reseller.

Apart from them, you may preview the API Email Address and API Key required to activate and configure the integration module.

PR2 33.png

Orders

This section includes a list of all bought products which are offered by this reseller.
Take a look at any crucial details on the orders.
PR2 34.png

Income

'Income' tab contains a current list of invoices that generate any income for the reseller.
Press the invoice ID and you will be redirected to the invoice summary.
PR2 35.png

Response Templates

In 'Response Templates' section you may add and edit new templates with text messages/information that are sent to clients instead of defined here system responses.

In order to add a new response template press 'Crate Template' button and then follow the below instructions.

PR2 36.png
Provide the pattern for search and replace in the system response depending on the type.
  • For Text type, simply provide a string like 'Error Response'.
  • For Regular Expression type, you need to provide a regular expression which will be replaced.
    For example, if you want to replace any dollar price in the response provide '\$\d+\.\d+', in this case it will replace strings like '$8.25'.
  • If you want to replace any response, simply type '.+' in here.
PR2 37.png
In the second step Replace With you need to enter a text message that will be sent to a client when the above entered pattern is found.
The two messages will be replaced with one another.
PR2 38.png
Define Priority. The higher number you enter, the higher priority will be assigned.
Important! Only the first occurrence with the highest priority will be replaced.
PR2 39.png
Finally,
  • choose 'Text' or 'Regular Expression' from Type dropdown menu.

It will specify if provided text in the first field should be treated as a text or a regular expression while searching for a pattern.

  • Registrar Action - must be chosen from dropdown menu as well to specify upon which action provided patterns will be searched for.

Remember, to finish successfully you need to press 'Confirm' button.

PR2 40.png
Now you can see a newly configured response is visible on the list. You may edit the added response or remove it any time you need.
To do so, just simply click on the appropriate action button.
PR2 41.png

Module Logs

In 'Logs' section you may preview a list of API requests and responses, including errors with the most important details on them.
PR2 42.png
Use action buttons to delete all logs or just single entries.
PR2 43.png

Documentation

API Documentation

Under 'Documentation' tab you will find two subsection. The first one is dedicated to API.

This API documentation has been prepared to allow you to write your own integration modules for platforms other than WHMCS.

'Information' subtab contains:

  • Endpoint - URL to which all the API requests are directed
  • Authorization - Username and token parameters to authenticate the client in the API request
  • Example - exemplary request to API to renew a domain
PR2 44.png
'Calls' subtab contains information about actions supported by the API.

Note: The screen below does not capture all the supported functions.
Full API functionality can be found on the module features list at the top of this documentation.

PR2 45.png
The last section includes 'Models' details.
PR2 46.png

Module Documentation

'Module Documentation ' is a hyperlink. It leads to the 'Products Reseller For WHMCS' wiki article you are currently reading.
DR3 52.png

Reseller Area

Resellers can manage API connection credentials directly from the provider WHMCS client area as well as see any details on its products offer.

Go to 'Domains' → 'Reseller Area' to access them.

PR2 53.png

Orders

As you can see, 'Orders' section includes a detailed list of orders placed on products along with any payment details and date.
PR2 54.png

Pricing

'Pricing' section includes a list of the Reseller's products with the option to preview its pricing set up by the provider.
PR2 55.png
PR2 56.png

Settings

Under 'Settings' section you will find any API details necessary to install and activate the integration module.
PR2 57.png
Underneath the API details you will find a list of generated integrations.
Depending on the provider, you may download the packages, download the additional fields and documentation per Integration.
PR2 58.png

Logs

Preview a list of logs on API requests and responses, including errors stored in the module.
PR2 59.png

API Documentation

Access API documentation details with basic information and API Calls and Models.

This API documentation has been prepared to allow you to write your own integration modules for platforms other than WHMCS.

'Information' tab contains:

  • Endpoint - URL to which all the API requests are directed
  • Authorization - Username and token parameters to authenticate the client in the API request
  • Example - exemplary request to API to renew a domain
PR2 60.png
Available 'Calls' list:

Note: The screen below does not capture all the supported functions.

PR2 61.png
Available 'API Models' list:
PR2 62.png

Products Reselling Workflow

Installation Of Integration Module

Below you can find instructions for installation of the integration module on the reseller's WHMCS.

Please refer to section Integrations to learn how to generate an integration module for your resellers.

1. Extract and upload the integration module into the reseller's main WHMCS directory.

Once you have uploaded the integration module, you should find a new folder with this module in 'resellerWHMCS/modules/servers/' directory as presented below.
Important: The folder and module name as well as description of the extracted integration module is customized by the provider and will be different that the one presented in the example below.

PR2 63.png
2. Now, go to 'Setup' → 'Products/Services' → 'Products/Services' and create a new group.
PR2 64.png
3. Enter a product group name and press 'Save Changes' .
PR2 65.png
4. When you have a product group, you can assign your product to it.

To create a product, click on 'Create a New Product'.

PR2 66.png
5. Afterwards, choose a product type, then select the previously created product group from the dropdown menu and provide a product name.
Finally, find the uploaded integration module in the dropdown menu. Do not forget to save changes.
PR2 67.png
6. Set up the pricing for your product
PR2 68.png
7. Finally, after saving previous changes, go to the 'Module Settings' and follow these steps:
Provide API Username and API Key which were generated here and save changes.
PR2 69.png
Now you have the possibility to choose the product from the dropdown menu. When selected, save changes again.
PR2 70.png
At the end, new actions will show up. You can now decide which ones should be enabled. Simply, tick the preferred actions.
Note: Please remember that these actions are available only for Proxmox VPS products.
PR2 71.png
8. After placing an order, the client area looks as presented here:
As you can see, the enabled options appear in the side menu and additional information about the product at the bottom of the page.
PR2 72.png

Sample Workflow

In this section we will present to you a sample workflow of the module.

In a basic workflow 3 users take part:
Provider – a person with Products Reseller For WHMCS installed on the WHMCS system.
Reseller - a provider's client who aims at reselling products offered to him by the provider.
The reseller must own a system with integration module generated for him by the provider with Products Reseller For WHMCS.
End Client – a person with a client account in the Reseller's WHMCS.

Provider's Part
Let us start from the beginning. Provider installs Products Reseller For WHMCS in the system.
He already has some products in the offer and wishes to allow the reseller to resell them.
Now, the provider configures Products Reseller For WHMCS, creates groups, configures them and assigns products and defines their pricing for the reseller who is assigned to one of the groups.
Finally, selects which of the clients will become resellers, assigns them to previously created groups and generates access details.

Reseller Part
The Reseller has access to the Reseller Area once logged into the provider's client area.
There, he can download both the integration module and its documentation as well as generate and copy any API details required to activate the integration module in his own system.
Then, the reseller needs to set up products that the provider allows him to resell with the integration module delivered by the provider. Defines the pricing (prices must be higher than the ones the provider has set up to generate any income).
There is one step that separates the reseller from offering the domain from his system.
The reseller must add funds to his credit balance in the provider system to be able to pay off the charges and settle the amounts owed to the provider for his resold products .
Provider creates an 'add funds invoice' for the Reseller, the Reseller pays the invoice and then again the Provider adds the same amount to Reseller's credit balance.
From now on, any domain can be ordered.

End Client
End Client orders a domain from his client area in the Reseller's system.

Last Word About Payment
Now, that the End-Client has ordered and paid the reseller for the domain, at the provider's system a new invoice for that domain is created automatically (on behalf of the reseller).
Depending on the selected "Payment Type" configuration the invoice will be paid with credits and domain attempted to be registered or attempt to register the domain and if successful, the invoice will be paid with credits.
In case the reseller does not have sufficient credits on his account to pay for the domain registration the process is stopped until the invoice is manually paid by the reseller.
The reseller's income is the difference between the price of the sold domain to the End-Client and the price he paid to the provider.

Update Instructions

Essential guidance through the process of updating the module is offered here.

Keep in mind there is a quick and easy option in our client area that will let you 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's page and a discounted invoice will be generated automatically.

Common Problems

1. When you have problems with connection, check whether your SELinux or firewall does not block ports.
Retrieved from "https://www.docs.modulesgarden.com/index.php?title=Products_Reseller_For_WHMCS&oldid=50386"
Navigation
WHMCS Modules
WHMCS Widgets
Tools And Applications
Translations
General
FAQ
Community
Products Reseller For WHMCS