Overview

As a Brixly Reseller Pro customer, you are able to 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 will need to 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...

Once you have downloaded the module, you will need to upload the .zip file to your WHMCS root directory, then extracted.


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 login to our client area) and an API Key (explained below)


Obtaining your API Key

To get the API key for use in the setup screen above, you can go to...

Domains -> Reseller Area -> Settings

From here, you can generate your API key by clicking the option below...


Configuring your WHMCS for selling domains

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

https://docs.whmcs.com/Domain_Pricing

A summarised guide can be found here...

go to 'Setup' 'Products/Services' 'Domains Pricing'.

Set up TLD your provider allows you to resell, select additional features, choose registrar you have just installed from a dropdown menu and save it through pressing 'Save Changes'.

DR3 20.png

Afterwards, set pricing for your TLD. To do so, press 'Open Pricing' text.

It will open in a new window, so make sure your browser does not block it.

DR3 21.png

7. Next, enter prices for specific actions. Press 'Save Changes' to confirm.

DR3 22.png

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.

Domain Reseller Pricing

Our domain reseller module allows you to sell domains at our main retail pricing.

You can view the domain pricing here...

https://client.brixly.uk/index.php?m=DomainsReseller&mg-page=Prices

For an easier view of our domain prices, see the following...

https://client.brixly.uk/cart.php?a=add&domain=register

Client Area for your End Users

Our domain reseller module gives your clients the ability to manage their domains entirely from within your own WHMCS.

Adding Funds to your Account

All payments for domains are taken from your account credit. Please note, you can add funds to your account balance by going to...

Billing -> Add Funds

Example Workflow

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

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 is able to download and install the providers provisioning module to allow resale of domain names via WHMCS.

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

End Clients Role:

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

Payment Flow:

Now, that the End-Client has ordered and has 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).

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.

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.

Assigning Existing Domains

If you are looking to assign a domain that already exists in our client area, to the reseller module, you can do this via the 'Domains -> Assign Domains' option.

Upgrading from Brixly Domain Reseller v1 Module

Unfortunately, the Brixly Domain Reseller v1.x module is no longer compatible with WHMCS v8.0, and would require significant development effort to work correctly in the new WHMCS structure.

As such, we are no longer able to offer support for the previous module.

If you had previously used our deprecated module, I would recommend going through the installation process above for the new module, then selecting all of your domain TLD's to use the new module in its place to ensure transfers and registrations take place as expected.

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 will need to 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 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 take place.

Did this answer your question?