Revision as of 17:13, 26 April 2023 (view source) Timo (Talk | contribs) m (→‎Delete Domain) ← Older edit		Latest revision as of 07:34, 4 March 2024 (view source) WikiAdmin (Talk | contribs) (Domain Transfer: X-FI-ACCEPT-REGISTRATION-TAC)
(One intermediate revision by one user not shown)
Line 115:		Line 115:
	=== Delete Domain ===		=== Delete Domain ===
	Domains can be deleted with the API DeleteDomain command.		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.	+
		+	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 180:		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===

---

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.