.. _epp-domain-create:

Domain Create
=============

Client request
--------------

Differences from standard EPP
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

* To submit a domain name registration request, at least ``domain:registrant``
  and ``domain:contact type="admin"`` elements should be present containing contact handles
  of the holder and administrative contact person for domain name respectively
  (they are both mandatory for us).

.. _domain-create-policy-restrictions:

Policy restrictions
~~~~~~~~~~~~~~~~~~~

* A minimum length of a domain name is 2 characters (so, both "a.lv" and "ā.lv" may not be registered)
* Only legal values for ``domain:period`` is 1 year
* Technical contact is mandatory and should be one of the registrar's hostmasters
  (also, if ``__DEFAULT__`` is specified as a contact handle or no technical contact has been given,
  the registrar's default hostmaster is assigned for the role).
* Although billing contact (``domain:contact type="bill"``) may be given, the only legal value for it
  is contact handle of the :term:`registrar's primary person` (there, too ``__DEFAULT__`` may be used as a contact handle).
* Administrative contact of the domain name is mandatory and should be a private person
* If the holder is a private person, the same contact should be used also for administrative contact
  (``domain:registrant`` and ``domain:contact type="admin"`` elements should contain the same values).
* Up to 5 nameserver hosts may be assigned (given as ``domain:hostAttr`` elements). At least
  two are required for a domain name to be published in the zone.

  .. note ::

    IPv6 is now supported while creating domain.

example:

.. code-block:: xml

    <?xml version="1.0" encoding="UTF-8" standalone="no"?>
    <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd">
      <command>
        <create>
          <domain:create xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"
                         xsi:schemaLocation="urn:ietf:params:xml:ns:domain-1.0 domain-1.0.xsd">
            <domain:name>ālūla.lv</domain:name>
            <domain:period unit='y'>1</domain:period>
            <domain:ns>
              <domain:hostAttr>
                <domain:hostName>ns.someserver.lv</domain:hostName>
              </domain:hostAttr>
              <domain:hostAttr>
                <domain:hostName>a-new-domain.lv</domain:hostName>
                <domain:hostAddr ip="v4">1.2.3.4</domain:hostAddr>
                <domain:hostAddr ip="v6">2a02:500:4400:500::2</domain:hostAddr>
              </domain:hostAttr>
            </domain:ns>
            <domain:registrant>test1106-27</domain:registrant>
            <domain:contact type='admin'>huma1106-28</domain:contact>
            <domain:contact type='tech'>__DEFAULT__</domain:contact>
            <domain:authInfo>
              <domain:pw>opqrstuv</domain:pw>
            </domain:authInfo>
          </domain:create>
        </create>
        <clTRID>9Gb3uEpUn6POknxbMWSn</clTRID>
      </command>
    </epp>

How registration requests are reviewed?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

An automatic process is invoked over a short interval which accepts registration requests if there is only one submitted for a given domain name.
If several registration requests are found for a single domain name or when an .id.lv domain name is requested, a human review is carried out in a time of one working day.
Registration request is either accepted or rejected and an appropriate EPP service message is queued for the registrar.

Server response
---------------

On success, a new domain name registration request is stored and following ``<domain:info>`` commands would report domain name as having a ``pendingCreate`` status.

.. note ::

   ``domain:name`` element in server response would contain domain name in its ASCII-encoded (punycode) form (so, when creating "ārečenu.lv", the server would return it as "xn--reenu-ewa0g.lv")

.. code-block:: xml

    <?xml version="1.0" encoding="UTF-8" standalone="no"?>
    <epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd">

      <response>
        <resData>
          <domain:creData xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"
                          xsi:schemaLocation="urn:ietf:params:xml:ns:domain-1.0 domain-1.0.xsd">
            <domain:name>xn--lla-0oa54c.lv</domain:name>
            <domain:crDate>2011-06-27T11:48:24+03:00</domain:crDate>
          </domain:creData>
        </resData>
        <result code="1001">
          <msg>Command completed successfully; action pending</msg>
        </result>
        <trID>
          <clTRID>9Gb3uEpUn6POknxbMWSn</clTRID>
          <svTRID>LVNIC-20110627-a097e71920248735a710eb84b9fba482-2</svTRID>
        </trID>
      </response>
    </epp>

Example of error response if another registration request already exists
for the same domain name:

.. code-block:: xml

    <?xml version="1.0" encoding="UTF-8" standalone="no"?>
    <epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd">

      <response>
        <result code="2302">
          <msg>Domain name already exists in pendingCreate state</msg>
        </result>
        <trID>
          <clTRID>6UT5BgGMgXrYFTwNrIVI</clTRID>
          <svTRID>LVNIC-20110627-b8c49f5859f20d81640f9dfc94771136-1</svTRID>
        </trID>
      </response>
    </epp>