How to perform a change of registrant for gTLDs

General:

Control Panel:

API:

About Change of Registrant

A change of registrant, also referred to as a trade, is the exchange of details for a domain's primary contact.

This specific contact is easily identifiable to be primary, and is often situated underneath the "Owner" or "Registrant" Fields. See example below. From your control panel, this field is referred to as "Owner".

1.png

Why might you want to change your registrant details?

1. The contact information is no longer fully accurate.

2. The email address is inaccessible (and):

  • Your domain is undergoing verification/suspension.
  • You are intending to transfer your domain away.

The ICANN Trade Policy

As of December 1st of 2016 we've implemented a new policy mandated by ICANN. This policy is known as the Inter-Registrar Transfer Policy. You can read the official documentation here.

In short, the Inter-Registrar Transfer Policy (aka ICANN Trade policy) modifies the former change of registrant process by asking both registrants (old and new) to approve modifications made to the owner/registrant field of a domain’s current contact details.

ICANN has determined that a registrants are unique and identifiable by their specific combination of:

  • First Name
  • Last Name
  • Organization Name
  • Email Address

Here are some common scenarios:

First Name: Jane
Last Name: Wilson
Organization Name: Super Corp of America
Email: jwilson@supercorpusa.com

and...

First Name: John
Last Name: Doe
Organization Name: Amazing Business Inc
Email: john.doe@amazinc.net

are two different registrants. According to the classification of registrants by the fields mentioned earlier, this also means that:

Registrant A
First Name: John
Last Name: Doe
Organization Name: Amazing Business Inc
Email: john.doe@typicalemail.com

and...

Registrant B
First Name: John
Last Name: Doe
Organization Name: Associates & Associates Associated
Email: john.doe@typicalemail.com

are different registrants under the new ICANN Trade Policy.

As mentioned above, both registrant A and registrant B must approve of the change of registrant. This means that john.doe@typicalemail.com will receive 2 emails that are to both be approved in order for the transition from A to B to take place.

A more common scenario would be:

Registrant A
First Name: John
Last Name: Doe
Organization Name: Amazing Business Inc
Email: john.doe@typicalemail.com

and...

Registrant B
First Name: John
Last Name: Doe
Organization Name: Amazing Business Inc
Email: john@doe.com

In this circumstance, as expected, registrant A (john.doe@typicalemail.com) and registrant B (john@doe.com) would both receive emails to confirm the change from A to B. Both must be approved for the change to take place.

Designated Agents (DA)

The Designated Agent program takes the onus of approving the “email confirmation” on behalf of a registrant and places it on the reseller.

Meaning in the scenarios above, in most circumstances, Registrant A will be excluded from the validation process of the ICANN Trade, as the reseller has taken the responsibility of approving their side of the agreement.

This can be exceptionally useful when the registrant can no longer access their old email address, and, as such, requires to swap it for a functional email address.

Once a unique combination of:

  • First Name
  • Last Name
  • Organization Name
  • Email Address

has been instantiated within a designated agent agreement, then that email address will never again have to approve an ICANN trade for any domain with that combination of values.

This includes both instances in which this particular set of information will be used as the new or old registrant details.

It is important to note that, in whichever method Designated Agent is enabled, the explicit consent of the registrant to participate in such a program is required. By default, a change of registrant processed with Designated Agent will be locked with a 60 day registrar transfer lock.

Enable DA for Existing Registrants

If you haven't already, you can enable Designated Agent for all your existing registrants via the reseller's control panel. Please note that this action is non-reversible!

Visit manage.opensrs.com > Domains > Settings > Scroll down to the bottom >

Enable Designated Agent for All Existing Domains > Edit

Read the agreement, check all of the checkboxes, enter your full name, toggle the Enable Designated Agent Switch, and finally...

...press Confirm

Untitled2.PNG

Full Trade with DA

You can enable Designated Agent for a particular registrant while performing a change of registrant on any domain in your reseller’s portfolio.

To do so:

visit manage.opensrs.com > domains > query a domain in need of a registrant change > click on the domain

2.png

In the domains overview > Contact Information > Edit

Untitled4.PNG

Under Owner, change the applicable fields: First Name, Last Name, Organization Name, Email > Save

6.png

You will now be presented with 2 options:

  • Waive Email Confirmation (Enable Designated Agent)
  • Opt-Out of 60 Day Transfer Lock

Untitled6.PNG

Configure these options according to your needs. If "Waive email confirmation" is selected, an IP address will be required when submitting the request. Please ask the registrant to provide the IP by having them visit websites such as whatsmyip.net.

If "Waive email confirmation" is enabled and "Opt-Out of 60-day Transfer Lock" is disabled, a single email will be dispatched to the new registrant's email address where a confirmation URL will be presented to the registrant. Once the registrant follows through with the instructions from the email, the ICANN trade will complete and the domain will be locked to the registrar for 60 days.

If "Waive email confirmation" is enabled and "Opt-Out of 60-day Transfer Lock" was enabled, a single email will be dispatched to the new registrant's email address where a confirmation URL will be presented to the registrant. Once the registrant follows through with the instructions from the email, the ICANN trade will complete and the domain will not be subjected to the 60 day registrar transfer lock.

If both are disabled, then both registrants (new and old) will receive an email confirmation which must be approved in order for the trade to complete.

Accepting Trades via SMS

If the old registrant would prefer not to have the confirmation approval by Designated Agent AND cannot access their email address, you can change the registrant's phone number (as so long as you do not change any of the registrant fields).

This is important because in this particular scenario, we are verifying the old registrant via SMS rather than their inaccessible email address.

Please keep in mind that when entering a phone number in any of our interfaces the format is: +countrycode.phonenumber (example: +1.4165350123).

Full Trade without DA

To do so:

visit manage.opensrs.com > domains > query a domain in need of a registrant change > click domain

2.png

In the domains overview > Contact Information > Edit

Untitled4.PNG

Change the Owner Phone number alone, then enter a phone number that can accept SMS. The phone number should be in the following format: +countrycode.phonenumber

4.png

Afterwards, go back to the domains overview page and press the edit button again.

Untitled4.PNG

Under Owner, change the applicable fields (First Name, Last Name, Organization Name, Email), then Save

6.png

You will be presented with the following options. Disable both options then click "Continue With Change of Registrant"

screenshot_7.png

When refreshing the domain overview page, two new buttons can be found above the contact information for the domain. The button on the left toggles the WHOIS contact information. The button on the right will resend the ICANN Trade validation email to the new registrant. As long as the button on the right displays "Resend Confirmation to New Registrant" the new registrant has yet to approve their side of the verification procedure. You can use this button to send another email request to the new registrant. Once the new new registrant approves their verification email, the button will automatically change to "Resend Confirmation to Existing Registrant".

7.png

To send an SMS to the existing registrant, click the button "Resend Confirmation to Existing Registrant". You will be presented with 2 options:

  • To resend via email
  • To resend via SMS

Click the SMS Checkbox > Ensure that the phone number matches what you originally submitted in the earlier stages of this tutorial > Send

8.png

The registrant will be sent an SMS with a URL to the confirmation page where they can complete their side of the verification procedure. The trade is completed once the two buttons above disappear.

Send SMS (API)

Submit 2 separate calls for update_contacts. The first call will change the phone number field alone for the "owner" item. The second call will modify the other crucial details for the "owner", including the email address.

Two separate emails will be dispatched to the old registrant and the new registrant. Once the new registrant approves the trade by following through with the instructions in their email (confirm this via domain notes or with the registrant directly), you can use the following call:

http://domains.opensrs.guide/docs/resend_trade_approval_notice

Example:

<?xml version='1.0' encoding="UTF-8" standalone="no" ?>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="object">DOMAIN</item>
<item key="action">RESEND_TRADE_APPROVAL_NOTICE</item>
<item key="attributes">
<dt_assoc>
<item key="registrant_type">current</item>
<item key="domain">example.com</item>
<item key="send_type">sms</item>
<item key="sms_phone_number">+1.2602180057</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>

This API call will send a new confirmation of the type SMS to the phone number +1.2602180057

For the old (current) registrant, please ensure that the phone number listed in the item_sms_phone_number is identical to the one implanted in your first update_contacts call.

Changing registrant contact details Via API

http://domains.opensrs.guide/docs/update_contacts

<?xml version='1.0' encoding="UTF-8" standalone="no" ?>
<!DOCTYPE OPS_envelope SYSTEM "ops.dtd">
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<itemkey="protocol">XCP</item>
<itemkey="object">DOMAIN</item>
<itemkey="action">UPDATE_CONTACTS</item>
<itemkey="attributes">
<dt_assoc>
<itemkey="types">
<dt_array>
<itemkey="0">owner</item>
</dt_array>
</item>
<itemkey="domain">example.com</item>
<itemkey="contact_set">
<dt_assoc>
<itemkey="owner">
<dt_assoc>
<itemkey="country">US</item>
<itemkey="address3">Owner</item>
<itemkey="org_name">Example Inc.</item>
<itemkey="phone">+1.4165350123x1902</item>
<itemkey="last_name">Ottway</item>
<itemkey="address2">Suite 500</item>
<itemkey="state">CA</item>
<itemkey="email">ottway@example.com</item>
<itemkey="city">SomeCity</item>
<itemkey="postal_code">90210</item>
<itemkey="fax">+1.4165350124</item>
<itemkey="address1">32 Oak Street</item>
<itemkey="first_name">Owen</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>

The API Call above will change the owner/registrant from its current information to:

Owen
Ottway
Example Inc.
32 Oak Street
Suite 500
Owner
90210
SomeCity
CA
US
+1.4165350123x1902
+1.4165350124

For further details on how this API call works, consult the link above.

Enabling Designated Agent Via API call:

http://domains.opensrs.guide/docs/enable_designated_agent

<?xml version='1.0' encoding="UTF-8" standalone="no" ?>
<!DOCTYPE OPS_envelope SYSTEM "ops.dtd">
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<itemkey="protocol">XCP</item>
<itemkey="object">icann_trade_registrant</item>
<itemkey="action">enable_designated_agent</item>
<itemkey="attributes">
<dt_assoc>
<itemkey="owner">
<dt_assoc>
<itemkey="email">johndoe@example.com</item>
<itemkey="org_name">Example Corp.</item>
<itemkey="last_name">Doe</item>
<itemkey="first_name">John</item>
</dt_assoc>
</item>
<itemkey="ip_address">0.0.0.0</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>

The API call above will ensure that following registrant:

First Name: John
Last Name: Doe
Organization: Example Corp.
Email: johndoe@example.com

..will no longer be subjected to any ICANN Trade approval emails from the reseller. An IP address is required when making the call. Please ask the registrant to provide the IP by having them visit websites such as whatsmyip.net. This IP acts as a “digital signature” to ensure that the registrant agrees to the actions of the reseller.

Disabling/Enabling the 60 day ICANN Trade lock via API:

The 60 day transfer lock will be on by default if the ICANN trade occurs with Designated Agent. To remove the lock, make the following API call BEFORE issuing a trade. The call will not unlock a domain if the domain is already transfer locked. In such a case, you must issue the command below, then process another trade to unlock the domain.

http://domains.opensrs.guide/docs/modify_trade_lock_setting

Example:

<?xml version='1.0' encoding="UTF-8" standalone="no" ?>
<!DOCTYPE OPS_envelope SYSTEM "ops.dtd">
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<itemkey="protocol">XCP</item>
<itemkey="object">DOMAIN</item>
<itemkey="action">modify_trade_lock_setting</item>
<itemkey="attributes">
<dt_assoc>
<itemkey="enable">0</item>
<itemkey="domain">example.com</item>
<itemkey="ip_address">0.0.0.0</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>

The lock can be toggled on or off by changing the value of:

<itemkey="enable">X</item&gt

Replacing x with:
0 - Lock Disabled
1 - Lock Enabled

Similarly to the enable_designated_agent API call, an IP address is required when making the call. Please ask the registrant to provide the IP by having them visit websites such as whatsmyip.net.

For further details on how this API call works, consult the link above.

Registrant Participation:

The screen cap below shows what the new and old registrant receive for their ICANN Trade Request Emails. The Old Registrant, unlike the New Registrant, will additionally receive an option to opt in or out of the 60 day transfer lock.

1.png

Have more questions? Submit a request

0 Comments

Article is closed for comments.
Powered by Zendesk