Identity Verification Statuses
Integrations guide
This page sets out possible statuses, explanatory status codes, CDD Report availability, and risk codes for Identity Verification.
Statuses
Possible notifications include:
Status | Guidance |
---|---|
new | Description: The workflow is successfully created. Action: • SDK integration: Wait for the next status. • API integration: Upload the identity data and identity files. |
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 client, see the risk code. Risk codes: • 200 – 500 : 100 series status codes • 500 : 4000 – 5000 series status codes Action: Download the CDD Report zipfile. |
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 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 client to use a supported ID document for their nationality. |
1022 | Description: ID document missing Action: Upload an ID document. |
Description: tax.countrySubjectToTaxation invalid Action: Update the identity data, changing the tax.countrySubjectToTaxation format to a valid ISO_3166-1 alpha-3 country code. | |
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: Client 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 client Action: None. You can't retry. |
1035 | Description: Ineligible client 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: Client not successfully verified Action: Create a new workflow for Identity Verification. |
1277 | Description: previousDocumentData missing Action: Update the identity data, providing the previousDocumentData . |
Description: Client 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 . |
2000: Home address
This series can accompany inconsistent_data
status and includes:
Status code | Guidance |
---|---|
2001 | Description: Invalid address Action: Provide a valid address. |
2002 | Description: PO box address Action: Provide a valid non-PO box address. |
2003 | Description: Non-residential address Action: Provide a valid residential address. |
2004 | Description: Address doesn't match the PoA document Action: Provide a valid address request, or ask the client for a new official PoA document. |
3000: Sendbacks
This series can accompany inconsistent_data
status and includes:
Status code | Guidance |
---|---|
3001 | Description: person.nationality doesn't match client input Action: Update the client's nationality. |
3002 | Description: person.placeOfBirth doesn't match client input Action: Update the client's place of birth. |
3003 | Description: person.birthDate doesn't match client input Action: Update the client's birth date. |
3005 | Description: person.gender doesn't match client input Action: Update the client'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 client matches ID document Action: Update the client'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 client input Action: Update the document number. |
3306 | Description: ID document issue date doesn't match client input Action: Update the issue date. |
3307 | Description: ID document expiry date doesn't match client input Action: Update the expiry date. |
3308 | Description: TIN not visible Action: Create a new workflow for Identity Verification. |
3311 | Description: QEC details don't match ID document Action: Create a new workflow that includes Identity Verification and Qualified Electronic Signature. |
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. |
3410 | Description: PoA document photo too bright Action: Upload a new PoA document photo. |
3411 | Description: PoA document photo too dark Action: Upload a new PoA document photo. |
3412 | Description: PoA document photo too blurry Action: Upload a new PoA document photo. |
3413 | Description: PoA document photo poor quality Action: Upload a new PoA document photo. |
3414 | Description: Expired PoA document Action: Upload a different PoA document. |
3415 | Description: Invalid PoA document Action: Upload a different PoA document. |
3416 | Description: PoA document photo of a photocopy or screen Action: Upload an authentic PoA document. |
3417 | Description: PoA document photo obscured Action: Upload a new PoA document photo. |
3418 | Description: PoA document in inadequate condition Action: Upload a different PoA document. |
3419 | Description: PoA document out of frame Action: Upload a new PoA document photo. |
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
This series can accompany completed
status and 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
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 |
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: Qualified Electronic Signature errors
This series can accompany completed
status and includes:
Status code | Guidance |
---|---|
6001 | Description: Fatal error while creating the QEC Action: Create a new workflow that includes Identity Verification and Qualified Electronic Signature. |
6002 | Description: Error while creating the QEC Action: • SDK integration: Handled by the SDK. • API integration: Retry the Document approval step. |
6003 | Description: Communication error while creating the QEC Action: • SDK integration: Handled by the SDK. • API integration: Retry the Signature confirmation step. |
6004 | Description: Fatal error while signing documents Action: Create a new workflow that includes Identity Verification and Qualified Electronic Signature. |
6005 | Description: Error while signing documents Action: • SDK integration: Handled by the SDK. • API integration: Retry the Signature confirmation step. |
6006 | Description: Communication error while signing documents Action: • SDK integration: Handled by the SDK. • API integration: Retry the Signature confirmation step. |
6007 | Pending verification flow only Description: Fatal error while signing documents with provisional signature Action: Create a new workflow that includes Identity Verification and Qualified Electronic Signature. |
6008 | Description: Signature flow timed out Action: Create a new workflow that includes Identity Verification and Qualified Electronic Signature. |
Updated 5 months ago