ExtendDomainDNS


Definition

In real time, renew DNS hosting services for a domain name that is registered elsewhere.

Usage

Use this command to renew DNS services for a name that is registered elsewhere. This is a real-time command that is most commonly used by resellers who maintain their own databases. Resellers who use a shopping cart and our order queue generally use the AddToCart command with input parameter ProductType=HostRenew.

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

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

The ExtendDomainDNS command is not implemented on www.enom.com. However, on the checkout page, the purchase button calls InsertNewOrder, a similar command that initiates checkout. The difference is that InserNewOrder acquires contents of the shopping cart and puts them in a queue for checkout; the ExtendDomainDNS command bypasses the shopping cart and the queue.

Constraints

The query must meet the following requirements:

  • The login ID and password must be valid.
  • To use our credit card processing, this must be an ETP reseller account.
  • The domain name must not be registered with us, but must use our name servers.

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 add to the DNS hosting subscription. Default value is 1. Maximum total is 10. 2
RegistrantFirstName Required if using our credit card processing Registrant first name 60
RegistrantLastName Required if using our credit card processing Registrant last name 60
RegistrantAddress1 Required if using our credit card processing Registrant address 60
RegistrantAddress2 Optional Registrant additional address info 60
RegistrantCity Required if using our credit card processing Registrant city 60
RegistrantCountry Optional Registrant country 60
RegistrantEmailAddress Required if using our credit card processing Registrant email address 128
RegistrantOrganizationName Optional Registrant organization 60
RegistrantJobTitle Optional Registrant job title 60
RegistrantPhone Optional Registrant phone. 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
RegistrantPostalCode Required if using our credit card processing Registrant postal code 16
RegistrantStateProvince Optional Registrant state or province 60
RegistrantStateProvinceChoice Optional Registrant state or province choice:
S state
P province
1
ChargeAmount Optional Amount to charge to the credit card 6
UseCreditCard Optional If UseCreditCard=yes, use our creditcard processing services. When you pass credit card information with this command, you must use the 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
CardType Required If UseCreditCard=yes Type of credit card. Permitted values are Visa, Mastercard, AmEx, and 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 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 60
ResponseType Optional Format of response. Permitted values are Text (default), HTML, or XML. 4

 

Returned parameters and values

Parameter Description
CCTransResult Success status for the credit card transaction
OrderID Order ID, assigned by us
Command Name of the command
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

  • The default response format is plain text. To receive the response in HTML or XML format, sendResponseType=HTML or ResponseType=XML
  • in your request.
  • 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