Status State Model Action Description

ID_VERIFICATION_REQUIRED

  • verifyAppName
  • qrUrl
  • verificationCode
  • errorDetails
  • poll
  • cancelAuthentication
Indicates that verification is required. This state is the first state returned from the adapter.

ID_VERIFICATION_IN_PROGRESS

  • poll
Indicates that ID verification is in progress.

ID_VERIFICATION_COMPLETED

  • continueAuthentication
Indicates that ID verification completed successfully.

ID_VERIFICATION_FAILED

  • errorDetails
  • cancelAuthentication
Indicates that ID verification failed and a retry is not allowed.

ID_VERIFICATION_TIMED_OUT

  • retryVerification
  • cancelAuthentication
Indicates that ID verification timed out.
Action Action Model Error Description

poll

(void)

Gets the current ID transaction status.

retryVerification

(void)

Retries verification after a time out.

Retry must be enabled in the adapter instance configuration.
Attribute name Type Description

verifyAppName

String

The name of the verification app.

This name is provided from the Verify App Name field in the adapter instance configuration.

You can use this name to help customers find the right verification app in the Google Play Store or Apple App Store.

qrUrl

String

The URL of the QR code image associated with the verification session.

Use this URL to show the QR code to the user. The user scans the QR code with the verification app to begin the verification process.

To display the QR code, your app needs to perform a GET request to the URL provided in qrUrl. Include an <img> element, and use the result of the GET request as the source.

For example:

QR URL provided by PingFederate:
"qrUrl":"https://api.pingone.com/v1/idValidations/shortcode/008030285946/qr"
GET request to get the QR code image:
GET "https://api.pingone.com/v1/idValidations/shortcode/008030285946/qr"
GET request response:
data:image/jpeg;base64,9j4AAQSkZJRgABAgAAAQABAAD
IsIxwcKDcpLDAxNDQ0Hyc5PTgyPC4zNDL...2wBDAQkJCQwL
DBgNDRgyIRwhMjIyMjIyMj
HTML element that displays the image in your app:
<img src="data:image/jpegbase64,9j4AAQSkZJRgABAgAAAQABAAD
IsIxwcKDcpLDAxNDQ0Hyc5PTgyPC4zNDL...2wBDAQkJCQwL
DBgNDRgyIRwhMjIyMjIyMj"/>

verificationCode

String

A code that the user can enter instead of scanning the QR code image.

errorDetails

List<CustomAuthnErrorDetail>

A list of errors.