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
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 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 colours
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)
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 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
The full copy of the Up-to-date Articles of Association is required (all the pages signed of the document need to be provided)
  • Date, name or signature is missing
  • Document was left blanked
  • Only legal entity legal person chart is completed and not the individual one
  • Important to know who INDIRECTLY own the company if a holding company has the first level ownership
Share feedback
Live chat
No agent is free at the moment please send us a request through our contact form