Request authorisation code[Link]

Purpose

to request an authorisation code to be sent to the registrant.

The command has only two elements:

  • <dnsbe:domainName> is required. Is the domain name for which you want to send an authorisation code.

  • <dnsbe:url> is optional. It’s a personalised url you can provide, DNS Belgium will add this url to the message that is sent to the registrant.

Please refer to the examples to see a complete request.

Examples[Link]

Requesting an authorisation code:

<?xml version="1.0" encoding="UTF-8"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
  <extension>
    <dnsbe:ext xmlns:dnsbe="http://www.dns.be/xml/epp/dnsbe-1.0">
      <dnsbe:command>
        <dnsbe:requestAuthCode>
          <dnsbe:domainName>test</dnsbe:domainName>
          <dnsbe:url>http://www.registrar-website.be/transfer?name=test</dnsbe:url>
        </dnsbe:requestAuthCode>
        <dnsbe:clTRID>request-code-test</dnsbe:clTRID>
      </dnsbe:command>
    </dnsbe:ext>
  </extension>
</epp>

When the request is successful, you will receive a success reply with code 1000.

A non-exhaustive list of error codes/messages:

  • 2001 (Command syntax error), with possible reasons:

  • Any error against the syntax

  • 2308 (Data management policy violation), with possible reasons:

  • domain [$domain] has invalid status (serverTransferprohibited) [HITPOINT]

  • domain [$domain] has invalid status [HITPOINT]

  • there were already 4 e-mails sent to this registrant for this authorisation code

  • 2306 (Parameter value policy error), with possible reasons:

  • URL should start with 'http://' or 'https://' [HITPOINT]

  • URL is too long (max 500 characters) [HITPOINT]

  • invalid domain name [HITPOINT]

A hitpoint will be attributed to the registrar for every error that could have been foreseen.

An example of a response with result code 2308:

<?xml version="1.0" encoding="UTF-8"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
        xmlns:dnsbe="http://www.dns.be/xml/epp/dnsbe-1.0">
  <response>
    <result code="2308">
      <msg>Data management policy violation</msg>
    </result>
    <extension>
      <dnsbe:ext>
        <dnsbe:result>
          <dnsbe:msg>domain [test] has invalid status (serverTransferprohibited) </dnsbe:msg>
        </dnsbe:result>
      </dnsbe:ext>
    </extension>
    <trID>
      <clTRID>request-code-test</clTRID>
      <svTRID>dnsbe-525</svTRID>
    </trID>
  </response>
</epp>