denyRisk response

The denyRisk response returns the status of the denyRisk request.
denyRisk
output fields
lists details about the
denyRisk
output fields.
denyRisk
output fields
Output Field
Required?
Type
Purpose
status
Y
hex string
Unique status code.
0000=Success
. Any other value is an error.
statusMessage
Y
String
Message corresponding to the status of the request. If the status is not
0000
(success), this message is an error message.
requestId
Y
String
The
requestId
sent with the
denyRisk
request.
KeyValuePair
Y
List
List of key and value strings:
  • device.feedback
    Indicates if the device was registered by the user during the denyRisk operation. Value is either true or false.
  • device.feedback.reason
    Provides more information about the device.feedback result.
  • device.friendly.name
    The descriptive name for the device provided by the user during registration. If the user registered the device without providing a friendly name, the default friendly name is used. Only returned if the user registered the device.
  • device.tag.id
    A unique identifier for the device. Value is a string.
Status codes for device.feedback.reason provides details about the status codes that are returned if the denyRisk operation attempts to register a device. Some messages may include additional details about the specific device in the device.feedback.reason response.
Status codes for device.feedback.reason
Status Code
Message
Description
SUCCESS
Device tag hash successfully  matched
The device is successfully registered.
FAILED
Tag redemption failed.
The device could not be registered. Additional reasons are provided, if available.
REMEMBER_DEVICE_NOT_REQUESTED
Remember device not  requested
The device was not registered because the denyRisk request did not include a flag to remember the device (the RememberDevice flag was not sent or was set to "false" in the request).
NO_TAG_PROVIDED
No device tag provided
The device could not be registered because the device tag was not sent in the denyRisk request.
TAG_NOT_FOUND
Provided device tag was not found
The device could not be registered because the device tag sent in the IAAuthData did not match the device tag issued in the EvaluateRisk response for the corresponding EventId. 
This response may also be returned if the device tag is not redeemed by a DenyRisk call within 30 minutes of invoking the EvaluateRisk call with the corresponding EventId.
TAG_EXPIRED
Provided device tag was  expired
The device could not be registered because the device tag that is provided by the device is already expired.
NO_FINGERPRINT
No IAAuthData element was  provided in the request
The device could not be registered because the IAAuthData element was not sent in the denyRisk request, or an empty IAAuthData element was sent.
INVALID_FINGERPRINT
Invalid fingerprint
The device could not be registered because the fingerprint that is sent in the IAAuthData element is not in a valid format.
FINGERPRINT_MISMATCH
Device fingerprint in the request did not match the expected device fingerprint
The device could not be registered because the fingerprint in the IAAuthData element does not match the fingerprint that is provided by the device.
MISSING_ENCRYPTION_KEY
Missing encrypted client key
The device could not be registered because the encryption key was not included in the IAAuthData element.
CLIENT_KEY_DECRYPTION_FAILED
Failed to decrypt the client key
The device could not be registered because the client key could not be decrypted.
AUTHENTICATION_FAILED
Required authentication did not pass
The device could not be registered because the device failed authentication
ISSUED_FOR_ANOTHER_USER
Provided device tag was issued for another user, not the redeemer.
The device could not be registered because the device tag provided by the device was originally attributed to a device owned by a different user.