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
- API command PE_GetPremiumPricing
- API command TP_CreateOrder
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 account holder must run two API commands; the first is to retrieve the price, and the second will create a new order with the retrieved pricing.
Note: Fill in the required fields and remove their brackets i.e. {transfer} becomes transfer.
- 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} - Located the price from the output.
<Price>230.00</Price>
- 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}
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 Parameter | Type | Status | Description |
| command | string | Required | PE_GetPremiumPricing |
| uid | string | Required | Your Account ID |
| pw | string | Required | Your API Token |
| sldX | string | Required | Second level domain. X=1 to Domain Count |
| tldX | string | Required | Top level domain X=1 to DomainCount. |
| qnameX | string | Required | Queue name |
| producttype | string | Required | Product type. Permitted values are: Register Renew RGP Extended RGP * Transfer |
| responsetype | string | Optional | Format of response. Permitted values are "Text" (default), "HTML", or XML |
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 Parameter | Type | Description |
| Domain | string | Domain name queried |
| IsPremium | string | Is premium domain? Expected values are: Yes No |
| IsEAP | string | Is EAP domain? Expected values are: Yes No |
| ICANNFees | float | ICANN fees |
| Price | float | Premium domain price. 0.00 value will be returned for a non-premium domain or if the domain is not eligible in a specified queue |
| RegistrationFee | float | Registration fee |
| EAPFee | float | EAP fee |
| Command | string | Name of command executed |
| ErrCount | int | The number of errors, if any, occurred. If greater than 0, check the Err (1 to ErrCount) values |
| ErrX | string | Error messages explaining the failure. These can be presented as is back to the client. |
| Done | string | "True" indicates this entire response has reached you successfully |
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
<?xml version="1.0" encoding="utf-8"?>
<interface-response>
<results>
<result>
<Domain>bike48n25.bike</Domain>
<IsPremium>true</IsPremium>
<IsEAP>false</IsEAP>
<ICANNFees/>
<Price>230.00</Price>
<RegistrationFee>230.00</RegistrationFee>
<EAPFee>0.00</EAPFee>
</result>
<result>
<Domain>bike48n01.ninja</Domain>
<IsPremium>false</IsPremium>
<IsEAP>false</IsEAP>
<ICANNFees>0.18</ICANNFees>
<Price>0.00</Price>
<RegistrationFee>0.00</RegistrationFee>
<EAPFee>0.00</EAPFee>
</result>
</results>
<Command>PE_GETPREMIUMPRICING</Command>
<Language>eng</Language>
<ErrCount>0</ErrCount>
<ResponseCount>0</ResponseCount>
<MinPeriod>1</MinPeriod>
<MaxPeriod>10</MaxPeriod>
<Server>RESELLERTEST</Server>
<Site>eNom</Site>
<IsLockable/>
<IsRealTimeTLD/>
<TimeDifference>+0.00</TimeDifference>
<ExecTime>0.672</ExecTime>
<Done>true</Done>
<TrackingKey>00000000-0000-0000-0000-000000000000</TrackingKey>
<RequestDateTime>11/25/2013 5:31:15 PM</RequestDateTime>
<debug/>
</interface-response>
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 Parameter | Type | Status | Description |
| command | string | Required | TP_CreateOrder |
| uid | string | Required | Your Account ID |
| pw | string | Required | Your API Token |
| PreConfig | string | Optional; default is 0 | Set 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. |
| OrderType | string | Required | Permitted values are Fax or Autoverification |
| CustomerSuppliedPrice | int | Required if transferring a premium domain | For premium domain(s), the exact price for this domain must be declared in this parameter. Use the PE_GetPremiumPricing command to retrieve the price. |
| IncludeIDP | int | Optional | Includes 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 |
| IDPPrice | int | Optional; required if IncludeIDP = 1 | Price of ID Protect (the price can be retrieved from the appropriate price command) |
| DomainCount | int | Required | The number of domain names to be submitted on the order. This number must match the actual number of names submitted. |
| SLDX X=1 to DomainCount | string | Required | Second-level domain name (for example, enom in enom.com) |
| TLDX | string | Required | Top-level domain name (extension) |
| AuthInfoX | string | Required | EPP TLDs Current (“losing”) registrar’s authorization key |
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
<?xml version="1.0" ?>
<interface-response>
<transferorder>
<transferorderid>445413</transferorderid>
<orderdate>7/29/2002 5:19:29 PM</orderdate>
<ordertypeid>1</ordertypeid>
<ordertypedesc>Auto Verification</ordertypedesc>
<statusid>4</statusid>
<statusdesc>Processing</statusdesc>
<authamount>17.90</authamount>
<version>1</version>
<transferorderdetail>
<transferorderdetailid>301770</transferorderdetailid>
<sld>resellerdocs2</sld>
<tld>net</tld>
<statusid>9</statusid>
<statusdesc>Awaiting auto verification of transfer request</statusdesc>
<price>8.95</price>
<usecontacts>0</usecontacts>
</transferorderdetail>
<transferorderdetail>
<transferorderdetailid>301771</transferorderdetailid>
<sld>resellerdocs3</sld>
<tld>info</tld>
<statusid>9</statusid>
<statusdesc>Awaiting auto verification of transfer request</statusdesc>
<price>8.95</price>
<usecontacts>0</usecontacts>
</transferorderdetail>
<transferorderdetailcount>2</transferorderdetailcount>
</transferorder>
<success>True</success>
<Command>TP_CREATEORDER</Command>
<ErrCount>0</ErrCount>
<Server>Dev Workstation</Server>
<Site>enom</Site>
<Done>true</Done>
<debug>
<![CDATA[ ] ]>
</debug>
</interface-response>
Comments
0 comments
Article is closed for comments.