Returns rejection reason clarification.
Overview
Use this method to retrieve the rejection reasons for a document or applicant. A specific buttonId
is automatically assigned to each rejection. For more information, see Temporary rejection clarification and Final rejection clarification.
Response explained
The following table explains the response structure.
Name | Type | Optional | Description |
---|---|---|---|
imagesStates | Object | Yes | The structure contains imageId and buttonId indicating the rejection reason. |
applicantState | Object | Yes | The structure contains buttonId indicating the rejection reason of the applicant data or applicant. |
Note
imagesStates
andapplicantState
are present in the response only when the applicant is rejected.
Temporary rejection clarification
Button |
buttonID |
Rejection label |
Description |
---|---|---|---|
Screenshots |
screenshot |
SCREENSHOTS, UNSATISFACTORY_PHOTOS |
The applicant uploaded screenshots instead of photos or scans. |
Black and white |
blackAndWhite |
BLACK_AND_WHITE, UNSATISFACTORY_PHOTOS |
The applicant uploaded black and white photos of a document instead of color photos. |
Edited PoA |
editedPoa |
GRAPHIC_EDITOR, UNSATISFACTORY_PHOTOS |
The uploaded photo displays signs of tampering via a digital editor. |
Data not readable |
dataNotVisible |
UNSATISFACTORY_PHOTOS |
The information on the uploaded photo is illegible. The image may be blurred or cropped, making it impossible to read the needed data (for example name or MRZ). |
Sticker |
sticker |
GRAPHIC_EDITOR, UNSATISFACTORY_PHOTOS |
The uploaded photo displays signs of tampering via a digital editor. |
Incomplete document |
incomplete |
INCOMPLETE_DOCUMENT, UNSATISFACTORY_PHOTOS |
Part of the document (document corners) is not visible. |
Photoshop |
imageEditor |
GRAPHIC_EDITOR, UNSATISFACTORY_PHOTOS |
The photo displays signs of tampering via a digital editor. The purpose of the editor could be anything from resizing to forgery. |
Main page of the document |
mainPageId |
DOCUMENT_PAGE_MISSING |
The uploaded document is missing the biodata page. |
Address page |
registrationStamp |
DOCUMENT_PAGE_MISSING |
The uploaded document is missing the address page. |
Expiration date page |
expirationPage |
DOCUMENT_PAGE_MISSING |
The uploaded document is missing the expiration date page. |
Next page |
nextPage |
DOCUMENT_PAGE_MISSING |
The uploaded document is missing a page. |
Another side |
anotherSide |
DOCUMENT_PAGE_MISSING |
The uploaded document is double-sided and only one side was uploaded. |
Button |
buttonID |
Rejection label |
Description |
---|---|---|---|
Full name issue |
fullName |
PROBLEMATIC_APPLICANT_DATA |
The full name in the profile does not match the name in the document uploaded by the applicant. |
Date of birth issue |
dateOfBirth |
PROBLEMATIC_APPLICANT_DATA |
The date of birth in the profile does not match the date of birth in the document uploaded by the applicant. |
Gender mismatch |
gender |
PROBLEMATIC_APPLICANT_DATA |
The gender in the applicant profile does not match the gender in the document uploaded by the applicant. |
Address issue |
address |
WRONG_ADDRESS |
The address in the profile does not match the address in the document uploaded by the applicant. |
Incorrect TIN |
incorrectTin |
INCORRECT_SOCIAL_NUMBER |
The tax number provided by the applicant is incorrect. |
Incorrect SSN |
incorrectSsn |
INCORRECT_SOCIAL_NUMBER |
The SSN number provided by the applicant is incorrect. |
Incorrect BVN |
incorrectBvn |
INCORRECT_SOCIAL_NUMBER |
The BVN number provided by the applicant is incorrect. |
Button |
buttonID |
Rejection label |
Description |
---|---|---|---|
Low quality of ID |
lowQuality |
BAD_SELFIE |
The information on the ID document is not visible or can not be read. |
Selfie with ID |
selfieWithId |
BAD_SELFIE |
The applicant uploaded a selfie without the ID document. |
Selfie with another ID |
selfieWithAnotherId |
BAD_SELFIE |
The ID document in the selfie is different from the ID document uploaded by the applicant. |
Selfie with new ID |
selfieWithNewId |
BAD_SELFIE |
The ID document in the selfie can not be detected or read. |
Compare with ID mismatch |
badFaceComparison |
BAD_FACE_MATCHING, BAD_SELFIE |
The applicant's face on the selfie is not clearly visible and can not be matched against the photo in the ID document. |
Webcam selfie |
webcamSelfie |
BAD_SELFIE |
The applicant failed the Liveness check. |
Liveness with watermark |
livenessWatermark |
BAD_SELFIE |
There is camera text or a watermark on the Liveness record originating from the proprietary software. |
Selfie Liveness |
selfieLiveness |
BAD_SELFIE |
The applicant failed the Liveness check. |
Spoken phrase mismatch |
videoWithoutFace |
BAD_VIDEO_SELFIE |
The pronounced phrase does not match the provided text. |
Video without face |
spokenPhraseMismatch |
BAD_VIDEO_SELFIE |
The applicant's face can not be detected on the selfie. |
Button |
buttonID |
Rejection label |
Description |
---|---|---|---|
Interrupted interview |
applicantInterruptedInterview |
APPLICANT_INTERRUPTED_INTERVIEW |
On the Video Ident call, the applicant did not finish the interview. |
No docs |
noSuitableDocs |
DOCUMENT_MISSING |
The applicant failed to provide the required documents on the Video Ident call. |
Not alone |
notAlone |
UNSUITABLE_ENV |
On the Video Ident call, the applicant was not alone. |
Applicant can not be seen |
notSeen |
UNSUITABLE_ENV |
On the Video Ident call, the applicant was not visible. |
Bad connection |
badConnection |
CONNECTION_INTERRUPTED |
The Video Ident call connection was interrupted. |
Button |
buttonID |
Rejection label |
Description |
---|---|---|---|
Invalid ID |
invalidId |
ID_INVALID |
The provided identity document is invalid. |
Expired ID |
expiredId |
EXPIRATION_DATE |
The provided identity document has expired. |
ID expiration date (1 month) |
expirationDate |
EXPIRATION_DATE |
The provided identity document expires in less than one month. |
Damaged ID |
damagedId |
DOCUMENT_DAMAGED |
The provided ID document is damaged to the extent that it makes verification data, such as name or MRZ, unreadable (e.g. the ID is stained or scratched). |
Without face |
withoutFace |
BAD_PROOF_OF_IDENTITY |
The face of the document’s owner is poorly visible, making face match impossible. |
No full name or DoB |
notFullNameOrDob |
BAD_PROOF_OF_IDENTITY |
Applicant full name or date of birth is not present in the provided document. |
English translation |
needTranslation |
INCOMPATIBLE_LANGUAGE |
The applicant uploaded a document in a language that is not supported by Sumsub, so the notarized English translation has been requested. |
Copy of ID doc |
copyOfIdDoc |
BAD_PROOF_OF_IDENTITY |
The applicant has uploaded a photo of a paper copy of their document instead of the original document, which is no acceptable. |
No stamp |
noStamp |
BAD_PROOF_OF_IDENTITY |
The applicant uploaded a document that does not have the stamp of the issuing organization. |
Unsigned document |
unsigned |
BAD_PROOF_OF_IDENTITY |
The applicant uploaded a document without relevant signatures and stamps. |
Wrong type |
wrongType |
BAD_PROOF_OF_IDENTITY |
The uploaded document can not be accepted for verification. |
Button |
buttonID |
Rejection label |
Description |
---|---|---|---|
List of documents |
listOfDocs |
BAD_PROOF_OF_ADDRESS |
The applicant uploaded a document that is not supported by Sumsub. |
Full name |
fullName |
BAD_PROOF_OF_ADDRESS |
The full name of the applicant has not been provided on the document or can’t be read. |
Full address |
fullAddress |
BAD_PROOF_OF_ADDRESS |
The full address of the applicant has not been provided on the document or can’t be read. |
Issue date |
issueDate |
BAD_PROOF_OF_ADDRESS |
There is no issue date on the document uploaded by the applicant. |
Passport without number |
notEnoughData |
BAD_PROOF_OF_ADDRESS |
There is no number on the document (passport) uploaded by the applicant. |
Certified form |
certifiedForm |
BAD_PROOF_OF_ADDRESS |
There is no stamp/signature of the issuing organization on the document uploaded by the applicant. |
Submit the same document |
sameDoc |
BAD_PROOF_OF_ADDRESS |
The applicant uploaded the same document as PoA and PoI. |
Applicant data mismatch |
dataMismatch |
BAD_PROOF_OF_ADDRESS |
The address on the document uploaded by the applicant does not match the address entered by the applicant. |
Button |
buttonID |
Rejection label |
Description |
---|---|---|---|
Black crypto |
blackCrypto |
BAD_PROOF_OF_PAYMENT |
The crypto wallet address is incorrect. |
Bank card |
bankCard |
BAD_PROOF_OF_PAYMENT |
The information on the bank card is missing or can’t be read. |
Bank statement |
bankStatement |
BAD_PROOF_OF_PAYMENT |
The information on the bank statement is missing or can’t be read. |
Bank account |
bankAccount |
BAD_PROOF_OF_PAYMENT |
The information about the bank account is missing. |
E-wallet |
e-wallet |
BAD_PROOF_OF_PAYMENT |
The e-wallet needs to be confirmed. |
Wire transfer |
wireTransfer |
BAD_PROOF_OF_PAYMENT |
The wire transfer needs to be confirmed. |
Bank card without name |
fullNameIssue |
BAD_PROOF_OF_PAYMENT |
The name on the bank card is missing. |
Expired bank card |
expirationDate |
BAD_PROOF_OF_PAYMENT |
The provided bank card has expired or expires soon. |
Copy bank card |
noCard |
BAD_PROOF_OF_PAYMENT |
The applicant uploaded an image of a copy of the bank card. |
Full name (bank statement) |
fullNameIssue |
BAD_PROOF_OF_PAYMENT |
The full name on the bank statement is missing or can not be read. |
Account/Card number |
notEnoughData |
BAD_PROOF_OF_PAYMENT |
The account/card number on the bank statement is missing or can not be read. |
Issue date (bank statement) |
invalidIssueDate |
BAD_PROOF_OF_PAYMENT |
The issue date on the bank statement is missing or can not be read. |
Card number mismatch |
numberMismatch |
BAD_PROOF_OF_PAYMENT |
The bank card number on the bank statement does not match the provided bank card. |
Decline payment |
proofOfPayment |
BAD_PROOF_OF_PAYMENT |
N/A |
Button |
buttonID |
Rejection label |
Description |
---|---|---|---|
Control structure is not established |
controlStructureIsNotEstablished |
COMPANY_NOT_DEFINED_STRUCTURE |
Sumsub could not establish the verified entity's control structure. |
Beneficiaries are not defined |
notDeteminedBeneficiares |
COMPANY_NOT_DEFINED_BENEFICIARIES |
Sumsub could not identify or properly verify the verified entity's beneficial owners. |
Beneficiaries are not validated |
notValidatedBeneficiares |
COMPANY_NOT_VALIDATED_BENEFICIARIES |
Sumsub could not validate the verified entity's beneficial owners. |
Representatives are not defined |
notDeterminedRepresentatives |
COMPANY_NOT_DEFINED_REPRESENTATIVES |
Sumsub could not validate the verified entity's representatives. |
Representatives are not validated |
notValidatedRepresentatives |
COMPANY_NOT_VALIDATED_REPRESENTATIVES |
Sumsub could not identify or properly verify the verified entity's representatives. |
More docs |
moreDocs |
ADDITIONAL_DOCUMENT_REQUIRED |
Sumsub needs more documents to process with verification. |
Button |
buttonID |
Rejection label |
Description |
---|---|---|---|
Check unavailable |
checkUnavailable |
CHECK_UNAVAILABLE |
The government database is currently unavailable, so we were not able to verify applicant data. |
Final rejection clarification
Button |
buttonID |
Associated rejection label |
Description |
---|---|---|---|
Edited MRZ |
editedMrz |
FORGERY |
MRZ of the document was modified. |
Edited ID data |
editedId |
FORGERY |
Data in the document was modified. |
Edited barcode |
editedBarcode |
FORGERY |
The barcode in the document was modified. |
Physical forgery |
forgedId |
FORGERY |
The document has been physically tampered with. |
Image from the web |
webId |
FORGERY |
The photo of the document was found on the dark web. |
Fake PoA |
fakePoa |
FORGERY |
The information in the PoA document is inconsistent. |
Fake Liveness |
fakeLiveness |
FORGERY |
An attempt to bypass the liveness check was detected. |
Selfie with fake ID |
fakeSelfie |
FORGERY |
The ID document used in the selfie is fake. |
Fake |
fake |
FORGERY |
We suspect the applicant account is fradulent. |
Deepfake |
deepFake |
FORGERY |
A deepfake attempt detected. |
NFC data mismatch |
nfcMismatch |
FORGERY |
The data extracted form the NFC chip does not match the data in the document. |
Forced Verification |
forcedVerification |
FORGERY |
We suspect the applicant was forced to pass verification. |
Liveness with phone |
livenessWithPhone |
FORGERY |
The applicant phone was present during the livdeness check. |
Fake (payments) |
fraudulentPatterns |
FORGERY |
We suspect the applicant account is fradulent. |
Template |
template |
FORGERY |
We suspect tampered data. |
Button |
buttonID |
Associated rejection label |
Description |
---|---|---|---|
Selfie mismatch |
selfieMismatch |
SELFIE_MISMATCH |
The applicant’s selfie does not match the photo in the document. |
Red crypto |
redCrypto |
BAD_PROOF_OF_PAYMENT |
The provided e-wallet has a high risk score. |
High-risk profile |
highRiskProfile |
FRAUDULENT_PATTERNS |
The system has detected suspicious applicant behavior such as high-risk IP, using multiple devices, etc. |
Different bank cards |
differentDocs |
INCONSISTENT_PROFILE, BAD_PROOF_OF_PAYMENT |
The bank cards submitted by the applicant belong to different people. |
Different people |
livenessDifferentPeople |
FRAUDULENT_LIVENESS |
Multiple people/devices were present during the liveness check. |
Bypass attempts |
livenessBypass |
FRAUDULENT_LIVENESS |
The applicant attempted to use digital and/or physical objects to fool the system. |
Different docs |
differentDocs |
INCONSISTENT_PROFILE |
The documents or means of payment submitted by the applicant belong to different people. |
Printed copy of ID |
printedIdCopy |
NOT_DOCUMENT |
The document uploaded by the applicant is a printout. |
Blocklist |
blocklist |
BLACKLIST |
We suspect the applicant account is fradulent, as it has a very high risk score. |
Countries mismatch |
countriesMismatch |
REGULATIONS_VIOLATIONS, BAD_PROOF_OF_PAYMENT |
The applicant country of residence does not match the bank card registration country. |
High-risk bank card |
riskBankCard |
REGULATIONS_VIOLATIONS, BAD_PROOF_OF_PAYMENT |
The provided bank card has a high risk score. |
Name mismatch |
inconsistency |
REGULATIONS_VIOLATIONS, BAD_PROOF_OF_PAYMENT |
The bank card holder name does not match the name on the applicant ID. |
Different bank cards (payments) |
differentDocs |
REGULATIONS_VIOLATIONS, BAD_PROOF_OF_PAYMENT |
The submitted bank cards belong to different people. |
3rd Force Involvement |
forcedVerification |
FRAUDULENT_PATTERNS |
The video ident call showed that the applicant was misled and/or forced by the 3rd party to create the account. |
Sponsored registration |
3rdPartyInvolvement |
THIRD_PARTY_INVOLVED |
We suspect the applicant was paid to create the account. |
Rejected payment |
paymentsIssues |
BAD_PROOF_OF_PAYMENT |
The provided payment method was rejected due to high risk. |
Button |
buttonID |
Associated rejection label |
Description |
---|---|---|---|
Age |
age |
AGE_REQUIREMENT_MISMATCH, REGULATIONS_VIOLATIONS |
The applicant does not meet the client's age requirements. |
Wrong region |
wrongRegion |
WRONG_USER_REGION, REGULATIONS_VIOLATIONS |
The applicant is from a region or a country that is not supported by the client. |
Duplicate |
duplicate |
DUPLICATE, REGULATIONS_VIOLATIONS |
By default, one applicant can have only one active account. |
Spam |
spam |
SPAM |
The applicant uploaded irrelevant images or failed to provide the required documents 6 or more times. |
Unsupported language |
unsupportedLanguage |
UNSUPPORTED_LANGUAGE |
The applicant doesn't speak any of the supported languages. |
Button |
buttonID |
Associated rejection label |
Description |
---|---|---|---|
Not enough data in source |
notEnoughDataInSource |
PROBLEMATIC_APPLICANT_DATA |
Sumsub could not find the applicant data in the government database. |
E-KYC skipped |
skip |
PROBLEMATIC_APPLICANT_DATA |
E-KYC step has been skipped. |
Data mismatch |
dataMismatch |
PROBLEMATIC_APPLICANT_DATA |
The data provided by the applicant does not match the data from the government database. |
Button |
buttonID |
Associated rejection label |
Description |
---|---|---|---|
Sanctions |
sanctionList |
SANCTIONS |
The applicant was mentioned on sanctions lists. |
PEP |
pep |
PEP |
The applicant is a politically exposed person. This means that they are currently in a position of great control or have been in the past. |
Criminal records |
criminalRecords |
CRIMINAL |
The applicant is a convicted criminal. |
Adverse media |
adverseMedia |
ADVERSE_MEDIA |
The applicant is mentioned in adverse media. |
Incomplete data |
incompleteName |
COMPROMISED_PERSONS |
The name the applicant entered is incomplete, so the system could not match it against the watchlists properly. |
JSON representation
The following is a JSON representation containing the list of button identifiers and their associated groups.
Info
The method returns a combination of group identifiers and button identifiers. For example,
dataMismatch_fullName
.
{
"spam":[],
"redCrypto":[],
"blackCrypto":[],
"differentDocs":[],
"paymentsIssues":[],
"regulationsViolations":[
"age",
"duplicate",
"wrongRegion",
"inconsistency",
"docNotFound",
"countriesMismatch",
"riskBankCard",
"spam",
"blocklist",
"highRiskProfile",
"gender",
"unsupportedLanguage"
],
"dataMismatch":[
"fullName",
"dateOfBirth",
"address",
"inconsistency",
"gender"
],
"fraudulentPatterns":[
"selfieMismatch",
"fake",
"blocklist",
"highRiskProfile",
"physicalForgery",
"wantedDocument",
"livenessForced",
"deepFake",
"template"
],
"dbNetChecks":[
"incorrectTin",
"incorrectSsn",
"incorrectBvn"
],
"compromisedPersons":[
"pep",
"sanctionList",
"criminalRecords",
"incompleteName",
"adverseMedia"
],
"company":[
"moreDocs",
"controlStructureIsNotEstablished",
"notValidatedBeneficiaries",
"notDeterminedRepresentatives",
"notValidatedRepresentatives"
],
"additionalPages":[
"mainPageId",
"nextPage",
"registrationStamp",
"expirationPage",
"proofOfAddress",
"anotherSide"
],
"badDocument":[
"expiredId",
"invalidId",
"damagedId",
"wrongType",
"notFullNameOrDob",
"withoutFace",
"dataNotVisible",
"copyOfIdDoc",
"noStamp",
"unsigned",
"needTranslation",
"fake",
"expirationDate",
"inconsistency"
],
"badPhoto":[
"lowQuality",
"editedPoa",
"screenshot",
"blackAndWhite",
"imageEditor",
"incomplete",
"dataNotVisible",
"sticker"
],
"selfie":[
"lowQuality",
"selfieWithId",
"webcamSelfie",
"selfieWithAnotherId",
"selfieWithNewId",
"blackAndWhite",
"badFaceComparison",
"selfieLiveness",
"livenessWatermark"
],
"videoSelfie":[
"lowQuality",
"videoWithoutFace",
"spokenPhraseMismatch"
],
"proofOfAddress":[
"fullName",
"fullAddress",
"issueDate",
"listOfDocs",
"expirationDate",
"dataMismatch",
"sameDoc",
"certifiedForm",
"notEnoughData"
],
"proofOfPayment":[
"bankCard",
"bankStatement",
"e-wallet",
"wireTransfer",
"bankAccount",
"dataMismatch"
],
"bankCard":[
"fullNameIssue",
"expirationDate",
"noCard"
],
"bankStatement":[
"fullNameIssue",
"numberMismatch",
"invalidIssueDate",
"notEnoughData"
],
"fake":[
"editedMrz",
"editedId",
"forgedId",
"webId",
"fakePoa",
"editedBarcode",
"fakeLiveness",
"fakeSelfie",
"nfcMismatch"
],
"selfieIssues":[
"livenessWithPhone",
"livenessDifferentPeople"
],
"videoIdent":[
"notAlone",
"badConnection",
"notSeen",
"noSuitableDocs",
"applicantInterruptedInterview"
],
"videoIdentFinalRejection":[
"unsupportedLanguage",
"3rdPartyInvolvement",
"forcedVerification"
],
"ekycReject":[
"notEnoughDataInSource",
"skip",
"dataMismatch"
],
"ekycRetry":[
"checkUnavailable"
]
}