Status codes

Here we mention possible statuses, explanatory status codes, CDD Report availability, and risk codes for the Fourthline 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:

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 Action: Upload a new document and selfie.
`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:

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:

Code	Description
`5100`	Tampered-with ID document
`5150`	Counterfeit ID document
`5200`	Tampered-with selfie photo
`5201`	Selfie is of another photo
`5202`	Impersonation
`5210`	Biometrics match known fraudster
`5400`	Fraudulent address
`5600`	Selfie video is a video or 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)