.XXX Transfer

Description

Definition

This document is designed to provide resellers with a quick guide about the processes for transferring .XXX domain names.

Usage

Use this command to create an order to transfer domains from another registrar to eNom or one of its resellers. There are two methods of transfers. First method, create and submit a transfer order in one command (quick transfer). Second method consist of few steps: create, configure and submit.

 

Quick transfer

Definition

Create and submit domain(s) transfer in one command.

Base parameters

* Required:

SLDx: second level domain name (X=1 to DomainCount)

TLDx: top level domain name (X=1 to DomainCount)

AuthInfox: current ("losing") registrar's authorization key

DomainCount: the number of domain names to be submitted on the order. This number must match the actual number of names submitted

OrderType: permitted values are Autoverification or Fax

* Optional:

XXX_MemberID: membership authorization token provided by ICM Registry. If left blank, the domain will still be transferred with the current value. You can update it using XXX_SetMemberID after the domain transferred successfully.

Query

http://resellertest.enom.com/interface.asp?UID=resellid&pw=resellpw&SLD1=mydomain&TLD1=xxx&AuthInfo1=1234ABCD&XXX_MemberID1=IXA12S3UPFA2&SLD2=yourdomain&TLD2=xxx&AuthInfo2=ABCD1234&XXX_MemberID2=IX22WDDPHMY21TZ&DomainCount=2&ResponseType=XML&UseContacts=1&Command=TP_CreateOrder&OrderType=Autoverification

Output

<interface-response>

<?xml version="1.0" ?>

<interface-response>

<success>True</success>

<transferorder>

<transferorderid>175625387</transferorderid>

<orderdate>1/1/2012 11:11:11 AM</orderdate>

<ordertypeid>1</ordertypeid>

<ordertypedesc>Auto Verification</ordertypedesc>

<statusid>9</statusid>

<statusdesc>Processing</statusdesc>

<authamount>400</authamount>

<version>1</version>

<transferorderdetail>

<transferorderdetailid>77458527</transferorderdetailid>

<sld>mydomain</sld>

<tld>xxx</tld>

<statusid>9</statusid>

<statusdesc>Awaiting auto verification of transfer request</statusdesc>

<price>200</price>

<usecontacts>1</usecontacts>

</transferorderdetail>

<transferorderdetail>

<transferorderdetailid>77458528</transferorderdetailid>

<sld>yourdomain</sld>

<tld>xxx</tld>

<statusid>9</statusid>

<statusdesc>Awaiting auto verification of transfer request</statusdesc>

<price>200</price>

<usecontacts>1</usecontacts>

</transferorderdetail>

<transferorderdetailcount>2</transferorderdetailcount>

</transferorder>

<Command>TP_CREATEORDER</Command>

<Language>eng</Language>

<ErrCount>0</ErrCount>

<ResponseCount>0</ResponseCount>

<MinPeriod>1</MinPeriod>

<MaxPeriod>10</MaxPeriod>

<Server>RESELLERTEST</Server>

<Site>eNom</Site>

<IsLockable>True</IsLockable>

<IsRealTimeTLD>True</IsRealTimeTLD>

<TimeDifference>+03.00</TimeDifference>

<ExecTime>0.828</ExecTime>

<Done>true</Done>

<RequestDateTime>1/1/2012 11:11:11 AM</RequestDateTime>

</interface-response>

 

Pre-Configuration method

Definition

Create, configure and submit domain(s) transfer. This method is used to support step-by-step domain(s) transfer configuration.

Top

1. TP_CreateOrder

Base parameters

* Required:

SLDx: second level domain name (X=1 to DomainCount)

TLDx: top level domain name (X=1 to DomainCount)

AuthInfox: current (losing) registrar's authorization key

OrderType: permitted values are Autoverification or Fax

PreConfig: set 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.

Query

http://resellertest.enom.com/interface.asp?command=TP_CreateOrder&TLD1=xxx&SLD1=mydomain&DomainCount=1&OrderType=Autoverification&AuthInfo1=123ABCD&responsetype=xml&UID=resellid&PW=resellepw&preconfig=1

Output

<interface-response>

<?xml version="1.0" ?>

<transferorder>

<transferorderid>175625417</transferorderid>

<orderdate>1/11/2012 1:1:11 PM</orderdate>

<ordertypeid>1</ordertypeid>

<ordertypedesc>Auto Verification</ordertypedesc>

<statusid>5</statusid>

<statusdesc>Order not submitted</statusdesc>

<authamount>100</authamount>

<version>1</version>

<transferorderdetail>

<transferorderdetailid>77458539</transferorderdetailid>

<sld>mydomain</sld>

<tld>xxx</tld>

<statusid>35</statusid>

<statusdesc>Transfer request not yet submitted</statusdesc>

<price>80</price>

<usecontacts>0</usecontacts>

</transferorderdetail>

<transferorderdetailcount>1</transferorderdetailcount>

</transferorder>

<Command>TP_CREATEORDER</Command>

<Language>eng</Language>

<ErrCount>0</ErrCount>

<ResponseCount>0</ResponseCount>

<MinPeriod>1</MinPeriod>

<MaxPeriod>10</MaxPeriod>

<Server>RESELLERTEST</Server>

<Site>eNom</Site>

<IsLockable>True</IsLockable>

<IsRealTimeTLD>True</IsRealTimeTLD>

<TimeDifference>+03.00</TimeDifference>

<ExecTime>0.547</ExecTime>

<Done>true</Done>

<RequestDateTime>1/11/2012 1:1:11 PM </RequestDateTime>

</interface-response>

 

Top

2. TP_UpdateOrderDetail

You can use this command to update multiple domain names. Each item must be in comma delimited format and the total item of each category must be matched. If you need to update other parameters such as Registrar Lock, Auto-Renew and so on, please refer to TP_UpdateOrderDetail detailed information in the API Catalog.

Here are few combinations:

VALID:

  • TransferOrderDetailID=175625417&xxx_memberid=
  • TransferOrderDetailID=175625417&xxx_memberid=1111
  • TransferOrderDetailID=175625417,175625418&xxx_memberid=1111,
  • TransferOrderDetailID=175625417,175625418,175625419&xxx_memberid=1111,,
  • TransferOrderDetailID=175625417,175625418,175625419&xxx_memberid=1111,,3333
  • TransferOrderDetailID=175625417,175625418,175625419&xxx_memberid=,,3333

NOT VALID:

  • TransferOrderDetailID=175625417,175625418&xxx_memberid=1111
  • TransferOrderDetailID=175625417,175625418,175625419&xxx_memberid=1111,2222

Base parameters

* Required:

Update: type of update for this command. In this case, Update=XXX_MemberID

TransferOrderDetailID: transfer order ID number. Use the TP_GetOrder command to retrieve this value

* Optional:

xxx_memberid: membership authorization token provided by ICM Registry

Query

http://resellertest.enom.com/interface.asp?UID=resellid&PW=resellpw&ResponseType=xml&Command=TP_UpdateOrderDetail&update=xxx_memberid&TransferOrderDetailID=175625417,175625418&xxx_memberid=,2222

Output

<interface-response>

<?xml version="1.0" ?>

<interface-response>

<TransferOrders>

<TransferOrder>

<OrderDetailID>175625417</OrderDetailID>

<XXX_MemberID />

<UpdateSuccess>True</UpdateSuccess>

</TransferOrder>

<TransferOrder>

<OrderDetailID>175625418</OrderDetailID>

<XXX_MemberID>2222</XXX_MemberID>

<UpdateSuccess>True</UpdateSuccess>

</TransferOrder>

</TransferOrders>

<success>True</success>

<Command>TP_UPDATEORDERDETAIL</Command>

<Language>eng</Language>

<ErrCount>0</ErrCount>

<ResponseCount>0</ResponseCount>

<MinPeriod />

<MaxPeriod>10</MaxPeriod>

<Server>RESELLERTEST</Server>

<Site>eNom</Site>

<IsLockable />

<IsRealTimeTLD />

<TimeDifference>+0.00</TimeDifference>

<ExecTime>0.234</ExecTime>

<Done>true</Done>

<RequestDateTime>1/11/2012 1:11:11 PM</RequestDateTime>

</interface-response>

 

Top

3. TP_SubmitOrder

Base parameters

* Required:

TransferOrderID: transfer order ID number. To retrieve this value, use the TP_GetOrderStatuses command

Query

http://resellertest.enom.com/interface.asp?Command=TP_SubmitOrder&uid=resellid&pw=resellpw&responsetype=xml&transferorderid=175625417

Output

<interface-response>

<?xml version="1.0" ?>

<interface-response>

<success>True</success>

<Command>TP_SUBMITORDER</Command>

<Language>eng</Language>

<ErrCount>0</ErrCount>

<ResponseCount>0</ResponseCount>

<MinPeriod />

<MaxPeriod>10</MaxPeriod>

<Server>RESELLERTEST</Server>

<Site>eNom</Site>

<IsLockable />

<IsRealTimeTLD />

<TimeDifference>+0.00</TimeDifference>

<ExecTime>0.219</ExecTime>

<Done>true</Done>

<RequestDateTime>1/11/2012 1:11:11 PM</RequestDateTime>

</interface-response>