Order voucher

POST

https://www.digicert.com/services/v2/voucher

Use this endpoint to place a voucher order. To order multiple products at once, pass an object for each product configuration you want to order.

Each voucher order is intended to be used by the same customer. If you need to order vouchers for multiple customers, place separate orders for each customer.

Example requests and responses

cURL

curl --request POST 'https://www.digicert.com/services/v2/voucher' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '
{
  "vouchers": [
    {
      "product_name_id": "ssl_ev_basic",
      "no_of_fqdns": 5,
      "validity_years": 1,
      "quantity": 1,
      "use_san_package": true
    },
    {
      "product_name_id": "ssl_ev_securesite_pro",
      "no_of_fqdns": 2,
      "validity_years": 2,
      "quantity": 1
    }
  ],
  "payment_method": "balance"
}'

201 Created

{
    "id": 1014,
    "name": "My test voucher order",
    "status": "completed",
    "cost": 2698,
    "expiration_date": "2021-07-09",
    "codes": [
        {
            "id": 2104,
            "value": "QWWQ7LQSO72QLPXEXMC5OA65SHS2CPWJ",
            "product": {
                "name_id": "ssl_ev_basic"
            },
            "no_of_fqdns": 5,
            "validity_years": 1,
            "status": "active"
        },
        {
            "id": 2105,
            "value": "WWXPP6EC2GUXRYY4AE52FMOZ33K32M7K",
            "product": {
                "name_id": "ssl_ev_securesite_pro"
            },
            "no_of_fqdns": 2,
            "validity_years": 2,
            "status": "active"
        }
    ],
}

Request parameters

Name	Req/Opt	Type	Description
vouchers	required	array	List of object containers for new vouchers to order.
.. product_name_id	required	string	Name ID of the product. Allowed values: See Glossary – Product identifiers.
.. no_of_fqdns	optional	int	Number of FQDN SAN slots. Range: `0`-`250`. Note that the total number of SANs cannot exceed 250.
.. no_of_wildcards	optional	int	Number of Wildcard SAN slots. Range: `0`-`250`
.. validity_years	optional*	int	The number of years of order coverage. Range: `1`-`6`. Note that the total number of SANs cannot exceed 250.
.. validity_days	optional*	int	The number of days of order coverage. Overrides `validity_years`.
.. quantity	required	int	Quantity of certificates you want to order with this configuration. Each certificate receives a unique voucher code. Range: `1`-`1000`
.. use_san_package	optional	boolean
payment_method	required	string	Specify the payment method to use. Allowed values: `balance`, `card`, `wire transfer`
name	optional	string	Include a customer name or organization that this voucher order is intended for. Only for tracking and order management purposes. Maximum allowed characters: `128`
notes	optional	string	Include any notes that help you with order management. Maximum allowed characters: `512`

Response parameters

Name	Type	Description
id	int	Voucher order ID.
status	string	Status of Voucher order. Possible values: `active`, `used`, `canceled`,
codes	array	List of objects with details about the voucher codes in this order. Each certificate in the order is returned as a separate object.
.. id	int	Voucher code ID.
.. value	string	Unique voucher code.
.. product	object	Object with product details.
.. .. product_name_id	string	Name ID of the product. See Glossary – Server platforms
no_of_fqdns	int	Number of FQDN SAN slots. Possible values: `0`-`250`. Note that the total number of SANs cannot exceed 250.
no_of_wildcards	int	Number of Wildcard SAN slots. Possible values: `0`-`250`. Note that the total number of SANs cannot exceed 250.
validity_years	int	Number of years the certificate is valid. ^Can be replaced with `validity_days`. Range*: `1`-`6`
validity_days	int	Number of days the certificate is valid. Range: `1`-`2190`

Example requests and responses

Request parameters

Response parameters

Über