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, and SHAREHOLDER_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:
  • The account will remain blocked until reception of a valid ID proof (document with better visual quality or a different ID proof)
  • Our Fraud team is checking all related transactions
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.
  • For a Natural User, declared FirstName must match with the firstname extracted from ID document
  • For a Legal User, declared LegalRepresentativeFirstName must match with the firstname extracted from ID document
009023 last_name does not match between declared information and extracted information.
  • For a Natural User, declared LastNameName must match with the lastname extracted from ID document
  • For a Legal User, declared LegalRepresentativeLastName must match with the lastname extracted from ID document
Note that for French ID document we do support spouse_name, widow_name or alias_name as declared LastName (or LegalRepresentativeLastName)
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
  • Document is outdated (more than 3 months)
  • A recent copy of Up-to-date Extract from the Companies Register is required (maximum 3 months old)
  • Document is outdated
  • A copy of Up-to-date and signed Articles of Association (which include the last modifications made) is required
 N/A
DOCUMENT_INCOMPLETE
  • A recent copy of Up-to-date Extract from the Companies Register is required
  • All the pages of the document need to be provided
  • Please add to this extract, the extract of the company president in order to identify the legal representative registered
  • The full copy of the Up-to-date Articles of Association is required (all the pages signed of the document need to be provided)
  • Please resubmit this document together with the statutes of the association in the same package. The registered legal representative does not seem to be one of the persons authorised to represent the association
  • Please resubmit these articles of association together with the latest minutes of the General Assembly stipulating the current officers of the association, as we cannot identify the registered legal representative.
  • Date, name or signature is missing
  • Document was left blanked
  • Missing information in the table
  • Important to know who INDIRECTLY own the company if a holding company has the first level ownership
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
  • The company or organization indicated on the document does not correspond to the one registered
  • For oganization, please change the registered legal representative to a natural person authorised to represent the association (president, secretary, treasurer)
  • The company / organization indicated on the document does not correspond to the one registered
  • The informations submitted do not match with the Articles of Association
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
Share feedback