2.1 Validate Data

2.1.1 Interface Description

Environment
Production environment	https://portal.racent.com/ssl/validate
Request method	POST
content-type	multipart/form-data
Description	This interface is used to validate all order data you submit. Please call this interface before calling the order interface to ensure smooth order processing. This validation confirms your account information, verifies that your order information is correct, and returns relevant error codes (see Appendix 3.1).

2.1.2 Parameter Definition

Parameter name	Parameter type	Required	Description
api_token	String	Y	User token. Please contact Racent technical support to obtain the token.
productCode	String	Y	Product code. Obtain the product code (see Section 2.7).
years	Int	Y	Purchase period (currently only 1, 2, 3, 4, and 5 years are supported), subject to the specific product.
refId	String	N	Unique customer order number provided by the client
verificationPic	File	N	Backup verification material. Used for organization verification, supports .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip/.pdf formats, with a maximum file size of 2 MB.
domainVerificationPic	File	N	This field is required (Y) when the Domain Control Validation (DCV) method is set to VERIFY_DOCUMENT. Used for Domain Control Validation (DCV) (currently only supported by CFCA).
params	String	Y	Order information (JSON string), detailed as follows
csr	String	N	When this parameter is empty, a CSR will be generated for you and the private key will be saved.
privateKey	String	N	Private key.
server	String	N	Server. Only related to SSL certificates. This parameter is Y for SSL certificates and N for other product types. If this parameter is not required, use the default value "other".
uniqueValue	String	N	Only related to Sectigo products. A 1-20 character string (a-z A-Z 0-9) used by resellers to independently generate verification values.
dcvMethod	String	N	Set the Domain Control Validation (DCV) method uniformly for the request. Must be one of the following four methods: EMAIL (Email validation) HTTP_CSR_HASH (File validation) CNAME_CSR_HASH (DNS validation) HTTPS_CSR_HASH (HTTPS file validation) VERIFY_DOCUMENT (Domain certificate proof, only supported by CFCA) This parameter is Y for CFCA.
domainInfo	String	N	Domain information, only relevant for SSL certificates. The parameter is Y for SSL certificates and N for other certificate types. Example: [ { "dcvEmail": "admin@xxx.com", "dcvMethod": "EMAIL", "domainName": "www.xxx.com" }, { "dcvEmail": "admin@aaa.com", "dcvMethod": "EMAIL", "domainName": "aaa.com" }, "dcvEmail": "admin@racent.com", "dcvMethod": "EMAIL", "domainName": "racent.com" } ] Detailed descriptions are as follows:
dcvMethod	String	N	Domain validation method. Must be one of the following four methods: EMAIL(Email validation) HTTP_CSR_HASH(File validation) CNAME_CSR_HASH(DNS validation) HTTPS_CSR_HASH(HTTPS file validation) When the higher-level dcvMethod does not exist, this field is Y. If the higher-level dcvMethod exists and this field is also provided, the higher-level dcvMethod will take precedence.
dcvEmail	String	N	Domain Control Validation (DCV) email address. When this parameter is set to N, the default values are as follows: racent.com : admin@racent.com www.racent.com : admin@racent.com *.racent.com : admin@racent.com
domainName	String	N	Domain name
organizationInfo	String	N	Company information. This parameter is required (Y) when ordering products that require enterprise validation. Example: { "organizationCity": "Shanghai", "organizationName": "Some Company", "organizationMobile": "18111111111", "organizationAddress": "Road, Shanghai", "organizationCountry": "CN", "organizationPostCode": "401320" }"
organizationCity	String	N	City where the company is located.
organizationName	String	N	Company name.
organizationMobile	String	N	Company phone number.
organizationAddress	String	N	Company address.
organizationCountry	String	N	Country where the company is located (two-letter code in ISO 3166-1 standard).
organizationPostCode	String	N	Postal code of the company's location.
organizationRegNumber	String	N	Company certificate number. This field is required (Y) for CFCA.
idType	String	N	Company certificate type. This field is required (Y) for CFCA. Allowed values: TYDMZ: Unified Social Credit Code OTHERS: Other
Administrator	string	Y	Administrator information, contact person. This parameter is used as application information when applying for code signing, email signing, and document signing certificates. In addition, if the csr field is set to N, this information will be used to generate the CSR. { "job": "General Manager's Office", "city": "Shanghai", "email": "xx@yy.com", "state": "Shanghai", "mobile": "18111111111", "address": "Shanghai", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "Company Name" }"
job	String	Y	Administrator's job title.
city	String	Y	City where the administrator is located.
email	String	Y	Administrator's email address.
state	String	Y	Province or state where the administrator is located.
mobile	String	Y	Contact phone number of the administrator.
address	String	Y	Contact address of the administrator.
country	String	Y	The administrator's country of residence, using a two-letter code as defined in the ISO 3166-1 standard.
lastName	String	Y	The administrator's last name.
postCode	String	Y	The postal code of the administrator's location.
firstName	String	Y	Administrator name.
organation	String	Y	Administrator company name.
idType	String	N	ID type. This field is Y for CFCA. Values are as follows: SFZ: ID card HZ: Passport
idNumber	String	N	Identification number. This field is required (Y) for CFCA.
finance	string		Only applicable to SSL certificates. Financial contact information, which can be the same as the administrator information. This parameter is required (Y) when the ordered product is not of DV type. { "job": "Finance Department", "city": "Shanghai", "email": "xx@yy.com", "state": "Shanghai", "mobile": "18111111111", "address": "Shanghai", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }"
job	String	N	The position of the financial officer.
city	String	N	The city where the financial officer is located.
email	String	N	The email address of the financial officer.
state	String	N	Province or state where the finance officer is located.
mobile	String	N	Contact information of the finance officer.
address	String	N	Contact address of the finance officer.
country	String	N	The country where the finance staff is located (two-letter code in ISO 3166-1 standard).
lastName	String	N	The last name of the finance staff.
postCode	String	N	The postal code of the location where the finance staff is located.
firstName	String	N	Name of the finance officer.
organation	String	N	Company of the finance officer.
idType	String	N	ID type. This field is mandatory (Y) for CFCA. Available values: SFZ: ID card HZ: Passport
idNumber	String	N	ID number. This parameter is Y for CFCA.
tech	string	N	Relevant to SSL certificates only. Technician information. This parameter is Y when the ordered product is not of the DV type. { "job": "技术部","city": "上海市", "email": "xx@yy.com", "state": "上海市", "mobile": "18111111111", "address": "上海市", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }"
job	String	N	Technician job title.
city	String	N	The city where the technician is located.
email	String	N	The email address of the technician.
state	String	N	The province or state where the technician is located.
mobile	String	N	Contact information of the technical personnel.
address	String	N	Contact address of the technical personnel.
country	String	N	Country where the technical personnel is located (two-letter code in ISO 3166-1 standard).
lastName	String	N	Last name of the technical contact.
postCode	String	N	Postal code of the technical contact's location.
firstName	String	N	First name of the technical contact.
organation	String	N	The company where the technician is employed.
idType	String	N	ID type. This field is required (Y) for CFCA. Possible values are: SFZ: Resident Identity Card HZ: Passport
idNumber	String	N	ID number. This field is required (Y) for CFCA.

Function Return

Parameter Name	Parameter Type	Required	Description
code	Int	Y	Return status. For detailed explanations, please refer to Appendix 3.1
errors	Object or String	N	Error message when the return status indicates an error.

2.1.3 Request Example

请求示例

{
	"years": 2,
	"params": ‘{"server":"iis7","csr":"-----BEGIN CERTIFICATE REQUEST-----\nxxxxxxyyyoo\n-----END CERTIFICATE REQUEST-----\n","domainInfo":[{"domainName":"tt.cn","dcvMethod":"HTTP_CSR_HASH","dcvEmail":""}],"Administrator":{"organation":"cola","job":"it","firstName":"nick","lastName":"zhang","email":"xx@tt.com.cn","mobile":"13911111111","country":"CN","address":"上海市","city":"上海","state":"上海","postCode":"4457145"},"finance":{"organation":"某公司","job":"ceo","firstName":"nick","lastName":"zhang","email":"xxx@qq.com","mobile":"18111111111","country":"CN","address":"上海市","city":"上海","state":"上海","postCode":"4514154"},"tech":{"organation":"某公司","job":"ceo","firstName":"nick","lastName":"zhang","email":"xxx@qq.com","mobile":"15122222222","country":"CN","address":"上海市","city":"上海","state":"上海","postCode":"48787"},"organizationInfo":{"organizationCity":"上海","organizationState":"上海","organizationMobile":"153999999999","organizationAddress":"上海某地","organizationCountry":"CN","organizationPostCode":"200233","organizationName":"个人"}}’,
	"api_token": "zzzoooppzz",
	"productCode": "comodo-positivessl"
}