Error Handling for Processing Payloads

Possible error codes and where they appear in a Decryptx response.

In a Decryptx response, error codes can appear in two separate locations:

  1. The errCode property appears at the base of the response object; it represents the high level error for the response, e.g., 1003 Authentication required. Error codes between 1 - 100 originate on the Parser; codes between 1000 and 2000 originate on Decryptx.
  2. In instances where the decryption fails, an errCode is returned with the value of 1303. A more specific error code is also returned in the decrypted array.
{
  "success"    : false,
  "errMessage" : "All values failed to decrypt",
  "errCode"    : 1303,
  "decrypted": [
     {
       "name"    : "track2",
       "failed"  : true,
       "message" : "No CC found in decrypted result",
       "code"    : 1406
     }
  ],
  "messageId": "1201610181032081012815612"
}

Sample 1303 "All decryptions failed" error response. In the decrypted array, the "code" property outlines the reason for each specific track failing to decrypt.

Error Codes

Following is a list of all possible error codes with their descriptions and the HTTP response code that will accompany them.

HTTP CodeerrCodeDescription
4091001Unknown Error
An unexpected error occurred. Please try again later.
4001101Missing partnerld
A required partnerld was not provided.
4001102Missing partnerKey
A required partnerKey was not provided.
4011103Partner not found
The specified partner could not be located.
4011104Partner disabled
The partner exists but is not permitted to make API calls.
4011105Invalid partnerKey
The provided partnerKey is not valid.
4001201Missing serial number
A device serial number was not provided.
4091202Device not found
The device could not be located or recognized.
4091203Device inactive
The indicated device is not currently active.
4091204Invalid firmware version
The provided firmware version is not valid.
4091205Duplicate devices
Multiple device records were found for the given identifier.
4091206Duplicate devices
Multiple device records were found for the given identifier.
4091207Invalid inject key
The provided inject key is not correct.
4091208Invalid PIN key
The provided PIN key is not correct.
4001301No data provided
No data was supplied for encryption.
4091302Partial decryption failure
One or more encrypted values failed to decrypt; check the decrypted items for specific error details.
4091303Decryption failed
All encrypted values failed to decrypt.
5031305Service unavailable
A required downstream service is unavailable or not responding.
4091401Missing name
Decryption failed because no name was
4091402Missing value
Decryption failed because no value was provided.
4001403Insufficient data
Decryption failed because required decryption parameters were not
4091404Decryption failed
Decryption failed due to an unspecified
4091405Unencrypted card data
Card data was transmitted without
4091406No card data found
No credit card data was present in the decrypted result.
4001409Invalid CBC vector
The CBC vector must be an 8-byte binary string.
4001410Missing client ID
A required client ID was not provided.
5031501MQTT error
An unexpected error occurred while communicating with the MQTT service. Please try again later.
4001601Invalid encrypted value
The encrypted value is outside the allowed range.
4001602Invalid decrypted value
The decrypted value is outside the allowed range.
4001603Invalid reference
The reference value is not valid.
4001604Invalid IP address
The provided IP address is not valid.
4001605Invalid complete value
The complete value is not valid.
4001801Missing KSI
A required KSI value was not provided.
4041802Inject key not found
The requested inject key could not be found.
4041803Missing key index
A required key index was not provided.
4001804Missing key type
A required key type was not provided.
4091805Multiple inject keys found
Multiple inject keys matched the request.
4001901Insufficient PIN data
Insufficient data was provided for PIN translation.
5001902PIN translation failed
PIN translation failed due to an internal error.
5001903Legacy PIN translation failed
PIN translation failed using the legacy method.
4001904No PIN data provided
No PIN block was provided.
4001905Missing client ID
A required client ID was not provided.
5001911Key import failed
The key import operation failed.