Queue_DomainPurchase


Definition

Purchase a domain in a specified queue. Note, these orders will be processed once the queue closes.

Usage

Use this command to purchase a domain in a specified queue. Note, these orders will be processed once the queue closes.

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/tld-queue/pages/manage/purchase.aspx

Constraints

The query must meet the following requirements:

  • The login ID and password must be valid

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
ItemList Required Collection of domain orders, grouped in domain module(s). Each parameters for a domain are separated by pipe symbol or "|". Multiple domain entry is allowed by adding comma or "," between each domain module. Use the PE_GetPremiumPricing command to retrieve the premium domain price for CustomerSuppliedPrice. Domain module format: QName= [phase] | SLD= [sld] | TLD= [tld] | ExtAttributes | Signed_Mark_Data | CustomerSuppliedPrice Example: ItemList=QName=Sunrise|SLD=IWantToBeA|TLD=ninja|ninja_name=Super+Samurai|ninja_number=007|signed_mark_data=Shogun, QName=Sunrise|SLD=Training|TLD=ninja|ninja_name=Jim+Smith|signed_mark_data=DkOnNp...CustomerSuppliedPrice=65.00 Note: please use URL Encoding for ListItem or the entire API string to avoid any unexpected results. ?
UseCreditCard Optional If UseCreditCard=Yes, use our credit card processing services. This service is available only to resellers who have entered into a credit card processing agreement with us. When you pass credit card information with this command, you must use the secure HTTPS protocol. 3
Amount Required if UseCreditCard=Yes Amount to charge for this order. Format: DDD.CC 8
EndUserIP Required if using our credit card processing End user’s IP address. This is used in fraud checking, as part of our order processing service. Format: NNN.NNN.NNN.NNN. 15
CCName Required if using our credit card processing Cardholder's name 60
CCNumber Required if using our credit card processing Customer's credit card number 128
CCExpMonth Required if using our credit card processing Credit card expiration month. Format: MM 2
CCExpYear Required if using our credit card processing Credit card expiration year. Format: YYYY 4
CVV2 Required if using our credit card processing Credit card verification code 4
CCAddress Required if using our credit card processing Credit card billing address 60
CCCity Required if using our credit card processing Credit card billing city 60
CCStateProvince Required if using our credit card processing Credit card billing state or province 60
CCZip Required if using our credit card processing Credit card billing postal code 15
CCCountry Required if using our credit card processing Credit card billing country (2 letter code) Format: XX 60
ResponseType Optional Format of response. Permitted values are Text (default), HTML, or XML 4

 

Returned parameters and values

Parameter Description
Success Overall item status. If there is one failure within a transaction (multiple domains), the entire transaction fails.
OrderID Order ID for this transaction. All domains are purchased in a single order.
Amount Total amount for this transaction. Please notice that the amount might be modified if the price does not meet the account's minimum cost
TransactionNumber Credit card transaction number
TransactionReference Credit card transaction reference
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.

Example