Renew SSL Certificate

POST  https://portal.nicsrs.com/ssl/renew

Use this endpoint to submit a request for a new SSL certificate using the CSR and parameters of the initial certificate. The renewal of certificate is available when the initial certificate will expire within 90 days.

Request parameters

Fields explanation:

▪ R – Required

▪ O – Optional

Name	Type	Req/Opt	Description
api_token	String	R	Authentication credentials (User token). To get token, please contact NicSRS technical support.
renewId	String	R	Certificate ID provided by nicsrs.com for renewal.
years	Int	R	The validity period of the certificate order. The value is from 1-6 years depending on the specific products of nicsrs.com.
refId	String	O	The unique customer order ID provided by reseller.
params	Json	R	Order details of renewal are as follows:
-csr	String	R	Certificate Signing Request (CSR).▪ Use openssl to generate Base-64 encoded CSR.▪ Visit the link to generate CSR. https://www.nicsrs.com/generate-csrNote: please keep your private key properly.
-server	String	R	The server platform.Please use one of these server platforms.
-uniqueValue	String	O	Value only for Sectigo products (Please set the value within 1-20 characters from a-z, A-Z, 0-9.)
-domainInfo	Json	R	Domain name information. A standard certificate includes only a piece of information. e.g. [{      “dcvEmail”: “admin@xxx.com”,      “dcvMethod”: “EMAIL”,      “domainName”: “www.xxx.com”    },{      “dcvEmail”: “admin@aaa.com”,      “dcvMethod”: “EMAIL”,      “domainName”: “aaa.com”    },{      “dcvEmail”: “admin@nicsrs.com”,      “dcvMethod”: “EMAIL”,      “domainName”: “nicsrs.com”    }]More parameters are as follows.
–dcvMethod	String	R	Domain control validation (DCV) methods. When performing domain control validation, you must choose one of four methods below.EMAIL (Approver Email Method)HTTP_CSR_HASH (HTTP Based Validation Method)CNAME_CSR_HASH (DNS Based Validation Method)HTTPS_CSR_HASH (https Based Validation Method)
–dcvEmail	String	O	Only required for Sectigo SSL certificates and the Email method of domain control validation.These are five different types of emails addresses that Sectigo can only send the DCV email. Use one of five addresses below.admin@administrator@postmaster@webmaster@hostmaster@
–domainName	String	R	The domain name for renewal.
-organizationInfo	Json	O	Organization informationNote: Only required for OV/ EV certificates.
–organizationCity	String	O	The city where organization is located.Note: Only required for OV/ EV certificates.
–organizationName	String	O	Organization name.Note: Only required for OV/ EV certificates.
–organizationMobile	String	O	Organization phone number that can be searched in the third authority.Note: Only required for OV/ EV certificates.
–organizationAddress	String	O	Organization address.Note: Only required for OV/ EV certificates.
–organizationCountry	String	O	Organization Country Name. See Appendix – Country codes.Note: Only required for OV/ EV certificates.
–organizationPostCode	String	O	Organization Postal Code.Note: Only required for OV/ EV certificates.
-Administrator	Json	R	Details about the administrator contact on the order.e.g.{“job”: “CEO”,       “city”: “Shanghai”,       “email”: “xx@zz.com”,       “state”: “Shanghai”,       “mobile”: “18111111111”,       “address”: “Shanghai”,       “country”: “CN”,       “lastName”: “zhang”,       “postCode”: “401320”,       “firstName”: “nick”,       “organization”: “NicSRS”}
–job	String	R	Administrator’s title.
–city	String	R	Administrator city name.
–email	String	R	Administrator email address.
–state	String	R	Administrator State name.
–mobile	String	R	Administrator contact phone number.
–address	String	R	Administrator contact address.
–country	String	R	Administrator contact country name. See Appendix – Country codes.
–lastName	String	R	Administrator’s last name.
–postCode	String	R	Administrator contact Postal Code.
–firstName	String	R	Administrator’s first name.
–organization	String	R	Organization name of administrator.
-finance	Json	O	Details about the Finance Manager. The information can be consistent with administrator’s.Note: Only required for OV/ EV certificates.e.g.{“job”: “CEO”,       “city”: “Shanghai”,       “email”: “xx@zz.com”,       “state”: ” Shanghai”,       “mobile”: “18111111111”,       “address”: ” Shanghai”,       “country”: “CN”,       “lastName”: “zhang”,       “postCode”: “401320”,       “firstName”: “nick”,       “organization”: “NicSRS”}
–job	String	O	Finance Manager’s title.Note: Only required for OV/ EV certificates.
–city	String	O	Finance Manager city name.Note: Only required for OV/ EV certificates.
–email	String	O	Finance Manager email address.Note: Only required for OV/ EV certificates.
–state	String	O	Finance Manager State name.Note: Only required for OV/ EV certificates.
–mobile	String	O	Finance Manager contact phone number.Note: Only required for OV/ EV certificates.
–address	String	O	Finance Manager contact address.Note: Only required for OV/ EV certificates.
–country	String	O	Finance Manager contact country name. See Appendix – Country codes.Note: Only required for OV/ EV certificates.
–lastName	String	O	Finance Manager’s last name.Note: Only required for OV/ EV certificates.
–postCode	String	O	Finance Manager contact Postal Code.Note: Only required for OV/ EV certificates.
–firstName	String	O	Finance Manager’s first name.Note: Only required for OV/ EV certificates.
–organization	String	O	Organization name of Finance Manager.Note: Only required for OV/ EV certificates.
-tech	Json	O	Details about the technical contact on the order.Note: Only required for OV/ EV certificates.e.g. {“job”: “Technician”,       “city”: “Shanghai”,       “email”: “xx@zz.com”,       “state”: ” Shanghai “,       “mobile”: “18111111111”,       “address”: ” Shanghai”,       “country”: “CN”,       “lastName”: “zhang”,       “postCode”: “401320”,       “firstName”: “nick”,       “organization”: “NicSRS”}
–job	String	O	Technical contact person’s title.Note: Only required for OV/ EV certificates.
–city	String	O	Technician city name.Note: Only required for OV/ EV certificates.
–email	String	O	Technician email address.Note: Only required for OV/ EV certificates.
–state	String	O	Note: Only required for OV/ EV certificates.
–mobile	String	O	Technician phone number.Note: Only required for OV/ EV certificates.
–address	String	O	Technician contact address.Note: Only required for OV/ EV certificates.
–country	String	O	Technician contact country name. See Appendix – Country codes.Note: Only required for OV/ EV certificates.
–lastName	String	O	Technician’s last name.Note: Only required for OV/ EV certificates.
–postCode	String	O	Technician contact Postal Code.Note: Only required for OV/ EV certificates.
–firstName	String	O	Technician’s first name.Note: Only required for OV/ EV certificates.
–organization	String	O	Organization name of Technician.Note: Only required for OV/ EV certificates.

Response parameters

Name	Type	Req/Opt	Description
code	Int	R	Response status codes. A response code identifies a specific status. See Appendix – Response Codes.
errors	Array or String	O
data	Json	O	Response data.For more information, see the resource section below.
-certId	String	O	Certificate ID.Note: please save the value that will be used in other endpoints.