Skip to main content

Voucher price estimate

POST https://www.digicert.com/services/v2/finance/voucher-pricing

Use this endpoint to get price estimates for a voucher order.

Example requests and responses

Request parameters

Name

Req/Opt

Type

Description

vouchers

required

array

List of objects with details about each voucher configuration to request a price estimate for.

.. product_name_id

required

string

Name ID of the product.

Supported products:

  • ssl_securesite_pro: Secure Site Pro SSL

  • ssl_ev_securesite_pro: Secure Site Pro EV SSL

  • ssl_securesite_flex: Secure Site OV

  • ssl_ev_securesite_flex: Secure Site EV

  • ssl_basic: Basic OV

  • ssl_ev_basic: Basic EV

  • ssl_geotrust_truebizid: GeoTrust TrueBusiness ID OV

  • ssl_ev_geotrust_truebizid: GeoTrust TrueBusiness ID EV

  • ssl_thawte_webserver: Thawte SSL Webserver OV

  • ssl_ev_thawte_webserver: Thawte SSL Webserver EV

  • ssl_dv_geotrust_flex: GeoTrust DV SSL

  • ssl_dv_thawte: Thawte SSL123 DV

  • ssl_dv_ee: Encryption Everywhere DV

  • code_signing: Code Signing Certificate

  • code_signing_ev: EV Code Signing Certifcate

.. 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. Note that the total number of SANs cannot exceed 250.

.. shipping_method

conditional

string

Shipping method.

Required for EV code signing certificates. Not used for other product types.

Allowed values:STANDARD or EXPEDITED

.. validity_years

conditional

int

The number of years of order coverage.

You must provide a value for validity_years or validity_days.

Range: 1-6

Note: Maximum order validity varies by product. To get the maximum order validity period for a product, use the Product info endpoint.

.. validity_days

conditional

int

The number of days of order coverage.

You must provide a value for validity_days or validity_years.

Note: Maximum order validity varies by product. To get the maximum order validity period for a product, use the Product info endpoint.

.. quantity

required

int

Quantity of certificates you want to order with this configuration. Each certificate receives a unique voucher code.

Range: 1-1000

billing_address

optional

object

Billing address details.

Used to calculate estimated tax. If not provided, we calculate estimated tax using the billing address associated with the account used to send the request.

.. country

required

string

Billing country.

.. city

required

string

Billing city.

.. state

conditional

string

Billing state or province.

Optional for some countries.

.. zip

conditional

string

Zip/postal code.

Optional for some countries.

.. address

optional

string

Billing address.

.. address2

optional

string

Continuation of the billing address.

Response parameters

Name

Type

Definition

voucher_prices

array

List of objects with details about each voucher configuration included in the request.

.. product_name_id

string

Name ID of the product.

.. no_of_fqdns

int

Number of FQDN SAN slots.

.. no_of_wildcards

int

Number of Wildcard SAN slots.

Range: 0-250

.. shipping_method

string

Shipping method.

Only returned for EV code signing certificates.

.. validity_years

int

The number of years of order coverage.

Only returned if you use validity_years to specify order validity in the request.

.. validity_days

int

The number of days of order coverage.

Only returned if you use validity_days to specify order validity in the request.

.. quantity

int

Quantity of certificates you want to order with this configuration.

.. cost

float

Estimated cost, excluding tax.

total_cost

float

Estimated total cost, excluding tax.

total_tax

float

Estimated tax on total cost. Returns 0 if an error prevents tax calculation.

Note: Estimated tax may change when you place your order.

total_cost_plus_tax

float

Estimated total cost including tax.

currency

string

Price estimate currency.