Ascio Web Service v2

Java Axis CreateOrder - Owner_Change

Replaces the registrant with a new handle. There are 2 ways to submit the new Registrant:

  • Submit a Handle-ID. The handle linked to the domain will be replaced
  • Submit new data. A new handle will be created. The handle linked to the domain will be replaced

With the OwnerChange, it is possible to change Registrant and Admistrative Contact in one request.

The rules for the owner-change depend on the registry. Please look at the TLD-Kit for details.

An OwnerChange is needed when materialized data is changed

  • Name
  • Company
  • Company Numer
  • E-Mail (IRTP)

If no materialized data is changed, a Registrant Details Update can be used instead. This is easier than an Owner change.

Response CreateOrder(string sessionId,Order order)

Response codes

ResultCodeMessageValue
200Order validated
200Order received
400Order not validatedMessages
401Authorization failed
405Access denied

CreateOrder Request

PropertyDescription
sessionIdExample: o58t9fjgw9bjarp6q7byv13e
order

CreateOrderResponse

Property
CreateOrderResult
order
PropertyValue
OrderTypeOwner_Change

Java Axis example

package ascio.v2.examples;
import com.ascio.www._2007._01.*;
import com.ascio.www._2007._01.holders.*;
import ascio.lib.*;

public class Owner_ChangeExample {
	public static Response main() {
		AscioConfig config = new AscioConfig();
		V2 env = config.getTesting().getV2();

		Registrant registrant =  new Registrant();
		registrant.setName("ascio-is-great.com");
		registrant.setOrgName("Ascio");
		registrant.setAddress1("Address1Test");
		registrant.setAddress2("Address2Test");
		registrant.setCity("CityTest");
		registrant.setState("StateTest");
		registrant.setPostalCode("888349");
		registrant.setCountryCode("DK");
		registrant.setEmail(config.getEmail());
		registrant.setPhone("+45.123456789");
		registrant.setFax("+45.987654321");
		registrant.setRegistrantType("C1");
		registrant.setVatNumber("VatNumberTest");
		registrant.setNexusCategory("NexusCategoryTest");
		registrant.setRegistrantNumber("abc123445");
		registrant.setDetails("DetailsTest");
Please enter firstname [space] lastname, or lastname, firstname as value. The name is part of social data. You need an owner-chage to change the name. The Name is required for every Registrant/Contact. (In case no handle is used)The OrgName is part of social data. You need an owner-chage to change the OrgName.The Address1 is required for every Registrant/Contact. (In case no handle is used)The City is required for every Registrant/Contact. (In case no handle is used)The PostalCode is required for every Registrant/Contact. (In case no handle is used)The ISO 3166-1 code for the Country (DE,GB,DK,CH,SE,...). The CountryCode is required for every Registrant/Contact. (In case no handle is used)The Email is required for every Registrant/Contact. (In case no handle is used)Phone number must be in E164a format, eg. +45.123456789 (no spaces, hyphens, etc.).Fax number must be in E164a format, eg. +45.123456789 (no spaces, hyphens, etc.)Some TLDs need a Registrant Type. In most cases this is used to specify which type of RegistrantNumber is used (e.G. VAT, Passboard ID)An ID of the Registrant. The RegistrantType may describe which type of ID is used.
		Contact adminContact =  new Contact();
		adminContact.setStatus("StatusTest");
		adminContact.setHandle("JD123");
		adminContact.setFirstName("John");
		adminContact.setLastName("Doe");
		adminContact.setOrgName("Ascio");
		adminContact.setAddress1("Address1Test");
		adminContact.setAddress2("Address2Test");
		adminContact.setPostalCode("888349");
		adminContact.setCity("CityTest");
		adminContact.setState("StateTest");
		adminContact.setCountryCode("DK");
		adminContact.setEmail(config.getEmail());
		adminContact.setPhone("+45.123456789");
		adminContact.setFax("+45.987654321");
		adminContact.setType("owner");
		adminContact.setDetails("DetailsTest");
		adminContact.setOrganisationNumber("OrganisationNumberTest");
The Handle. Please don't use Handle and contact-data. The data won't be merged!All contacts have FirstName and LastName. This is different than Registrants.All contacts have FirstName and LastName. This is different than Registrants.The Address1 is required for every Registrant/Contact. (In case no handle is used)The PostalCode is required for every Registrant/Contact. (In case no handle is used).The City is required for every Registrant/Contact. (In case no handle is used)The ISO 3166-1 code for the Country (DE,GB,DK,CH,SE,...). The CountryCode is required for every Registrant/Contact. (In case no handle is used)The Email is required for every Registrant/Contact. (In case no handle is used)Phone numbers must be in E164a format, eg. +45.123456789 (no spaces, hyphens, etc.).Fax numbers must be in E164a format, eg. +45.123456789 (no spaces, hyphens, etc.)
		Domain domain =  new Domain();
		domain.setDomainName(env.getProperties().getProperty("DomainName"));
		domain.setRegistrant(registrant);
		domain.setAdminContact(adminContact);
The registrant is different from all other contacts. You can use a Registrant as Admin/Tech/Billing/Reseller contact. You can't you a Contact as Registrant
		Order order =  new Order();
		order.setType(OrderType.Owner_Change);
		order.setDomain(domain);

		try {
			/**inputs holders*/

			OrderHolder orderHolder = new OrderHolder(order);

			Response response = env.getClient().createOrder(env.getSessionId(), orderHolder);


			System.out.println("CreateOrder ResultCode\t: " + response.getResultCode().toString());
			System.out.println("CreateOrder Message\t: " + response.getMessage());
			System.out.println("Created OrderId\t\t: " + orderHolder.value.getOrderId());
			if(response.getResultCode() == 400) {
				for( String value : response.getValues()) {
					System.out.println("Error:	" + value);
				}
			}
			env.repeatSync(orderHolder.value.getOrderId(), 10);
			return response;
		} catch (Exception e) {
			System.out.print(e);
		}
		return new Response();package ascio.v2.examples;
import com.ascio.www._2007._01.*;
import com.ascio.www._2007._01.holders.*;
import ascio.lib.*;

public class Owner_ChangeExample {
	public static Response main() {
		AscioConfig config = new AscioConfig();
		V2 env = config.getTesting().getV2();

		Registrant registrant =  new Registrant();
		registrant.setName("ascio-is-great.com");
		registrant.setOrgName("Ascio");
		registrant.setAddress1("Address1Test");
		registrant.setAddress2("Address2Test");
		registrant.setCity("CityTest");
		registrant.setState("StateTest");
		registrant.setPostalCode("888349");
		registrant.setCountryCode("DK");
		registrant.setEmail(config.getEmail());
		registrant.setPhone("+45.123456789");
		registrant.setFax("+45.987654321");
		registrant.setRegistrantType("C1");
		registrant.setVatNumber("VatNumberTest");
		registrant.setNexusCategory("NexusCategoryTest");
		registrant.setRegistrantNumber("abc123445");
		registrant.setDetails("DetailsTest");

		Contact adminContact =  new Contact();
		adminContact.setStatus("StatusTest");
		adminContact.setHandle("JD123");
		adminContact.setFirstName("John");
		adminContact.setLastName("Doe");
		adminContact.setOrgName("Ascio");
		adminContact.setAddress1("Address1Test");
		adminContact.setAddress2("Address2Test");
		adminContact.setPostalCode("888349");
		adminContact.setCity("CityTest");
		adminContact.setState("StateTest");
		adminContact.setCountryCode("DK");
		adminContact.setEmail(config.getEmail());
		adminContact.setPhone("+45.123456789");
		adminContact.setFax("+45.987654321");
		adminContact.setType("owner");
		adminContact.setDetails("DetailsTest");
		adminContact.setOrganisationNumber("OrganisationNumberTest");

		Domain domain =  new Domain();
		domain.setDomainName(env.getProperties().getProperty("DomainName"));
		domain.setRegistrant(registrant);
		domain.setAdminContact(adminContact);

		Order order =  new Order();
		order.setType(OrderType.Owner_Change);
		order.setDomain(domain);

		try {
			/**inputs holders*/

			OrderHolder orderHolder = new OrderHolder(order);

			Response response = env.getClient().createOrder(env.getSessionId(), orderHolder);


			System.out.println("CreateOrder ResultCode\t: " + response.getResultCode().toString());
			System.out.println("CreateOrder Message\t: " + response.getMessage());
			System.out.println("Created OrderId\t\t: " + orderHolder.value.getOrderId());
			if(response.getResultCode() == 400) {
				for( String value : response.getValues()) {
					System.out.println("Error:	" + value);
				}
			}
			env.repeatSync(orderHolder.value.getOrderId(), 10);
			return response;
		} catch (Exception e) {
			System.out.print(e);
		}
		return new Response();
WSDL for AWS v2
https://aws.demo.ascio.com/2012/01/01/AscioService.wsdl (OTE)
https://aws.ascio.com/2012/01/01/AscioService.wsdl (Live)
Please configure the IP-Whitelisting in the portal/demo-portal.