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

Supported Features #

Activation #

To activate and begin using the HEXONET registrar module:

1. Log in to the WHMCS Admin Area.
2. Go to Configuration () > System Settings > Domain Registrars.
3. Find HEXONET in the list.
4. Click Activate.
5. Enter your HEXONET credentials and configuration.
   • By default, the HEXONET API converts domains to IDN format. Change this to PHP to use the deprecated idn_to_ascii function. You must compile this function in your php.ini file.
   • Check DNSSEC to display the DNSSEC configuration interface in the Client Area domain details page. This feature allows your customer to add DS and KEY records and set the maxSigLife setting.
   • Check TRANSFERLOCK to automatically apply the transfer lock to new domain registrations.
     For help with using a proxy server, see HEXONET’s documentation.
6. Click Save Changes.
7. Log in to the HEXONET control panel.
8. Go to Products > Domain Name Settings. Click + More and search for it if you do not see it in the list.
   
9. For Renewal Mode For New Domains, select Expire Domain. If you do not do this, the system may renew domains without payment from the client.
10. Click Save.

IP Registration #

HEXONET’s API is not IP address-restricted by default. However, you can configure this restriction in the control panel to improve security.

To do this:

1. Log in to HEXONET.
2. Click on your username in the upper-right corner.
3. Go to Settings > Security > IP Restrictions.
4. Enter your server’s IP address.
5. Click Save Changes.

You can find the IP address to whitelist at Help () > License Information in the WHMCS Admin Area.

Test Mode #

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.

To use Test Mode, you must create a HEXONET test account.

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.

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.

Troubleshooting #

Disconnected or Authorization Failed Errors #

Common causes for a Disconnected or Authorization Failed error are:

• An incorrect password or username in the registrar module settings at Configuration () > System Settings > Domain Registrars.
• Two-Factor authentication is enabled for the user in your HEXONET account. Resolve this by deactivating it for your HEXONET user or creating a restricted user role and new user that WHMCS will use to connect to HEXONET’s API.
• IP address restriction settings in your HEXONET account do not allow your WHMCS server to connect to the HEXONET API.
• Your server firewall is blocking the connection.
• You are connecting to the test environment using your HEXONET production account or connecting to the production environment using your test account. The HEXONET OTE API uses a different set of login credentials than the production environment.

Empty response from API #

This error indicates that the API endpoint is unreachable. You can test this by running the ping api.ispapi.net command from the WHMCS server’s command line.

The module uses ports 80 and 443 to connect to HEXONET over HTTP. Make sure to whitelist these ports in your server firewall.

Last modified: October 25, 2024