Clarify rejection reason

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.

NameTypeOptionalDescription
imagesStatesObjectYesThe structure contains imageId and buttonId indicating the rejection reason.
applicantStateObjectYesThe structure contains buttonId indicating the rejection reason of the applicant data or applicant.

📘

Note

imagesStates and applicantState 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" 
  ]
}

Language
Authorization
Header
Click Try It! to start a request and see the response here!