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
REGISTRATION_PROOF
,ARTICLES_OF_ASSOCIATION
, andSHAREHOLDER_DECLARATION
the 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.
Identity proof
Flags | Description |
---|---|
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 |
Legal documents
RefusedReasonType | REGISTRATION_PROOF | ARTICLES_OF_ASSOCIATION | SHAREHOLDER_DECLARATION |
---|---|---|---|
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_HAS_EXPIRED |
|
|
N/A |
DOCUMENT_INCOMPLETE |
|
|
|
DOCUMENT_MISSING | |||
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 |
UNDERAGE_PERSON |