Skip to main content

Set subaccount products

PUT https://www.digicert.com/services/v2/account/subaccount/{{subaccount_id}}/products

Use this endpoint to set product availability and pricing for a subaccount.

Important

This endpoint is destructive to the products array.

  • Any existing array is overwritten with the sent array.

  • Sending an empty products array disables all products for the subaccount.

Example requests and responses

Request parameters

Name

Req/Opt

Type

Description

currency

optional

string

Sets the currency code for displaying product prices. When you change the display currency for a bill-to-parent subaccount, you must also update the price for each of the subaccount's enabled products. This parameter is ignored for self-billed subaccounts. Parent accounts and self-billed subaccounts always see prices and receive invoices in the currency associated with their account.

Possible values: See Glossary - Subaccount display currencies.

Default: Previously assigned currency code, or USD if no code has been assigned.

Important:

  • Changing the display currency resets the subaccount’s balance or division balances to 0. This cannot be undone.

  • If any orders placed in a different currency are rejected or revoked, refunds are issued only to the parent account.

  • For any orders placed in a different currency, additional domains cannot be added when reissuing the certificate.

pricing_method

optional

string

Pricing method used by the subaccount.

Possible values: Units

balance_negative_limit

optional

int

Dollar amount that the account balance can go into the negative.

products

required

array

List of products to enable for the subaccount.

.. product_name_id

optional

string

Name ID of the product to enable for the subaccount. See Glossary – Product identifiers.

.. prices

optional

array

List of objects with information about the prices to set for each product.

Note: If DigiCert supports billing in the chosen currency, prices default to DigiCert's retail price in that currency. Otherwise, prices default to 0. This parameter is ignored for self-billed subaccounts.

.. .. lifetime

required

int

Validity term in years that the pricing applies to.

.. .. cost

required

int float

Specify the base price of the product.

Max: 99999999.99

.. .. additional_fqdn_cost

required*

int float

Specify the cost for each additional domain name (SAN) added to the order.

*Required only for products that support this parameter. See Product-specific parameter support.

Max: 99999999.99

.. .. additional_wildcard_cost

required*

int float

Specify the cost for each additional wildcard domain (e.g., *.example.com) added to the order.

*Required only for products that support this parameter. See Product-specific parameter support.

Max: 99999999.99

Product-specific parameter support

Notice

If a product does not support additional cost parameters (additional_fqdn_cost or additional_wildcard_cost), any value specified for that product is ignored.

Product name ID

Supports additional_fqdn_cost

Supports additional_wildcard_cost

ssl_cloud_wildcard

Yes

ssl_plus

ssl_multi_domain

Yes

ssl_wildcard

Yes

ssl_ev_plus

ssl_ev_multi_domain

Yes

private_ssl_multi_domain

Yes

private_ssl_plus

private_ssl_wildcard

Yes

client_digital_signature_plus

client_digital_signature_plus_ad

client_digital_signature_plus_sha2

client_email_security_plus

client_email_security_plus_ad

client_email_security_plus_sha2

client_authentication_plus

client_authentication_plus_ad

client_premium

client_premium_ad

client_premium_sha2

client_ltans_adobe_signing

client_timestamp_authority

private_client_premium

client_authentication_only

client_grid_premium

client_grid_robot_email

client_grid_robot_fqdn

client_grid_robot_name

grid_host_ssl

client_multi_name

grid_host_ssl_multi_domain

Yes

code_signing

code_signing_ev

document_signing_org_1

document_signing_org_2

document_signing_individual_1

document_signing_individual_2

client_authentication_only_non_repudiation

class1_smime

ssl_dv_geotrust

Yes

ssl_dv_rapidssl

ssl_ev_geotrust_truebizid

Yes

ssl_ev_thawte_webserver

Yes

ssl_geotrust_truebizid

Yes

Yes

client_premium_data_encipherment

client_premium_non_repudiation

ssl_thawte_webserver

Yes

Yes

wildcard_dv_geotrust

Yes

wildcard_dv_rapidssl

cloud_dv_geotrust

Yes

ssl_ev_securesite

ssl_ev_securesite_multi_domain

Yes

ssl_ev_securesite_pro

Yes

ssl_securesite

ssl_securesite_multi_domain

Yes

ssl_securesite_pro

Yes

Yes

ssl_securesite_wildcard

Yes

ssl_basic

Yes

Yes

ssl_ev_basic

Yes

ssl_securesite_flex

Yes

Yes

ssl_ev_securesite_flex

Yes

ssl_dv_thawte

Yes

Yes

ssl_dv_geotrust_flex

Yes

Yes

private_ssl_flex

Yes

Yes

ssl_dv_ee

Yes

Yes