Extend


Definition

Extend (renew) the registration period for a domain name.

Usage

Use this command to renew domain registrations in real time. We recommend that you renew at least a week before the domain expiration date.

When you pass credit card information with this command, you must use the secure HTTPS protocol.

Most commonly, this command is used by resellers who maintain their own databases. Resellers who use a shopping cart and our order processing queue generally use the AddToCart command with input parameter ProductType=Renew.

After a domain expires, use UpdateExpiredDomains to reactivate it and renew its registration.

Availability

All resellers have access to this command.

Implementation on eNom.com

Log on to resellertest.enom.com with Login ID resellid, password resellpw.

https://resellertest.enom.com/domains/DomainDetail.asp?DomainNameID=152533676

The Extend command is a real-time command that is not implemented on enom.com; however, on the domain control panel page, the add years button behaves similarly to the Extend command.

Constraints

The query must meet the following requirements:

  • To use our credit card processing, this must be an ETP reseller account.
  • The domain name must be valid and active.
  • The new expiration date cannot be more than 10 years in the future.

Input parameters

Build the query string using this syntax:

https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
&paramname=paramvalue&nextparamname=nextparamvalue

 

Parameter Status Description Max Size
UID Required Account login ID 20
PW Required Account password 20
SLD Required Second-level domain name (for example, enom in enom.com) 63
TLD Required Top-level domain name (extension) 15
NumYears Optional Number of years to extend 10
OverrideOrder Optional Use OverrideOrder=1 to submit more than one renewal request for this domain name within 24 hours of the first transaction 1
UseCreditCard Optional If UseCreditCard=yes, use eNom’s credit-card processing services. When you pass credit card information with this command, you must secure HTTPS protocol. 3
EndUserIP Required If UseCreditCard=yes End user’s IP address. This is used in fraud checking, as part of our order processing service. Use format NNN.NNN.NNN.NNN. 15
ChargeAmount Required If UseCreditCard=yes Amount to charge per year for the renewal. Use DD.cc format. 6
CardType Required If UseCreditCard=yes Type of credit card. Permitted values are Visa, Mastercard, AmEx, Discover 20
CCName Required If UseCreditCard=yes Cardholder's name 60
CreditCardNumber Required If UseCreditCard=yes Customer's credit card number 128
CreditCardExpMonth Required If UseCreditCard=yes Credit card expiration month in MM format 2
CreditCardExpYear Required If UseCreditCard=yes Credit card expiration year in YYYY format 4
CVV2 Required If UseCreditCard=yes Credit card verification code 4
CCAddress Required If UseCreditCard=yes Credit card billing address 60
CCZip Required If UseCreditCard=yes Credit card billing postal code 15
CCCountry Required If UseCreditCard=yes Credit card billing country. The two-letter country code is a permitted format. 60
RegistrantFirstName Required UseCreditCard=yes Registrant first name 60
RegistrantLastName Required If UseCreditCard=yes Registrant last name 60
RegistrantAddress1 Required If UseCreditCard=yes Registrant address 60
RegistrantAddress2 Optional Registrant additional address info 60
RegistrantCity Required If UseCreditCard=yes Registrant city 60
RegistrantStateProvinceChoice Optional Required If UseCreditCard=yes Registrant state or province choice: S state P province 1
RegistrantStateProvince Required If UseCreditCard=yes Registrant state or province 60
RegistrantPostalCode Required If UseCreditCard=yes Registrant postal code 16
RegistrantCountry Required If UseCreditCard=yes Registrant country 60
RegistrantEmailAddress Required If UseCreditCard=yes Registrant email address 128
RegistrantOrganizationName Optional Registrant organization 60
RegistrantJobTitle Optional Registrant job title 60
RegistrantPhone Required If UseCreditCard=yes Registrant phone number. Required format is +CountryCode.PhoneNumber, where CountryCode and PhoneNumber use only numeric characters and the + is URL-encoded as a plus sign (%2B). 20
RegistrantFax Optional Registrant fax number. Required format is +CountryCode.PhoneNumber, where CountryCode and PhoneNumber use only numeric characters and the + is URL-encoded as a plus sign (%2B). 20
ResponseType Optional Format of response. Permitted values are Text (default), HTML, or XML. 4

 

Returned parameters and values

Parameter Description
OrderID Order number if successful. We recommend that you store this value for future use.
Extension Returns Successful, otherwise this parameter isn't returned.
RRPCode Success code. Only a 200 indicates success.
RRPText Text which accompanies and describes the RRPCode.
RegistryExpDate Domain expiration date at the Registry level.
Command Name of command executed
ErrCount The number of errors if any occurred. If greater than 0 check the Err(1 to ErrCount) values.
ErrX Error messages explaining the failure. These can be presented as is back to the client.
Done True indicates this entire response has reached you successfully.

 

Notes

  • If using our credit card option ALL credit card information is required.
  • The default response format is plain text. To receive the response in HTML or XML format, send ResponseType=HTML or ResponseType=XML in your request.
  • We recommend that you store the OrderID value—at least the most recent one for each domain—from thereturn. Several other commands use this value as a required input parameter.
  • Check the return parameter ErrCount. If greater than 0 the transaction failed. The parameterErr(ErrCount) can be presented to the client. Otherwise process the returned parameters as defined above.

Example