Personal tools

From HEXONET Wiki

Jump to: navigation, search
m
(Domain Transfer: X-FI-ACCEPT-REGISTRATION-TAC)
 
(9 intermediate revisions by 2 users not shown)
Line 101: Line 101:
 
<span class="label label-important">REQUIRED</span>
 
<span class="label label-important">REQUIRED</span>
 
<pre>
 
<pre>
 +
auth = <authcode>
 
action = REQUEST | APPROVE | DENY | CANCEL | USERTRANSFER
 
action = REQUEST | APPROVE | DENY | CANCEL | USERTRANSFER
 
</pre>
 
</pre>
Line 113: Line 114:
  
 
=== Delete Domain ===
 
=== Delete Domain ===
{{#var:DELETESENTENCE}}
+
Domains can be deleted with the API DeleteDomain command.
 +
 
 +
Please note that API deletions are not completed at the registry, but will naturally expire once it reaches the expiration date.<br/>
 +
If you would like the domain deleted immediately, please contact support.
 
{{#var:DELETEDOMAINCOMMAND}}
 
{{#var:DELETEDOMAINCOMMAND}}
  
Line 172: Line 176:
 
|registrant||other||individual||*required*&nbsp;birth&nbsp;date&nbsp;of&nbsp;the&nbsp;registrant
 
|registrant||other||individual||*required*&nbsp;birth&nbsp;date&nbsp;of&nbsp;the&nbsp;registrant
 
|}
 
|}
 +
Format: YYYY-MM-DD
  
 
=== Domain Transfers ===
 
=== Domain Transfers ===
Line 177: Line 182:
 
The losing registrar has to create a '''transfer key''' for the domain at the registry which will be only valid for 30 days. This key can be used as Authorization Code when requesting the transfer at HEXONET:
 
The losing registrar has to create a '''transfer key''' for the domain at the registry which will be only valid for 30 days. This key can be used as Authorization Code when requesting the transfer at HEXONET:
 
{{#var:TRANSFERDOMAINCOMMAND}}
 
{{#var:TRANSFERDOMAINCOMMAND}}
 +
<br>
 +
Similar to the registration process, the terms and conditions need to be accepted with:
 +
<pre>
 +
X-FI-ACCEPT-REGISTRATION-TAC = 1
 +
</pre>
 +
 +
<br>
  
 
=== Renewal Process===
 
=== Renewal Process===
Line 182: Line 194:
  
 
=== Ownerchange ===
 
=== Ownerchange ===
'''Step 1'''
+
'''Step 1'''<br>
 
Request a TradeDomain:<br>
 
Request a TradeDomain:<br>
 
<span class="label label-important">REQUIRED</span>
 
<span class="label label-important">REQUIRED</span>
Line 197: Line 209:
 
You have to provide either X-FI-REGISTRANT-IDNUMBER or X-FI-REGISTRANT-BIRTH-DATE (see table above).
 
You have to provide either X-FI-REGISTRANT-IDNUMBER or X-FI-REGISTRANT-BIRTH-DATE (see table above).
  
If this command was executed successfully then the registry will send an email with a so called 'transfer key' (referring to >>transfer of ownership<<) to the registrant of the domain.
+
When this command is executed successfully, the registry will send an email with a 'transfer key' (referring to >>transfer of ownership<<) to the registrant of the domain. This key is valid for 30 days.
  
This works a a trigger to authorise the change of ownership.
+
This key is used to authorise the change of ownership.<br>
  
'''Step 2'''
+
'''Step 2'''<br>
 
Authorize the change of registrant with an ActivateDomainTrade command:<br>
 
Authorize the change of registrant with an ActivateDomainTrade command:<br>
 
<span class="label label-important">REQUIRED</span>
 
<span class="label label-important">REQUIRED</span>
Line 210: Line 222:
 
</pre>
 
</pre>
  
If this command was executed successfully then the trade will be completed automatically within a few minutes.
+
If this command was executed successfully then the trade will be completed automatically within a few minutes.<br><br>
  
 +
'''Cancelling a Trade''': After requesting a trade but prior to a successful ActivateDomainTrade command you can cancel a trade as follows:<br>
 +
<span class="label label-important">REQUIRED</span>
 +
<pre>
 +
command = TradeDomain
 +
action = cancel
 +
domain = (DOMAIN)
 +
</pre>
  
 
= Addons =
 
= Addons =

Latest revision as of 07:34, 4 March 2024

.FI

.FI is the country code top-level domain (ccTLD) for the country of Finland. Highly popular in Finland, the intended use of the domain is for individuals and commercial entities associated with the country of Finland.


Fi.jpg
Introduced 1986
Country Finland
Registry FI Registry
IDN Capable Yes
Webpage Register .FI

Contents


[edit] Registry

TLD

-

Registry

.FI REGISTRY

Dispute Policy

Rules

Registrar

1api GmbH

WHOIS-Server

whois.ficora.fi

WHOIS-Update

Real-Time

Min. Characters

2

Max. Characters

63

Character Set
  • Letters and numbers
  • Hyphens ("-"), however not at the beginning or directly in front of the TLD
  • IDN: allowed
Limitations
  • Registrant Contacts: Required: 1 / Maximum: 1
  • Admin Contacts: Required: 0 / Maximum: 1
  • Tech Contacts: Required: 0 / Maximum: 1
  • Billing Contacts: Required: 0 / Maximum: 1

{{{Possible Extensions}}}

IDN capable

Yes

Restore capable

Real-Time

Handle Updates

Supported

Registration System

Real-Time

Allowed number of NS

0 to 10

Host IP-Addresses Type

IPv4 / IPv6

Hosts managed as

Object

SEC DNS Interface

DS data interface

Transferclass

Pull

Transfer Periods

0Y

Transfer Authcode required

Yes

Transfer Real-Time

Yes

Transfer Lock

Yes

Transfer Confirmation (Request / Approve)

- / -

Owner Change by

Trade

Trade Real-Time

Yes

Trade Periods

-

Transfer included

No

Trade Confirmation (Request / Approve)

E-Mail / -

Trade ACK by

-

Trade NACK by

-


[edit] Periods

{{{Possible Extensions}}}

Registration Periods

1-5 years

Add Grace Period

0 days

Accounting Period

-1 week

Finalization Period

-1 day

Failure Period

26 days

Payment Period

-61 days

Deletion Restorable Period

0 days

Deletion Hold Period

0 days

Explicit Renewals

Yes

Renewal Periods

1-5 years


[edit] API

[edit] Domain Registration

Domains can be registered in Real-Time with the API AddDomain command.

command = AddDomain
domain  = (DOMAIN)

REQUIRED

ownercontact0 = (CONTACT)
admincontact0 = (CONTACT)
techcontact0 = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0 = (NAMESERVER)
nameserver1 = (NAMESERVER)

X-FI-ACCEPT-REGISTRATION-TAC = 1

OPTIONAL

X-FI-REGISTRANT-IDNUMBER = <TEXT>
X-FI-REGISTRANT-BIRTH-DATE = <TEXT>
auth = <TEXT> | <NULL>
subuser = <TEXT> | <NULL>

[edit] Domain Transfer

The transfer has to be initiated by the gaining registrar and can be requested with the API TransferDomain command.
A valid Authorization Code must be provided to initiate a transfer successfully. You may obtain the authorization code from the losing registrar.
Domain transfers are processed in Real-Time.

command = TransferDomain
domain = (DOMAIN)

REQUIRED

auth = <authcode>
action = REQUEST | APPROVE | DENY | CANCEL | USERTRANSFER

OPTIONAL

order = CREATE | REPLACE | UPDATE

subuser = <TEXT> | <NULL>
period = <PERIOD>

[edit] Delete Domain

Domains can be deleted with the API DeleteDomain command.

Please note that API deletions are not completed at the registry, but will naturally expire once it reaches the expiration date.
If you would like the domain deleted immediately, please contact support.

command = DeleteDomain
domain = (DOMAIN)

[edit] Restore Domain

Restores can be processed in realtime. A restore is possible within 0 days upon deletion. Please use the command RestoreDomain.


[edit] Ownerchange

All contact information with the exception of registrant Name, Firstname and Organisation can be updated through the ModifyDomain command.
In order to change the owner you have to request a trade with the TradeDomain command. This can be done through our web interface or through our API:

command = TradeDomain
domain = <DOMAIN>
ownercontact0 = <CONTACT>

Before a trade gets initiated at the registry, a confirmation is required: An email confirmation will be sent to the registrant / administrative contact which has to be confirmed. Once confirmed then the trade is initiated.

The trade request will be processed in Real-Time by the registry.

A Change of Registrar with the simultaneous change in the Registrant is not possible. Please be aware that domain name must be already managed by us. If the domain is currently managed by another registrar there are two possibilities:
   1.) first step: transfer the domain to us, second step: trade the domain with us.
   2.) first step: trade the domain with the current registrar, second step: transfer the domain to us.
OPTIONAL

X-FI-REGISTRANT-IDNUMBER = <TEXT>
X-FI-REGISTRANT-BIRTH-DATE = <TEXT>

There is further information about available in the TLD specific section.

[edit] TLD specific

[edit] Registration

Necessary extensions

X-FI-ACCEPT-REGISTRATION-TAC = 1

Accept terms and conditions

additional parameter X-FI-REGISTRANT-IDNUMBER
role country of origin entity value
registrant FI organization *required* has to be the registernumber of the Finnish organization
registrant FI individual *required* has to be the identity number of the Finnish registrant
registrant other organization *required* has to be the registernumber of the organization
registrant other individual n/a

For individuals, please note that the X-FI-REGISTRANT-IDNUMBER has to contain of eleven characters of the form DDMMYYCZZZQ, where DDMMYY is the date of birth, C the century sign, ZZZ the individual number and Q the control character (checksum). The sign for the century is either + (1800–1899), - (1900–1999), or A (2000–2099). The individual number ZZZ is odd for males and even for females and for people born in Finland its range is 002-899 (larger numbers may be used in special cases). An example of a valid code is 311280-888Y.


additional parameter X-FI-REGISTRANT-BIRTH-DATE
role country of origin entity value
registrant FI organization n/a
registrant FI individual n/a
registrant other organization n/a
registrant other individual *required* birth date of the registrant

Format: YYYY-MM-DD

[edit] Domain Transfers

[edit] Inbound Domain Transfers

The losing registrar has to create a transfer key for the domain at the registry which will be only valid for 30 days. This key can be used as Authorization Code when requesting the transfer at HEXONET:

command = TransferDomain
domain = (DOMAIN)


Similar to the registration process, the terms and conditions need to be accepted with:

X-FI-ACCEPT-REGISTRATION-TAC = 1


[edit] Renewal Process

Domains can be renewed explicitly with the API RenewDomain command.
Valid Renewal Periods are: 1-5 years.

[edit] Ownerchange

Step 1
Request a TradeDomain:
REQUIRED

command = TradeDomain
domain = (DOMAIN)
ownercontact0 = (CONTACT)

OPTIONAL

X-FI-REGISTRANT-IDNUMBER = <TEXT>
X-FI-REGISTRANT-BIRTH-DATE = <TEXT>

You have to provide either X-FI-REGISTRANT-IDNUMBER or X-FI-REGISTRANT-BIRTH-DATE (see table above).

When this command is executed successfully, the registry will send an email with a 'transfer key' (referring to >>transfer of ownership<<) to the registrant of the domain. This key is valid for 30 days.

This key is used to authorise the change of ownership.

Step 2
Authorize the change of registrant with an ActivateDomainTrade command:
REQUIRED

command = ActivateDomainTrade
domain = (DOMAIN)
trigger = (TRANSFER KEY)

If this command was executed successfully then the trade will be completed automatically within a few minutes.

Cancelling a Trade: After requesting a trade but prior to a successful ActivateDomainTrade command you can cancel a trade as follows:
REQUIRED

command = TradeDomain
action = cancel
domain = (DOMAIN)

[edit] Addons

[edit] RegistrarOC

Restore Process

To restore a domain as a RegistrarOC customer, you simply have to execute the RestoreDomain command. HEXONET directly forwards the restore request to the registry, which performs the restore in real-time. As soon as the restore is complete, the domain will get assigned to your account with the original domain data.

Please do not initiate a restore directly at the registry (e.g. using the registrar webinterface). All restore operations must be performed through our system.


[edit] Pass-Through Behavior

It is also possible to configure your account in such a way that AddDomain and TradeDomain are directly sent to the registry. In this case, there is no need to use the commands ActivateDomainRegistration and ActivateDomainTrade.