2.1 Validate Data

2.1.1 API Description

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

2.1.2 Parameter Definition

Parameter Name	Parameter Type	Required	Description
api_token	String	Y	User token. To obtain the token, please contact Racent technical support.
productCode	String	Y	Product code. To obtain the product code (see 2.7).
years	Int	Y	Purchase duration (currently only 1, 2, 3, 4, 5 are supported), depending on the specific product.
refId	String	N	The unique customer order number provided by the customer
verificationPic	File	N	Backup verification material. Used for organization pre-validation, supports .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip/.pdf formats, content size does not exceed 2M.
domainVerificationPic	File	N	When the Domain Control Validation (DCV) method is: VERIFY_DOCUMENT, this field is Y. Used for Domain Control Validation (DCV) (currently only supports CFCA).
params	String	Y	Order information (JSON string), as described in detail below
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 relevant to SSL certificates. The parameter is Y for SSL certificates and N for other product types. If this parameter is not required, default to "other".
uniqueValue	String	N	Only relevant to Sectigo products. 1-20 characters (a-z A-Z 0-9) used by distributors to generate a verification value independently.
dcvMethod	String	N	Set the domain validation method for the certificate request uniformly. 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 for CFCA) Y for CFCA
domainInfo	String	N	Domain information, only relevant to SSL certificates. This parameter is Y for SSL certificates and N for other 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 description is 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 parent dcvMethod does not exist, this parameter is Y. When the parent dcvMethod exists and this parameter also exists, the parent dcvMethod takes precedence.
dcvEmail	String	N	Domain validation email. When this field is 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 Y when ordering products that require enterprise verification. Example: { "organizationCity": "Shanghai", "organizationName": "A Company", "organizationMobile": "18111111111", "organizationAddress": "Shanghai Road", "organizationCountry": "CN", "organizationPostCode": "401320" }"
organizationCity	String	N	The city where the company is located.
organizationName	String	N	The company name.
organizationMobile	String	N	The company phone number.
organizationAddress	String	N	Company address.
organizationCountry	String	N	Country where the company is located (two-letter code per ISO 3166-1 standard).
organizationPostCode	String	N	Postal code of the company location.
organizationRegNumber	String	N	Company registration number. This is Y for CFCA.
idType	String	N	Company ID type. This is Y for CFCA. Values: TYDMZ: Unified Social Credit Code OTHERS: Others
Administrator	string	Y	Administrator information, contact. When applying for code signing, email signing, or document signing, this parameter serves as application information. Additionally, if csr is N, this information is used to generate the CSR. { "job": "General Manager Office", "city": "Shanghai", "email": "xx@yy.com", "state": "Shanghai", "mobile": "18111111111", "address": "Shanghai", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "A Company" }"
job	String	Y	Administrator's job title.
city	String	Y	Administrator's city.
email	String	Y	Administrator's email address.
state	String	Y	The province or state where the administrator is located.
mobile	String	Y	The administrator's contact information.
address	String	Y	The administrator's contact address.
country	String	Y	The country where the administrator is located (two-letter code per ISO 3166-1).
lastName	String	Y	The administrator's last name.
postCode	String	Y	The postal code of the administrator's location.
firstName	String	Y	Administrator's first name.
organation	String	Y	Administrator's 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	ID number. For CFCA, this field is Y.
finance	string		Only relevant to SSL certificates. Financial officer information. Can be the same as the administrator information. When the ordered product is not of the DV type, this parameter is Y. { "job": "Finance Department", "city": "Shanghai", "email": "xx@yy.com", "state": "Shanghai", "mobile": "18111111111", "address": "Shanghai", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "A Company" }"
job	String	N	The job title 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	The province or state where the finance officer is located.
mobile	String	N	Contact information for the finance officer.
address	String	N	Contact address for the finance officer.
country	String	N	Country where the finance officer is located (two-letter code per ISO 3166-1 standard).
lastName	String	N	Last name of the finance officer.
postCode	String	N	Postal code of the finance officer's location.
firstName	String	N	Accountant's first name.
organation	String	N	The company the accountant belongs to.
idType	String	N	ID type. For CFCA, this field is Y. Values are as follows: SFZ: ID card HZ: Passport
idNumber	String	N	ID number. This is Y for CFCA.
tech	string	N	Only relevant to SSL certificates. Technician information. This parameter is Y when the ordered product is not of the DV type. { "job": "Technical Department","city": "Shanghai", "email": "xx@yy.com", "state": "Shanghai", "mobile": "18111111111", "address": "Shanghai", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "A Company" }"
job	String	N	Technician job title.
city	String	N	The city where the technician is located.
email	String	N	The technician's email address.
state	String	N	The province or state where the technician is located.
mobile	String	N	Technician contact information.
address	String	N	Technician contact address.
country	String	N	Country where the technician is located (two-letter code per ISO 3166-1 standard).
lastName	String	N	Last name of the technician.
postCode	String	N	Postal code of the technician's location.
firstName	String	N	First name of the technician.
organization	String	N	The company of the technician.
idType	String	N	ID type. Required for CFCA. Values: SFZ: ID card HZ: Passport
idNumber	String	N	ID number. Required for CFCA.

Function Return

Parameter Name	Parameter Type	Required	Description
code	Int	Y	Return status. Refer to Appendix 3.1 for details.
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"
}