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 Max. Length Description

loginName

string

64 chars

Your account username.

This value is case sensitive.

loginPassword

string

128 chars

Your account password.

This value is case sensitive.

orderNumber

integer

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

Either orderNumber or baseOrderNumber must be provided.

baseOrderNumber

integer

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

255 chars

Fully-qualified Domain Name (FQDN).

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

newMethod

string

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

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

255 chars

Space-separated FQDNs to update the DCV methods.

Only relevant for multi-domain certificates.

newMethods

string

32 chars

Comma-separated DCV methods for each domain in domainNames. Only relevant for multi-domain certificates. 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

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.