> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.mangopay.com/guides/users/verification/documents/submission/id-best-practices/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.mangopay.com/_mcp/server.

# Identity proof best practices

> **Warning**
>
> **Caution – Legacy solution**
>
> This page relates to the legacy solution for submitting KYC/KYB documents via the API KYC Document endpoints. New integrations must use the [hosted KYC/KYB solution](/guides/users/verification/hosted) relying on the [IDV Session](/api-reference/idv-sessions/create-idv-session) endpoints.
>
> Platforms with existing integrations should refer to email communications for details about the transition timeline.
>
> The hosted KYC/KYB session provides guidance to the user during the process to maximize success rates. Many of the principles described below remain the same.

Both natural and legal users must provide an official identity document (ID) as proof of identity during the verification process. For legal users, it is the entity’s

legal representative

who must provide proof of identity.

> **Note**
>
> **Note - Accepted documents vary by country**
>
> Not all kinds of official identity documents are accepted for all countries. Check which documents can be submitted per country in the [Accepted ID documents](/guides/users/verification/requirements/id-accepted) article.

## Best practices

When uploading files, it is very important that the user respects the best practices below to ensure that the document can be read and verified.

If any of the guidelines are not respected, it may result in an error or delay in processing the document.

The document should be:

One of the [accepted documents](/guides/users/verification/requirements/id-accepted) from the country of issue

Consistent with the information provided for the user

For passports: one file (double-page spread) uploaded to one KYC Document API object.

For ID cards, driving licenses, residence permits: two files (front and back) uploaded to one KYC Document API object.

Valid and up to date

For a person aged over 18

A color photo (rather than a scan from an image scanner, like a flatbed photocopier or a printer)

Between 32KB and about 7MB (max. 10MB when encoded)

In one of the accepted formats: PNG, PDF, JPG, JPEG

See the how-to guide for guidance in technical implementation:

#### [How to](/guides/users/verification/documents/submission/how-to)

Submit a KYC Document for verification

## Errors to avoid

Below are some common errors than can lead to a document being refused:

![](/_fern-img/2663921745ac788721c27d12d441202c104f0ce3d01571f449536a8f3090c81b.webp)\


Edges not fully visible

![](/_fern-img/1628b92b3ad110aad312f292d9f316bc2b72838c5e680f9659e474579ad610a6.webp)\


Machine-readable zone (MRZ), data, or photo not fully visible

![](/_fern-img/a0dbea7098cd73ee67727e5d79a106d62c963eeeb8573d3680d7c946bf406dd6.webp)\


Covered by anything, especially a finger

![](/_fern-img/4e14dbd96ed57248060a6b4b3c6fa40959e74b470ad3602e3ce6029266df0508.webp)\


Glare or flash obscuring readability

![](/_fern-img/bb58f97b98acf712bb83d955be0dca3bf64a2eb106e44124d8ccb19e32d824c0.webp)\


Blurred

![](/_fern-img/48e175842ce03bec3c4751be650005e2c7d6f5de52d10f2e77b953e941b359fb.webp)\


Black and white

![](/_fern-img/f8b7275d3bd0a2e1744993a830dca68adf6b8b4c20534cf53ae663ba901c1dfb.webp)\


Card-type with both sides in one file

![](/_fern-img/4c7f98ff81f8a5ca678431ee721805a094bff311a2ceb7df463c9bc4239a6c55.webp)\


Two types of document submitted simultaneously (in the same file or not)

## Related resources

#### [Guide](/guides/users/verification/requirements)

Learn about verification requirements for each user type