ResellerClub

The ResellerClub module allows you to register and manage domains with ResellerClub.

Supported Features

RegisterTransferRenewRegistrar LockUpdate Nameservers
Update WHOISGet EPP CodeRegister NameserversDNS Record ManagementEmail Forwarding
Domain ReleaseDomain Sync ScriptPremium DomainsTransfer Out AutomationTLD Pricing Sync

Activation

You must create a ResellerClub account.

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.
  3. Find ResellerClub in the list.
  4. Click Activate.
  5. Enter your ResellerClub API credentials and configure the module’s settings.
    Entering ResellerClub credentials
    • You can find your ResellerClub API credentials in the ResellerClub control panel:
      • Your reseller ID appears in the user menu or you can view it at User Profile > Manage Profile.
        The User Profile menu in ResellerClub
      • Your API key appears at Settings > API when you click View API Key.
    • Enable Designated Agent to act as the designated agent for all contact changes.
      For more information, see the ResellerClub documentation.
  6. Click Save Changes.
  7. Grant API access to your ResellerClub account to your server’s IP address. You can do this by going to Settings > API in the ResellerClub control panel and entering and saving your IP address under Whitelist your IP Addresses.
    • You can find the IP address to use in WHMCS at Help () > License Information.
    • If you do not do this, you will see a You must authorize your IP address to use this API. error in WHMCS 8.4 and later or an Access Denied error in WHMCS 8.3 and earlier.

Test Mode

ResellerClub requires the use of a Demo Account Reseller ID and API Key with the Test URL instead of your Live Account credentials. Use of your Live Account credentials, even with the Test URL, will cause you to perform actions in the live environment.

You can use test mode to simulate domain registration and management function without registering a domain or incurring charges. This can be useful to test WHMCS configurations.

Nameservers

Live nameservers will return a Nameserver is not a valid Nameserver error unless you create and register them in the demo environment before attempting domain registrations on the demo platform. The demo control panel will try to check the validity of the nameservers in the demo platform and not on the registry.

You can use ns1.onlyfordemo.net and ns2.onlyfordemo.net as your nameservers without registering them on the demo environment.

Terms and Conditions

ResellerClub requires that clients agree to their terms and conditions when registering a domain. To do this, it adds an additional checkbox to the registration process.

To translate the checkbox name, use tnc as the LangVar key in the appropriate language file in the lang/overrides/ directory:

$_LANG['tnc'] = 'I agree to the ResellerClub terms and conditions.';
For more information, see Additional Domain Fields.

Domain Contacts

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 Domain Pricing.

Automatic Domain Synchronization

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

To use this, enable Domain Sync Enabled and configure the domain sync task at Configuration () > System Settings > Automation Settings.

Check Prices

You can check the prices that you pay for each domain from within your ResellerClub account.

To do this:

  1. Log in to the ResellerClub control panel.
  2. Go to Settings > Manage Products and Pricing > Set the price for the TLDs you want to sell.
  3. Select the Sub-Reseller tab.
  4. Click Manage Pricing for the TLD that you want to view.

A Your Cost Price row will display the price for each type of that TLD.

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:

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

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

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 or Contacts tabs of the client’s profile.
  • Enter your company details in the Domains tab at Configuration () > System Settings > General Settings.

Also make certain to check Use Clients Details in the Domains tab at Configuration () > System Settings > General Settings.

There is already a pending action on this domain

This message indicates that an update to the domain’s contact information is pending. After the new and old contacts confirm the new contact details, this message will disappear within one day.

For more information, see ICANN Policies.

Locked in Processing Errors

A Locked in Processing error indicates that you do not have enough funds in your ResellerClub account.

For more information, see ResellerClub’s Interpreting Order Locked in Processing Messages documentation.

Last modified: September 23, 2024