Here we mention possible statuses, explanatory status codes, CDD Report availability, and risk codes for the Fourtline Identity Verification method.
Identity Verification Statuses
The following statuses are applicable to each identity verification:
| Status | Guidance |
|---|---|
| new | Description: The workflow is successfully created. Action: • SDK integration: Wait for the next status. |
| pending | Description: We are validating the data. Action: Wait for the next status. Status code: 1000 |
| inconsistent_data | Description: We found inconsistent data. Action: Create a new workflow Status codes: 2000 – 3000 series |
| invalid_data | Description: We found invalid or missing data. Action: Create a new workflow Status codes: 1001 – 1999 |
| completed | Description: We have processed the case. For our recommendation to accept or reject the user, see the risk code. Risk codes: • 200 – 500: 100 series status codes • 500: 4000 – 5000 series status codes Action: Download the CDD report |
Risk codes
Possible risk codes include:
| Risk code | Risk score |
|---|---|
| 200 | completed_low_risk |
| 300 | completed_medium_risk |
| 400 | completed_high_risk |
| 500 | completed_unacceptable_risk |
Identity Verification Status Codes
All status codes described below are applicable for the identity verifications.
100: AML screening
This series can accompany completed status and includes:
| Status code | Description |
|---|---|
| 100 | False positive sanctions hit |
| 102 | False positive sensitivity list hit |
| 110 | False positive PEP hit |
| 120 | Confirmed PEP hit |
| 130 | Elevated risk indicators checked |
| 140 | Potential sanctions hit |
| 141 | Potential PEP hit |
1000: Identity data
This series can accompany invalid_data status (except for 1000, which accompanies pending status) and includes:
| Status code | Guidance |
|---|---|
| 1000 | Description: Data successfully validated |
| 1004 | Description: person.type invalid Action: Update the identity data, setting person.type to naturalPerson or legalPerson. |
| 1005 | Description: person.fullName invalid or missing Action: Update the identity data, setting the person.fullName format to only contain alphabetical characters, spaces, hyphens, and apostrophes. |
| 1006 | Description: person.firstName invalid or missing Action: Update the identity data, setting the person.firstName format to only contain alphabetical characters, spaces, hyphens, and apostrophes. |
| 1007 | Description: person.lastName invalid or missing Action: Update the identity data, setting the person.lastName format to only contain alphabetical characters, spaces, hyphens, and apostrophes. |
| 1008 | Description: person.gender invalid or missing Action: Update the identity data, setting person.gender to Female, Male, Other, or Unknown (case sensitive). |
| 1009 | Description: person.nationality invalid or missing Action: Update the identity data, setting person.nationality to a valid ISO_3166-1 alpha-3 country code. |
| 1010 | Description: person.birthDate invalid or missing Action: Update the identity data, setting person.birthDate to a valid date in YYYY-MM-DD format. |
| 1011 | Description: address.country invalid or missing Action: Update the identity data, setting address.country to a valid ISO_3166-1 alpha-3 country code. |
| 1012 | Description: emailAndPhone.email invalid or missing Action: Update the identity data, setting emailAndPhone.email to a valid email address including an @ character. |
| 1013 | Description: emailAndPhone.mobile invalid or missing Action: Update the identity data, setting emailAndPhone.mobile to a valid mobile phone number including the country code and beginning with 00 or + without spaces. Example: 0031201234567 or +31201234567 |
| 1014 | Description: address.streetNumber invalid or missing Action: Update the identity data, setting address.streetNumber to an integer greater than or equal to zero. |
| 1015 | Description: address.street invalid or missing Action: Update the identity data, setting address.street with only alphabetical characters, spaces, hyphens, and apostrophes. |
| 1016 | Description: address.postalCode invalid or missing Action: Update the identity data, setting address.postalCode. |
| 1017 | Description: address.city invalid or missing Action: Update the identity data, setting the address.city format to only contain alphabetical characters, spaces, hyphens, and apostrophes. |
| 1018 | Description: kycDocument.documentType missing Action: Update the identity file, setting kycDocument.documentType. |
| 1021 | Description: person.nationality not supported for this document type Action: Ask the user to use a supported ID document for their nationality. |
| 1022 | Description: ID document missing Action: Upload an ID document. |
| 1023 | Description: Selfie photo missing Action: Upload a selfie photo. |
| 1024 | Description: ID document photo(s) missing or inconsistent Action: Upload new document photos. |
| 1025 | Description: All riskRequirement parameters are required Action: Update the identity data, setting all riskRequirement parameters. |
| 1031 | Description: Identity data too old Action: Upload new identity data. |
| 1032 | Description: User not a natural person Action: Update the identity data, setting person.type to Natural Person. |
| 1033 | Description: person.fullName format invalid Action: Update the identity data, making sure person.fullName consists of at least 2 words. |
| 1034 | Description: Underage user Action: None. You can't retry. |
| 1035 | Description: Ineligible user Action: None. You can't retry. |
| 1036 | Description: ID document number already used Action: Upload a new ID document. |
| 1037 | Description: kycDocument.documentNumber missing Action: Update the identity file, setting kycDocument.documentNumber. |
| 1100 | Description: Second ID document missing Action: Upload a second ID document. |
| 1201 | Description: User not successfully verified Action: Create a new workflow for Identity Verification. |
| 1277 | Description: previousDocumentData missing Action: Update the identity data, providing the previousDocumentData. |
| Description: User has no successful AML-compliant Identity Verification case | |
| 1278 | Description: previousDocumentData incomplete Action: Update the identity data, providing the previousDocumentData. |
| 1279 | Description: previousDocumentData incomplete Action: Update the identity data, providing all required previousDocumentData. |
3000: Sendbacks
This series can accompany inconsistent_data status and includes:
| Status code | Guidance |
|---|---|
| 3001 | Description: person.nationality doesn't match user input Action: Update the user's nationality. |
| 3002 | Description: person.placeOfBirth doesn't match user input Action: Update the user's place of birth. |
| 3003 | Description: person.birthDate doesn't match user input Action: Update the user's birth date. |
| 3005 | Description: person.gender doesn't match user input Action: Update the user's gender. |
| 3100 | Description: Selfie photo too bright Action: Upload a new selfie. |
| 3101 | Description: Selfie photo too dark Action: Upload a new selfie. |
| 3102 | Description: Selfie photo too blurry Action: Upload a new selfie. |
| 3103 | Description: Selfie photo poor quality Action: Upload a new selfie. |
| 3104 | Description: Selfie photo inadequate Action: Upload a new selfie. |
| 3105 | Description: Selfie doesn’t match ID document portrait Action: Create a new workflow for Identity Verification. |
| 3106 | Description: Inadequate input Action: Create a new workflow for Identity Verification. |
| 3107 | Description: Face not fully visible or within frame Action: Upload a new selfie. |
| 3108 | Description: Selfie photo GDPR breach Action: Upload a new selfie. |
| 3200 | Description: ID document photo too bright Action: Upload a new ID document. |
| 3201 | Description: ID document photo too dark Action: Upload a new ID document. |
| 3202 | Description: ID document photo too blurry Action: Upload a new ID document. |
| 3203 | Description: ID document photo poor quality Action: Upload a new ID document. |
| 3204 | Description: Expired ID document Action: Upload a new ID document. |
| 3205 | Description: Invalid ID document Action: Upload a new ID document. |
| 3206 | Description: ID document photo of a photocopy or screen Action: Upload a new ID document. |
| 3207 | Description: ID document photo obscured Action: Upload a new ID document. |
| 3208 | Description: ID document in inadequate condition Action: Upload a new ID document. |
| 3209 | Description: Issuing country not supported Action: Upload a new ID document. |
| 3210 | Description: Nationality not supported Action: Upload a new ID document. |
| 3211 | Description: ID document out of frame Action: Upload a new ID document. |
| 3212 | Description: ID document in plastic cover Action: Upload a new ID document. |
| 3213 | Description: ID document photo GDPR breach Action: Upload a new ID document. |
| 3250 | Description: Security features not visible Action: Upload a new ID document. |
| 3300 | Description: Unclear if legal name provided by user matches ID document Action: Update the user's full name. |
| 3304 | Description: Photos of required ID document sides missing Action: Provide the required number of photos for the document type. |
| 3305 | Description: ID document number doesn't match user input Action: Update the document number. |
| 3306 | Description: ID document issue date doesn't match user input Action: Update the issue date. |
| 3307 | Description: ID document expiry date doesn't match user input Action: Update the expiry date. |
| 3400 | Description: Second ID document photo too bright Action: Upload a new second document. |
| 3401 | Description: Second ID document photo too dark Action: Upload a new second document. |
| 3402 | Description: Second ID document photo too blurry Action: Upload a new second document. |
| 3403 | Description: Second ID document photo poor quality Action: Upload a new second document. |
| 3404 | Description: Expired second ID document Action: Upload a new second document. |
| 3405 | Description: Invalid second ID document Action: Upload a new second document. |
| 3406 | Description: Second ID document photo of a photocopy or screen Action: Upload a new second document. |
| 3407 | Description: Second ID document photo obscured Action: Upload a new second document. |
| 3408 | Description: Second ID document in inadequate condition Action: Upload a new second document. |
| 3409 | Description: Second ID document out of frame Action: Upload a new second document. |
| 3500 | Description: Geolocation not provided Action: Upload a new selfie with the geolocation. |
| 3505 | Description: Not the same person Action: Upload a new ID document and selfie. |
| 3510 | Description: Geolocation not supported Action: Upload a new selfie with the geolocation. |
| 3520 | Description: Photo metadata inconsistent Action: Upload a new document and selfie. |
| 3521 | Description: Video metadata inconsistent Action: Upload a new document and selfie. |
| 3540 | Description: Device metadata inconsistent |
| 3541 | Description: Device model inconsistent Action: Upload a new document and selfie. |
| 3542 | Description: Device language inconsistent Action: Upload a new document and selfie. |
| 3543 | Description: Device geolocation inconsistent Action: Upload a new document and selfie. |
| 3560 | Description: Invalid IP address Action: Provide a valid IP address. |
| 3600 | Description: Selfie video too bright Action: Upload a new selfie video. |
| 3601 | Description: Selfie video too dark Action: Upload a new selfie video. |
| 3602 | Description: Selfie video too blurry Action: Upload a new selfie video. |
| 3603 | Description: Selfie video poor quality Action: Upload a new selfie video. |
| 3604 | Description: Selfie video GDPR breach Action: Upload a new selfie video. |
| 3610 | Description: Selfie video inadequate Action: Upload a new selfie video. |
| 3620 | Description: Liveness features not visible Action: Upload a new selfie video. |
| 3700 | Description: Insufficient data Action: Create a new workflow for Identity Verification. |
4000: Rejections
The user can't retry.
This series can accompany completed status and includes:
| Status code | Description |
|---|---|
| 4110 | Confirmed sanctions hit |
| 4112 | Confirmed sensitivity list hit |
| 4120 | Underage user |
| 4130 | Unacceptable risk score |
| 4135 | Unacceptable combination of data points |
| 4140 | Country of residence not supported |
| 4145 | Geolocation prohibited |
| 4150 | Issuing country prohibited |
| 4155 | Nationality prohibited |
| 4160 | Hits above agreed threshold |
| 4170 | High-risk IP address |
| 4171 | High-risk country phone code |
| 4172 | High-risk country of residence |
| 4173 | High-risk geolocation |
| 4190 | Rejected (other) |
| 4192 | Selfie video rejected |
| 4200 | Unacceptable third-party involvement in selfie photo |
| 4202 | Unacceptable third-party involvement in selfie video |
| 4211 | Unacceptable third-party involvement in ID document photo |
| 4310 | Birth date doesn't match previous ID document |
| 4311 | Place of birth doesn't match previous ID document |
| 4400 | Name on ID document doesn't match user input |
5000: Fraud
The user can't retry.
This series can accompany completed status and includes:
| Status code | Description |
|---|---|
| 5100 | Tampered-with ID document |
| 5150 | Counterfeit ID document |
| 5200 | Tampered-with selfie photo |
| 5201 | Selfie photo is of another photo |
| 5202 | Impersonation |
| 5210 | Biometrics match known fraudster |
| 5400 | Fraudulent address |
| 5600 | Selfie video is of a video or a photo |
| 5601 | User in selfie video doesn’t match ID document |
| 5602 | User in selfie video wearing a mask |
| 5610 | Fraudulent selfie video |
| 5900 | Fraud (other) |