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 | 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. |
Updated about 2 months ago