This page sets out possible statuses, explanatory status codes, CDD Report availability, and risk codes
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:
Identity Verification status flow
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 |
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 due to unsupported country of residence 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: Secondary document missing Action: Upload a secondary document. |
1201 | Description: Client not successfully verified Action: Create a new workflow for Identity Verification. |
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. | |
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 Qualified Electronic Signature. | |
3400 | Description: Secondary document photo too bright Action: Upload a new secondary document. | |
3401 | Description: Secondary document photo too dark Action: Upload a new secondary document. | |
3402 | Description: Secondary document photo too blurry Action: Upload a new secondary document. | |
3403 | Description: Secondary document photo poor quality Action: Upload a new secondary document. | |
3404 | Description: Expired secondary document Action: Upload a new secondary document. | |
3405 | Description: Invalid secondary document Action: Upload a new secondary document. | |
3406 | Description: Secondary document photo of a photocopy or screen Action: Upload a new secondary document. | |
3407 | Description: Secondary document photo obscured Action: Upload a new secondary document. | |
3408 | Description: Secondary document in inadequate condition Action: Upload a new secondary document. | |
3409 | Description: Secondary Document out of frame Action: Upload a new secondary 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. | |
3420 | Description: Name doesn't match the PoA> document 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 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 client cannot retry
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
The client cannot 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 |
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) |