Top-level domains

BILLmanager includes over 500 pre-configured top-level domains (TLD). Additionally, you can:

• create and configure a new top-level domain;
• configure the set of fields for domains contacts in accordance with registrar requirements.

Creating top-level domains

To create top-level domain, go to Directories → Top-level domains → click Add:

1. Name — the name of the top-level domain. It can be specified in punycode or national symbols. When saved, the name will be converted to Punycode.
2. Data retrieval — source of data on domains. Available protocol options

   • WHOIS — uses a text response format and connects to the server via port 43. When selected, the following settings are available:

     • Whois host — the whois address of the server for the top-level domain. It also can be a whois server provided by the domain registrar, which supports the top-level domain. The whois server specified here will be used for checking whether the domain name is available.
     • Whois string — the response string of the whois server which will be used to determine the availability of the domain.

   • RDAP — uses a structured data format in the form of JSON and data transfer over the HTTPS protocol. When selected, the following setting is available:

     • RDAP URL — URL of the server that provides information on domains.
   For each tariff, you can configure your own method of receiving data. More details in Tariff plan settings for domains.
3. Request timeout — timeout for a response of the whois server when domain name availability is checked.

4. Supported characters — groups of characters available for use in the domain name. They can be:

   • Latin alphabet letters — the domain name can contain letters from the Latin alphabet, digits, and -.
   • Latin alphabet letters and characters from the sets — the domain name can contain letters from the Latin alphabet, digits, and -, or characters from the kit. Characters from the kit can be set up in Directories → Top-level domains → click Characters.
   • only characters from the list — the domain name can contain characters from the kit only. They can be set up in Directories → Top-level domains → click Characters.
5. Minimum name length — the minimum length of the domain name. It is to be specified in national alphabet characters or symbols of the Latin alphabet.
6. Maximum name length — the maximum length of Punycode for the domain name.

For example, the Whois string value is no match. When a new order comes, the billing platform will request information about the domain name from the whois server.

If the response string includes no match, then this domain will be available for registration. Otherwise, it is be considered occupied and unavailable for registration.

$ whois -h whois.verisign-grs.com domain2dom3ain.com
No match for "DOMAIN2DOM3AIN.COM".
......

Character kits for top-level domains are the files stored in catalog /usr/local/mgr5/etc/idntable and containing the Unicode of the characters to be used in the name. The name can contain characters only from the same kit. National symbols are not supported in domain registration if the domain zone does not have the corresponding character set in the system. 

You can change any of the top-level domain settings for any tariff plan. E.g. you can set a different registration price for domains of different length.

After creating a new domain zone, restart the platform. Run the command:

/usr/local/mgr5/sbin/mgrctl -m billmgr exit

Modifying top-level domains

To modify a top-level domain:

1. Go to the Directories → Top-level domains → select a domain → click Edit.
2. Modify the settings as described in the section Creating top-level domains.
3. Restart the platform with the command:

   /usr/local/mgr5/sbin/mgrctl -m billmgr exit

Domain parameter settings

To configure top-level domain parameters, go to the Directories → Top-level domains → select a domain → click Contact parameters. You can:

• Add the parameter. For details, see the Creating parameters section;
• Edit the parameter;
• Delete the parameter;
• configure parameter interaction with registrar Processing modules:
  • Edit— make filling in the parameter mandatory. The setting is available if the processing module is enabled for the parameter. For test fields you can also set:
    • Minimum number of characters — specify the minimum number of characters that the customer can enter;
    • Maximum number of characters — specify the minimum number of characters that the customer can enter;
  • Enable — enable use of the parameter with the registrar processing module;
  • Disable — disable use of the parameter with the registrar processing module;
• set Values for parameters of the "List" type. For details, see the Configuring values section;
• Restore default parameter values;
• move the parameter Up or Down in the list.

Creating a parameter

To create a parameter for a domain contact, go to the Directories → Top-level domains section → select a domain → click Contact parameters → click Add:

1. Select registrar Processing modules to which the parameter needs to be connected.
2. Click Next.
3. Fill in the required data in the Main settings section:
   1. Name — specify the parameter name. Required field.
   2. Internal name — specify the parameter name for its identification in service  processing modules. Required field. Name requirements:
      • • unique;
        • consists of Latin alphabet characters;
        • contains only lowercase letters;
        • does not contain spaces, special characters (except underscore);
        • does not start with a digit.
   3. Hint — specify a hint for customers.
   4. Select Use for all countries or Select countries for which the parameter is relevant.
   5. Select Contact type:
      • individual;
      • legal entity;
      • sole proprietor.
   6. Select Contact view. Available options:
      • Customer contact;
      • Owner contact;
      • Billing contact;
      • Administrative contact;
      • Technical contact;
      • CED — Charter Eligibility Declaration Contact. Charter Eligibility Declaration Contact. A contact type used when registering domains in the .ASIA zone
   7. Select the Block in which the parameter will be located. For example, "General parameters" or "Contact person details".
   8. Select Input field type:
      • string field;
      • list;
      • list with multiple selection;
      • flag;
      • text area.
   9. Select Multiple values if you need to enter multiple values separated by spaces. The selected validator will be applied to each value individually.
   10. Specify the Number of input lines in the text field.
   11. Select a Validation function for the entered value to prevent the user from entering a value in an incorrect format.
   12. Sorting — specify a value for the sort parameter. The lower the value, the higher the position in the list.
4. Fill in the required data for the selected registrar processing modules:
   1. Required parameter — enable the option to prevent the customer from leaving the field empty.
   2. Minimum number of characters — specify the minimum number of characters that the customer can enter.
   3. Maximum number of characters — specify the minimum number of characters that the customer can enter.
5. Click Finish.

Configuring values

To set values for parameters of the "List" type, go to the Directories → Top-level domains section → select a domain → click Contact parameters → select a parameter → click Values:

1. Click Add.
2. Specify Name.
3. Specify Internal name.
4. Specify Code.
5. Select the Send code option if upon sending the value needs to be taken from the Code field, rather than Internal name.
6.  Sorting — specify a value for the sort parameter. The lower the value, the higher the position in the list.