.cn

API commandsExtensionsRestrictions

API Commands

Please find in the following a set of the most commonly used standard API commands in order to register, modify, renew, and transfer a domain name.

AddDomainModifyDomainRenewDomainDeleteDomainTransferDomainRestoreDomain

Domain Registration

(API Command reference » AddDomain)

.CN: No Special Characters in Registrant Names

The Chinese Registry CNNIC has been enforcing the Real-Name Verification (RNV) regulation for .CN and .中国 (.xn—fiqs8s) domains since last year.

The RNV process requires a real name of an individual person to be provided in the Owner Contact. In addition, a proof of identification (e.g. passport, ID card) is needed to register / transfer / trade a .CN or .中国 domain.

The following problem occurs: If the registrant is foreign (so not Chinese) and the name contains special non-English characters, CNNIC cannot process auditing the passport and registration / transfer / trade cannot be completed.

The solution is to provide a registrant name without special characters. If the registrant is a company, the domain may be registered to another person of the company who does not have special characters in the name and is willing to submit a verification document to CNNIC.

Please note: We refer here to the full name as it appears on the verification document such as the passport.

Examples for special characters that lead to problems:

German umlauts such as ä, ü, ö;

Spanisch / French letters with accents such as é

and other characters not found in the English language.

If you have any further questions, please contact our Support Team.

The .cn registry changed its policies and relaxed the restrictions for .cn registrations. Under the new rules, companies and individuals outside China are allowed to register Chinese domain names again.

The following requirements for registrants outside China are effective as of Monday, September 3, 2012:

• For individuals outside of China:
  • Applicants need to submit a scan or photo copy of an official document that could prove the identity of the registrant: CNNIC is accepting passports or personal ID cards and must be provided in JPEG format (Driver’s licence is NOT acceptable). All documents provided as a proof of identity must feature the name of the registrant.
  • A signed Letter of Commitment is no longer required!
• For companies and organizations outside of China:
  • Applicants need to submit a scan or photo copy of their business license / business certificate or an excerpt from the commercial register
  • The contact ID (Handle) needs to provide a contact name for the responsible person in the company/organization. A copy of passport or ID is required. CNNIC is accepting passports or personal ID cards and must be provided in JPEG format (Driver’s licence is NOT acceptable).
  • A signed Letter of Commitment is no longer required!
  • The contact does not need to be listed on the company certificate.
• For individuals, organizations, and legal entities inside of China:
  We do not provide .cn domains to customers with a Chinese country code.

Additional Info:

• For registrants from Hong Kong, Macau, Taiwan, the acceptable document/certificate include: Mainland Travel Permit for Hong Kong and Macao Residents, Mainland Travel Permit for Taiwan Residents , Residence Permit for Hong Kong and Macao Residents , Residence Permit for Taiwan Residents , Permanent Residence Identity Card for Foreigners.

Note: For these 3 certificates: Residence Permit for Hong Kong and Macao Residents , Residence Permit for Taiwan Residents , Permanent Residence Identity Card for Foreigners, both of front and back side of the certificate are needed

Please send the required documents (identity proof / business license) to [email protected] for domain name registrations.
Please pay attention to the correct subject line of the e-mail:

• For new registrations: Register [domain name] documents, e.g. “Register example.cn documents”
• Please provide the document in one of the following format: .jpeg. (Document size max. 1MB!)

Please note:

• If the documents are not received after 8 days the registration will fail.
• Once a contact is whitelisted, the audit process is still manual
• Once you enter the order in the system, you need to send an email to [email protected] to let them know you have done so (you can send one email with a list of the registrations you submitted.
• The domain will then be registered

Furthermore all applicants must be explicitly be informed of the following during the registration process:

• Applicants must provide authentic, accurate and complete documentation
• Applicants must confirm to have read and understood CNNIC’s registration rules and policies
• Applicants must adhere to all policies governing the contents of the website(s) under the domain name
• In case the domain name is used for a website where the webserver is located in mainland China, a valid ICP number must be obtained from MIIT and provided to CNNIC through registrar (only available if registrant has an office in China)
• Applicants must accept full responsibility for the suspension of the domain name or any consequences caused by violations of the applicants commitments, and understand that CNNIC and the registrar undertake no responsibility in the event that it needs to interrupt the usage of the domain name.

Registration

Exception

command         = AddDomain
domain          = yourdomain.cn
period          = (INT)
ownercontact0   = (CONTACT)
admincontact0   = (CONTACT)
techcontact0    = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0  = (NAMESERVER)
nameserver1   = (NAMESERVER)
X-CN-OWNER-TYPE = (E|I)
X-CN-OWNER-ID-TYPE = (SFZ|HZ|GAJMTX|TWJMTX|WJLSFZ|GAJZZ|TWJZZ|JGZ|JWJG)
X-CN-OWNER-ID-NUMBER = (INT)

Domain Modification

(API Command reference » ModifyDomain)

Standard command

command = ModifyDomain
domain  = yourdomain.cn

Change of Registrant

Exception

command       = TradeDomain
domain        = yourdomain.cn
ownercontact0 = (CONTACT)
X-CN-OWNER-TYPE = (E|I)
X-CN-OWNER-ID-TYPE = (SFZ|HZ|GAJMTX|TWJMTX|WJLSFZ|GAJZZ|TWJZZ|JGZ|JWJG)
X-CN-OWNER-ID-NUMBER = (INT)

• For the trade of the domain the corresponding copy of ID/passport or business license is required for the new domain holder. Please also note that the trade is not processed real time.
• Please send the required documents (identity proof / business license) to [email protected] for domain name registrations and owner changes. Please pay attention to the correct subject line of the e-mail:

  • For owner changes: Trade [domain name] documents, e.g. “Trade xn—fjdkijfdkshj.cn document”

  • Trade away from former Trustee service is possible, please include

    x-cn-accept-trustee-tac = 0

  • Please provide the document in one of the following formats: .jpg, .png, .gif or .jpeg. (Document size max. 1MB!)

Domain Renewal

(API Command reference » RenewDomain)

Command

command    = RenewDomain
domain     = yourdomain.cn
period     = (INT)
expiration = (INT)

Domain Deletion

(API Command reference » DeleteDomain)

Command

COMMAND = DeleteDomain
DOMAIN = yourdomain.cn

Domain Transfer

(API Command reference » TransferDomain)

Exception

command = TransferDomain
domain = yourdomain.TLD
action = REQUEST
auth = (TEXT)
ownercontact0   = (CONTACT)
X-CN-OWNER-TYPE = (E|I)
X-CN-OWNER-ID-TYPE = (SFZ|HZ|GAJMTX|TWJMTX|WJLSFZ|GAJZZ|TWJZZ|JGZ|JWJG)
X-CN-OWNER-ID-NUMBER = (INT)

• We would also like to inform you that transfers will now require an owner contact. If RNV must be processed during the transfer, a fee will be charged.

• A .cn domain transfer must be initiated with a so-called authorisation code, which can be obtained from the current registrar through the owner or Admin-C of the domain.

• Please ensure, that you have a correct authorisation code associated with the domain, before initiating the transfer, otherwise it will fail.

• Ensure that your respective domain does not have a lock-status (REGISTRAR-LOCK or HOLD). This can be seen in the WHOIS. If the domain is locked, then the owner can demand that this be unlocked.

• Initiate the transfer on time and not just shortly before the domain expires.

• Please ensure that the domain is older than 60 days otherwise the transfer will be denied.

• Please note that the expiration date needs to be more then 15 days in the future otherwise the transfer will be denied.

• Please note that you need a signed request from the registrant before you initiate the transfer.

Domain Restore

(API Command reference » RestoreDomain)

Command

command = RestoreDomain
domain  = yourdomain.cn

After a restore, the domain will be inactive and have no nameservers. Please add nameservers and the domain will become active again automatically.

Domain Extensions

X-CN-ACCEPT-TRUSTEE-TAC	0 -> Usable only for trading away from former Trustee service
X-CN-OWNER-ID-NUMBER	ID Number of the Ownercontact
X-CN-OWNER-ID-TYPE	For Natural Persons GAJMTX -> Exit-Entry Permit for Travelling to and from Hong Kong and Macao GAJZZ -> Residence permit for Hong Kong, Macao residents HZ -> Passport JGZ -> Officer’s identity card QT -> Others SFZ -> Chinese ID card TWJMTX -> Travel passes for Taiwan Residents to Enter or Leave the Mainland TWJZZ -> Residence permit for Taiwan residents WJLSFZ -> Foreign Permanent Resident ID Card For Legal Entities BDDM -> Military Code Designation BJWSXX -> Beijing School for Children of Foreign Embassy Staff in China Permit GZJGZY -> Notary Organization Practicing License JDDWFW -> Military Paid External Service License JJHFR -> Fund Legal Person Registration Certificate JWJG -> Overseas Organization Certificate LSZY -> Practicing License of Law Firm MBFQY -> Private Non-Enterprise Entity Registration Certificate MBXXBX -> Private School Permit ORG -> Organization Code Certificate QTTYDM -> Others-Certificate for Uniform Social Credit Code SFJD -> Judicial Expertise License SHFWJG -> Social Service Agency Registration Certificate SHTTFR -> Social Organization Legal Person Registration Certificate SYDWFR -> Public Institution Legal Person Certificate TYDM -> Certificate for Uniform Social Credit Code WGCZJG -> Resident Representative Offices of Foreign Enterprises Registration Form WGZHWH -> Registration Certificate of Foreign Cultural Center in China WLCZJG -> Resident Representative Office of Tourism Departments of Foreign Government Approval Registration Certificate YLJGZY -> Medical Institution Practicing License YYZZ -> Business License ZJCS -> Religion Activity Site Registration Certificate
X-CN-OWNER-TYPE	E (Enterprise) I (Individual)

Domain Restrictions

• Registrants of net.CN Domains must comply to the General Terms and Conditions of .CN Domains:
• General Policies under http://www.cnnic.cn
• China Internet Domain Name Regulations
• CNNIC Internet Domain Name Registration Administration http://www.cnnic.cn/html/Dir/2003/11/27/1522.htm
• CNNIC Domain Name Dispute Resolution Policy
• CNNIC Domain Name Dispute Resolution Policy Rules
• The name on the owner handle must be an exact(!) match of the name on the ID-card or company registration certificate (kind of company, for example LTD. must be included!)
  • Prohibited Uses for .cn domain names. Registrant may not register or use a domain name that is deemed by CNNIC to:
  • Be against the basic principles prescribed in the Constitution of the Peoples Republic of China (“PRC”);
  • Jeopardize national security, leak state secrets, intend to overturn the government, or disrupt of state integrity of the PRC;
  • Harm national honor and national interests of the PRC;
  • Instigate hostility or discrimination between different nationalities, or disrupt the national solidarity of the PRC;
  • Violate the PRC’s religion policies or propagate cult and feudal superstition;
  • Spread rumours, disturb public order or disrupt social stability of the PRC;
  • Spread pornography, obscenity, gambling, violence, homicide, terror or instigate crimes in the PRC;
  • Insult, libel against others and infringe other people’ s legal rights and interests in the PRC; or
  • Take any other action prohibited in laws, rules and administrative regulations of the PRC.
• MIIT ICP Recording
  • A ICP number from government institute MIIT is required if the webserver for the domain is located in mainland China. The following document provides a short overview: ICP.pdf
  • A domain certificate can be requested from here. Please make sure to fill in the domain name and the registrant’s telephone number