ZA Domain Create
Table of Contents
1. Performing the Domain Create Request
2. Possible Responses
2.1. 1000: Domain Creation Successful
2.2. 2302: Domain or Subordinate Nameserver Duplication
2.3. 2303: Associated Contact Errors
2.4. 2306: Policy Restriction Errors
EPP Domain Create
Notes
1. The ZACR makes use of the <domain:hostAttr> elements for the creation of domains.
2. When creating a domain with subordinate hosts, the IP address must be specified for the nameservers in the <domain:hostAttr ip='v4'> (or v6) element. IPv4 and IVP6 are supported.
3. When creating a domain with delegated hosts the IP address in not required as the IP address has already been specified on creation of the parent domain.
4. Multiple IPv4 and IPv6 addresses may be specified by duplicating the <domain:hostAttr ip=''> element for each nameserver.
5. The <domain:contact type=''> element must be specified 3 times, providing the contact ID for the "admin", "billing" and "tech" contacts for the domain name.
6. A <domain:pw> must be specified. This password will be used for transfers between registrars. The CO.ZA namespace requires that this element must have a value of "coza" ONLY.
7. The <domain:period> element may be used to specify the initial duration of the registration. If this element is not provided, the registry will default to a 1 year registration. Please note that for the CO.ZA namespace, this element must have a value of "1".
8. The ZACR WILL perform nameserver checks on the successful creation of a domain. Unsuccessful checks will result in the domain name having a "serverHold" message attached. Registrars are encouraged to have responsive nameservers prior to registration of the domain.
9. The ZACR will send poll message notifications to registars for a continuous week if the nameservers are still unresponsive. Please reference the Poll Messages section for an example of the messages.
<epp:command>
<epp: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>exampledomain.test.dnservices.co.za</domain:name>
<domain:period unit="y">1</domain:period>
<domain:ns>
<domain:hostAttr>
<domain:hostName>ns1.exampledomain.test.dnservices.co.za</domain:hostName>
<domain:hostAddr ip="v4">x.x.x.x</domain:hostAddr>
<domain:hostAddr ip="v4">y.y.y.y</domain:hostAddr>
<domain:hostAddr ip="v6">
ff02::1</domain:hostAddr> </domain:hostAttr>
<domain:hostAttr>
<domain:hostName>ns1.otherdomain.test.dnservices.co.za</domain:hostName>
</domain:hostAttr>
</domain:ns>
<domain:registrant>RegistrantID</domain:registrant>
<domain:contact type="admin">AdminID</domain:contact>
<domain:contact type="tech">TechID</domain:contact>
<domain:contact type="billing">BillingID</domain:contact>
<domain:authInfo>
<domain:pw>TransferPassword</domain:pw>
</domain:authInfo>
</domain:create>
</epp:create>
</epp:command>
</epp:epp>
Possible Responses
The following are possible responses from our server.
1000: Domain Creation Successful
A response code of 1000 means that the domain has been successfully created and entered into the registry database.
<epp:response>
<epp:result code="1000">
<epp:msg>Domain Creation Successful</epp:msg>
</epp:result>
<epp:resData>
<domain:creData xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
<domain:name>exampledomain.test.dnservices.co.za</domain:name>
<domain:crDate>2010-01-01T04:41:55Z</domain:crDate>
<domain:exDate>2011-01-01T04:41:55Z</domain:exDate>
</domain:creData>
</epp:resData>
<epp:trID>
<epp:svTRID>ZACR-EPP-13EF8E45C1E-5FA29</epp:svTRID>
</epp:trID>
</epp:response>
</epp:epp>
2302: Domain Exists or Subordinate Nameserver Duplication
A response code of 2302 means that either the domain name specified is already registered in the registry database, or the nameserver(s) specified are being duplicated. The associated messages are as follows:
1. "Domain exists: exampledomain.test.dnservices.co.za" means that the domain name is already registered.
2. "Domain 'exampledomain.test.dnservices.co.za' exists in a reserved list" means that the domain name is currently reserved and may not be registered.
3. "domain_host object already exists: ERROR" means that 1 or more nameservers that you specified are being duplicated in the request. Please review your request and ensure that nameserver names are unique.
<epp:response>
<epp:result code="2302">
<epp:msg>MESSAGE AS ABOVE</epp:msg>
</epp:result>
<epp:trID>
<epp:svTRID>ZACR-EPP-13EF8F9993D-58181</epp:svTRID>
</epp:trID>
</epp:response>
</epp:epp>
2303: Associated Contact Errors
A response code of 2303 means that there was an error in the declaration of the associated contacts. The associated messages are as follows:
1. "Contact 'ContactID' not found" means that one of your declared contacts in either the Registrant, Tech, Billing, Admin or Reseller elements has not been created with the registry. Please perform a Contact Create to create the contact and try again.
2. "Registrar contacts cannot be used as registrants" means that you have declared your registrar ID in the <domain:registrant> element. Please review the request and associate the correct information.
<epp:response>
<epp:result code="2303">
<epp:msg>MESSAGE AS ABOVE</epp:msg>
</epp:result>
<epp:trID>
<epp:svTRID>ZACR-EPP-13EF8FBCD3E-B13B5</epp:svTRID>
</epp:trID>
</epp:response>
</epp:epp>
2306: Policy Restriction Errors
A response code of 2306 means that your request does not match the policies for Domain Creation as outlined by the ZACR. The associated messages are as follows:
1. "A minimum of two and a maximum of 10 nameservers are required" means that you have either specified more that 10 (ten) nameservers in the requests, or that you have specified less than 2 (two) nameservers in the request. Please review the request and ensure that a minimum of 2 (two) nameservers are provided, with a maximum of 10 (ten) being provided.
2. "Domain period unit 'm' not supported" means that you have specified the <domain:period> element in your request, with an attribute of "m". Only an attribute of "y" is accepted by some ZA Namespaces. Please review the individual Published Policies and Procedures for identification of use.
<epp:response>
<epp:result code="2306">
<epp:msg>MESSAGE AS ABOVE</epp:msg>
</epp:result>
<epp:trID>
<epp:svTRID>ZACR-EPP-13F186E3F49-7F53D</epp:svTRID>
</epp:trID>
</epp:response>
</epp:epp>
2201: Requestor != Contact Owner ContactID
A response code 2201 means that one of the specified contacts in the Registrant, Billing, Admin, Tech or Reseller contacts hos not been created by you. Please ensure that all specified contacts are owned by you before proceeding. Additional contact types are accepted by some ZA Namespaces. Please review the individual Published Policies and Procedures for identification of use.
<epp:response>
<epp:result code="2201">
<epp:msg>Requester != Contact Owner ContactID</epp:msg>
</epp:result>
<epp:trID>
<epp:svTRID>ZACR-EPP-13EF900B2DE-A4677</epp:svTRID>
</epp:trID>
</epp:response>
</epp:epp>
2003: Claims Notice Check required
A response code of 2003 means that there is a Prior Right associated with the domain name. This result will only be returned during the Claims Period of General Availability. The Claims Period is a total of 90 days initiated from the start of General Availability.
In order to continue with the registration of the domain, the Claims Period Domain Check command has to be used and the Claims Period Domain Create command has to be used.
All the information on how to handle Claims Period Domain Creates is available HERE.
<epp:response>
<epp:result code="2003">
<epp:msg>Claims Notice Check required</epp:msg>
</epp:result>
<epp:trID>
<epp:svTRID>ZACR-EPP-14401396381-D29E2</epp:svTRID>
</epp:trID>
</epp:response>
</epp:epp>
Last update: 17-06-2016 09:08:05
festive season
As the end of the year approaches, please keep in mind the following information to avoid any frustrations over the holiday period.
Closure Date:
Our offices will be closed from the 21st of December 2020 and will reopen on the 4th of January 2021. We will have skeleton staff on standby to attend to urgent customer queries.
Contact details:
EPP and Legacy Support: support@registry.net.za
EPP and Legacy Accounts: accounts@registry.net.za
Legal: legal@registry.net.za
Happy holidays and let us continue to maintain social distancing as we approach this peak time!
ZACR Team
Technical Support
All issues and questions relating to the co.za EPP Registry Registrar System must be raised in the Contact/Support pages through the Registrar Portal. This is to ensure that our support department tracks and addresses all issues. Log in to the Registrar Portal and submit a support request online.
Registrar Noticeboard
Click here for the latest status updates.