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.

PageStatus Event CodeEvent Message
Transaction105Transaction type: Capture.
Transaction110Transaction type: Direct.
Transaction405Message type: <(sms, link, whatsapp, etc.)>
Transaction500Document type: Not found.
Transaction505Document type: NA_DL.
Transaction510Document type: Passport.
Transaction515Document type: Other.
(Deprecated) Transaction1000Transaction - Transaction started.
Transaction1001URL <client url>
Transaction1002User Agent <client user agent>
*********
Landing1100User has opened text link.
Landing1101Company configured to skip Landing page.
Landing1105/user/get-config API call made.
Landing1110User taps Privacy Policy link.
Landing1140Capture requirements include front.
Landing1141Capture requirements include back.
Landing1142Capture requirements include barcode.
Landing1143Capture requirements include selfie.
Landing1180/submit/ipqs-trackerid API call made.
Landing1190User clicks start button.
*********
Capture Front1200User navigates to front page.
Capture Front1205Capture component initializes.
Capture Front1206Capture component fails to initialize.
Capture Front / Capture Back1207Capture component camera permissions presented to user.
Capture Front / Capture Back1208Capture component camera permissions accepted by user.
Capture Front1210Front image is captured.
Capture Front1215User taps retake image button.
Capture Front1220User taps use image button.
Capture Front1225/submit/front API call made.
*********
Capture Back1300User navigates to back page.
Capture Back1305Capture component initializes.
Capture Back1306Capture component fails to initialize.
Capture Back1310Back image is captured.
Capture Back1315User taps retake image button.
Capture Back1320User taps use image button.
Capture Back1325/submit/back API call made.
*********
Capture Barcode1400User lands on barcode page.
Capture Barcode1405Capture component initializes.
Capture Barcode1406Capture component fails to initialize.
Capture Barcode1410Barcode is captured.
Capture Barcode1425/submit/barcode API call made.
*********
Biometrics Accept1500User navigates to biometric permission page.
Biometrics Accept1510User taps Biometric Policy link.
Biometrics Accept1515User taps Cancel button.
Biometrics Accept1520User taps Continue button.
*********
Capture Selfie1615Selfie camera permissions presented.
Capture Selfie1620Selfie camera permissions accepted.
Capture Selfie1625/submit/selfie API call is made.
Capture Selfie1630AuthID missing generated URL.
*********
Complete1800User lands on complete page.
Complete1825Transaction ended – processing result.
*********
4041900User navigates to 404 page.
4041910User taps Back to Capture button.
Camera Access Denied1920User navigates to Camera Access Denied page.
Camera Access Denied1925User taps Back to Capture button.
Biometrics Denied1940User navigates to Biometrics Denied page.
Biometrics Denied1945User taps Back to Biometrics button.
Timeout1990User navigates to Timeout page.
Abandoned2000Transaction processed after abandonment.