OrderingTransferDomain

Latest revision as of 10:58, 11 March 2014

You can order a transfer domain name using the Ordering API. The ordering process should have the following steps. You need to create an order, create an account or set an existing account to use with the order, add a product, add service to the product, add attributes to the service and finally you need to validate the order, get a quote and submit the order. The general process is documented in the Ordering API.

When creating a product, you need to use the product offering (specification) associated with the domain product, e.g.

{ "offering": "http://coreapi01.ote.chicago.hostway:8100/productSpecifications/core.plan.dnr.only/offerings/USD-12" }
 

When adding a service to the product you need to use service specification associated with domain name registration:

{
   "name": "ng-test-fitnesse-20130412-0840.com",
   "serviceSpecification": "http://coreapi01.ote.chicago.hostway:8100/serviceSpecifications/core.dnr.com",
   "billingCycle": 12
}
 

Finally, the service needs to have attributes such asdomain contacts, nameservers, registration term, etc.:

Transfer .com

{
   "domainName": "ng-test-fitnesse-20130412-0840.com",
   "operation": "transfer",
   "term": 1,
   "authInfo" : "mysecret",
   "nameservers" : [ "ns1.test.com", "ns2.test.com" ],
   "contactInfo" : {
      "registrant": {
         "type": "registrant",
         "firstName": "John",
         "lastName": "Doe",
         "company": "ACME Inc.",
         "street1": "123 First Str.",
         "city": "Chicago",
         "zipOrPostal": "34567",
         "stateOrProvince": "IL",
         "countryCode": "US",
         "email1": "john.doe@test.com",
         "phone1": "+1.312.456789098" },
      "administrative": {
         "type": "administrative",
         ...
      },
      "billing": {
         "type": "billing",
         ...
      },
      "technical": {
         "type": "technical",
         ...
      }
   }
}
 

Transfer .us

{
   "domainName": "ng-test-fitnesse-20130412-0840.us",
   "operation": "transfer",
   "term": 1,
   "authInfo" : "mysecret",
   "nameservers" : [ "ns1.test.com", "ns2.test.com" ],
   "additionalParams" : { 
      "usNexusCode": "{usNexusCode}", 
      "usNexusCategory": "{usNexusCategory}" 
   },
   "contactInfo" : {
      "registrant": {
         "type": "registrant",
         "firstName": "John",
         "lastName": "Doe",
         "company": "ACME Inc.",
         "street1": "123 First Str.",
         "city": "Chicago",
         "zipOrPostal": "34567",
         "stateOrProvince": "IL",
         "countryCode": "US",
         "email1": "john.doe@test.com",
         "phone1": "+1.312.456789098" },
      "administrative": {
         "type": "administrative",
         ...
      },
      "billing": {
         "type": "billing",
         ...
      },
      "technical": {
         "type": "technical",
         ...
      }
   }
}
 

Service Attributes

domainName - string

The domain name

operation - string

"register" to register a domain

term - integer

the registration term (period) in years, term must equal 1

authInfo - string

authentication info, currently not supported

nameservers - list of strings

domain name servers (DNS) for the domain

usNexusCode - string (optional) (required for .us)

one of the following [P1, P2, P3, P4, P5]

usNexusCategory - string (optional) (required for .us)

one of the following [C11, C12, C21, C31, C32]

company - string (optional)

The company or organization name

firstName - string

The first name of the contact person

lastName - string

The last name of the contact person

street1 - string

The street address

street2 - string (optional)

The second line of the street address (if any)

city - string

The city

countryCode - string

The international 2-letter country code

stateOrProvince - string

The state or province. For US states use the 2-letter state code

zipOrPostal - string

The postal code

email1 - string

The e-mail address of the contact person

phone1 - string

The phone number of the contact person in valid E.164 format, e.g. +1.3209270625

See also

• Ordering API