InsertNewOrder


Definition

Insert a checkout order of items in the shopping cart.

Usage

Use this command if you use our shopping cart, to finalize purchase of the cart contents.

This command checks out the items in a shopping cart that are in A (active) status, and puts the order in a queue.

Purchase, a similar command, completes the purchase of selected products in real time, without using our shopping cart or waiting for the order processing queue.

Because of the high prices for some Premium Domains, we offer you a wider variety of payment methods than for most purchases. In addition to immediate payment using your account balance, as you do for other domains and services, we offer two additional payment options for high-value Premium Domains: wire transfer, or delayed payment using your account balance. Use the UseWireTransfer parameter in the InsertNewOrder command to signal that you want to pay later, then either wire your payment or use the NM_ProcessOrder command to pay

using your account balance.

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

On the checkout page, the purchase button calls the InsertNewOrder command.

Constraints

The query must meet the following requirements:

  • The login ID and password must be valid.
  • If the shopping cart is empty, ItemCount must equal 1 or the query will return an error message.

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
EndUserIP Required 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
ItemCount Optional Number of items ready to purchase. All with a status of A (active). To retrieve the statuses of items in the shopping cart, use the GetCartContent command 4
UseWireTransfer Optional overall, but Required defer payment of a Premium Domain order If UseWireTransfer=Yes, process this Premium Domain order as a deferred payment order. Options for later payment are wire transfer or account balance. If you pay by wire transfer, contact your sales representative for wire transfer instructions. If you pay using your account balance (but after submitting the order using the InsertNewOrder command), use the NM_ProcessOrder command. 3
ResponseType Optional Format of response. Permitted values are Text (default), HTML, or XML. 4

 

Returned parameters and values

Parameter Description
PremiumDomainOrderID Identification number for the order that includes all Premium Domains and the services directly associated with those Premium Domains.
OrderID Identification number for the order that includes all items not associated with Premium Domains
ProdTypeX Product type identification number for domain names
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