On This Page
Response to an Unsuccessful Request
It is important to understand the fields that are contained in a response to an
unsuccessful request. These fields provide information that identify and resolve
unsuccessful requests.
The response to an unsuccessful request contains these fields:
- v-c-correlationid: The response header includes a unique identifier for this validation request.
- submitTimeUtc: The timestamp of the validation request. The format isYYYY-MM-DDThhmmssZ.
- message: The detailed message related to the status and reason for the response.
For more information about response codes, see Transaction response codes.
HTTP Status Codes for an Unsuccessful Request
These are the possible values you can receive for a status, reason, and details block
depending on the HTTP status code:
HTTP Status Code (part of HTTP header)
| Status | Reason | Details (an array with 0 to many
blocks) |
|---|---|---|---|
400 | INVALID_ REQUEST | INVALID_REQUEST | Field contains the name of the field
that is missing or incorrect: Reason – MISSING_FIELD,
INVALID_DATA |
403 | UNAUTHORIZED | UNAUTHORIZED | — |
404 | NOT_FOUND | NOT_FOUND | — |
422 | VALIDATION_ ERROR | PRODUCT_INACTIVE
INVALID_MERCHANT_ CONFIGURATION PRODUCT_NOT_CONFIGURED | — |
502 | SERVER_ERROR | SYSTEM_ERROR
SERVER_TIMEOUT SERVICE_TIMEOUT | — |