All domain commands: (check) (create) (delete) (info) (modify) (transfer) (renew) (undelete) (privacy) (autorenew)
For those registries that do not autorenew domain names, it may be necessary to manually renew a domain name.
It is possible to renew a domain name for up to 10 years in advance. When no duration parameter is specified, a renewal for 1 year is assumed. With some registries you can renew domain names for 1-12 months.
As a failsafe, the current expiration date for the domain name has to be specified. The requested number of months/years will be added to this date.
To renew a domain you can use the domain:renew command. You only have to specify the date of expiration, no need to add time to this field. Normally you would request the expiration date of the domain name with a domain:info command, but please note that that will return the date and time of expiration. You must remove the time part before issueing the domain:renew command.
<?xml version="1.0" encoding="UTF-8"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
<command>
<renew>
<domain:renew>
<domain:name>docu-domain-test.com</domain:name>
<domain:curExpDate>2017-09-07</domain:curExpDate>
</domain:renew>
</renew>
<clTRID>57d0129609d26</clTRID>
</command>
</epp>
You will then receive a confirmation the domain renewal was succesful. The system will add the requested number of years/months to the current expiration date, and report back with the exact time the domain name will expire. Time format is ISO-8601.
<?xml version="1.0" encoding="UTF-8"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:domain="urn:ietf:params:xml:ns:domain-1.0" xmlns:contact="urn:ietf:params:xml:ns:contact-1.0" xmlns:host="urn:ietf:params:xml:ns:host-1.0" xmlns:ext="http://www.metaregistrar.com/epp/ext-1.0" xmlns:secDNS="urn:ietf:params:xml:ns:secDNS-1.1">
<response>
<result code="1000">
<msg>Command completed successfully</msg>
</result>
<resData>
<domain:infData>
<domain:name><![CDATA[docu-domain-test.com]]></domain:name>
<domain:exDate><![CDATA[2018-09-07T13:13:55.000000+0000]]></domain:exDate>
</domain:infData>
</resData>
<trID>
<svTRID>MTR_4426af5d2fd1b20dcec3c5c9c55fc8e58fff35e9</svTRID>
<clTRID>57d0129609d26</clTRID>
</trID>
</response>
</epp>
SIDN, the registry for .NL domain names, will allow you to renew a domain name for 3 months
<?xml version="1.0" encoding="UTF-8"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
<command>
<renew>
<domain:renew xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
<domain:name>domain-to-renew.nl</domain:name>
<domain:curExpDate>2016-04-03</domain:curExpDate>
<domain:period unit="m">3</domain:period>
</domain:renew>
</renew>
<clTRID>MTR-12345</clTRID>
</command>
</epp>
In case you have the wrong renewal date you will get the following response:
<?xml version="1.0" encoding="UTF-8"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
<response>
<result code="2306">
<msg>Parameter value policy error; Expiry date supplied is not the date on record.</msg>
</result>
<trID>
<svTRID>MTR_108ed66ac0003300c5a1610fa9544c88d244dcd6</svTRID>
<clTRID>57d013cd55469</clTRID>
</trID>
</response>
</epp>
In case the domain does not exist you will get the following response:
<?xml version="1.0" encoding="UTF-8"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
<response>
<result code="2303">
<msg>Object does not exist</msg>
</result>
<trID>
<svTRID>MTR_6f95995c2bba8d57425c8e9e2731ed5fcab6c1d5</svTRID>
</trID>
</response>
</epp>