renew (domain)
Renews a domain and allows you to set the auto-renewal flag on a domain.
Request parameters for renew (domain)
Standard parameters
- action = renew
- object = domain
- registrant_ip = valid IP address of the registrant (optional) attributes
Attributes
Parameters within the attributes associative array are described below.
Parameter name | Obligation | Definition/Value |
|---|---|---|
affiliate_id | Optional | ID that allows RSP's to track orders coming through various affiliates. |
auto_renew | Required | A flag indicating whether the domain should be set to auto-renew.
|
currentexpirationyear | Required | The domain's current expiration year in the format YYYY; must match the data in the registry. |
domain | Required | The name of the domain to be renewed. Domain must be registered, and must exist in both OpenSRS and the appropriate registry. |
f_parkp | Optional | Enables the Parked Pages Program. When the Parked Pages Program is enabled, a customized page containing contextual ads is displayed. The ads generate revenue whenever a visitor clicks on one of the links, and that revenue is shared with you, the reseller. Important: Enabling Parked Pages changes the nameservers of that domain, and any existing website will not display. Parked Pages functionality is available for these TLDs: .COM, .NET, .ORG, .INFO, .BIZ, .MOBI, .NAME, .ASIA, .BE, .BZ, .CA, .CC, .CO, .EU, .IN, .ME, .NL, .TV, .UK, .US, .WS and .XXX.
|
handle | Required | Instructions for the processing of the order. (Overrides the RSP's 'process immediately' settings.).
|
period | Required | The renewal period, from 1 to 10 years. (May not exceed 10 years.) |
Response parameters for renew (domain)
Standard parameters action = reply
- object = domain
- is_success = a Boolean is returned, indicating success or failure of the
request - response_code = response code indicating outcome of the request
- response_text = message describing the outcome of the request
Attributes
If the request is successful, the attributes associative array may include the
following:
Parameter name | Obligation | Definition/Value |
|---|---|---|
admin_email | Returned if is_success = true | The email address of the administrative contact for the domain. |
auto_renew | Returned if is_success = true | A flag indicating whether the domain is set to auto-renew.
|
id | Returned if is_success = true and order is not queued | The domain ID. If queue_request_id is returned, id is not returned. |
order_id | Returned if is_success = true | The order ID of the renewal. |
queue_request_id | Returned if is_success = true and order is queued | The ID of the request as it occurs within the queue. Later, if you want to renew the order from the queue, you'll need this ID. If queue_request_id is returned, id is not returned. |
registration expiration date | Returned if is_success = true | The domain's current expiration year. |
Response codes
Response Code | Response Text | Explanation |
|---|---|---|
200 | Command completed successfully | Success response. |
480 | Renew capability is not enabled for domain.tv | Renewals are not yet supported for this TLD. |
465 | Domain already renewed | Domain has already been successfully renewed, with the current expiration year matching the year provided by the user. |
541 | Invalid attribute value | Domain's current expiration year in registry doesn't match the year provided by user. |
400 | Fatal Server Error Domain already renewed; another renewal cannot be applied until the first request completes', at the registry, approximately six to eight weeks after the original expiration date (2003-03-19 12:12:00) | System error. Domain is already in 'renewal applied' state. |
Note:
When a renew operation fails, the reseller receives a message indicating which domain failed to be renewed. This message is only sent once in 24 hours, regardless of how many renewals failed within this period.
Examples for renew (domain)
Request
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">renew</item>
<item key="object">DOMAIN</item>
<item key="attributes">
<dt_assoc>
<item key="auto_renew">1</item>
<item key="f_parkp">Y</item>
<item key="handle">process</item>
<item key="domain">example.com</item>
<item key="currentexpirationyear">2008</item>
<item key="period">1</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="action">REPLY</item>
<item key="object">DOMAIN</item>
<item key="attributes">
<dt_assoc>
<item key="registration expiration date">2009-01-08 15:35:00</item>
<item key="auto_renew">1</item>
<item key="admin_email">[email protected]</item>
<item key="id">3212624</item>
<item key="order_id">3511417</item>
</dt_assoc>
</item>
<item key="response_text">Command completed successfully</item>
<item key="is_success">1</item>
<item key="response_code">200</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Updated over 4 years ago