Status Event Codes

Applies to: Capture

This page describes possible status event codes that are returned during the identity validation transaction workflow with Capture.

👍

Applies to Capture only. Does not apply to Direct.

Status event code categories

The codes are categorized as follows:

100s, 10xx. Events for transaction details, URLs, and Telesign events.

11xx Landing. Events for initialization and setup.

12xx Capture Front. Events that track the status of the frontside capture.

13xx Capture Back. Events that track the status of the backside capture.

14xx Capture Barcode. Events that track the status of the barcode scan.

15xx Biometrics. Events that track biometric policy review.

16xx Capture Selfie. Events that track the status of selfie capture.

18xx Complete. Events that track the complete page.

19xx, 20xx Failure. Events that track errors, denials, timeouts, and other drop-off events.

Postback responses and polling requests

Status event codes are returned either by a postback response or alternatively by polling requests.

  • Postback response (preferred) - The status_url location, as specified in the /start request body, provides a postback response endpoint. The advantage to this approach is real-time updates. Your client receives immediate notifications when events occur. This is the preferred method for gathering status event codes.
  • Polling requests (alternative) - The /get-status endpoint provides an alternative approach to poll for status event codes. The disadvantage to this approach is its inefficiency. Frequent requests must be made, even when no updates are available.

Example status event code log

Status event codes are returned in reverse chronological order with the newest status event code at the top of the list.

The following text shows a sample status event code log from the status_url endpoint for a one-step (barcode only) identity validation transaction workflow.

{
  "public_data": {
    "version": "3.5.8",
    "endpoint": "postback"
  },
  "private_data": {
    "transaction_id": "a6e7c62a-0af0-4a03-9662-131557613d87",
    "status": [
      {
        "event": 1800,
        "sequence": "2024-06-21 16:52:12.309000+00:00",
        "timestamp": "2024-06-21 16:52:12.309000+00:00",
        "message": "Complete - User navigates to complete page",
        "url": "{\"href\":\"https://capture.intellicheck.com/complete?token=a6e7c62a-0af0-4a03-9662-131557613d87&version=default&language=en-us\",\"protocol\":\"https:\",\"host\":\"capture.intellicheck.com\",\"hostname\":\"capture.intellicheck.com\",\"port\":\"\",\"pathname\":\"/complete\",\"search\":\"?token=a6e7c62a-0af0-4a03-9662-131557613d87&version=default&language=en-us\",\"hash\":\"\",\"origin\":\"https://capture.intellicheck.com\",\"ancestorOrigins\":{}}",
        "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1"
      },
      {
        "event": 1825,
        "sequence": "2024-06-21 16:52:11.977000+00:00",
        "timestamp": "2024-06-21 16:52:11.977000+00:00",
        "message": "Complete - User ended transaction",
        "url": "N/A",
        "user_agent": "N/A"
      },
      {
        "event": 1425,
        "sequence": "2024-06-21 16:52:10.476000+00:00",
        "timestamp": "2024-06-21 16:52:10.476000+00:00",
        "message": "Capture Barcode - /submit/barcode API call made",
        "url": "N/A",
        "user_agent": "N/A"
      },
      {
        "event": 1425,
        "sequence": "2024-06-21 16:52:09.722000+00:00",
        "timestamp": "2024-06-21 16:52:09.722000+00:00",
        "message": "Capture Barcode - /submit/barcode API call made",
        "url": "N/A",
        "user_agent": "N/A"
      },
      {
        "event": 1410,
        "sequence": "2024-06-21 16:52:02.193000+00:00",
        "timestamp": "2024-06-21 16:52:02.193000+00:00",
        "message": "Capture Barcode - Barcode is captured",
        "url": "{\"href\":\"https://capture.intellicheck.com/barcode?token=a6e7c62a-0af0-4a03-9662-131557613d87&version=default&language=en-us\",\"protocol\":\"https:\",\"host\":\"capture.intellicheck.com\",\"hostname\":\"capture.intellicheck.com\",\"port\":\"\",\"pathname\":\"/barcode\",\"search\":\"?token=a6e7c62a-0af0-4a03-9662-131557613d87&version=default&language=en-us\",\"hash\":\"\",\"origin\":\"https://capture.intellicheck.com\",\"ancestorOrigins\":{}}",
        "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1"
      },
      {
        "event": 1400,
        "sequence": "2024-06-21 16:52:02.182000+00:00",
        "timestamp": "2024-06-21 16:52:02.182000+00:00",
        "message": "Capture Barcode - User navigates to barcode page",
        "url": "{\"href\":\"https://capture.intellicheck.com/barcode?token=a6e7c62a-0af0-4a03-9662-131557613d87&version=default&language=en-us\",\"protocol\":\"https:\",\"host\":\"capture.intellicheck.com\",\"hostname\":\"capture.intellicheck.com\",\"port\":\"\",\"pathname\":\"/barcode\",\"search\":\"?token=a6e7c62a-0af0-4a03-9662-131557613d87&version=default&language=en-us\",\"hash\":\"\",\"origin\":\"https://capture.intellicheck.com\",\"ancestorOrigins\":{}}",
        "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1"
      },
      {
        "event": 1190,
        "sequence": "2024-06-21 16:52:02.164000+00:00",
        "timestamp": "2024-06-21 16:52:02.164000+00:00",
        "message": "Landing - User clicks start button",
        "url": "{\"href\":\"https://capture.intellicheck.com/?token=a6e7c62a-0af0-4a03-9662-131557613d87&version=default&language=en-us\",\"protocol\":\"https:\",\"host\":\"capture.intellicheck.com\",\"hostname\":\"capture.intellicheck.com\",\"port\":\"\",\"pathname\":\"/\",\"search\":\"?token=a6e7c62a-0af0-4a03-9662-131557613d87&version=default&language=en-us\",\"hash\":\"\",\"origin\":\"https://capture.intellicheck.com\",\"ancestorOrigins\":{}}",
        "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1"
      },
      {
        "event": 1180,
        "sequence": "2024-06-21 16:51:55.121000+00:00",
        "timestamp": "2024-06-21 16:51:55.121000+00:00",
        "message": "Landing - /submit/ipqs-trackerid API call made",
        "url": "N/A",
        "user_agent": "N/A"
      },
      {
        "event": 1100,
        "sequence": "2024-06-21 16:51:52.254000+00:00",
        "timestamp": "2024-06-21 16:51:52.254000+00:00",
        "message": "Landing - User has opened text link",
        "url": "{\"href\":\"https://capture.intellicheck.com/?token=a6e7c62a-0af0-4a03-9662-131557613d87&version=default&language=en-us\",\"protocol\":\"https:\",\"host\":\"capture.intellicheck.com\",\"hostname\":\"capture.intellicheck.com\",\"port\":\"\",\"pathname\":\"/\",\"search\":\"?token=a6e7c62a-0af0-4a03-9662-131557613d87&version=default&language=en-us\",\"hash\":\"\",\"origin\":\"https://capture.intellicheck.com\",\"ancestorOrigins\":{}}",
        "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1"
      }
    ]
  }
}

Status event code list

The following table shows status event codes and corresponding event messages grouped by page type.

Page

Status Event Code

Event Message

Transaction

100

Transaction type: Portal.

Transaction

105

Transaction type: Capture.

Transaction

110

Transaction type: Direct.

Transaction

405

Message type: <(sms, link, whatsapp, etc.)>

Transaction

500

Document type: Not found.

Transaction

505

Document type: NA_DL.

Transaction

510

Document type: Passport.

Transaction

515

Document type: Other.

(Deprecated) Transaction

1000

Transaction - Transaction started.

Transaction

1001

URL <client url>

Transaction

1002

User Agent <client user agent>




Landing

1100

User has opened text link.

Landing

1101

Company configured to skip Landing page.

Landing

1105

/user/get-config API call made.

Landing

1110

User taps Privacy Policy link.

Landing

1140

Capture requirements include front.

Landing

1141

Capture requirements include back.

Landing

1142

Capture requirements include barcode.

Landing

1143

Capture requirements include selfie.

Landing

1180

/submit/ipqs-trackerid API call made.

Landing

1190

User clicks start button.




Capture Front

1200

User navigates to front page.

Capture Front

1205

Capture component initializes.

Capture Front

1206

Capture component fails to initialize.

Capture Front / Capture Back

1207

Capture component camera permissions presented to user.

Capture Front / Capture Back

1208

Capture component camera permissions accepted by user.

Capture Front

1210

Front image is captured.

Capture Front

1215

User taps retake image button.

Capture Front

1220

User taps use image button.

Capture Front

1225

/submit/front API call made.




Capture Back

1300

User navigates to back page.

Capture Back

1305

Capture component initializes.

Capture Back

1306

Capture component fails to initialize.

Capture Back

1310

Back image is captured.

Capture Back

1315

User taps retake image button.

Capture Back

1320

User taps use image button.

Capture Back

1325

/submit/back API call made.




Capture Barcode

1400

User lands on barcode page.

Capture Barcode

1405

Capture component initializes.

Capture Barcode

1406

Capture component fails to initialize.

Capture Barcode

1410

Barcode is captured.

Capture Barcode

1425

/submit/barcode API call made.




Biometrics Accept

1500

User navigates to biometric permission page.

Biometrics Accept

1510

User taps Biometric Policy link.

Biometrics Accept

1515

User taps Cancel button.

Biometrics Accept

1520

User taps Continue button.




Capture Selfie

1615

Selfie camera permissions presented.

Capture Selfie

1620

Selfie camera permissions accepted.

Capture Selfie

1625

/submit/selfie API call is made.

Capture Selfie

1630

AuthID missing generated URL.




Complete

1800

User lands on complete page.

Complete

1805

User navigates to supplied redirect URL.

Complete

1810

Something went wrong redirecting to the supplied redirect URL.

Complete

1825

Transaction ended – processing result.

Complete

1830

Transaction processed after abandonment.




404

1900

User navigates to 404 page.

404

1910

User taps Back to Capture button.

Camera Access Denied

1920

User navigates to Camera Access Denied page.

Camera Access Denied

1925

User taps Back to Capture button.

Biometrics Denied

1940

User navigates to Biometrics Denied page.

Biometrics Denied

1945

User taps Back to Biometrics button.

Timeout

1990

User navigates to Timeout page.

Timeout

1995

User navigates to supplied error redirect URL.

Timeout

2000

Something went wrong redirecting to supplied error redirect URL.