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-csr

Note: 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": "[email protected]",

      "dcvMethod": "EMAIL",

      "domainName": "www.xxx.com"

    },

{

      "dcvEmail": "[email protected]",

      "dcvMethod": "EMAIL",

      "domainName": "aaa.com"

    },

{

      "dcvEmail": "[email protected]",

      "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 information

Note: 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": "[email protected]",

       "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": "[email protected]",

       "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": "[email protected]",

       "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.