Identity Verification Statuses
Integrations guide
This page sets out possible statuses, explanatory status codes, CDD Report availability, and risk codes for Identity Verification.
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:
Status | Description | Action |
---|---|---|
new | The workflow is successfully created. | Upload the identity data and ID document. |
pending | We are validating the data. | Check the case status. Status code: 1000 |
inconsistent_data | We found inconsistent data. | Create a new workflow set to IDV . Status codes: 2000 series – 3000 series |
invalid_data | We found invalid or missing data. | Create a new workflow set to IDV . Status codes: 1001 – 1999 |
completed | We have processed the case. For our recommendation to accept or reject the client, see the risk code. | Download the CDD Report. Risk code: 200 – 500 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 code | Risk score |
---|---|
200 | completed_low_risk |
300 | completed_medium_risk |
400 | completed_high_risk |
500 | completed_unacceptable_risk |
Status codes
Statuses can be accompanied by one or multiple of the following status codes:
100: AML screening
This series 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 includes:
Status code | Description | Action |
---|---|---|
1000 | Data successfully validated | |
1004 | person.type invalid | Update the identity data, setting person.type to naturalPerson or legalPerson . |
1005 | person.fullName invalid or missing | Update the identity data, setting the person.fullName format to only contain alphabetical characters, spaces, hyphens, and apostrophes. |
1006 | person.firstName invalid or missing | Update the identity data, setting the person.firstName format to only contain alphabetical characters, spaces, hyphens, and apostrophes. |
1007 | person.lastName invalid or missing | Update the identity data, setting the person.lastName format to only contain alphabetical characters, spaces, hyphens, and apostrophes. |
1008 | person.gender invalid or missing | Update the identity data, setting person.gender to Female , Male , Other , or Unknown (case sensitive). |
1009 | person.nationality invalid or missing | Update the identity data, setting person.nationality to a valid ISO_3166-1 alpha-3 country code. |
1010 | person.birthDate invalid or missing | Update the identity data, setting person.birthDate to a valid date in YYYY-MM-DD format. |
1011 | address.country invalid or missing | Update the identity data, setting address.country to a valid ISO_3166-1 alpha-3 country code. |
1012 | emailAndPhone.email invalid or missing | Update the identity data, setting emailAndPhone.email to a valid email address including an @ character. |
1013 | emailAndPhone.mobile invalid or missing | 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 | address.streetNumber invalid or missing | Update the identity data, setting address.streetNumber to an integer greater than or equal to zero. |
1015 | address.street invalid or missing | Update the identity data, setting address.street with only alphabetical characters, spaces, hyphens, and apostrophes. |
1016 | address.postalCode invalid or missing | Update the identity data, setting address.postalCode . |
1017 | address.city invalid or missing | Update the identity data, setting the address.city format to only contain alphabetical characters, spaces, hyphens, and apostrophes. |
1018 | kycDocument.documentType missing | Update the identity file, setting kycDocument.documentType . |
1021 | person.nationality not supported for this document type | Ask the client to use a supported ID document for their nationality. |
1022 | ID 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. |
1023 | Selfie photo missing | Upload a selfie photo. |
1024 | ID document photo(s) missing or inconsistent | Upload new document photos. |
1025 | All riskRequirement parameters required | Update the identity data, setting all riskRequirement parameters. |
1031 | Identity data too old | Upload new identity data. |
1032 | Client not a natural person | Update the identity data, setting person.type to Natural Person . |
1033 | person.fullName format invalid | Update the identity data, making sure person.fullName consists of at least 2 words. |
1034 | Underage client | You can't retry. |
1035 | Ineligible client | You can't retry. |
1036 | ID document number already used | Upload a new ID document. |
1037 | kycDocument.documentNumber missing | Update the identity file, setting kycDocument.documentNumber . |
1100 | Second ID document missing | Upload a second ID document. |
1201 | Client not successfully verified | Create a new workflow set to IDV . |
1277 | previousDocumentData missing or client has no successful AML-compliant Identity Verification case | Update the identity data, providing the previousDocumentData . |
1278 | previousDocumentData incomplete | Update the identity data, providing the previousDocumentData . |
1279 | previousDocumentData incomplete | Update the identity data, providing all required previousDocumentData . |
2000: Home address
This series includes:
Status code | Description | Action |
---|---|---|
2001 | Invalid address | Provide a valid address. |
2002 | PO box address | Provide a valid non-PO box address. |
2003 | Non-residential address | Provide a valid residential address. |
2004 | Address doesn't match the PoA document | Provide a valid address request, or ask the client for a new official PoA document. |
3000: Sendback reasons
This series includes:
Status code | Description | Action |
---|---|---|
3001 | person.nationality doesn't match client input | Update the client's nationality. |
3002 | person.placeOfBirth doesn't match client input | Update the client's place of birth. |
3003 | person.birthDate doesn't match client input | Update the client's birth date. |
3005 | person.gender doesn't match client input | Update the client's gender. |
3100 | Selfie photo too bright | Upload a new selfie. |
3101 | Selfie photo too dark | Upload a new selfie. |
3102 | Selfie photo too blurry | Upload a new selfie. |
3103 | Selfie photo poor quality | Upload a new selfie. |
3104 | Selfie photo inadequate | Upload a new selfie. |
3105 | Selfie doesn’t match ID document portrait | Create a new workflow set to IDV . |
3106 | Inadequate input | Create a new workflow set to IDV . |
3107 | Face not fully visible or within frame | Upload a new selfie. |
3108 | Selfie photo GDPR breach | Upload a new selfie. |
3200 | ID document photo too bright | Upload a new ID document. |
3201 | ID document photo too dark | Upload a new ID document. |
3202 | ID document photo too blurry | Upload a new ID document. |
3203 | ID document photo poor quality | Upload a new ID document. |
3204 | Expired ID document | Upload a new ID document. |
3205 | Invalid ID document | Upload a new ID document. |
3206 | ID document photo of a photocopy or screen | Upload a new ID document. |
3207 | ID document photo obscured | Upload a new ID document. |
3208 | ID document in inadequate condition | Upload a new ID document. |
3209 | Issuing country not supported | Upload a new ID document. |
3210 | Nationality not supported | Upload a new ID document. |
3211 | ID document out of frame | Upload a new ID document. |
3212 | ID document in plastic cover | Upload a new ID document. |
3213 | ID document photo GDPR breach | Upload a new ID document. |
3250 | Security features not visible | Upload a new ID document. |
3300 | Unclear if legal name provided by client matches ID document | Update the client's full name. |
3304 | Photos of required ID document sides missing | Provide the required number of photos for the document type. |
3305 | ID document number doesn't match client input | Update the document number. |
3306 | ID document issue date doesn't match client input | Update the issue date. |
3307 | ID document expiry date doesn't match client input | Update the expiry date. |
3308 | TIN not visible | Create a new workflow set to IDV . |
3311 | QEC details don't match ID document | Create a new workflow that includes IDV and QES . |
3400 | Second ID document photo too bright | Upload a new second document. |
3401 | Second ID document photo too dark | Upload a new second document. |
3402 | Second ID document photo too blurry | Upload a new second document. |
3403 | Second ID document photo poor quality | Upload a new second document. |
3404 | Expired second ID document | Upload a new second document. |
3405 | Invalid second ID document | Upload a new second document. |
3406 | Second ID document photo of a photocopy or screen | Upload a new second document. |
3407 | Second ID document photo obscured | Upload a new second document. |
3408 | Second ID document in inadequate condition | Upload a new second document. |
3409 | Second ID document out of frame | Upload a new second document. |
3410 | PoA document photo too bright | Upload a new ID document. |
3411 | PoA document photo too dark | Upload a new ID document. |
3412 | PoA document photo too blurry | Upload a new ID document. |
3413 | PoA document photo poor quality | Upload a new ID document. |
3414 | Expired PoA document | Upload a new ID document. |
3415 | Invalid PoA document | Upload a new ID document. |
3416 | PoA document photo of a photocopy or screen | Upload a new ID document. |
3417 | PoA document photo obscured | Upload a new ID document. |
3418 | PoA document in inadequate condition | Upload a new ID document. |
3419 | PoA document out of frame | Upload a new ID document. |
3500 | Geolocation not provided | Upload a new selfie with the geolocation. |
3505 | Not the same person | Upload a new ID document and selfie. |
3510 | Geolocation not supported | Upload a new selfie with the geolocation. |
3520 | Photo metadata inconsistent | Upload a new document and selfie. |
3521 | Video metadata inconsistent | Upload a new document and selfie. |
3540 | Device metadata inconsistent | Upload a new document and selfie. |
3541 | Device model inconsistent | Upload a new document and selfie. |
3542 | Device language inconsistent | Upload a new document and selfie. |
3543 | Device geolocation inconsistent | Upload a new document and selfie. |
3560 | Invalid IP address | Provide a valid IP address. |
3600 | Selfie video too bright | Upload a new selfie video. |
3601 | Selfie video too dark | Upload a new selfie video. |
3602 | Selfie video too blurry | Upload a new selfie video. |
3603 | Selfie video poor quality | Upload a new selfie video. |
3604 | Selfie video GDPR breach | Upload a new selfie video. |
3610 | Selfie video inadequate | Upload a new selfie video. |
3620 | Liveness features not visible | Upload a new selfie video. |
3700 | Insufficient data | Create a new workflow set to IDV . |
4000: Rejection reasons
Note
You cannot retry.
This series includes:
Status code | Description |
---|---|
4110 | Confirmed sanctions hit |
4112 | Confirmed sensitivity list hit |
4120 | Underage client |
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 client input |
5000: Fraud reasons
Note
You can't retry.
This series 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 |
5300 | Tampered-with PoA document |
5400 | Fraudulent address |
5600 | Selfie video is of a video or a photo |
5601 | Client in selfie video doesn’t match ID document |
5602 | Client in selfie video wearing a mask |
5610 | Fraudulent selfie video |
5900 | Fraud (other) |
6000: Signature errors
This series includes:
Status code | Description | Action |
---|---|---|
6001 | Fatal error while creating QEC | Create a new workflow that includes IDV and QES . |
6002 | Error while creating QEC | Retry the document approval step. |
6003 | Communication error while creating QEC | Retry the signature confirmation step. |
6004 | Fatal error while signing documents | Create a new workflow that includes IDV and QES . |
6005 | Error while signing documents | Retry the signature confirmation step. |
6006 | Communication error while signing documents | Retry the signature confirmation step. |
6007 | Pending verification flow: Fatal error while signing documents with provisional signature | Create a new workflow that includes IDV and QES . |
6008 | Signature flow timed out | Create a new workflow that includes IDV and QES . |
Updated 9 days ago