Open a Ticket

Overview

As a Brixly Reseller customer, you can sell domain names through our automated API / module for WHMCS. This guide will step you through the process.


Pre-Requisites

  • WHMCS will need to be installed/configured ready for the domain reseller module to be installed

  • Domain name purchased come from your credit balance, so please ensure you have sufficient funds available in your Brixly account (Billing -> Add Funds)
  • You must add a ‘Default Payment Method’ to your account. To do this, log in to our client area and click your name in the top right > click "Account Details" > go to "Billing address" section > change the "payment method" dropdown to your default payment gateway. (please note, this will not necessarily be the payment method for your domains, it is just a technical requirement for the module to work).


Download and Install the WHMCS Module

The Brixly Domain Reseller module can be downloaded from our client area by navigating to Domains -> Reseller Area -> Settings, then scrolling down to the 'Integrations' section...
 
ce722158ec4b3e87c9df2462a866ce7d46e1fc5906d5de50141509f16fd3a5427de529139e0285e5?t=1d9ff5a80587da2ffd3e8e0bd8016c1e
 
Once you have downloaded the module, you must upload the .zip file to your WHMCS root directory, and then extract it. 


Enable the Domain Registrar Module in WHMCS

Once you have installed the module, you will be able to…

Navigate to Setup -> Products / Services -> Domain Registrars.

Click ‘Activate’ next to the Brixly - Domain Reseller v2 module.

You will be prompted to enter your ‘User Email’ (the email address you use to log in to our client area) and an API Key (explained below)


Obtaining your API Key

To get the API key to use within the setup screen above, you can go to...
 
Domains -> Reseller Area -> Settings

 
Configuring your WHMCS for selling domains

That is the integration complete. You must now configure WHMCS to define your ‘Domain Pricing’. A video and the full documentation of this process can be found below:
 


Reviewing your Domain Reseller Logs

Preview a list of logs on API requests and responses, including errors stored in the module. This is ideal for diagnosing issues with any domain registrations or renewals.

 

52e7f94174736ec4ee690f153efa0c8e2d10796803c21eb4c4c5fb70dc448de5d6c61447a31a4966?t=d02614750cc0c8387b3a1956224e5626
  

Domain Reseller Pricing

Our domain reseller module allows you to sell domains at our public pricing, discounted by 10%. 
 
You can view the domain pricing here...
 
 
For a more accessible view of our domain prices, see the following...
 


Adding Funds to your Account

All payments for domains are taken from your account credit. Please note that you can add funds to your account balance by going to the following:
 
Billing -> Add Funds 
  

Example Workflow

In this section, we will present you with a sample module workflow. In a basic workflow, 3 users take part:

Provider – us, as the top-level provider for your domain registrations
Reseller - you, as the provider's client who aims at reselling TLDs offered to him/her by the provider.
End Client – a person with a client account in the Reseller's system (WHMCS)
  
Resellers Role:
The Reseller has access to the Reseller Area once logged into the provider's client area, as outlined above in the documentation. 
 
The Reseller can download and install the provider's provisioning module to allow the resale of domain names via WHMCS.
 
The reseller must add funds to his credit balance in the provider system to pay off the charges and settle the amounts owed to the provider for his resold TLDs.
 
End Clients Role:
The end Client orders a domain in the Reseller's system from his client area.


Payment Flow:

Now that the End-Client has ordered and has paid the reseller for the domain, in the provider's system, a new invoice for that domain is created automatically (on behalf of the reseller). If funds are available, the invoice will be paid with credits, and the domain registration/transfer will be attempted - if successful, the invoice will be marked as paid with credits.
 
If the reseller does not have sufficient credits on his account to pay for the domain registration, the process is stopped until the reseller manually pays the invoice.

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.

 

Assigning Existing Domains

If you want to assign a domain existing in our client area to the reseller module, you can do this via the 'Domains -> Assign Domains' option.
 
 

Common Errors and Problems:

Invalid Payment Method. Valid options include
This message indicates that the default payment method wasn't defined in the pre-requisites above...

  • You must add a ‘Default Payment Method’ to your account. 
  • To do this, log in to our client area and click your name in the top right > click "Account Details" > go to "Billing address" section > change the "payment method" dropdown to your default payment gateway. (please note, this will not necessarily be the payment method for your domains, it is just a technical requirement for the module to work).


Provided domain has not been found in the reseller account

Since upgrading to the v2 of our Domain Reseller module, you will need to 'import' your domains to the Reseller Area. This is a security enhancement which ensures that domain control is restricted to the correct reseller.
 
To do this, you can go to Domains -> Reseller Area -> Domains.
 
Then click 'Assign Domains', and select the domain from the dropdown. Once you have confirmed by clicking 'Assign', the error should no longer occur.