Ascio Web Service v3

C# CreateOrder - OwnerChange

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.

CreateOrderResponse CreateOrder(SecurityHeaderDetails securityHeader,CreateOrderRequest request)

Response codes

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

CreateOrder Request

PropertyType
request

CreateOrderResponse

PropertyDescription
CreateOrderResult
OrderInfo
ResultCodeExample: 1
ResultMessage
Errors

Used in Classes

PropertyValue
OrderTypeOwnerChange
requestDomainOrderRequest

C# example

AscioServices services = new ServiceReference1.AscioServiceClient();
SecurityHeaderDetails securityHeader = new SecurityHeaderDetails();
securityHeader.Account = "username";
securityHeader.Password = "password";

KeyValue keyValue =  new KeyValue();
keyValue.Key = "Title";
keyValue.KeySpecified = true;
keyValue.Value = "Mr.";
keyValue.ValueSpecified = true;

Extensions ownerExtensions =  new Extensions(array($keyValue));

Registrant owner =  new Registrant();
owner.FirstName = "John";
owner.FirstNameSpecified = true;
owner.LastName = "Doe";
owner.LastNameSpecified = true;
owner.OrgName = "Ascio";
owner.OrgNameSpecified = true;
owner.Address1 = "Address1Test";
owner.Address1Specified = true;
owner.Address2 = "Address2Test";
owner.Address2Specified = true;
owner.City = "CityTest";
owner.CitySpecified = true;
owner.State = "StateTest";
owner.StateSpecified = true;
owner.PostalCode = "888349";
owner.PostalCodeSpecified = true;
owner.CountryCode = "DK";
owner.CountryCodeSpecified = true;
owner.Phone = "+45.123456789";
owner.PhoneSpecified = true;
owner.Fax = "+45.987654321";
owner.FaxSpecified = true;
owner.Email = email@email.com
owner.Type = "owner";
owner.TypeSpecified = true;
owner.Details = "DetailsTest";
owner.DetailsSpecified = true;
owner.OrganisationNumber = "OrganisationNumberTest";
owner.OrganisationNumberSpecified = true;
owner.Extensions = ownerExtensions;
owner.VatNumber = "VatNumberTest";
owner.VatNumberSpecified = true;
owner.NexusCategory = "NexusCategoryTest";
owner.NexusCategorySpecified = true;

KeyValue keyValue =  new KeyValue();
keyValue.Key = "Title";
keyValue.KeySpecified = true;
keyValue.Value = "Mr.";
keyValue.ValueSpecified = true;

Extensions adminExtensions =  new Extensions({(
		new KeyValue("Title", "Mrs.")
		}
	);

Contact admin =  new Contact();
admin.FirstName = "John";
admin.FirstNameSpecified = true;
admin.LastName = "Doe";
admin.LastNameSpecified = true;
admin.OrgName = "Ascio";
admin.OrgNameSpecified = true;
admin.Address1 = "Address1Test";
admin.Address1Specified = true;
admin.Address2 = "Address2Test";
admin.Address2Specified = true;
admin.City = "CityTest";
admin.CitySpecified = true;
admin.State = "StateTest";
admin.StateSpecified = true;
admin.PostalCode = "888349";
admin.PostalCodeSpecified = true;
admin.CountryCode = "DK";
admin.CountryCodeSpecified = true;
admin.Phone = "+45.123456789";
admin.PhoneSpecified = true;
admin.Fax = "+45.987654321";
admin.FaxSpecified = true;
admin.Email = email@email.com
admin.Type = "owner";
admin.TypeSpecified = true;
admin.Details = "DetailsTest";
admin.DetailsSpecified = true;
admin.OrganisationNumber = "OrganisationNumberTest";
admin.OrganisationNumberSpecified = true;
admin.Extensions = adminExtensions;

Domain domain =  new Domain();
domain.Name = "ascio-is-great.com";
domain.Owner = owner;
domain.Admin = admin;

DomainOrderRequest request =  new DomainOrderRequest();
request.Type = OrderType.OwnerChange;
request.TypeSpecified = true;
request.TransactionComment = "TransactionCommentTest";
request.TransactionCommentSpecified = true;
request.Documentation = "DocumentationTest";
request.DocumentationSpecified = true;
request.Domain = domain;
CreateOrderResponse response = services.CreateOrder(securityHeader, request);
if (response.ResultCode == 200) {
	Console.WriteLine("My new orderId is : " + request.OrderInfo.OrderId);
} else {
	if (response.Errors != null) {
		Console.WriteLine(String.Join(",", response.Errors));
	}
	Console.WriteLine(response.ResultMessage)
}
WSDL for AWS v3
https://aws.demo.ascio.com/v3/aws.wsdl (OTE)
https://aws.ascio.com/v3/aws.wsdl (Live)
Please configure the IP-Whitelisting in the portal/demo-portal.