KYC document errors
In case we could not validate a KYC document, you may be able to obtain more information about the reason why via two parameters returned by the API when you call the endpoint View a KYC Document.
For the document type
IDENTITY_PROOF, the parameter Flags may contain one or more error codes, which are explained below in the identity proof table.
For the document types
SHAREHOLDER_DECLARATIONthe RefusedReasonType may contain further information. The values of this parameter are explained below in the legal documents table. Additional information may also be available in the parameter RefusedReasonMessage.
|009000||The document is suspected to be fraudulent:
|009001||Fonts of the document don’t match the expected ones|
|009002||Picture of person is altered|
|009003||Document is partially or totally covered|
|009004||Document is blurred|
|009005||Cut-off document (MRZ band, …)|
|009006||Glare on photo. Please make sure to submit a perfectly readable document without a flash on it.|
|009007||Incorrect side of the document was submitted|
|009008||Two different documents were uploaded at the same time|
|009009||Document not accepted (deprecated since June 13th, 2022). Please contact our Support team.|
|009010||No document in image|
|009011||Photo is too dark|
|009012||Document is damaged|
|009013||A punched hole is present|
|009014||Corner has been physically cut off, please make sure document is valid|
|009015||Document contains severely diminished colors (due to resolution issues, liquid scan, or washed out background for instance)|
|009016||Glare obscuring a security chip|
|009017||Some features are obscured, please check your document quality|
|009018||Back of document is needed for processing|
|009019||Mangopay currently does not support that type of document. Please see our list of supported documents here|
|009020||Document owner is under the age of 18 years old|
|009021||Document has expired. Please make sure to submit an up-to-date document|
|009022||first_name does not match between declared information and extracted information.
|009023||last_name does not match between declared information and extracted information.
|009024||Document information is not readable because the image resolution is too low (please note that prior June 13th, 2022, the 009009 error was returned)|
|009025||Document information is not readable because the image is in black and white (rather than in color)|
|009100||Please contact our Support team for a further explanation about the issue|
|DOCUMENT_UNREADABLE||A clear copy of your Up-to-date Extract from the Companies Register is required. The one provided is not clear enough||A clear copy of Up-to-date Articles of Association is required. The one provided is not clear enough||A clear copy of Up-to-date shareholder declaration is required. The one provided is not clear enough|
|DOCUMENT_NOT_ACCEPTED||Document is not acceptable, it doesn't fit the KYC requirements guideline agreed with us||Document is not acceptable, it doesn't fit the KYC requirements guideline agreed with us||Document is not acceptable, it doesn't fit the KYC requirements guideline agreed with us|
|DOCUMENT_DO_NOT_MATCH_USER_DATA||We cannot identify the legal representative registered, please proceed to the change or submit a proxy with this extract||
|SPECIFIC_CASE||Depends on the specific message||Depends on the specific message||Depends on the specific message|
|DOCUMENT_FALSIFIED||The information on the document seems to be fraudulent or inconsistent||The information on the document seems to be fraudulent or inconsistent||The information on the document seems to be fraudulent or inconsistent|