Endpoint: !AutoUpdateDCV

https://secure.trust-provider.com/products/download/!AutoUpdateDCV

The !AutoUpdateDCV API allows you to update the DCV method for an existing certificate order. This endpoint supports both single-domain and multi-domain certificates.

Use the POST method for this endpoint.

Submit parameters in the x-www-form-urlencoded format.

The following table lists the required and optional parameters.

Parameter Type Required/Optional Max. Length Description

loginName

string

required

64 chars

Your account username.

This value is case sensitive.

loginPassword

string

required

128 chars

Your account password.

This value is case sensitive.

orderNumber

integer

conditional

The order number for which you want to update the DCV method.

Either orderNumber or baseOrderNumber must be provided.

baseOrderNumber

integer

conditional

A unique identifier for the initial certificate order associated with your account, returned to your account.

Either orderNumber or baseOrderNumber must be provided.

domainName

string

required

255 chars

Fully qualified domain name (FQDN).

Not required for single-domain orders or for multi-domain orders if domainNames is provided.

newMethod

string

required

32 chars

The selected DCV method.

The possible values are:

  • EMAIL

  • HTTP_CSR_HASH

  • HTTPS_CSR_HASH

  • CNAME_CSR_HASH

Not required for multi-domain orders if newMethods is provided.

newDCVEmailAddress

string

required

255 chars

DCV email address for a single domain.

Required if newMethod is EMAIL. Not required for multi-domain orders if newDCVEmailAddresses is provided.

domainNames

string

optional

255 chars

(Multi-domain certificates only) Space-separated FQDNs to update the DCV methods.

newMethods

string

optional

32 chars

(Multi-domain certificates only) Comma-separated DCV methods for each domain in domainNames. The number and order of DCV methods must match the FQDNs in domainNames.

The possible values are:

  • EMAIL

  • HTTP_CSR_HASH

  • HTTPS_CSR_HASH

  • CNAME_CSR_HASH

newDCVEmailAddresses

string

optional

255 chars

Space-separated DCV email addresses for each domain in domainNames where the method is EMAIL.

If specified, each address must be valid for DCV for the corresponding domain.

Required only if newMethods includes EMAIL for any FQDN in domainNames.

The number and order of email addresses must match the FQDNs in domainNames where the method is EMAIL.

Sample request

curl --location --request POST 'https://secure.trust-provider.com/products/!AutoUpdateDCV' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'loginName=yourLoginName' \
--data-urlencode 'loginPassword=yourPassword' \
--data-urlencode 'orderNumber=yourOrderNumber' \
--data-urlencode 'domainName=yourdomain.com' \
--data-urlencode 'newMethod=HTTP_CSR_HASH' \
--data-urlencode '[email protected]'

Success response

errorCode=0