Latest revision as of 12:18, 7 June 2023

About this Module

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 or, prior to WHMCS 8.0, Setup > Products/Services > Domain Registrars.
3. Find HEXONET in the list.
4. Click Activate.
5. Enter your HEXONET credentials and configuration.
   • For help with using a proxy server, see HEXONET's documentation.
   • By default, the HEXONET API converts domains to IDN format (recommended). Change this to PHP to make use of the idn_to_ascii function (deprecated). This function must be compiled 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.
6. Click Save Changes.
7. Log in to the HEXONET control panel.
   

   Renewal Mode Setting
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, domains might be renewed 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. Navigate 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.

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 or, prior to WHMCS 8.0, Setup > Automation Settings.

Troubleshooting

Disconnected / Authorization Failed

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 or, prior to WHMCS 8.0, Setup > Products/Services > Domain Registrars.
• Two-Factor authentication is enabled for the user in your HEXONET account. This can be resolved 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 vice versa. The HEXONET OTE API uses a different set of login credentials than the production environment.

Empty response from API

This can occur when 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 that these ports are whitelisted in your server firewall.