Documentation Index
Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
Use this file to discover all available pages before exploring further.
Overview
KYC validation branches into Reject / Retry / Warning based on the result. Warning skips only the affected check and continues the KYC flow — nothing is blocked and the user is not asked to retake the photo; only a record is left.The accumulated Warning records appear in thewarning[] array of the GET Submission API response. Each element contains the fields userDataType, relatedEngine, and occurrenceTime. Customers can pick these values up with the “Warning Occurred” trigger in Custom Policy to apply post-processing such as ARGOS Score deductions, Pending status, or Reject.This page lists the 11 WarningOccurred values produced by the liveform, grouped by the mechanism that generates them, the field combination each value exposes in warning[], and the dashboard option that controls it.warning[] Field Schema
| Field | Type | Description |
|---|---|---|
warning[i].userDataType | String | Type of input data that triggered the warning (e.g. ID Card, ID_card_uploaded, User Input) |
warning[i].relatedEngine | String | Name of the engine or validation stage that produced the warning |
warning[i].occurrenceTime | String | Time the warning was raised (ISO 8601) |
For the full response field definitions, see GET Submission response fields.
Group A — ID Liveness Upload-mode Warnings
In the ID Liveness policy, when a pipeline (Screen replay / Paper printed / Replace portraits) is set to Retry and the sub-option “Apply Warning on Upload” is enabled, the Retry decision is converted to a Warning only when the user submitted via Upload mode. Upload mode does not allow re-capture, so the flow continues with a Warning instead of forcing a Retry.| WarningOccurred | Pipeline | Trigger condition | userDataType | relatedEngine |
|---|---|---|---|---|
id_liveness_screen_replay | Screen replay | Screen replay pipeline hits Retry, submission via Upload mode | ID_card_uploaded | ID Liveness Screen replay |
id_liveness_paper_printed | Paper printed | Paper printed pipeline hits Retry, submission via Upload mode | ID_card_uploaded | ID Liveness Paper printed |
id_liveness_replace_portraits | Replace portraits | Replace portraits pipeline hits Retry, submission via Upload mode | ID_card_uploaded | ID Liveness Replace portraits |
Group B — Expiry-validation Warnings
When the dashboard option for ID expiry / passport stay expiry is set to Warning, the submission is not auto-rejected; instead it is Approved with a Warning record.| WarningOccurred | Trigger condition | userDataType | relatedEngine |
|---|---|---|---|
expired_id | The Expired ID option is set to Warning, and either the OCR expiry date or the user-input expiry date is in the past — Step 1 / Step 2 expiry blocking is bypassed | ID Card / User Input | Expiry validation |
gov_verification_passport_expired_stay | Korean government verification finds the passport’s stay-period expiry (expiryDateOfStayKor, registered with the Ministry of Justice) is in the past | User Input | KOR Gov Passport stay expiry |
Group C — Engine-error Warning Conversion
For ID Liveness · Selfie Passive Liveness · Korean government verification engines, the dashboard provides an Error Handling Method setting. When this is set to Warning the flow does not redirect to the engine-specific error page (SE-5002x / SE-5003x); the affected check is skipped and a Warning record is left instead.| WarningOccurred | Mapped error code | Engine |
|---|---|---|
id_liveness_engine_error_warning | SE-50020 | ID Liveness |
selfie_liveness_engine_error_warning | SE-50021 | Selfie Passive Liveness |
kor_gov_rrc_error_warning | SE-50030 | KOR government verification — Resident Registration Card |
kor_gov_drvlic_error_warning | SE-50031 | KOR government verification — Driver’s License |
kor_gov_passport_error_warning | SE-50032 | KOR government verification — Passport |
kor_gov_foreign_error_warning | SE-50033 | KOR government verification — Alien Registration Card |
Face Compare engine errors (
SE-50022) are Error-only and cannot be converted to Warning. Matching the selfie to the ID photo is core to KYC integrity, so no skip branch is provided.Using Warnings in Custom Policy
Each item recorded inwarning[] can be picked up by the Custom Policy → Trigger → “Warning Occurred” condition in the KYC Process dashboard, and acted on with a post-processing step.Matching conditions
Conditions are built from combinations ofuserDataType and relatedEngine. Examples:| Match target | Meaning |
|---|---|
userDataType = ID Card, relatedEngine = Expiry validation | Warning raised from ID-document OCR expiry date |
userDataType = ID_card_uploaded, relatedEngine = ID Liveness Screen replay | Screen-replay liveness Warning produced by Upload-mode submission |
relatedEngine = SE-50020 (or engine name ID Liveness) | ID Liveness engine-error Warning conversion |
Applicable post-actions
- ARGOS Score deduction (e.g. -10 to -30)
- Switch the result to Pending for manual admin review
- Reject the submission
- Default pass-through (when no policy applies)
The Trigger list, operators, and action composition in Custom Policy are documented in the KYC Process dashboard guide.
Related Documents
- GET Submission response fields —
warning[]schema and other response fields - Error codes and pages — SE error pages used when Error Handling Method is set to Error
- Reject codes and Retry codes — Reject and Retry branch codes
- April 2026 update — Introduction of Expired ID / ID Liveness Upload-mode Warning
- May 2026 update — Introduction of engine-error Warning conversion