ZA Contact Create
Table of Contents
1. Performing the Contact Create Request
2. Possible Responses
2.1. 1000: Contact Creation Successful
2.2. 2303: Contact Exists
2.3. 2004: Internationalised contact address must only contain ascii characters
EPP Contact Create
Notes
1. The <contact:id> element in the unique identifier for the contact object. A registrar decides a contact's unique ID.
2. The <contact:postalInfo type="loc"> element. Within this element the localised contact information may be provided. Localised information may be in UTF8 format, representing the formal version of the information partaining to the locale of the contact.
3. The <contact:postalInfo type="int"> element. Within this element the internationalised contact information may be provided. Internationalised information must be in ASCII format, representing the internationally readable format of the contact information.
4. The <contact:name> element must contain the full name of the registrant.
5. The <contact:addr> element. Within this element, child elements will be included that specify address information about the registrant.
6. Within the <contact:addr> element, the following child elements must be populated with the relative registrant information: <contact:street>, an OPTIONAL secondary <contact:street> for the suburb, <contact:city>, OPTIONAL <contact:sp> to indicate the province, OPTONAL <contact:pc> to indicate the postal code, <contact:cc> to indicate the country code.
7. The <contact:voice> to indicate the telephone number of the registrant. The syntax for the value must be a "+" followed by the country dialing code such as "27" for South Africa, followed by a ".", followed by the rest of the digits in the number.
8. The <contact:fax> element. This tag is OPTIONAL as not all registrants have faxes.
9. The <contact:email> element to indicate the registrant's e-mail address.
10. The <contact:authInfo> element is not used by any ZA Namespace therefore it is not shown below.
11. The <contact:disclose> element is not used by any ZA Namespace therefore it is not shown below.
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>
<contact:create xmlns:contact="urn:ietf:params:xml:ns:contact-1.0"
xsi:schemaLocation="urn:ietf:params:xml:ns:contact-1.0 contact-1.0.xsd">
<contact:id>YourChosenID</contact:id>
<contact:postalInfo type="loc">
<contact:name>John Doe LOC</contact:name>
<contact:addr>
<contact:street>12 Fake Place</contact:street>
<contact:street>False Street</contact:street>
<contact:street>Nowhere</contact:street>
<contact:city>Invisible City</contact:city>
<contact:sp>Province</contact:sp>
<contact:pc>1111</contact:pc>
<contact:cc>CountryCode</contact:cc>
</contact:addr>
</contact:postalInfo>
<contact:postalInfo type="int">
<contact:name>John Doe INT</contact:name>
<contact:addr>
<contact:street>12 Fake Place</contact:street>
<contact:street>False Street</contact:street>
<contact:street>Nowhere</contact:street>
<contact:city>Invisible City</contact:city>
<contact:sp>Province</contact:sp>
<contact:pc>1111</contact:pc>
<contact:cc>CountryCode</contact:cc>
</contact:addr>
</contact:postalInfo>
<contact:voice>+27.123456789</contact:voice>
<contact:fax x="01">+27.123459876</contact:fax>
<contact:email>contact@email</contact:email>
</contact:create>
</create>
</command>
</epp>
Possible Responses
The following are possible responses from our server.
1000: Contact Creation Successful
A response code of 1000 means that the contact object has been created and may be used.
<epp:response>
<epp:result code="1000">
<epp:msg>Contact Creation Successful</epp:msg>
</epp:result>
<epp:resData>
<contact:creData xmlns:contact="urn:ietf:params:xml:ns:contact-1.0">
<contact:id>YourChosenID</contact:id>
<contact:crDate>2010-01-01T07:00:52Z</contact:crDate>
</contact:creData>
</epp:resData>
<epp:trID>
<epp:svTRID>ZACR-EPP-13EE4CA2297-14BF7</epp:svTRID>
</epp:trID>
</epp:response>
</epp:epp>
2302: Contact Exists ID
A response code of 2302 means that the ID of the contact that you tried to create already exists in the database of the registry. Please change the <contact:id> element value.
<epp:response>
<epp:result code="2302">
<epp:msg>Contact exists: YourSpecifiedID</epp:msg>
</epp:result>
<epp:trID>
<epp:svTRID>ZACR-EPP-13EE4CD37C8-9AC39</epp:svTRID>
</epp:trID>
</epp:response>
</epp:epp>
2004: Internationalised contact address must only contain ascii characters
A response code of 2004 means that you have specified UTF8 characters within one or more the <postalInfo type="int"> child elements. Please ensure the information provided in the element is all in ASCII.
<epp:response>
<epp:result code="2004">
<epp:msg>Internationalised contact address must only contain ascii characters.</epp:msg>
</epp:result>
<epp:trID>
<epp:svTRID>ZACR-EPP-13EE4D07C87-A0F8</epp:svTRID>
</epp:trID>
</epp:response>
</epp:epp>
Last update: 20-05-2014 09:28:27
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.