Revision as of 16:10, 14 July 2016 (view source) Timo (Talk | contribs) (→‎Update) ← Older edit		Latest revision as of 07:34, 4 March 2024 (view source) WikiAdmin (Talk | contribs) (Domain Transfer: X-FI-ACCEPT-REGISTRATION-TAC)
(22 intermediate revisions by 2 users not shown)
Line 8:		Line 8:
	| webpage = [https://www.hexonet.net/domain-name/fi Register .FI]		| webpage = [https://www.hexonet.net/domain-name/fi Register .FI]
	}}		}}
−	{{#repositoryinfo: FI-LIVE-1API | fi }}	+	{{#repositoryinfo: FIEPP-LIVE-1API | fi }}
	{{Sidebar}}		{{Sidebar}}
Line 87:		Line 87:
	X-FI-ACCEPT-REGISTRATION-TAC = 1		X-FI-ACCEPT-REGISTRATION-TAC = 1
−	X-FI-IDNUMBER = <TEXT>
	</pre>		</pre>
	<span class="label label-info">OPTIONAL</span>		<span class="label label-info">OPTIONAL</span>
	<pre>		<pre>
		+	X-FI-REGISTRANT-IDNUMBER = <TEXT>
		+	X-FI-REGISTRANT-BIRTH-DATE = <TEXT>
	auth = <TEXT> | <NULL>		auth = <TEXT> | <NULL>
	subuser = <TEXT> | <NULL>		subuser = <TEXT> | <NULL>
Line 100:		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 112:		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 121:		Line 126:
	=== Ownerchange ===		=== Ownerchange ===
	{{#var:TRADESENTENCE}}<br>		{{#var:TRADESENTENCE}}<br>
−	<span class="label label-important">REQUIRED</span>	+	<span class="label label-important">OPTIONAL</span>
	<pre>		<pre>
−	X-FI-IDNUMBER = <TEXT>	+	X-FI-REGISTRANT-IDNUMBER = <TEXT>
		+	X-FI-REGISTRANT-BIRTH-DATE = <TEXT>
	</pre>		</pre>
		+
		+	There is further information about available in the TLD specific section.
	= TLD specific =		= TLD specific =
−	=== Registration Limitations and Requirements ===	+	=== Registration ===
−	Prerequisites for applying for a domain name are met, when the applicant is	+	'''Necessary extensions'''
		+	<br>
		+	<pre>
		+	X-FI-ACCEPT-REGISTRATION-TAC = 1
		+	</pre>
		+	Accept terms and conditions
		+	<br>
−	*a person of at least 15 years of age who has a Finnish Personal Identity Number and is domiciled in Finland	+	{| class="wikitable"
−	*a company, an organization or a private entrepreneur entered in the Finnish Trade Register, the Finnish Register of Associations or the Finnish Register of Foundations	+	!colspan="4"|additional parameter '''X-FI-REGISTRANT-IDNUMBER'''
−	*a Finnish public corporation	+	|-
−	*a state-owned company	+	|'''role'''||'''country&nbsp;of&nbsp;origin'''||'''entity'''||'''value'''
−	*an independent public service, public association or an embassy of a foreign state.	+	|-
		+	|registrant||FI||organization||*required*&nbsp;has&nbsp;to&nbsp;be&nbsp;the&nbsp;registernumber&nbsp;of&nbsp;the&nbsp;Finnish&nbsp;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
		+	|}
−	Domain names may be applied for only after the Trade, Association or Foundation registration has been finalised. A pending registration is not sufficient. An applicant who has only a Business ID or is entered only in the tax administration register is not entitled to a domain name.	+	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.
−	According to the Act on Domain Names, the applicant is responsible for ensuring that the domain name is not wrongfully based on the registered name or trademark of another party. In the application form, the applicant must certify that the domain name is not a registered name or trademark that belongs to another party.	+	<br>
−	{{Warnbox | If the name server inspection reveals that the name server is inoperative, it must be corrected within a month. Otherwise, the domain name application will expire and the applicant loses the domain name. The fee will not be returned.}}	+	{| class="wikitable"
		+	!colspan="4"|additional parameter '''X-FI-REGISTRANT-BIRTH-DATE'''
		+	|-
		+	|'''role'''||'''country&nbsp;of&nbsp;origin'''||'''entity'''||'''value'''
		+	|-
		+	|registrant||FI||organization||n/a
		+	|-
		+	|registrant||FI||individual||n/a
		+	|-
		+	|registrant||other||organization||n/a
		+	|-
		+	|registrant||other||individual||*required*&nbsp;birth&nbsp;date&nbsp;of&nbsp;the&nbsp;registrant
		+	|}
		+	Format: YYYY-MM-DD
−	PLEASE NOTE:  Domain Name Application (Registration) fees will not be refunded if:	+	=== Domain Transfers ===
−		+	==== Inbound Domain Transfers ====
−	*the domain name is registered incorrectly by mistake;	+	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 application expires due to inoperative name servers; or	+	{{#var:TRANSFERDOMAINCOMMAND}}
−	*FICORA later suspends or revokes the domain name pursuant to the [https://domain.fi/info/en/index/tietoa/laitjamaaraykset.html  Domain Name Act.]	+
−		+
−	=== Registration ===	+
−	'''Necessary extensions'''	+
	<br>		<br>
		+	Similar to the registration process, the terms and conditions need to be accepted with:
	<pre>		<pre>
	X-FI-ACCEPT-REGISTRATION-TAC = 1		X-FI-ACCEPT-REGISTRATION-TAC = 1
	</pre>		</pre>
−	Accept terms and conditions	+
−	<br><br>	+	<br>
		+
		+	=== Renewal Process===
		+	{{#var:RENEWALSENTENCE}}
		+
		+	=== Ownerchange ===
		+	'''Step 1'''<br>
		+	Request a TradeDomain:<br>
		+	<span class="label label-important">REQUIRED</span>
	<pre>		<pre>
−	X-FI-IDNUMBER = <TEXT>	+	command = TradeDomain
		+	domain = (DOMAIN)
		+	ownercontact0 = (CONTACT)
	</pre>		</pre>
−	A valid Finish number must be provided for individuals as well as for organizations.	+	<span class="label label-info">OPTIONAL</span>
		+	<pre>
		+	X-FI-REGISTRANT-IDNUMBER = <TEXT>
		+	X-FI-REGISTRANT-BIRTH-DATE = <TEXT>
		+	</pre>
		+	You have to provide either X-FI-REGISTRANT-IDNUMBER or X-FI-REGISTRANT-BIRTH-DATE (see table above).
−	The registry sends the auth code to the registrant's email no later than three days upon successful registration.	+	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.
−	=== Update ===	+	This key is used to authorise the change of ownership.<br>
−	After a successful registration, the registry sends an "authorisation key" letter by mail to the holder of the domain.	+	'''Step 2'''<br>
		+	Authorize the change of registrant with an ActivateDomainTrade command:<br>
		+	<span class="label label-important">REQUIRED</span>
		+	<pre>
		+	command = ActivateDomainTrade
		+	domain = (DOMAIN)
		+	trigger = (TRANSFER KEY)
		+	</pre>
−	{{Warnbox| You need to enter the "authorisation key"  as the domain Authorization Code in our system before you can change some information, such as the Nameservers or contacts of your domain}}	+	If this command was executed successfully then the trade will be completed automatically within a few minutes.<br><br>
−		+
−	=== Renewal Process===	+
−	{{#var:RENEWALSENTENCE}}	+
		+	'''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 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.

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

Contents 1 Registry 2 Periods 3 API 3.1 Domain Registration 3.2 Domain Transfer 3.3 Delete Domain 3.4 Restore Domain 3.5 Ownerchange 4 TLD specific 4.1 Registration 4.2 Domain Transfers 4.2.1 Inbound Domain Transfers 4.3 Renewal Process 4.4 Ownerchange 5 Addons 6 RegistrarOC 6.1 Restore Process 6.2 Pass-Through Behavior

[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.

[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.