Latest revision as of 20:27, 3 July 2024

.HK is the official country code Top-Level-Domain (ccTLD) of Hong Kong.

Introduced	1990
Country	Hong Kong
Registry	HKIRC
IDN Capable	Yes
Webpage	Register .HK

[edit] Registry

[edit] Periods

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

OPTIONAL

auth = <TEXT> | <NULL>
transferlock = 0 | 1 | <NULL>
subuser = <TEXT> | <NULL>

X-HK-REGISTRANT-CHINESE-COMPANY = <TEXT>
X-HK-REGISTRANT-DOCUMENT-TYPE = <TEXT> (mandatory, if X-HK-REGISTRANT-DOCUMENT-TYPE is 'OTHIDV' or 'OTHORG')
X-HK-REGISTRANT-OTHER-DOCUMENT-TYPE = <TEXT>
X-HK-REGISTRANT-DOCUMENT-NUMBER = <TEXT>
X-HK-REGISTRANT-DOCUMENT-ORIGIN-COUNTRY = <COUNTRY>
X-HK-ACCEPT-INDIVIDUAL-REGISTRATION-TAC = 0 | 1 (0 = No, 1 = Yes) (Approval is mandatory, if the registrant is an individual)
X-REGISTRANT-BIRTH-DATE = YYYY-MM-DD (mandatory, if the registrant is an individual)

[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.
As soon as a domain transfer has been initiated it can either be approved ("ACK") by Registrar or denied ("NACK") by Registrar. If the registry receives neither a denial ("NACK") nor an approval ("ACK") the transfer will be ACKed after 3 days.

command = TransferDomain
domain = (DOMAIN)

REQUIRED

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

OPTIONAL

order = CREATE | REPLACE | UPDATE

subuser = <TEXT> | <NULL>
period = <PERIOD>
transferlock = 0 | 1 | <NULL>

[edit] Delete Domain

Domains can be deleted with the API DeleteDomain command.
There is a Deletion Restorable Period of 60 days.

command = DeleteDomain
domain = (DOMAIN)

[edit] Restore Domain

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

command = RestoreDomain
domain = (DOMAIN)

OPTIONAL

renewalmode = <NULL> | <TEXT>
subuser = <TEXT>

[edit] Ownerchange

In order to change or modify the owner you have to request a trade with the TradeDomain command. This can be done through our web interface or through our API:
REQUIRED

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

OPTIONAL

X-HK-REGISTRANT-CHINESE-COMPANY = <TEXT>
X-HK-REGISTRANT-DOCUMENT-TYPE = <TEXT>
X-HK-REGISTRANT-OTHER-DOCUMENT-TYPE = <TEXT> (mandatory, if X-HK-REGISTRANT-DOCUMENT-TYPE is 'OTHIDV' or 'OTHORG')
X-HK-REGISTRANT-DOCUMENT-NUMBER = <TEXT>
X-HK-REGISTRANT-DOCUMENT-ORIGIN-COUNTRY = <COUNTRY>
X-REGISTRANT-BIRTH-DATE = YYYY-MM-DD (mandatory, if the registrant is an individual)
X-HK-ACCEPT-INDIVIDUAL-REGISTRATION-TAC = 0 | 1 (mandatory if the registrant is an individual)

Please review the TLD-specific requirements for an ownerchange mentioned below.

[edit] TLD specific

[edit] Domain Registration

Additional API parameters needed for the registration of .HK domains:

Company name with Chinese characters:
X-HK-REGISTRANT-CHINESE-COMPANY = <TEXT> (optional)

X-HK-REGISTRANT-DOCUMENT-TYPE = <TEXT> (mandatory)

Registrant Document Type. Please refer to the possible values below:

• • If the registrant is an individual:
    • HKID - Hong Kong Identity Number
    • OTHID - Other's Country Identity Number
    • PASSNO - Passport No.
    • BIRTHCERT - Birth Certificate
    • OTHIDV - Others Individual Document
  • If the registrant is an organization:
    • BR - Business Registration Certificate
    • CI - Certificate of Incorporation
    • CRS - Certificate of Registration of a School
    • HKSARG - Hong Kong Special Administrative Region Government Department
    • HKORDINANCE - Ordinance of Hong Kong
    • OTHORG - Others Organization Document

X-HK-REGISTRANT-OTHER-DOCUMENT-TYPE = <TEXT> (mandatory, if X-HK-REGISTRANT-DOCUMENT-TYPE is 'OTHIDV' or 'OTHORG')
X-HK-REGISTRANT-DOCUMENT-NUMBER = <TEXT> (mandatory)
X-HK-REGISTRANT-DOCUMENT-ORIGIN-COUNTRY = <COUNTRY> (mandatory)
X-HK-REGISTRANT-BIRTH-DATE = YYYY-MM-DD (mandatory, if the registrant is an individual)
X-HK-ACCEPT-INDIVIDUAL-REGISTRATION-TAC = 0 | 1 (0 = No, 1 = Yes) (mandatory, it the registrant is an individual - For explanations see the paragraph below) 

Additional agreement if the registrant is an individual:

X-HK-ACCEPT-INDIVIDUAL-REGISTRATION-TAC = 0 | 1 (0 = No | 1 = Yes)

The customer is aware that the official .HK registry registration policy requires all individuals to provide identification (i.e. passport numbers) to register a .HK domain. In processing .HK domain registrations through HEXONET, the customer explicitly authorizes HEXONET to transmit this information to the registry on the customer's behalf in the fulfillment of .HK registration policy and the registration of domain names.

The customer in submitting a .HK domain registration through HEXONET explicitly agrees to indemnify HEXONET against any and all liability, loss, damages and legal costs in the transmission of identification information, understanding that HEXONET deletes identification information from all its systems immediately after transmission. The customer understands and accepts that the .HK registry may choose to store identification information along with other registration data on their own accord and completely independent from HEXONET.

[edit] Ownerchange

An ownerchange has to be requested via TRADE command. After the TRADE has been started, you will find the TNR number within the command response/object-log for this domain. This number should be placed on the form and the form must be submitted to the address below.

Via Fax:
+49.68416984199

Via e-Mail:
[email protected]

A Transfer Application Letter must be printed on the letterhead, signed by the current AND new owner and contain company stamps of the current OR new owner if applicable and the Tracking Number which can be retrieved within the command response or object log of the TRADE command.

There are different types of Transfer Application Letters depending on whether the new owner is a business or an individual.

CASE 1 - New owner is a business: Organization
CASE 2 - New owner is an individual:Individual

Please be aware that with a trade the expiration date will be extended according to the trade period. The trade period for .HK domain is 1 year.

[edit] Request Authcode

The registrar cannot set an authcode, they can only request for the registry to email the authcode to the registrant. The authcode can also be requested via the following registry website.
https://www.hkirc.hk/en/our-services-support/domain-services/change-of-registrar/

[edit] Domain Renewal

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

[edit] Notification emails from the .HK Registry

The .HK Registry (HKDNR) sends out email notifications upon the renewal of a .HK domain. Three (3) emails are sent to the registrant of the domain upon renewal:

• HKDNR will send a reminder to the registrant that the payment for the renewal must be made within seven (7) days before the expiration date of the domain.
• HKDNR will send a notice to the registrant to acknowledge the receipt of the domain name renewal request (this request is made by our renewal system automatically).
• HKDNR will send a notice to the registrant to acknowledge the successful renewal.

Please note that you don't need to react on these emails.

Our renewal system renews the domains and charges your account at the correct date.

[edit] Addons

[edit] RegistrarOC

Restore Process