TP_UpdateOrderDetail


Definition

Update a preconfigured transfer order before submitting the order.

Usage

Use this command to configure registrar lock, auto-renew, domain password, or contact information for a domain name that is in the process of being transferred to eNom.

This command is typically used after an order has been created using the TP_CreateOrder command with the parameter PreConfig=1. Once the transfer order has been configured using this command, the next step is typically to use the TP_SubmitOrder command, which causes the transfer order to be processed.

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/TransferNew.asp

Enter a domain name and click next.

On the Pending orders page, click the domain name.

In the Editing transfer order for domain name box, the check boxes set the parameter values for the TP_UpdateOrderDetail command, and the next button calls the command.

Constraints

The query must meet the following requirements:

  • The login ID and password must be valid.
  • The transfer order detail ID must be valid and must be part of an order created under this account.
  • The transfer order must be in a StatusID of 5 (Order not submitted).

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
TransferOrderDetailID Required Transfer order detail ID. Use the TP_GetOrder command to retrieve this value. 10
Lock Optional; default is True Set registrar lock on the name. Permitted values are True or False. 5
Renew Optional; default is True Set auto-renew. Permitted values are True or False. 5
DomainPassword Optional Set a domain password on the name 60
DeleteOrderDetail Optional Remove all names from this order,. To remove all names, supply DeleteOrderDetail=Yes 3
RegistrantAddress1 Optional; Required Fax orders Registrant address 60
RegistrantAddress2 Optional Registrant additional address info 60
RegistrantCity Optional; Required Fax orders Registrant city 60
RegistrantCountry Optional; Required Fax orders Registrant country 60
RegistrantEmailAddress Optional; Required Fax orders and for .org names for which you are supplying new Registrant information Registrant email address 128
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
RegistrantFirstName Optional; Required Fax orders Registrant first name 60
RegistrantLastName Optional; Required Fax orders Registrant last name 60
RegistrantJobTitle Optional Registrant job title 60
RegistrantOrganizationName Optional; Required Fax orders Registrant organization 60
RegistrantPhone Optional; Required Fax orders Registrant phone. Required format is +CountryCode.PhoneNumber, where CountryCode and PhoneNumber use only numeric characters and the + is URLencoded as a plus sign (%2B). . 20
RegistrantPostalCode Optional Registrant postal code 16
RegistrantStateProvince Optional Registrant state or province 60
RegistrantStateProvinceChoice Optional Registrant state or province choice:
S state
P province
1
UseContacts Optional; default is 0 Set =1 to transfer existing Whois contacts when the transfer is complete. If you supply UseContacts=0 for a domain that has extended attributes, you must supply contact information and extended attributes before submitting the transfer order. 1
ExtendedAttributes Required
TLDs that use extended attributes, when UseContacts=0
Extended attributes, required for some country code TLDs. You can retrieve a list of required extended attributes for any TLD using the GetExtAttributes command. n/a
RegistrantUseContact Optional If set =none then Billing contact will be used, otherwise Registrant contact data must be submitted 3
Tech* Optional Technical contact data. See Note. *
TechUseContact Optional If set =none then no contact will be used, otherwise Tech contact data must be submitted. 3
AuxBilling* Optional Auxiliary Billing contact data. See Note. *
AuxBillingUseContact Optional If set =none then no contact will be used, otherwise Auxbilling contact data must be submitted. 3
ResponseType Optional Format of response. Permitted values are Text (default), HTML, or XML. 4

 

Returned parameters and values

Parameter Description
TransferOrderDetailID Transfer order detail number
SLD Second-level domain name
TLD Top-level domain name
lock Registrar lock status
renew Auto-renew status
domainpassword Password to set for the domain name
statusid Status ID of the order
statusdesc Description of the status
price Transfer price
usecontacts Use the current contacts flag
Registrant* Registrant contact data
AuxBilling* Auxilliary Billing contact data
Tech* Technical contact data
Admin* Administrative contact data
Billing* Billing contact data
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.
  • To update Technical or Auxilliary Billing contacts submit the contact data by replacing Registrant* param names with Tech* or AuxBilling* param names.

Example