API Documentation

Everything you need to know, in one place

Important: Only HTTPPOST is supported for this method.

namecheap.ssl.reissue

Reissues an active SSL certificate

Sandbox Limitation: Reissue process in Sandbox works for all certificates. However, an actual test certificate will not be returned for Comodo OV and EV certificates.

Request Parameters

Global parameters are not shown here (for clarity), but they should be present in all requests.

Name Type MaxLength Required? Description
CertificateID Number 10 Yes ID of the SSL certificate you wish to reissue
ApproverEmail** String 255 Yes** The EmailID which is on the Approver Email list (refer to the notes at the bottom of this table)
csr String 2000 Yes Certificate Signing Request
WebServerType String 50 Yes Possible values: apacheopenssl, apachessl, apacheraven, apachessleay, c2net, ibmhttp, iplanet, domino, dominogo4625, dominogo4626, netscape, zeusv3, apache2, apacheapachessl, cobaltseries, cpanel, ensim, hsphere, ipswitch, plesk, tomcat, weblogic, website, webstar, iis, other, iis4, iis5
AdminOrganizationName String 255 No Organization of the Administrator
AdminJobTitle String 255 Yes* Job title of the Administrator (refer to the notes at the bottom of this table)
AdminFirstName String 100 Yes First name of the Administrator
AdminLastName String 100 Yes Second name of the Administrator
AdminAddress1 String 255 Yes Address1 of the Administrator
AdminAddress2 String 255 No Address2 of the Administrator
AdminCity String 255 Yes City of the Administrator
AdminStateProvince String 255 Yes State/Province of the Administrator
AdminStateProvinceChoice String 255 No StateProvinceChoice of the Administrator
AdminPostalCode String 255 Yes PostalCode/ZIP of the Administrator
AdminCountry String 255 Yes Country of the Administrator
AdminPhone String 255 Yes Phone number in the format +NNN.NNNNNNNNNN
AdminPhoneExt String 10 No PhoneExt of the Admin user
AdminFax String 255 No Fax number in the format +NNN.NNNNNNNNNN
AdminEmailAddress String 255 Yes Email address of the Administrator
TechOrganizationName String 100 No Organization of the Technical Contact
TechJobTitle String 100 Yes* Job title of the Technical Contact (refer to notes at the bottom of this table)
TechFirstName String 100 No First name of the Technical Contact
TechLastName String 100 No Last name of the Technical Contact
TechAddress1 String 100 No Address1 of the Technical Contact
TechAddress2 String 100 No Address2 of the Technical Contact
TechCity String 100 No City where the Technical Contact is located
TechStateProvince String 100 No State/Province of the Technical Contact
TechStateProvinceChoice String 100 No StateProvinceChoice of the Technical Contact
TechPostalCode String 100 No PostalCode/ZIP of the Technical Contact
TechCountry String 100 No Country of the Technical Contact
TechPhone String 100 No Phone number in the format +NNN.NNNNNNNNNN
TechPhoneExt String 10 No PhoneExt of the Tech user
TechFax String 100 No Fax number in the format +NNN.NNNNNNNNNN
TechEmailAddress String 100 No Email address of the Technical Contact
BillingOrganizationName String 100 No Organization of the BillingContact
BillingJobTitle String 100 Yes* Job title of the BillingContact (refer to notes at the bottom of this table)
BillingFirstName String 100 No First name of the Billing Contact
BillingLastName String 100 No Last name of the Billing Contact
BillingAddress1 String 100 No Address1 of the Billing Contact
BillingAddress2 String 100 No Address2 of the Billing Contact
BillingCity String 100 No City where the Billing Contact is located
BillingStateProvince String 100 No State/Province of the Billing Contact
BillingStateProvinceChoice String 100 No StateProvinceChoice of the Billing Contact
BillingPostalCode String 100 No PostalCode/ZIP of the Billing Contact
BillingCountry String 100 No Country of the Billing Contact
BillingPhone String 100 No Phone number in the format +NNN.NNNNNNNNNN
BillingPhoneExt String 10 No PhoneExt of the Billing Contact
BillingFax String 100 No Fax number in the format +NNN.NNNNNNNNNN
BillingEmailAddress String 100 No Email address of the Billing Contact

Request parameters for Symantec, GeoTrust and Thawte certificates

Global parameters are not shown here (for clarity), but they should be present in all requests.

Name Type MaxLength Required? Description
CertificateID Number 10 Yes ID of the SSL certificate you wish to reissue
ApproverEmail** String 255 Yes** The EmailID which is on the Approver Email list (refer to the notes at the bottom of this table)
csr String 2000 Yes Certificate Signing Request
WebServerType String 50 Yes Possible values: apacheopenssl, apachessl, apacheraven, apachessleay, c2net, ibmhttp, iplanet, domino, dominogo4625, dominogo4626, netscape, zeusv3, apache2, apacheapachessl, cobaltseries, cpanel, ensim, hsphere, ipswitch, plesk, tomcat, weblogic, website, webstar, iis, other, iis4, iis5

Notes: *It is mandatory to send AdminJobTitle, TechJobTitle and BillingJobTitle parameters when activating all Organization Validated and Extended Validation SSL certs, as well as Thawte SSL123 certificate. These parameters are optional for Domain Validated certs. 

**Approver emails provided during reissue of any Symantec/GeoTrust/Thawte SSL certificates should be the same as for initial activation.

Reissue of multi-domain certificates:

If you wish to reissue a multi-domain certificate, you need to use the following parameters in the call. Please specify emails in DNSApproverEmails parameter in the order corresponding to order of domains in DNSNames parameter.

Name Type MaxLength Required? Description
DNSNames String 3500 No* A comma-separated list of domain names to be included
DNSApproverEmails** String 3500 No* A comma-separated list of approver emails

Notes: *These parameters are not mandatory for activation of SSL certificates. However, you need to use them if you wish to activate multi-domain certificate with add-on domains. If you have specified some add-on domains in DNSNames parameter, you must specify approver emails for each add-on domain in DNSApproverEmail parameter.

**This parameter is not required for Symantec/Thawte/GeoTrust EV and OV certificates supporting SANs.

Additional parameter for activating certificates with HTTP-based validation selected as approval method:

Important
  • HTTP-based validation is not applicable to Symantec/Thawte/GeoTrust OV and EV certificates, as they do not require domain control validation.

  • This parameter enables use of HTTP-based domain control validation (instead of email-based domain control validation) during certificate re-issue.

  • For Symantec certificates, name and contents of the file that should be uploaded to a server will be returned in response to namecheap.ssl.re-issue call (see example responses at the end of this method’s section).

  • For Comodo certificates, file name and contents will be returned in response to namecheap.ssl.parsecsr call (see example response in the namecheap.ssl.parseCSR method section).

Name Type MaxLength Required? Description
HTTPDCValidation String 10 No* An indicator that shows if certificate should be activated using HTTP-based validation. Please specify True if you wish to use HTTP-based validation.

Note: *If you have set HTTPDCValidation as ‘True’ you should not use ApproverEmail parameter.

Additional parameters for activating GeoTrust, Symantec and Thawte OV and EV Certificates and Thawte SSL 123:

In addition to general parameters, you need to pass additional parameters for reissuing GeoTrust, Symantec, Thawte Organization Validated (OV) and Extended Validation (EV) certificates and Thawte SSL 123 certificates.

Name Type MaxLength Required? Description
OrganizationLegalName String 255 Yes* Legal Name of the Organization (refer to the notes at the bottom of this table)
OrganizationDUNS String 255 No DUNS of the Organization
OrganizationAddress1 String 255 Yes* Address1 of the Organization(refer to the notes at the bottom of this table)
OrganizationAddress2 String 255 No Address2 of the Organization
OrganizationCity String 255 Yes* City where the Organization is located (refer to the notes at the bottom of this table)
OrganizationStateProvince String 255 Yes* State/Province of the Organization(refer to the notes at the bottom of this table)
OrganizationPostalCode String 255 Yes* PostalCode/ZIP of the Organization(refer to the notes at the bottom of this table)
OrganizationCountry String 255 Yes* Country of the Organization(refer to the notes at the bottom of this table)
OrganizationPhone String 255 Yes* Phone number in the format +NNN.NNNNNNNNNN(refer to the notes at the bottom of this table)
OrganizationFax String 255 No Fax number in the format +NNN.NNNNNNNNNN

Note: *These additional parameters are currently optional but will be required in the near future. We advise you to pass these parameters, to ensure your reissue goes smoothly.

Additional parameters for reissue of Comodo EV Certificates (Comodo EV SSL, Comodo EV SGC SSL):

In addition to these parameters, you need to pass additional parameters for activating Comodo Organization Validated (OV) certificates and Comodo Extended Validation (EV) certificates.

Name Type MaxLength Required? Description
CompanyIncorporationCountry String 100 Yes Country of company incorporation
CompanyIncorporationLocality String 100 No Locality of company incorporation
CompanyIncorporationStateProvince String 100 No State/province of company incorporation
CompanyIncorporationDate String 100 No Company incorporation date
CompanyDBA String 100 No Company DBA
CompanyRegistrationNumber String 100 No Registration number of the company

Callback parameters for reissue of Comodo OV certificates (InstantSSL, InstantSSL Pro, PremiumSSL, PremiumSSL Wildcard):

Name Type MaxLength Required? Description
OrganizationRepEmailAddress String 128 Yes Representative's email address used for verification by Comodo
OrganizationRepCallbackMethod String 7 Yes Possible values: phone, letter
OrganizationRepFirstName String 60 Yes Representative's first name
OrganizationRepLastName String 60 Yes Representative's last name
OrganizationRepTitle String 60 No Representative's title
OrganizationRepCallbackDestinationSame String 3 Yes Possible values: yes, no
OrganizationRepLegalName String 255 Yes Representative's legal name. This parameter is required only if OrganizationRepCallbackDestinationSame parameter is set as No.
OrganizationRepDUNS String 255 No DUNS of the Representative
OrganizationRepAddress1 String 255 Yes Representative's address. This parameter is required only if OrganizationRepCallbackDestinationSame parameter is set as No.
OrganizationRepAddress2 String 255 No Representative's address
OrganizationRepCity String 255 Yes Representative's city. This parameter is required only if OrganizationRepCallbackDestinationSame parameter is set as No.
OrganizationRepStateProvince String 255 Yes Representative's State/Province. This parameter is required if OrganizationRepCallbackDestinationSame parameter is set as No.
OrganizationRepPostalCode String 255 Yes Representative's postal code. This parameter is required only if OrganizationRepCallbackDestinationSame parameter is set as No.
OrganizationRepCountry String 255 Yes Representative's country. This parameter is required only if OrganizationRepCallbackDestinationSame parameter is set as No.
OrganizationRepPhone String 255 Yes Representative's phone number
OrganizationRepFax String 255 No Representative's fax number
OrganizationRepPostOfficeBox String 128 No Representative's PO box

Example Response

<?xml version="1.0" encoding="UTF-8"?>
<ApiResponse Status="OK">
  <Errors />
  <RequestedCommand>namecheap.ssl.reissue</RequestedCommand>
  <CommandResponse Type="namecheap.ssl.reissue">
    <SSLReissueResult ID="123455" IsSuccess="true" />
  </CommandResponse>
  <Server>SERVER-NAME</Server>
  <GMTTimeDifference>+5:30</GMTTimeDifference>
  <ExecutionTime>55.5</ExecutionTime>
</ApiResponse>

Example response for Symantec certificates with HTTPDCValidation set to True

<?xml version="1.0" encoding="UTF-8"?>
<ApiResponse Status="OK">
  <Errors />
  <Warnings />
  <RequestedCommand>namecheap.ssl.reissue</RequestedCommand>
  <CommandResponse Type="namecheap.ssl.reissue">
    <SSLReissueResult ID="802258" IsSuccess="true">
      <HttpDCValidation ValueAvailable="true">
        <FileName><![CDATA[m2gswec3.htm]]></FileName>
        <FileContent><![CDATA[q3BUwrGagOfnlMGQTgCF]]></FileContent>
      </HttpDCValidation>
    </SSLReissueResult>
  </CommandResponse>
  <Server>WEB1-SANDBOX1</Server>
  <GMTTimeDifference>--5:00</GMTTimeDifference>
  <ExecutionTime>4.941</ExecutionTime>
</ApiResponse>

Response Parameters

Name Description
ID The unique integer value that represents the SSL certificate
IsSuccess Indicates whether the SSL was reissued
HTTPDCValidation ValueAvailable Indicates whether HTTPDCValidation is available. Possible values: True, False.

Error Codes

Specifies the error codes that might be returned from this method

Number Description
2010326 Error while validating administrative address
2011294, 4011294 CertificateID is invalid
2019331 Certificate status is not available
4011331 Certificate status is invalid
4011297, 2011297 WebServerType is invalid
3011166 Invalid renewal order domain
3011296 The CSR provided is invalid
4024295 Unable to update ApproverEmail in database
2015182 The contact phone is invalid. The phone number format is +NNN.NNNNNNNNNN.
4024331 Unable to update status in database
3028301 Failed to purchase certificate
3011295 ApproverEmail is not valid
2011300 Validation for True Business with EV
2030332 Config file value does not support for activation
2010297 WebServerType is missing
4011296 CSR invalid error from provider
4024294 Failed to update CertificateID
4027295 Failed to send ApproverEmail
2011510 Partner name is invalid
5050900 Unhandled exceptions
2011333 xmlfile is missing error while getting xml form from filepath and xmlstring from config file
4050900 Unhandled exception from database error

Comments

We welcome your comments, questions, corrections and additional info relating to this article. Your comments may take some time to appear. Please be aware that off-topic comments will be deleted.

If you need specific help with your account, feel free to contact our Support Team. Thank you.

Need help? We're always here for you.

× Close