# QES System URLs

### Types

The relevant systemUrl types for QES are "callback" and "redirect." The callback URL is invoked after the process is completed and includes the extID of the corresponding process in the request body. Once the process is finished, the user is redirected to the provided redirect URL.

{% hint style="info" %}
Please note that the "review-callback" type mentioned in the fidentity documentation is not applicable for QES.
{% endhint %}

### Statuses

<table><thead><tr><th width="210">State</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>Created</td><td>This state occurs as soon as a process was set up (successful call).</td><td></td></tr><tr><td>Started</td><td>This state occurs as soon as the user clicks on the link for identification and initiates the process.</td><td></td></tr><tr><td>*Review-pending</td><td>This state occurs when the identification is completed, and the data enters the review phase. Here, the information provided by the user is checked for accuracy.</td><td></td></tr><tr><td>Reviewed</td><td>This state is reached when the review of the provided information is completed, and a final decision (OK or NOK) has been made.</td><td></td></tr><tr><td>Success</td><td>This state is triggered when the document has been successfully signed.</td><td></td></tr><tr><td>Session-expired</td><td>This status indicates processes where the session duration has expired. It occurs four hours after the process was initiated (while in the 'Started' status) or after the third click on the URL (one time token).</td><td></td></tr><tr><td>Abort</td><td>This state occurs when the user prematurely ends the identification process by closing the process (by clicking "abort" (X)).</td><td></td></tr><tr><td>Error</td><td>This state arises when a user is underage, hails from a non-supported country, or if fraud is identified by a review agent. Blocking occurs either after agent review or before the user completes the sign-up process. The verification status is labeled as 'blocked,' and the specific reason for the cancellation is displayed under 'cancelReason.</td><td></td></tr></tbody></table>

The review-pending redirect URLs (inside and outside operation hours can be hard coded, please specify accordingly to fidentity).

{% hint style="info" %}
The "warn" state mentioned in the fidentity documentation is not applicable for QES Hybrid and Review only.
{% endhint %}

### Subtypes

<table><thead><tr><th width="227">Subtype</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>insideOperatingHours</td><td>Configures a redirect during agent review within operation hours. Only applied to type 'redirect' with the state 'review-pending'.</td><td></td></tr><tr><td>outsideOperatingHours</td><td>Configures a redirect during agent review outside operation hours. Only applied to type 'redirect' with the state 'review-pending'.</td><td></td></tr></tbody></table>

<img src="/files/OVXRnvV0lUEQno1UfVIP" alt="System URLs flowchart from user perspective, statuses are indicated in teal. " class="gitbook-drawing">

## Verification states

The relevant verification states for QES come into play when retrieving processes via GET, and are as follows.

<table><thead><tr><th width="250">State</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>Created</td><td>This indicates that the process was created (POST occurred). No further activities have taken place.</td><td></td></tr><tr><td>Started</td><td>This state occurs as soon as the user clicks on the link for identification and initiates the process.</td><td></td></tr><tr><td>Review-pending</td><td>This state occurs when the identification is completed, and the data enters the review phase. Here, the information provided by the user is checked for accuracy.</td><td></td></tr><tr><td>Reviewed</td><td>This state is reached when the review of the provided information is completed, and a final decision (ok or nok) has been made.</td><td></td></tr><tr><td>Processed</td><td>At this state, the process has been successfully completed.</td><td></td></tr><tr><td>Aborted</td><td>This state occurs when the user prematurely ends the identification process by closing the process (by clicking "abort" [X]).</td><td></td></tr><tr><td>Blocked*</td><td>This status is the counterpart of the Error SystemUrl, which can be set at POST. This state arises when a user is underage, hails from a non-supported country, or if fraud is identified by a review agent. Blocking occurs either after agent review or before the user completes the sign-up process. The verification status is labeled as 'blocked,' and the specific reason for the cancellation is displayed under 'cancelReason.</td><td></td></tr><tr><td>Expired</td><td>This status indicates processes where the session duration has expired. It occurs four hours after the process was initiated (while in the 'Started' status) or after the third click on the URL (one time token).</td><td></td></tr></tbody></table>

Please note that the statuses *Processed*, *Aborted*, *Blocked*, and *Expired* represent final processes, meaning they cannot be altered anymore. On the other hand, processes in the *Created*, *Started*, *Review-Pending*, and *Reviewed* statuses can still undergo changes.

<img src="/files/xu3y7Ml5rmqmxYPMOto9" alt="Verification states - happy case (status indicated in teal)." class="gitbook-drawing">

<img src="/files/2FUIpYSh3hOckDLvPstc" alt="Verification states - NOK cases  (status indicated in teal)." class="gitbook-drawing">

<details>

<summary>*Blocked Reasons</summary>

&#x20;(please note that the blocked reasons can be expanded)

1. MAXRESCANREACHED - The user had to rescan the documents for 3 times and still was not successful
2. INVALIDCOUNTRY - The scanned document originates from a country that is blacklisted for this tenant/customer.
3. UNDERAGE – The user is below the defined age limit.
4. DOCUMENTEXPIRED - The scanned document expired.
5. FRAUDDETECTEDBYREVIEW – The agent classified the process as suspected fraud.
6. FRAUDBLOCKLIST - The user appears in a known fraud database.
7. INVALIDCOUNTRYCODE - The scanned document originates from a country that is not supported by fidentity.
8. FRAUDSPECIMEN - The scanned document is identified as a specimen or sample.
9. FRONTBACKVALIDATION - The Front and the Back of the scanned document belongs to the same user.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fidentity.ch/use-cases/qes/qes-system-urls.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.