TLD Setup (Top Level Domain)

Top Level Domain can be setup so you can offer customers the ability to order domains during the signup process.  The system will allow you to configure each TLD (Top Level Domain) you want to offer your customers. You can also select the Whois Server you want to use for each TLD along with pricing plans including registrations and transfers.

Setting Up A TLD Configuration (Example: .com)
TLD Specific Configuration Options

Adding A New TLD

Setting Up A TLD Configuration

In our example we use the .com TLD that is setup by default in your system.

1. Go to Products/TLD Setup. When the page loads you will see a list of TLDs that are already setup by default.

2. Click on Edit in the Action column for the .com (USA) TLD.

3. By default "com" is already entered in the Extension textbox.

4. By default ".com (USA)" is already entered in the Name textbox. This is what will be displayed in the order form.

5. By default "whois.internic.net" is already entered in the Whois Server textbox. You can change this to the Whois Server of your choice.

Notes: Define the Whois Server you want to search for this TLD extension. Not all servers are the same and there may be more than one that will work for you.

The billing system supports fsocket connections: (Example: "whois.internic.net")

And also URL based searches: (Example: "http://www.some_whois_server.com/some_lookup.cgi?domain=%%domain%%" )

Be sure to use the %%domain%% variable to be replaced at runtime with a domain name.

IMPORTANT:
Please be sure that Port 43 is open to allow proper connection to the whois server.

6. By default "No match" is already entered in the Whois Match textbox. If the Whois Match is not set correctly, the domain search for this TLD in the order form will not function properly. Please read the Notes section below.

Notes: Define the string to be searched for within the results of the whois query. (Example: "No Match" is different than no match)

IMPORTANT:
You should test the Whois Server in your order form with BOTH a registered and non-registered domain. The “whois match” string is case sensitive and the Whois Server you selected may use something entirely different than “No Match”. The best way to test this is to go directly to the Whois Server and run a non-registered domain query. Then look for the text that will signify the domain is not registered and use it as your Whois Match.

HINT: To find out the exact Whois Match, turn on Debug Mode by going to Tools/System Config/Main System Config. When you search for the domain in your order form Debug Mode will output the exact Whois Match.

7. Change the Status to Active using the drop down menu.

8. For the Auto Search selection, select Yes if you want this TLD searched during the signup process.

Notes: You should never have more than 2 or 3 TLDs set to Yes. Your connection may timeout.

9. If you offer domain transfer, set the price in the Transfer Registrars textbox provided.

Notes: Enter "0.00" for a FREE transfer OR "0.001" to suppress the transfer option.

10. Set the price for each number of years for domain registrations. If you do not offer a specific number of years for domain registrations, leave the price as default "0.000" and the year(s) will not be displayed and offered to your customers.

11. Select the Registrar you would like to use in the drop down menu.

12. The Package MUST be set to Domain Registration in the drop down menu.

NOTICE: The generic domain registration MUST be mapped to each TLD configuration. This is how the system knows to create a domain registration package in the order from. To learn more about the Domain Registration package, take a look at the Domain Registration Package document.

13. Select the Order Group you want to map your TLD to in the Order Group drop down menu.

14. Click on Submit.

15. Repeat Steps 1-14 to edit additional TLDs.

TLD Specific Configuration Options

Some of the TLD Specific Configuration Options are specific to the Registrar you are using and should be verified.

NOTICE: If you are using eNom as your domain registrar for any of your TLDs, please visit http://www.enom.com/help/faq_tlds.asp. When the page loads, use the matrix as a reference when configuring each of your TLDs.

1. Enter the minimum term you want your TLD to be registered in the Minimum Term textbox. The default value is 1.

2. Enter the maximum term you want your TLD to be registered in the Maximum Term textbox. The default value is 1.

3. Do you want your TLD to be renewable? Select Yes or No for the Renewable setting.

4. Do you want your TLD to be transferable? Select Yes or No for the Transferable setting.

5. Take a look at the Transfer Type Key below.

1=Auto (standard email approval)
2
=Fax (must fax in a signed authorization letter)
3
=EPP (Requires an authorization key for each transfer request)

Next, enter the value you want to use for your TLD in the Transfer Type textbox. The default value is 1.

NOTICE: If you are using the eNom registrar module, you MUST look at the Transfers column in the eNom TLD Overview matrix.

Example: org, biz, us, and info all use Transfer Type EPP. For EPP transfers you will enter 3 in the Transfer Type field of each TLD.

6. Select Yes or No for the Lockable setting. Your registrar must support domain locking.

NOTICE: Your Registrar MUST support this feature. Please check with your Registar to verify.

7. Do you want your TLD to be auto renewed at the end of each billing cycle? Select Yes or No for the Auto Renewable setting.

NOTICE: Your Registrar MUST support this feature. Please check with your Registar to verify.

8. Leave the IDN Support and IDN Type as default. Currently these settings are not available.

Adding A New TLD

1. Go to Products/TLD Setup.

2. Click on Add.

Follow Steps 1-14 in the Setting Up A TLD Configuration section above.