Revision as of 19:33, 4 May 2017

Supported Features

Configuration

1. Begin by going to Setup > Products/Services > Domain Registrars
2. Locate eNom in the list of registrars and click the Activate button
3. The eNom configuration screen will then be displayed
4. Enter your eNom username and API Token
5. Click Save

IP Registration (User not permitted from this IP address)

In order to use the Enom API, you must first contact them and let them know the server IP address where you will be connecting from (the server IP address where you have WHMCS installed). This is part of Enom's security measures to prevent unauthorised users being able to submit registration requests to your account.

• Login to your account on the Enom website,
• Navigate to Resellers > Manage > API
• Enter your server's IP address into the "New" field.
• Click "add"

Test Mode

To use the Enom test mode, it's not as simple as ticking the test mode option in the configuration area. You must setup an account separately on the dedicated demo system they offer. In your Enom account navigate to Resellers > API > Test Account and click all three links under "Test Interface Options": http://www.enom.com/resellers/ResellerTestAccount.asp

With the Test Mode checkbox ticked you can now place domain registration orders in WHMCS, the domains will appear on your demo Enom account @ http://resellertest.enom.com but no domain will actually be registered and you will not be charged.

Expiry Date Syncronisation

WHMCS can sync the expiry dates of domains you have registered with Enom. This is particularly useful for domain transfers where the expiry date cannot be calculated automatically. This can be enabled under Setup > General Settings > Domains Tab.

Notes

.ca Registrations

.ca Registrations require additional fields. A common error "Invalid registrant information" is caused by the location field. Instead of entering the full place name you should use one of the following province abbreviations:

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

Upsell ID Protection

We have created some 'copy & paste' ready code for adding to the order templates to promote the ID Protection service within the order process and change it from being something users have to opt-into to being an addon that's enabled by default that they have to opt out from instead. For more information refer to Enom ID Protection Promo.

Common Problems

User not permitted from this IP address

This error message indicates that you haven't yet allowed your server's IP to access your eNom account via the API. You have to do this by opening a ticket to eNom's API department 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. EG 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. Please ensure your server is able to make cURL calls to the following URLs:

Demo mode: resellertest.enom.com
Live: reseller.enom.com