> ## 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.

# Create and Retry

> The webhook will be triggered upon the submission’s initial creation. Additionally, the event will be triggered if it occurs during the retry of the KYC submission process. 

### Webhook: created

<CodeGroup>
  ```json create-response.json theme={null}
  {
      "webhook_trigger": "created",
      "submission_id": "{submission_id}",
      "kyc_result": {
          "status": "incomplete"
      },
      "cf": {
          "cf1": "{custom_field1}",
          "cf2": "{custom_field2}",
          "cf3": "{custom_field3}"
      },
      "userid": "{user_id}",
      "tokenId": "{token_id}",
      "retryCode": "{retry_code}",
      "attempts": 1,
      "ipAddress": "{ip_address}"
  }
  ```

  ```json create-response-no-retry.json theme={null}
  {
      "webhook_trigger": "created",
      "submission_id": "{submission_id}",
      "kyc_result": {
          "status": "incomplete"
      },
      "cf": {
          "cf1": "{custom_field1}",
          "cf2": "{custom_field2}",
          "cf3": "{custom_field3}"
      },
      "userid": "{user_id}",
      "tokenId": "{token_id}",
      "ipAddress": "{ip_address}"
  }
  ```
</CodeGroup>

<ResponseField name="webhook_trigger" type="string">
  Webhook trigger type - `created` indicates that the submission was created initially.
</ResponseField>

<ResponseField name="submission_id" type="string">
  Unique identifier for each KYC submission
</ResponseField>

<ResponseField name="kyc_result" type="object">
  Object containing KYC submission results, first initial status is created.

  <Expandable title="properties">
    <ResponseField name="status" type="string">
      During KYC submission status is `imcomplete`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="cf" type="object">
  Object containing custom field (cf1, cf2, cf3) data

  <Expandable title="properties">
    <ResponseField name="cf1" type="string">
      Value of custom field 1
    </ResponseField>

    <ResponseField name="cf2" type="string">
      Value of custom field 2
    </ResponseField>

    <ResponseField name="cf3" type="string">
      Value of custom field 3
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="userid" type="string">
  Unique identifier for the KYC submitter defined by the client
</ResponseField>

<ResponseField name="tokenId" type="string">
  Token ID used when submitting via live form in private mode
</ResponseField>

<ResponseField name="retryCode" type="string">
  The code describing the reason behind the retry
</ResponseField>

<ResponseField name="attempts" type="int">
  Attempt to determine the submitter count
</ResponseField>

<ResponseField name="ipAddress" type="string">
  Submitter's IP address
</ResponseField>

### Webhook: retry

```json retry-response.json theme={null}
{
    "webhook_trigger": "retry",
    "submission_id": "{submission_id}",
    "kyc_result": {
        "status": "incomplete"
    },
    "cf": {
        "cf1": "{custom_field1}",
        "cf2": "{custom_field2}",
        "cf3": "{custom_field3}"
    },
    "userid": "{user_id}",
    "tokenId": "{token_id}",
    "ipAddress": "{ip_address}"
    "retryCode": "{retry_code}",
    "attempts": 1
}
```

<ResponseField name="webhook_trigger" type="string">
  Webhook trigger type - `retry` indicates that the retry triggerred during the submission.
</ResponseField>

<ResponseField name="submission_id" type="string">
  Unique identifier for each KYC submission
</ResponseField>

<ResponseField name="kyc_result" type="object">
  <Expandable title="properties">
    <ResponseField name="status" type="string">
      During KYC submission status is `imcomplete`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="cf" type="object">
  Object containing custom field (cf1, cf2, cf3) data

  <Expandable title="properties">
    <ResponseField name="cf1" type="string">
      Value of custom field 1
    </ResponseField>

    <ResponseField name="cf2" type="string">
      Value of custom field 2
    </ResponseField>

    <ResponseField name="cf3" type="string">
      Value of custom field 3
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="userid" type="string">
  Unique identifier for the KYC submitter defined by the client
</ResponseField>

<ResponseField name="tokenId" type="string">
  Token ID used when submitting via live form in private mode
</ResponseField>

<ResponseField name="ipAddress" type="string">
  Submitter's IP address
</ResponseField>

<ResponseField name="retryCode" type="string">
  The code describing the reason behind the retry
</ResponseField>

<ResponseField name="attempts" type="int">
  Attempt to determine the submitter count
</ResponseField>

## Retry Code

| retryCode                        | ID document | Knowledge Based | Description                                                                       |
| -------------------------------- | ----------- | --------------- | --------------------------------------------------------------------------------- |
| recognition\_fail                | O           | X               | The system failed to verify the submitter’s identification.                       |
| expired\_id                      | O           | X               | The ID card is outdated.                                                          |
| document\_expired                | O           | X               | The document is outdated.                                                         |
| invalid\_back\_document          | O           | X               | Front and back side image mismatch.                                               |
| invalid\_dual\_side              | O           | X               | There is an error in the dual-sided document.                                     |
| document\_country\_mismatch      | O           | X               | The document country does not match.                                              |
| glare\_detected                  | O           | X               | Detected glare from id or document                                                |
| image\_too\_blurry               | O           | X               | The image is excessively blurry.                                                  |
| recaptured\_document             | O           | X               | A document that has been recaptured.                                              |
| screen\_detected                 | O           | X               | From the image, a screen was identified.                                          |
| black\_white\_document           | O           | X               | The colour that was detected is exclusively black and white.                      |
| missing\_birth\_date             | O           | X               | The value of the birth date was missed.                                           |
| document\_name\_mismatch         | O           | X               | The name in the document does not match.                                          |
| document\_dob\_mismatch          | O           | X               | The date of birth in the document does not match.                                 |
| image\_forgery                   | O           | X               | The image is fraudulent.                                                          |
| text\_forgery                    | O           | X               | The text is fraudulent.                                                           |
| feature\_verification\_failed    | O           | X               | Verification of the feature was unsuccessful.                                     |
| image\_edited                    | O           | X               | The image is an edited image.                                                     |
| fake\_id                         | O           | X               | The ID is fake.                                                                   |
| artificial\_image                | O           | X               | This is an artificial image.                                                      |
| artificial\_text                 | O           | X               | This is an artificial text.                                                       |
| check\_digit\_failed             | O           | X               | Unable to check the digit.                                                        |
| physical\_document\_missing      | O           | X               | The physical document is missing.                                                 |
| missing\_expiry\_date            | O           | X               | The expiry date data is missing.                                                  |
| missing\_issue\_date             | O           | X               | The issue date data is missing.                                                   |
| missing\_document\_number        | O           | X               | The document number data is missing.                                              |
| missing\_personal\_number        | O           | X               | The personal number(ID number) data is missing.                                   |
| missing\_name                    | O           | X               | The name data is missing.                                                         |
| bank\_authentication\_fail       | O           | X               | Both the authentication code number and name did not match.                       |
| bank\_authentication\_code\_fail | O           | X               | The authentication code number did not match.                                     |
| bank\_authentication\_name\_fail | O           | X               | The name does not match.                                                          |
| blacklist\_country               | O           | O               | The country was identified as a blacklist by the system based on Issuing Country. |
| mrz\_protocol\_fail              | O           | X               | The system was unable to retrieve the appropriate MRZ protocol.                   |
| Identity\_verification\_fail     | O           | X               | System failure to verify ID.                                                      |
| barcode\_protocol\_fail          | O           | X               | The system was unable to retrieve the appropriate barcode.                        |
| no\_face                         | O           | O               | Face cannot be identified                                                         |
| face\_compare\_underscore        | O           | O               | Face compare scores were incapable of attaining a standard.                       |
| face\_compare\_fail              | O           | O               | Unable to continue with the face comparison.                                      |
| face\_occluded                   | O           | O               | Unable to confirm that the face was hidden.                                       |
| Id\_livness\_fail                | O           | X               | The score for ID liveliness was less than what is expected.                       |
| liveness\_error                  | O           | O               | Unable to proceed with the liveness.                                              |
| liveness\_fail                   | O           | O               | The score for passive liveness was less than what is expected.                    |
| liveness\_fail\_active           | O           | O               | The score for active liveness was less than what is expected.                     |
| too\_many\_retry                 | O           | O               | Retry count has already exceeded the maximum.                                     |
| VERIFICATION\_CODE\_MISS\_MATCH  | X           | O               | The verification code does not match the inputted code.                           |