PurchaseHosting


Definition

Subscribe to our domain name hosting services, while leaving the registration of the domain name at another registrar. This is a real-time command.

Usage

Use this command to purchase domain name hosting services in real time, while leaving the registration of a domain name at another registrar.

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

To purchase DNS hosting using the shopping art and order queue, use the AddToCart command.

Availability

All resellers have access to this command.

Implementation on eNom.com

This command is not imThis command is not implemented on eNom.com, but is the real-time analog to two commands that are. On our site, we use AddToCart to allow a customer to specify that they want to purchase DNS Hosting, and InsertNewOrder to submit the order.

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.

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
DomainPassword Optional Set a password on the domain name 60
NumYears Optional Number of years to register the name 2
Renewname Optional Set =1 to auto-renew the name 1
ChargeAmount Optional Amount to charge per year for the registration 6
UseCreditCard Optional overall, but Required for resellers who have a credit card processing agreement with us AND want to use our CC processing to charge this transaction to the credit card included in this query string. Default is no. Permitted values are yes and no. The credit card supplied in this query string is charged only if UseCreditCard=yes. If this param is omitted, or if the value supplied is anything other than yes, the account balance rather than the credit card is debited for this transaction. This is true even if the query string includes all the required credit card information. 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, Discover 20
CreditCardNumber Required if UseCreditCard=yes Customer's credit card number 128
CreditCardExpMonth Required if UseCreditCard=yes Credit card expiration month 2
CreditCardExpYear Required if UseCreditCard=yes Credit card expiration year 4
CVV2 Required if UseCreditCard=yes Credit card verification code 4
CCName Required for our CC processing Cardholder’s name 60
CCAddress Required for our CC processing Credit card billing street address 60
CCCity Optional for our CC processing Credit card billing city ?
CCStateProvince Optional for our CC processing Credit card billing state or province 40
CCCountry Required for our CC processing Credit card billing country. Two-character country code is a permitted format 40
CCZip Required for our CC processing Credit card billing postal code 60
CCPhone Optional for our CC processing Credit card billing 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
EmailNotify Optional Set =1 to receive email notification for orders, set =0 or omit this parameter otherwise. 1
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.
RRPCode Success code. Only a 200 indicates success.
RRPText Text which accompanies and describes the RRPCode.
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

  • 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.
  • Check the return parameter ErrCount. If greater than 0 the transaction failed. The parameter Err(ErrCount) can be presented to the client. Otherwise process the returned parameters as defined above.
  • Additional params for contact information can be passed by replacing Registrant in the param names above with Tech, Admin or AuxBilling.
  • If using our credit card option ALL registrant and credit card information is required.

Example