Revision as of 15:03, 29 September 2021

Supported Features

Activation

To activate and begin using the ResellerClub registrar module:

1. Log in to the WHMCS Admin Area.
2. Go to Configuration () > System Settings > Domain Registrars or, prior to WHMCS 8.0, Setup > Products/Services > Domain Registrars.
3. Find ResellerClub in the list.
4. Click Activate.
5. Enter your Resellerclub API credentials.
6. Click Save Changes.

IP Registration

ResellerClub's API is IP address-restricted. To use the ResellerClub API, you must allow your server's IP address to access your ResellerClub account via the API. Failure to do this will result in the following error:

Access Denied: You are not authorized to perform this action.

To do this:

1. Log in to the LogicBoxes/ResellerClub control panel.
2. Navigate to Settings > API.
3. Enter your server's IP address.
   Use the Valid IP IP address in the WHMCS Admin Area at Help > License Information.
4. Click Save Whitelisted IP addresses.

Configuration

User Profile Menu

To configure ResellerClub:

1. Log in to the ResellerClub control panel.
2. Go to User Profile > Manage Profile.
3. Note the Reseller ID.
4. Go to Settings -> API.
5. Enter the IP address of your WHMCS installation's server.
6. Note the API Key.

Use the Reseller ID and API Key to configure the Resellerclub module in WHMCS.

Designated Agent

This option changes the approval workflow for updating the Whois contact details and transferring domain names. For more information, see the ResellerClub documentation.

Demo Mode

ResellerClub Demo Platform orders will simulate domain registration and management functions, but this will not register a domain and will not charge you. This can be useful to test WHMCS configurations.

To use the ResellerClub demo mode:

1. Register for an account on the dedicated demo system.
2. In WHMCS, navigate to ResellerClub at Configuration () > System Settings > Domain Registrars or, prior to WHMCS 8.0, Setup > Domain Registrars.
3. Enter the new Reseller ID and API Key for your demo account.
4. Check TestMode.
5. Click Save Changes.

After testing, enter the Reseller ID and API Key of your live account and uncheck TestMode.

IDN Configuration

To register internationalized domain names (IDNs) through ResellerClub, you must add an additional domain field to WHMCS via the resources/domains/additionalfields.php file.

The language options differ for each TLD. You can find the appropriate values in the idnLanguageCode section in the ResellerClub API Documentation.

For example, to register a .eu domain, add the following line to the /resources/domains/additionalfields.php file:

<?php
$additionaldomainfields[".eu"][] = array(
    "Name" => "IDN Language",
    "DisplayName" => "IDN Language",
    "LangVar" => "idnlang",
    "Type" => "dropdown",
    "Options" => "latin",
    "Default" => "latin",
    "Required" => "true",
);

For .org domains, add the following line to the /resources/domains/additionalfields.php file:

$additionaldomainfields[".org"][] = array(
    "Name" => "IDN Language",
    "DisplayName" => "IDN Language",
    "LangVar" => "idnlang",
    "Type" => "dropdown",
    "Options" => "da,de,hu,is,ko,lv,lt,pl,es,sv",
    "Default" => "da",
    "Required" => "true",
);

For more information, see the Additional Domain Fields documentation.

Domain Contacts

In WHMCS version 5.x and below, domain registration through LogicBoxes modules (ResellerClub, NetEarthOne, Stargate) always used the client's profile data regardless of whether User Client Details was disabled.

If a client has multiple registered domains, they will use the same contact details for all four Whois contacts. Changing the Whois details on one domain will also change the details for the others.

In WHMCS 6.x and above, domain registration creates a unique contact for each domain. This contact becomes the Registrant, Billing, Tech, and Admin contact for the domain's Whois records. Modifying the Whois details for the domain will change only that domain.

Automatic Registration

WHMCS allows you to set up automatic domain registration on a per-extension basis, enabling you to use different registrars for different TLDs.

To enable automatic registration, see Configuring Automatic Registration.

Automatic Domain Synchronization

The ResellerClub module supports automatic domain synchronization for syncing expiry dates and status changes for incoming transfers.

To use this, enable Domain Sync Enabled in the Domains tab at Configuration () > System Settings > General Settings or, prior to WHMCS 8.0, Setup > General Settings. You must also make certain to configure the Domain Sync Cron.

Troubleshooting

Connection Problems

The following errors occur when the ResellerClub server is unreachable. They may be experiencing problems or a local firewall may block the connection:

• HTTP Error: Couldn't open socket connection to server.
• Domain Registration Error - Unable to connect to Registry.

Access Problems

The following errors indicate problems accessing ResellerClub:

• Access Denied: You are not authorized to perform this action.
• CURL Error: 7 - couldn't connect to host.

Usually, this indicates that you haven't allowed your server's IP address to access your ResellerClub account via the API. Do this in the Settings > API section of the LogicBoxes control panel.

The IP address you need to authorize is typically the main shared IP address of the server, which is usually the IP address your WHMCS license is assigned to. If you experience problems, contact ResellerClub.

Invalid Password/Username, or your User account maybe Inactive or Suspended

This error response indicates that the login details in Configuration () > System Settings > Domain Registrars or, prior to WHMCS 8.0, Setup > Domain Registrars, for the Resellerclub module are incorrect or your account is suspended.

Website Doesn't Exist For xxx

This error indicates that the domain does not exist in your ResellerClub account while a domain transfer is in progress. It automatically disappears when the transfer is complete.

Telephone No. is invalid. Please note that only digits are allowed

This error displays when you include a country code in a phone number. Only enter the phone number as it would be called from that country.

Language code not valid for this TLD

This error occurs when attempting to register an IDN without specifying a valid language for the domain. For more information, see IDN Configuration.

If you have already configured a IDN Language additional domain field, this error indicates that the selected language is not valid for the TLD. For more information, see the idnLanguageCode section in the ResellerClub API Documentation.

An unknown fault occurred - please contact support

This error occurs when the client's profile data contains characters other than a-z and 0-9. The ResellerClub API won't accept any accents or other non-Latin characters.

You can customize WHMCS to automatically convert non-Latin characters. For more information, see Custom Transliteration.

An unexpected error has occurred

This error usually indicates that the login details are missing or incorrect. Make sure that you have correctly entered your reseller ID and API key at Configuration () > System Settings > Domain Registrars or, prior to WHMCS 8.0, Setup > Products/Services > Domain Registrars.

Required parameter missing: name

This error indicates that ResellerClub is not receiving the client's details. Make sure to enter the appropriate information in the following locations:

• Enter the client's details in the Profile and Contacts tabs.
• Enter your company details in the Domains tab at Configuration () > System Settings > General Settings or, prior to WHMCS 8.0, Setup > General Settings.

Also make certain to check Use Clients Details in the Domains tab at Configuration () > System Settings > General Settings or, prior to WHMCS 8.0, Setup > General Settings.

There is already a pending action on this domain

This message indicates that a Whois contact details update is pending on this domain. Once the new contact details are confirmed by the new and old contact, this message will disappear within one day.

For more information, see in our blog.