Order Multi-year Plan

POST

https://www.digicert.com/services/v2/order/certificate/{{product_id}}

Use this endpoint to create or renew an order for a Multi-year Plan. You must place renewal requests from the same account used to create the original order.

Multi-year Plans allow you to pay a single discounted price for up to six years of SSL/TLS certificate coverage. With Multi-year Plans, you pick the SSL/TLS certificate, the certificate validity period, and the duration of coverage you want (up to six years). Until the plan expires, you can reissue your certificate at no cost each time it reaches the end of its validity period. For more information, see Multi-year Plans.

Replace {{product_id}} in the URL with the product identifier of the certificate you want to order. Multi-year Plans are available for the following product types:

ssl_basic - Basic OV
ssl_ev_basic - Basic EV
ssl_securesite_flex - Secure Site OV
ssl_ev_securesite_flex - Secure Site EV
ssl_securesite_pro - Secure Site Pro SSL
ssl_ev_securesite_pro - Secure Site Pro EV SSL
ssl_dv_thawte - Thawte SSL 123 DV
ssl_thawte_webserver - Thawte SSL Webserver OV
ssl_ev_thawte_webserver - Thawte SSL Webserver EV
ssl_dv_geotrust_flex - GeoTrust DV SSL
ssl_geotrust_truebizid - GeoTrust TrueBusiness ID OV
ssl_ev_geotrust_truebizid - GeoTrust TrueBusiness ID EV
ssl_dv_rapidssl - RapidSSL Standard DV SSL Certificate
wildcard_dv_rapidssl – RapidSSL Wildcard DV SSL Certificate

End of 2-year public SSL/TLS certificates

On August 27, 2020, 5:59 PM MDT (23:59 UTC), the Services API will stop issuing public SSL/TLS certificates with a validity period greater than 397 days.

After August 27:

If Multi-year Plans are enabled for your account, requests that specify an order validity greater than 1 year for certificates that support Multi-year plans will create a new Multi-year Plan. For more information, see Multi-year Plans.
If Multi-year Plans are not enabled for your account, requests that specify an order validity period greater than 397 days will return an error.

To learn more about this change, see End of 2-year DV, OV, EV Public SSL/TLS Certificates.

Multi-year Plans are only enabled for a subset of products and CertCentral accounts. To get the list of products that are enabled for your account, use the Product List endpoint. For more information about pricing, cancellation, and other details about Multi-year Plans, contact your account manager.

Example requests and responses

cURL

curl -X POST \
  https://www.digicert.com/services/v2/order/certificate/ssl_ev_basic \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "certificate": {
        "common_name": "example.com",
        "dns_names": [
            "sub.example.com",
            "app.example.com"
        ],
        "csr": "<csr>",
        "signature_hash": "sha256",
        "server_platform": {
            "id": 2
        },
        "cert_validity": {
            "custom_expiration_date": "21 DEC 2021"
        }
    },
    "comments": "Certificate for app server.",
    "container": {
        "id": 334455
    },
    "auto_renew": 1,
    "custom_renewal_message": "Keep this renewed.",
    "organization": {
        "id": 123456,
        "contacts": [
            {
                "contact_type": "ev_approver",
                "user_id": 565622
            },
            {
                "contact_type": "organization_contact",
                "user_id": 565611
            },
            {
                "contact_type": "technical_contact",
                "first_name": "Jill",
                "last_name": "Valentine",
                "job_title": "STAR Member",
                "telephone": "8017019600",
                "email": "jill.valentine@digicert.com"
            }
        ]
    },
   "order_validity": {
        "custom_expiration_date": "21 DEC 2024"
    },
    "payment_method": "balance"
}

Python

import requests

url = "https://www.digicert.com/services/v2/order/certificate/ssl_ev_basic"

payload = "{\n    \"certificate\": {\n        \"common_name\": \"example.com\",\n        \"dns_names\": [\n            \"sub.example.com\",\n            \"app.example.com\"\n        ],\n        \"csr\": \"<csr>\",\n        \"signature_hash\": \"sha256\",\n        \"server_platform\": {\n            \"id\": 2\n        },\n        \"cert_validity\": {\n            \"custom_expiration_date\": \"21 DEC 2021\"\n        }\n    },\n    \"comments\": \"Certificate for app server.\",\n    \"container\": {\n        \"id\": 334455\n    },\n    \"auto_renew\": 1,\n    \"custom_renewal_message\": \"Keep this renewed.\",\n    \"organization\": {\n        \"id\": 123456,\n        \"contacts\": [\n            {\n                \"contact_type\": \"ev_approver\",\n                \"user_id\": 565622\n            },\n            {\n                \"contact_type\": \"organization_contact\",\n                \"user_id\": 565611\n            },\n            {\n                \"contact_type\": \"technical_contact\",\n                \"first_name\": \"Jill\",\n                \"last_name\": \"Valentine\",\n                \"job_title\": \"STAR Member\",\n                \"telephone\": \"8017019600\",\n                \"email\": \"jill.valentine@digicert.com\"\n            }\n        ]\n    },\n    \"order_validity\": {\n        \"custom_expiration_date\": \"21 DEC 2024\"\n    },\n    \"payment_method\": \"balance\"\n}"
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://www.digicert.com/services/v2/order/certificate/ssl_ev_basic"

	payload := strings.NewReader("{\n    \"certificate\": {\n        \"common_name\": \"example.com\",\n        \"dns_names\": [\n            \"sub.example.com\",\n            \"app.example.com\"\n        ],\n        \"csr\": \"<csr>\",\n        \"signature_hash\": \"sha256\",\n        \"server_platform\": {\n            \"id\": 2\n        },\n        \"cert_validity\": {\n            \"custom_expiration_date\": \"21 DEC 2021\"\n        }\n    },\n    \"comments\": \"Certificate for app server.\",\n    \"container\": {\n        \"id\": 334455\n    },\n    \"auto_renew\": 1,\n    \"custom_renewal_message\": \"Keep this renewed.\",\n    \"organization\": {\n        \"id\": 123456,\n        \"contacts\": [\n            {\n                \"contact_type\": \"ev_approver\",\n                \"user_id\": 565622\n            },\n            {\n                \"contact_type\": \"organization_contact\",\n                \"user_id\": 565611\n            },\n            {\n                \"contact_type\": \"technical_contact\",\n                \"first_name\": \"Jill\",\n                \"last_name\": \"Valentine\",\n                \"job_title\": \"STAR Member\",\n                \"telephone\": \"8017019600\",\n                \"email\": \"jill.valentine@digicert.com\"\n            }\n        ]\n    },\n    \"order_validity\": {\n        \"custom_expiration_date\": \"21 DEC 2024\"\n    },\n    \"payment_method\": \"balance\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://localhost.digicert.com/services/v2/order/certificate/ssl_ev_basic',
  'headers': {
    'X-DC-DEVKEY': '{{api_key}}',
    'Content-Type': ['application/json', 'text/plain']
  },
  body: "{\n    \"certificate\": {\n        \"common_name\": \"example.com\",\n        \"dns_names\": [\n            \"sub.example.com\",\n            \"app.example.com\"\n        ],\n        \"csr\": \"<csr>\",\n        \"signature_hash\": \"sha256\",\n        \"server_platform\": {\n            \"id\": 2\n        },\n        \"cert_validity\": {\n            \"custom_expiration_date\": \"21 DEC 2021\"\n        }\n    },\n    \"comments\": \"Certificate for app server.\",\n    \"container\": {\n        \"id\": 334455\n    },\n    \"auto_renew\": 1,\n    \"custom_renewal_message\": \"Keep this renewed.\",\n    \"organization\": {\n        \"id\": 123456,\n        \"contacts\": [\n            {\n                \"contact_type\": \"ev_approver\",\n                \"user_id\": 565622\n            },\n            {\n                \"contact_type\": \"organization_contact\",\n                \"user_id\": 565611\n            },\n            {\n                \"contact_type\": \"technical_contact\",\n                \"first_name\": \"Jill\",\n                \"last_name\": \"Valentine\",\n                \"job_title\": \"STAR Member\",\n                \"telephone\": \"8017019600\",\n                \"email\": \"jill.valentine@digicert.com\"\n            }\n        ]\n    },\n    \"order_validity\": {\n        \"custom_expiration_date\": \"21 DEC 2024\"\n    },\n    \"payment_method\": \"balance\"\n}"

};
request(options, function (error, response) { 
  if (error) throw new Error(error);
  console.log(response.body);
});

201 (one-step)

{
  "id": 112233,
  "requests": [
    {
      "id": 113,
      "status": "pending"
    }
  ],
  "domains": [
      {
          "id": 1469,
          "name": "example.com"
      },
      {
          "id": 1470,
          "name": "sub.example.com"
      },
      {
          "id": 1471,
          "name": "app.example.com"
      }
  ]
}

201 (two-step)

{
  "id": 112233,
  "requests": [
    {
      "id": 113,
      "status": "submitted"
    }
  ],
  "domains": [
      {
          "id": 1469,
          "name": "example.com"
      },
      {
          "id": 1470,
          "name": "sub.example.com"
      },
      {
          "id": 1471,
          "name": "app.example.com"
      }
  ]
}

201 (auto)

{
  "id": 112233,
  "requests": [
    {
      "id": 113,
      "status": "approved"
    }
  ],
  "domains": [
      {
          "id": 1469,
          "name": "example.com"
      },
      {
          "id": 1470,
          "name": "sub.example.com"
      },
      {
          "id": 1471,
          "name": "app.example.com"
      }
  ],
  "certificate_id": 113
}

201 (skip)

{
  "id": 112233,
  ],
  "domains": [
      {
          "id": 1469,
          "name": "example.com"
      },
      {
          "id": 1470,
          "name": "sub.example.com"
      },
      {
          "id": 1471,
          "name": "app.example.com"
      }
  ],
  "certificate_id": 113
}

Request parameters

Name	Req/Opt	Type	Description
certificate	required	object	Certificate details.
.. common_name	required	string	Domain to be secured.
.. dns_names	optional	array	Additional domains to be secured. Can result in additional costs. (See Best practices – Get both versions of a domain for free.)
.. csr	required	string	Certificate signing request (CSR). Note: The Services API does not extract information from the CSR to fill in the details of a certificate request. You must provide values for all relevant request parameters, including `certificate.common_name`, `certificate.dns_names`, and `organization.id`. If you are requesting a certificate for an organization without an existing ID, you must provide values for all required parameters of the `organization` object.
.. signature_hash	required	string	Hash algorithm used to signing the certificate. Code signing certificates support only SHA-256.
.. organization_units	optional	array	Department in your organization the certificate is for.
.. server_platform	optional	object	Server platform type. Default: `-1` (other)
.. .. id	required	int	Server platform ID. See Glossary – Server platforms
.. cert_validity	optional	object	Defines the validity period of the first certificate issued for this order. Cannot exceed order validity period. If not provided, the certificate's validity period defaults to the validity period of the order or the maximum certificate validity period defined by CA/B Forum baseline requirements, whichever is shorter. This object is not used for requests from accounts that do not have Multi-year Plans enabled.
.. .. years	optional	int	Number of years the certificate is valid after it is issued. Can be replaced with `cert_validity.days` or `cert_validity.custom_expiration_date`. Range: `1`-`2`
.. .. days	optional	int	Number of days the certificate is valid after it is issued. Overrides `cert_validity.years`. Max: `825`
.. .. custom_expiration_date	optional	string	A custom expiration date for the certificate. Overrides `cert_validity.days` and `cert_validity.years`. Format: `dd MMM YYYY` (for example, `"09 JUN 2021"`) Range: Must be within 825 days of the date you request the certificate.
.. profile_option	optional	string	If using custom certificate profiles, specify the profile name.
renewed_thumbprint	optional^*	string	If order is a renewal, enter the SHA-1 thumbprint of the previous order's primary certificate. For more information, see How to check a certificate's thumbprint. ^*Renewal orders must include either a `renewed_thumbprint` or `renewal_of_order_id` value.
order_validity	required^*	object	Defines the validity period of the order. Order validity determines the length of a Multi-year Plan. ^*Requests must include a value for either the `order_validity` object or for one of the top-level order validity parameters (`validity_years`, `validity_days`, or `custom_expiration_date`). The values you provide in the `order_validity` object override the top-level validity parameters.
.. years	required^*	int	Number of years the order is valid. ^Can be replaced by `order_validity.days` or `order_validity.custom_expiration_date`. Range*: `1`-`6`
.. days	optional	int	Number of days the order is valid. Overrides `order_validity.years`. Max: `2190`
.. custom_expiration_date	optional	string	Custom expiration date for the order. Overrides `order_validity.days` and `order_validity.years`. Format: `dd MMM YYYY` (for example, `"09 JUN 2025"`) Range: Must be within six years of the date you request the order.
validity_years	optional^*	int	Number of years the order is valid. Can be replaced by `validity_days` or `custom_expiration_date`. Range: `1`-`6` ^*Required if `order_validity` object is not used.
validity_days	optional	int	Number of days the order is valid. Overrides `validity_years`. Max: `2190`
custom_expiration_date	optional	string	Custom expiration date for the order. Overrides `validity_days` and `validity_years`. Format: `yyyy-MM-dd` Range: Must be within six years of the date you request the order.
comments	optional	string	Comments about the order for the approver.
auto_renew	optional	int	Specify if the certificate should automatically renew. Default: `0` Allowed values: `0` (disabled), `1` (enabled)
custom_renewal_message	optional	string	Custom message to be included in renewal notifications.
disable_renewal_notifications	optional	bool	Specify if renewal notification emails should be disabled. Default: `false`
additional_emails	optional	array	Additional email addresses to receive certificate notification emails (e.g., certificate issuance, duplicate certificate, certificate renewals, etc.).
locale	optional	string	Language that the DCV email should use. See Glossary – Locale codes
renewal_of_order_id	optional*	int	If order is a renewal, enter the previous order's ID. *Renewal orders must include either a `renewed_thumbprint` or `renewal_of_order_id` value.
payment_method	optional	string	Specify the payment method to use. Allowed values: `balance`, `card`, `profile` Default: `balance`
dcv_method	optional	string	DCV method to use when verifying domain control. See Glossary – DCV methods
skip_approval	optional	bool	Specify if the order should skip the approval step and be immediately submitted for validation and issued when complete. Default: `false`
disable_ct	optional	bool	Specify if CT logging for the certificate should be disabled. Order-specific CT logging must be enabled or this will be ignored. See Allow Users to Keep Certificates Out of CT Logs.Default: `false`
organization	required	object	Object with information about the organization to associate with the request. You can associate the request with an existing organization, or you can create a new organization when you submit the order request. To associate the request with an existing organization, pass the ID of the organization as the value of `organization.id` in the body of your request. To create a new organization, include the details of the organization in the `organization` object. For more information about the structure and required parameters of the `organization` object, see the Create organization documentation. Important: When you create an order without providing an organization ID, we check the organizations that already exist in your account to avoid creating a duplicate organization. If the details you provide in the request match the details of an existing organization, we associate the order with the existing organization instead of creating a new one. To override this behavior and force the request to create a new organization, set the `organization.skip_duplicate_org_check` parameter to `true` in the body of your request.
.. id	required*	int	The ID of an existing organization to associate with the order. To get the ID of organizations in your account, use the List organizations endpoint. *Not required if you are creating a new organization with your request.
.. skip_duplicate_org_check	optional	bool	Use `true` to skip the check for duplicate organizations in your account. When you skip this check, you force the request to create a new organization, regardless of whether the details you provide in the request match the details of an organization that already exists in your account. Default: `false`
.. contacts	required	array	List of organization contacts for the order. Note: For OV orders, you can omit this array to use the default contact for the specified organization. For EV orders, you must include an `ev_approver` contact. To get potential EV approvers, see List approvers.
.. .. contact_type	required	string	Type of contact to add to the order. Allowed values: `organization_contact`, `technical_contact`, `ev_approver`
.. .. user_id	required^*	int	ID of existing user or contact for the account. ^* Can be omitted if adding a new contact.
.. .. first_name	optional	string	First name of the new contact. Note: Required when omitting `user_id`. If `user_id` is not omitted, the specified user's information will be updated with the new value.
.. .. last_name	optional	string	Last name of the new contact. Note: Required when omitting `user_id`. If `user_id` is not omitted, the specified user's information will be updated with the new value.
.. .. job_title	optional	string	Job title of the new contact. Note: Required when omitting `user_id`. If `user_id` is not omitted, the specified user's information will be updated with the new value.
.. .. telephone	optional	string	Telephone number of the new contact. Note: Required when omitting `user_id`. If `user_id` is not omitted, the specified user's information will be updated with the new value.
.. .. email	optional	string	Email address of the new contact. Note: Required when omitting `user_id`. If `user_id` is not omitted, the specified user's information will be updated with the new value.
container	optional	object	If needed, specify the container the order should be placed under.
.. id	required	int	Container ID.
custom_fields	optional^*	array	Account-specific custom fields. ^* Whether or not these fields are required depends on your custom field settings.
.. metadata_id	required	int	Custom field ID.
.. value	required	string	Value for the custom field. Data validation type depends on your custom field settings.

Response parameters

Name	Type	Description
id	int	Order ID.
organization	object	Container for new organization details. Only returned if a new organization was created with the order.
.. id	int	Organization ID for the new organization.
domains	object	Container for domain details. Returned for new and existing domains on the order.
.. id	int	Domain ID for the domain.
.. name	int	Name of the domain.
requests	array	Contains information about the request.
.. id	int	Request ID.
.. status	string	Request status. Possible values: `pending`, `submitted`, `approved`, `rejected`
certificate_id	int	Certificate ID. Returned if request status is `approved`.

Example requests and responses

Request parameters

Response parameters

정보