pollPushStatus response

The pollPushStatus response returns the status of the request to obtain the status of a push request.
pollPushStatus output fields provides details about the
pollPushStatus
output fields.
pollPushStatus output fields
Output Field
Required?
Type
Purpose
requestID
Y
string
The
requestId
sent with the
pollPushStatus
request.
status
Y
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 is an error message.
authnTime
N
Datetime
Date and time stamp identifying when the VIP mobile push transaction was approved or denied by the user (in GMT format). Only returned if the transaction was approved or denied.
transactionStatus
Y
list
Status of the mobile push transaction previously sent using either
authenticateUserWithPush
or
authenticateCredentials
.
deviceInfo
Y
string
Includes as much of the following information about the health status and security status of the device as can be captured.
  • os
    : (iOS or Android) The device operating system
  • osVersion
    : (iOS or Android) The version of the device operating system
  • vipAccessVersion
    : (iOS or Android) The version of VIP Access app installed
  • malwareDetected
    : (Android only) Returns
    true
    if malware is present on the device. Not returned if malware is not present.
  • rootDetected
    : (iOS or Android) Returns
    true
    if the device has been rooted or jailbroken. Not returned if the device has not been rooted or jailbroken.
The
deviceInfo
field is only returned if all of the following conditions are met:
  • The
    authenticateUsersWithPush
    or
    authenticateCredentials
    call includes the
    includeDeviceInfo
    flag.
  • The user has approved or rejected the push notification.
  • A supported version of the VIP Access client is installed on the user's device to capture the information.
payloadSignature
N
string
If you have integrated VIP SDK version 3.0.2 or later with your client app and sent an encrypted transaction method using the
authenticateCredentials
call, this is the signature of the following information in one concatenated string. The signature is generated by the client app using the private key on the mobile device.
  1. the clear text version of the display message you sent in the
    EncryptedDisplayParameters
    field of the
    authenticateCredentials
    call.
  2. the credential ID
  3. the transaction ID returned in the authenticateCredentials response
  4. approval status (Y or N)
To verify the integrity of the encryption, validate the signature using this text string and the public key returned from the
getCredentialInfo
or
getUserInfo
call.
pubkeyHash
N
If you have integrated VIP SDK version 3.0.2 or later with your client app and sent an encrypted transaction method using the
authenticateCredentials
call, this is a copy of the
pubkeyHash
value that you sent in the
authenticateCredentials
call.
algName:
N
If you have integrated VIP SDK version 3.0.2 or later with your client app and sent an encrypted transaction method using the
authenticateCredentials
call, this is algorithm name that you sent in the
authenticateCredentials
call.