View source for Enom

== About this Module ==

The Enom module allows you to register and manage domains with Enom.
{{registrar
| register = yes
| transfer = yes
| renew = yes
| lock = yes
| dns = yes
| whois = yes
| getepp = yes
| regns = yes
| dnsmanagement = yes
| emailforwarding = yes
| domainsync = yes
| premium = yes
| transferout = yes
| tldpricingsync = yes
}}

==Activation==

<div class="docs-alert-success">
You must create an [https://www.whmcs.com/partners/enom/ Enom account].
</div>

To activate and begin using the Enom registrar module:

# Log in to your account on the [https://www.enom.com/apitokens/default.aspx Enom website].
# Enter an identifying name in the textbox (for example, <tt>WHMCS</tt>).
# Click '''Generate New API Token'''.
# Copy the generated API token.
# Log in to the WHMCS Admin Area.
# Go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Domain Registrars]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Domain Registrars'''.
# Find '''Enom''' in the list.
# Click '''Activate'''.
# Enter your Enom username.
# Paste in the API token.
# Check '''Disable IRTP''' to prevent WHMCS from displaying contact information verification notices.
# Check '''Use Default Nameservers''' to use Enom's default nameservers for new registrations, overriding the nameservers in WHMCS.
# Click '''Save Changes'''.
# In your Enom account, go to '''Resellers > Manage > API''' and add your server's IP address. 
#* You can find this address in WHMCS at '''Help > [[License Information]]'''.
#* If you do not do this, you will see a '''Registrar Error Invalid Client IP''' error.

<html><a href="http://www.youtube.com/watch?v=0Sz9mkBzLN0&hd=1" class="docs-video-tutorial"><em>Watch the video tutorial for this feature</em><span>&nbsp;<img src="https://assets.whmcs.com/icons/youtube.png">&nbsp;</span></a></html>
<div class="docs-alert-warning">Before you can begin using the Enom API with your account. you must authorize your server IP address for access to your account. See below for steps to do this.</div>

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

Before you enable '''Test Mode''' in WHMCS, you must register on Enom's Reseller Test environment:

# Log in to [https://resellertest.enom.com/resellers/reseller-testaccount.aspx Enom's Reseller Test Account].
# Click all three links under '''Test Interface Options''' to configure the test account.
# [https://resellertest.enom.com/apitokens/default.aspx Generate a test API token.]

When you place domain registration orders in WHMCS with test mode active, the domains will appear on your demo Enom account (<tt>http://resellertest.enom.com</tt>) but no domain will actually be registered and you will not be charged.

=== .ca Registrations ===

<tt>.ca</tt> registrations require additional fields. The <tt>Invalid registrant information</tt> error is due to problems with the location field. 

Instead of entering the full place name, use one of the following province abbreviations:

* Alberta — <tt>AB</tt>
* British Columbia — <tt>BC</tt>  
* Manitoba — <tt>MB</tt>  
* New Brunswick — <tt>NB</tt>  
* Newfoundland and Labrador — <tt>NL</tt>  
* Northwest Territories — <tt>NT</tt>  
* Nova Scotia — <tt>NS</tt>  
* Nunavut — <tt>NU</tt>  
* Ontario — <tt>ON</tt>  
* Prince Edward Island — <tt>PE</tt>  
* Quebec — <tt>QC</tt>  
* Saskatchewan — <tt>SK</tt>  
* Yukon — <tt>YT</tt>

== Transfer Pricing ==

Enom does not allow a domain's registration term to be defined when transferring a domain name.
 
When configuring pricing for TLDs to transfer using Enom, only configure a one year transfer price. Set all other transfer prices to <tt>-1.00</tt>.

== 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''' in the '''[[Domains_Tab|Domains]]''' tab at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings''' or, prior to WHMCS 8.0, '''Setup > General Settings'''. You must also make certain to configure the '''[[Crons#Domain_Sync_Cron|Domain Sync Cron]]'''.

== Troubleshooting ==

=== User not permitted from this IP address ===

This error message indicates that you haven't yet allowed your server's IP to [[Enom#Activation)|access your Enom account via the API as described in step 14 above]]. This must be done via the Enom website before you can use the integration.

The IP you need to authorize is typically the main shared IP of the server, usually most easily found from the IP your WHMCS license is assigned to, but if you're unsure or neither of those IPs work, then Enom can assist and advise you of the IP they see your connection tests as coming from via a support ticket.

=== Cannot parse empty response from server/Empty data response from server - Please try again later ===

This can occur only if an empty response is received from Enom. This isn't a curl error, but an empty response from the Enom API. This suggests a temporary problem at Enom's end. Trying the command again later should be successful.

=== Invalid data response from server - Please try again later ===

This can occur when an unexpected response occurs; e.g. a 404 error or other non-XML method. This suggests a temporary problem at Enom's end. Trying the command again later should be successful.
 
=== CURL Error ===

A standard curl error which indicates a connection issue between your server and Enom's API. Make certain that your server is able to make cURL calls to the following URLs:
 
Demo Mode: <tt>resellertest.enom.com</tt>
Live Mode: <tt>reseller.enom.com</tt>

=== Domain name not found ===

This error occurs when the domain does not exist in your Enom account. This message will be displayed when a domain transfer is in progress but will automatically disappear when the transfer is complete. 

{{modules}}
No results found.