Premium domain transfer API management

Due to their popularity and value, premium domains have special transfer pricing.  When the transfer of a premium domain to Enom fails due to an invalid premium price error, the price must be obtained through Application Programming Interface (API) commands.

Transfer error canceled due to invalid premium price

This error is presented when transferring a domain to Enom when a premium domain is missing the price, and the order cannot proceed.

Transfer error Canceled - Invalid premium price

To resolve the issue, the account holder must run two API commands: the first retrieves the price, and the second creates a new order with the retrieved pricing.
Note: Fill in the required fields and remove their brackets i.e. {transfer} becomes transfer.

  1. Fill in the required fields and run the example PE_GetPremiumPricing command.
    https://resellertest.enom.com/interface.asp?command=PE_GetPremiumPricing&uid=YourAccountID&pw=YourApiToken&sldX={Required}&tldX={Required}&qnameX={Required}&producttype=Transfer&responsetype={Optional}
  2. Located the price from the output.
    230.00
  3. Enter the price into the example TP_CreateOrder API command to create a new transfer order.
    https://resellertest.enom.com/interface.asp?command=TP_CreateOrder&uid={Required}&pw={Required}&OrderType=transfer&DomainCount={Required}&SLD1={Required}&TLD1={Required}&AuthInfo1={Required}&CustomerSuppliedPrice=230.00&responsetype={Optional}

Back to top

API command PE_GetPremiumPricing

To retrieve the premium pricing, run the following API command.  The login ID and password must be correct for the command to run properly.

https://resellertest.enom.com/interface.asp?command=PE_GetPremiumPricing&uid=YourAccountID&pw=YourApiToken&sldX={Required}&tldX={Required}&qnameX={Required}&producttype={Required}&responsetype={Optional}
Input ParameterTypeStatusDescription
commandstringRequiredPE_GetPremiumPricing
uidstringRequiredYour Account ID
pwstringRequiredYour API Token
sldXstringRequiredSecond level domain.
X=1 to Domain Count
tldXstringRequiredTop level domain
X=1 to DomainCount.
qnameXstringRequiredQueue name
producttypestringRequiredProduct type. Permitted values are:
Register
Renew
RGP
Extended RGP
* Transfer
responsetypestringOptionalFormat of response. Permitted values are "Text" (default), "HTML", or XML

Back to top

Returned parameters and values

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.

Output ParameterTypeDescription
DomainstringDomain name queried
IsPremiumstringIs premium domain? Expected values are:
Yes
No
IsEAPstringIs EAP domain? Expected values are:
Yes
No
ICANNFeesfloatICANN fees
PricefloatPremium domain price. 0.00 value will be returned for a non-premium domain or if the domain is not eligible in a specified queue
RegistrationFeefloatRegistration fee
EAPFeefloatEAP fee
CommandstringName of command executed
ErrCountintThe number of errors, if any, occurred. If greater than 0, check the Err (1 to ErrCount) values
ErrXstringError messages explaining the failure. These can be presented as is back to the client.
Donestring"True" indicates this entire response has reached you successfully

Back to top

Example Output

XML string query

https://resellertest.enom.com/interface.asp?command=PE_GetPremiumPricing&uid=resellid&pw=resellpw&responsetype=xml&sld1=bike48n25&tld1=bike&qname1=sunrise&sld2=bike48n01&tld2=ninja&qname2=sunrise&producttype=register


XML response

bike48n25.bike
true
false

230.00
230.00
0.00 


bike48n01.ninja
false
false
0.18
0.00
0.00
0.00 


PE_GETPREMIUMPRICING
eng
0
0
1
10
RESELLERTEST
eNom


+0.00
0.672
true
00000000-0000-0000-0000-000000000000
11/25/2013 5:31:15 PM

Back to top

API command TP_CreateOrder

This command creates an order to transfer domains from another registrar to Enom.

The command string must meet the following requirements:

  • The login ID and password must be valid.
  • All domain names in the order must be in top-level domains supported by this registrar.
  • To transfer EPP names, the query must include the authorization key from the registrar.
https://resellertest.enom.com/interface.asp?command=TP_CreateOrder&uid=(Required)&pw=(Required)&OrderType=transfer&DomainCount=(Required)&SLD1=(Required)&TLD1=(Required)&AuthInfo1=(Required)&CustomerSuppliedPrice=(Price)&responsetype=(Optional)

Returned parameters and values

Input ParameterTypeStatusDescription
commandstringRequiredTP_CreateOrder
uidstringRequiredYour Account ID
pwstringRequiredYour API Token
PreConfigstringOptional; default is 0Set PreConfig=1 to create, but not send, the order at this time. Using PreConfig=1 allows you to use TP_UpdateOrderDetail to modify DomainPassword, Lock, Renew, contacts, and extended attributes before submitting the order. When you are ready to submit the order, call TP_SubmitOrder.
OrderTypestringRequiredPermitted values are Fax or Autoverification
CustomerSuppliedPriceintRequired if transferring a premium domainFor premium domain(s), the exact price for this domain must be declared in this parameter. Use the PE_GetPremiumPricing command to retrieve the price.
IncludeIDPintOptionalIncludes ID Protect on domain transfers for TLDs that support ID Protect. Permitted values are 1 = include ID Protect, and 0 = Do not include ID Protect
IDPPriceintOptional; required if IncludeIDP = 1Price of ID Protect (the price can be retrieved from the appropriate price command)
DomainCountintRequiredThe number of domain names to be submitted on the order. This number must match the actual number of names submitted.
SLDX X=1 to DomainCountstringRequiredSecond-level domain name (for example, enom in enom.com)
TLDXstringRequiredTop-level domain name (extension)
AuthInfoXstringRequiredEPP TLDs Current (“losing”) registrar’s authorization key

Back to top

Example Output

https://resellertest.enom.com/interface.asp?
command=TP_CreateOrder&uid=resellid&pw=resellpw
&orderType=AutoVerification&sld1=resellerdocs2
&tld1=net&AuthInfo1=ros8enQi&sld2=resellerdocs3&tld2=info
&AuthInfo2=pkv7ihRb& domaincount=2&responsetype=xml

XML response

445413
7/29/2002 5:19:29 PM
1
Auto Verification
4
Processing
17.90
1

301770
resellerdocs2
net
9
Awaiting auto verification of transfer request
8.95
0


301771
resellerdocs3
info
9
Awaiting auto verification of transfer request
8.95
0

2

True
TP_CREATEORDER
0
Dev Workstation
enom
true

Back to top

Was this article helpful? If not please submit a request here

How helpful was this article?