Endpoint: !getPostPaymentStatus

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

The getPostPaymentStatus API action allows you to retrieve a detailed Validation Manager page state for the orders. This information can be used to implement a similar page on your side if needed.

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 Requirement 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

string

required

64 chars

The order number of the certificate to retrieve the Post Payment page status.

Sample request

curl --location --request POST 'https://secure.trust-provider.com/products/!getPostPaymentStatus' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'loginName=yourLoginName' \
--data-urlencode 'loginPassword=yourPassword' \
--data-urlencode 'orderNumber=yourOrderNumber'

Response

The response from getPostPaymentStatus is in JSON format.

The character encoding is charset=UTF-8.

Response parameters

The following table displays the various parameters that can appear in the response.

Parameter Type Description

errorCode

integer

A numeric code that identifies the type of error. For more details, see Error codes.

errorMessage

string

Specifies the error message.

data

Descriptions of statuses.

Object (PostPaymentData)

orderNumber

string

The order number.

productType

integer

The product type identifier.

productName

string

The product name.

certificateDuration

integer

The certificate duration, in days.

productTerm

integer

The product term, in days.

uploadDocumentUrl

string

The URL for uploading order documents.

uploadDocumentToken

string

A JSON Web Token for file upload.

orderStatus

string

The order status.

The possible values are:

  • Current

  • Awaiting Payment

  • Payment Promised

  • Pending

  • Awaiting Authorization

  • Processed

  • Rejected

  • Refunded

  • ERROR!!!

domainName

string

For a single domain the certificate contains a common name.

For multi-domain the certificate contains a static text 'Multiple domains'.

primaryDomainName

string

(Multi-domain only) The primary domain name.

maxMDCDomains

integer

Maximum number of domains for multi-domain certificates.

maxMDCWildcardDomains

integer

Maximum number of wildcard domains for multi-domain certificates.

maStatus

integer

The master account status.

The possible options are:

  • -1 — not-required

  • 0 — not-completed

  • 1 — completed

  • 2 — in-progress

  • 3 — rejected

csrStatus

CSR status details.

dcvStatus

DCV status details.

agreementStatus

Agreement execution status details.

callbackStatus

Callback status detail.

organizationStatus

Organization validation status details.

secondApprovalStatus

Second approval status for the EV order.

fsupStatus

The fast service status.

caaCheckStatus

A Certification Authority Authorization (CAA) check status.

Object (csrStatus)

title

string

A section title.

status

string

A general status.

The possible values are:

  • NotApplicable

  • ActionRequired

  • Completed

  • InProgress

  • Unknown

description

string

A text of description.

availableActions

array of string

Available actions for the current status.

The possible values are:

  • needProvideCSR

  • canReplaceCSR

Object (dcvStatus)

title

string

A section title.

status

string

A general status.

The possible values are:

  • NotApplicable

  • ActionRequired

  • Completed

  • InProgress

  • Unknown

description

string

A text of description.

availableActions

array of string

Available actions for the current status.

The possible values are:

  • selectDCVMethod

  • canChangeDCVMethod

  • enterDCVCode

domains

array of object (domainDescription)

List of domains. For single domain certificates, the array contains one element only.

MD5

string

The MD5 hash of the CSR.

SHA256

string

The SHA256 hash of the CSR.

uniqueValue

string

A unique request token.

Object (agreementStatus)

title

string

A section title.

status

string

A general status.

The possible values are:

  • NotApplicable

  • ActionRequired

  • Completed

  • InProgress

  • Unknown

description

string

Text of description.

availableActions

array of string

Available actions for the current status.

The possible values are:

  • canUpdateEmailAddress

  • resendAgreementEmail

  • needUpdateEmailAddress

clickThroughStatus

string

Click-through status.

The possible values are:

  • notExecuted

  • Executed

clickThroughEmailAddress

string

EV Subscriber Agreement & Certificate Request Form Email Address.

lastEmailSent

date

The date of the last email sent (YYYY-MM-DD).

lastOpenDate

date

The date of the last open (YYYY-MM-DD).

Object (callbackStatus)

title

string

A section title.

status

string

A general status.

The possible values are:

  • NotApplicable

  • ActionRequired

  • Completed

  • InProgress

  • Unknown

description

string

A text of description.

phoneNumber

string

A callback phone number.

availableActions

array of string

Available actions for the current status.

The possible values are:

  • callMeNow

  • callMeLater

  • provideCorrectPhoneNumber

  • enterCallbackCode

  • requestManualCallback

Object (organizationStatus)

title

string

A section title.

status

string

A general status.

The possible values are:

  • NotApplicable

  • ActionRequired

  • Completed

  • InProgress

  • Unknown

description

string

A text of description.

availableActions

array of string

Available actions for the current status.

The possible value is:

  • uploadDocument

organizationName

object (requirementStatus)

The status of organization name check.

legalExistence

object (requirementStatus)

The status of legal existence check.

assumedName

object (requirementStatus)

The status of assumed name check.

physicalExistence

object (requirementStatus)

The status of physical existence check.

operationalExistence

object (requirementStatus)

The status of operational existence check.

trademarkCheck

object (requirementStatus)

The status of brand validation check.

Object (secondApproval)

title

string

A section title.

status

string

A general status.

The possible values are:

  • NotApplicable

  • ActionRequired

  • Completed

  • InProgress

  • Unknown

description

string

A text of description.

Object (fsupStatus)

title

string

A section title.

status

string

A general status.

The possible values are:

  • NotApplicable

  • ActionRequired

  • Completed

  • InProgress

  • Unknown

description

string

A text of description.

Object (requirementStatus)

title

string

A section title.

status

string

A validation status.

The possible values are:

  • NotApplicable

  • InProgress

  • Completed

description

string

A text of description.

Object (domainDescription)

domainName

string

A domain name.

dcvStatus

string

A validation status.

The possible values are:

  • NotApplicable

  • InProgress

  • Completed

selectedMethod

string

The selected DCV method.

methods

array of object (dcvMethod)

Available DCV methods for the domain.

Object (dcvMethod)

type

string

A type of method.

The possible values are:

  • whoisEmail

  • email

  • csrHash

  • manual

title

string

A name of method.

level

string

Level of email list (for type = email).

selectedMethod

string

The selected DCV method.

options

array of string

Available options.

If type = whoisEmail — List of email addresses for DCV method based on Whois.

If type = csrHash — List of available DCV methods based on CSR HASH: CNAME CSR Hash, HTTP CSR Hash, HTTPS CSR Hash.

If type = email — List of email addresses for DCV method based on email.

If type = manual — List contains only one element: Manual.

Object (caaCheckStatus)

title

string

A section title.

status

string

A check status.

The possible values are:

  • NotApplicable

  • ActionRequired

  • Completed

  • InProgress

  • Unknown

latestCAACheckErrors

object (latestCAACheckErrors)

List of failed checks for the latest CAA check session (displayed only if status = ActionRequired).

Object (latestCAACheckErrors)

lookupDatetime

date

Date and time of the check (YYYY-MM-DD HH24:MI:SS).

queriedFQDN

string

A fully qualified domain name (FQDN).

domainName

string

The domain name.

result

string

The check result.

The possible values are:

  • Empty

  • Authorized

  • Not Authorized

  • ERROR!

  • Timeout!

  • Unrecognized Critical Tag

  • Malformed Response

Sample success response

{
  "errorCode": 0,
  "errorMessage": "",
  "data": {
    "orderNumber": "yourOrderNumber",
    "productType": 801,
    "productName": "Verified Mark Certificate (VMC)",
    "certificateDuration": 365,
    "productTerm": 365,
    "orderStatus": "Pending",
    "domainName": "Multiple domains",
    "maxMDCDomains": 2,
    "csrStatus": {
      "title": "Submit your CSR",
      "status": "Completed",
      "description": "You have already submitted your CSR."
    },
    "agreementStatus": {
      "title": "Agreement Execution",
      "status": "ActionRequired",
      "clickThroughStatus": "notExecuted",
      "clickThroughEmailAddress": "",
      "lastEmailSent": "2025-06-11",
      "lastOpenDate": "2025-06-12",
      "availableActions": [
        "canUpdateEmailAddress",
        "resendAgreementEmail"
      ]
    },
    "callbackStatus": {
      "title": "Order Authorization",
      "status": "NotApplicable"
    },
    "organizationStatus": {
      "title": "Organization Validation",
      "status": "NotApplicable"
    },
    "secondApprovalStatus": {
      "title": "Second Approval",
      "status": "NotApplicable"
    },
    "fsupStatus": {
      "title": "Fast Service Certificate",
      "status": "NotApplicable"
    },
    "caaCheckStatus": {
      "title": "CAA Check",
      "status": "NotApplicable"
    }
  }
}