Identity Verification Statuses

Integrations guide

This page sets out possible statuses, explanatory status codes, CDD Report availability, and risk codes for Identity Verification.

Note
Note
In addition to checking the status in webhook notifications, you can check the status of a specific Identity Verification case any time via a Get case status request.

Statuses

Possible notifications include:

StatusDescriptionAction
newThe workflow is successfully created.Upload the identity data and ID document.
pendingWe are validating the data.Check the case status.
Status code: 1000
inconsistent_dataWe found inconsistent data.Create a new workflow set to IDV.
Status codes: 2000 series – 3000 series
invalid_dataWe found invalid or missing data.Create a new workflow set to IDV.
Status codes: 10011999
completedWe have processed the case.
For our recommendation to accept or reject the client, see the risk code.
Download the CDD Report.
Risk code: 200500
Status codes: 100 series, and for risk code 500: 4000 series – 5000 series

Status flow diagram

The pathways for statuses are as follows:



Risk codes

Possible risk codes include:

Risk codeRisk score
200completed_low_risk
300completed_medium_risk
400completed_high_risk
500completed_unacceptable_risk


Status codes

Statuses can be accompanied by one or multiple of the following status codes:

100: AML screening

This series includes:

Status codeDescription
100False positive sanctions hit
102False positive sensitivity list hit
110False positive PEP hit
120Confirmed PEP hit
130Elevated risk indicators checked
140Potential sanctions hit
141Potential PEP hit

1000: Identity data

This series includes:

Status codeDescriptionAction
1000Data successfully validated
1004person.type invalidUpdate the identity data, setting person.type to naturalPerson or legalPerson.
1005person.fullName invalid or missingUpdate the identity data, setting the person.fullName format to only contain alphabetical characters, spaces, hyphens, and apostrophes.
1006person.firstName invalid or missingUpdate the identity data, setting the person.firstName format to only contain alphabetical characters, spaces, hyphens, and apostrophes.
1007person.lastName invalid or missingUpdate the identity data, setting the person.lastName format to only contain alphabetical characters, spaces, hyphens, and apostrophes.
1008person.gender invalid or missingUpdate the identity data, setting person.gender to Female, Male, Other, or Unknown (case sensitive).
1009person.nationality invalid or missingUpdate the identity data, setting person.nationality to a valid ISO_3166-1 alpha-3 country code.
1010person.birthDate invalid or missingUpdate the identity data, setting person.birthDate to a valid date in YYYY-MM-DD format.
1011address.country invalid or missingUpdate the identity data, setting address.country to a valid ISO_3166-1 alpha-3 country code.
1012emailAndPhone.email invalid or missingUpdate the identity data, setting emailAndPhone.email to a valid email address including an @ character.
1013emailAndPhone.mobile invalid or missingUpdate 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
1014address.streetNumber invalid or missingUpdate the identity data, setting address.streetNumber to an integer greater than or equal to zero.
1015address.street invalid or missingUpdate the identity data, setting address.street with only alphabetical characters, spaces, hyphens, and apostrophes.
1016address.postalCode invalid or missingUpdate the identity data, setting address.postalCode.
1017address.city invalid or missingUpdate the identity data, setting the address.city format to only contain alphabetical characters, spaces, hyphens, and apostrophes.
1018kycDocument.documentType missingUpdate the identity file, setting kycDocument.documentType.
1021person.nationality not supported for this document typeAsk the client to use a supported ID document for their nationality.
1022ID document missing or
tax.countrySubjectToTaxation invalid
Upload an ID document.
Update the identity data, setting the tax.countrySubjectToTaxation format to a valid ISO_3166-1 alpha-3 country code.
1023Selfie photo missingUpload a selfie photo.
1024ID document photo(s) missing or inconsistentUpload new document photos.
1025All riskRequirement parameters requiredUpdate the identity data, setting all riskRequirement parameters.
1031Identity data too oldUpload new identity data.
1032Client not a natural personUpdate the identity data, setting person.type to Natural Person.
1033person.fullName format invalidUpdate the identity data, making sure person.fullName consists of at least 2 words.
1034Underage clientYou can't retry.
1035Ineligible clientYou can't retry.
1036ID document number already usedUpload a new ID document.
1037kycDocument.documentNumber missingUpdate the identity file, setting kycDocument.documentNumber.
1100Second ID document missingUpload a second ID document.
1201Client not successfully verifiedCreate a new workflow set to IDV.
1277previousDocumentData missing or client has no successful AML-compliant Identity Verification caseUpdate the identity data, providing the previousDocumentData.
1278previousDocumentData incompleteUpdate the identity data, providing the previousDocumentData.
1279previousDocumentData incompleteUpdate the identity data, providing all required previousDocumentData.

2000: Home address

This series includes:

Status codeDescriptionAction
2001Invalid addressProvide a valid address.
2002PO box addressProvide a valid non-PO box address.
2003Non-residential addressProvide a valid residential address.
2004Address doesn't match the PoA documentProvide a valid address request, or ask the client for a new official PoA document.

3000: Sendback reasons

This series includes:

Status codeDescriptionAction
3001person.nationality doesn't match client inputUpdate the client's nationality.
3002person.placeOfBirth doesn't match client inputUpdate the client's place of birth.
3003person.birthDate doesn't match client inputUpdate the client's birth date.
3005person.gender doesn't match client inputUpdate the client's gender.
3100Selfie photo too brightUpload a new selfie.
3101Selfie photo too darkUpload a new selfie.
3102Selfie photo too blurryUpload a new selfie.
3103Selfie photo poor qualityUpload a new selfie.
3104Selfie photo inadequateUpload a new selfie.
3105Selfie doesn’t match ID document portraitCreate a new workflow set to IDV.
3106Inadequate inputCreate a new workflow set to IDV.
3107Face not fully visible or within frameUpload a new selfie.
3108Selfie photo GDPR breachUpload a new selfie.
3200ID document photo too brightUpload a new ID document.
3201ID document photo too darkUpload a new ID document.
3202ID document photo too blurryUpload a new ID document.
3203ID document photo poor qualityUpload a new ID document.
3204Expired ID documentUpload a new ID document.
3205Invalid ID documentUpload a new ID document.
3206ID document photo of a photocopyUpload a new ID document.
3207ID document photo obscuredUpload a new ID document.
3208ID document in inadequate conditionUpload a new ID document.
3209Issuing country not supportedUpload a new ID document.
3210Nationality not supportedUpload a new ID document.
3211ID document out of frameUpload a new ID document.
3212ID document in plastic coverUpload a new ID document.
3213ID document photo GDPR breachUpload a new ID document.
3250Security features not visibleUpload a new ID document.
3300Unclear if legal name provided by client matches ID documentUpdate the client's full name.
3304Photos of required ID document sides missingProvide the required number of photos for the document type.
3305ID document number doesn't match client inputUpdate the document number.
3306ID document issue date doesn't match client inputUpdate the issue date.
3307ID document expiry date doesn't match client inputUpdate the expiry date.
3308TIN not visibleCreate a new workflow set to IDV.
3311QEC details don't match ID documentCreate a new workflow that includes IDV and QES.
3400Second ID document photo too brightUpload a new second document.
3401Second ID document photo too darkUpload a new second document.
3402Second ID document photo too blurryUpload a new second document.
3403Second ID document photo poor qualityUpload a new second document.
3404Expired second ID documentUpload a new second document.
3405Invalid second ID documentUpload a new second document.
3406Second ID document photo of a photocopy or screenUpload a new second document.
3407Second ID document photo obscuredUpload a new second document.
3408Second ID document in inadequate conditionUpload a new second document.
3409Second ID document out of frameUpload a new second document.
3410PoA document photo too brightUpload a new ID document.
3411PoA document photo too darkUpload a new ID document.
3412PoA document photo too blurryUpload a new ID document.
3413PoA document photo poor qualityUpload a new ID document.
3414Expired PoA documentUpload a new ID document.
3415Invalid PoA documentUpload a new ID document.
3416PoA document photo of a photocopy or screenUpload a new ID document.
3417PoA document photo obscuredUpload a new ID document.
3418PoA document in inadequate conditionUpload a new ID document.
3419PoA document out of frameUpload a new ID document.
3500Geolocation not providedUpload a new selfie with the geolocation.
3505Not the same personUpload a new ID document and selfie.
3510Geolocation not supportedUpload a new selfie with the geolocation.
3520Photo metadata inconsistentUpload a new document and selfie.
3521Video metadata inconsistentUpload a new document and selfie.
3540Device metadata inconsistentUpload a new document and selfie.
3541Device model inconsistentUpload a new document and selfie.
3542Device language inconsistentUpload a new document and selfie.
3543Device geolocation inconsistentUpload a new document and selfie.
3560Invalid IP addressProvide a valid IP address.
3600Selfie video too brightUpload a new selfie video.
3601Selfie video too darkUpload a new selfie video.
3602Selfie video too blurryUpload a new selfie video.
3603Selfie video poor qualityUpload a new selfie video.
3604Selfie video GDPR breachUpload a new selfie video.
3610Selfie video inadequateUpload a new selfie video.
3620Liveness features not visibleUpload a new selfie video.
3700Insufficient dataCreate a new workflow set to IDV.

4000: Rejection reasons

Note
Note
You cannot retry.

This series includes:

Status codeDescription
4110Confirmed sanctions hit
4112Confirmed sensitivity list hit
4120Underage client
4130Unacceptable risk score
4135Unacceptable combination of data points
4140Country of residence not supported
4145Geolocation prohibited
4150Issuing country prohibited
4155Nationality prohibited
4160Hits above agreed threshold
4170High-risk IP address
4171High-risk country phone code
4172High-risk country of residence
4173High-risk geolocation
4190Rejected (other)
4192Selfie video rejected
4200Unacceptable third-party involvement in selfie photo
4202Unacceptable third-party involvement in selfie video
4211Unacceptable third-party involvement in ID document photo
4310Birth date doesn't match previous ID document
4311Place of birth doesn't match previous ID document
4400Name on ID document doesn't match client input

5000: Fraud reasons

Note
Note
You can't retry.

This series includes:

Status codeDescription
5100Tampered-with ID document
5150Counterfeit ID document
5200Tampered-with selfie photo
5201Selfie photo is of another photo
5202Impersonation
5210Biometrics match known fraudster
5300Tampered-with PoA document
5400Fraudulent address
5600Selfie video is of a video or a photo
5601Client in selfie video doesn’t match ID document
5602Client in selfie video wearing a mask
5610Fraudulent selfie video
5900Fraud (other)

6000: Signature errors

This series includes:

Status codeDescriptionAction
6001Fatal error while creating QECCreate a new workflow that includes IDV and QES.
6002Error while creating QECRetry the document approval step.
6003Communication error while creating QECRetry the signature confirmation step.
6004Fatal error while signing documentsCreate a new workflow that includes IDV and QES.
6005Error while signing documentsRetry the signature confirmation step.
6006Communication error while signing documentsRetry the signature confirmation step.
6007Pending verification flow: Fatal error while signing documents with provisional signatureCreate a new workflow that includes IDV and QES.
6008Signature flow timed outCreate a new workflow that includes IDV and QES.

Top of page