Showing the first 18000 characters. Load the complete file to read the remainder.
# Mangopay docs
## Instructions for AI Agents
- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.mangopay.com/_mcp/server
## Docs
- [Welcome to Mangopay docs](https://docs.mangopay.com/.md)
- [Onboarding guide](https://docs.mangopay.com/onboarding.md): How your platform can partner with Mangopay
- [Company information and documents](https://docs.mangopay.com/onboarding/company-documentation.md): Information and documents required to verify your platform during onboarding
- [Build with AI](https://docs.mangopay.com/build-with-ai.md): Use Mangopay docs and SDKs with AI tools
- [API](https://docs.mangopay.com/release-notes/api.md)
- [Packages and changelogs](https://docs.mangopay.com/release-notes/sdk.md)
- [Java SDK](https://docs.mangopay.com/release-notes/sdk/java.md)
- [NodeJS SDK](https://docs.mangopay.com/release-notes/sdk/nodejs.md)
- [.NET SDK](https://docs.mangopay.com/release-notes/sdk/net.md)
- [PHP SDK](https://docs.mangopay.com/release-notes/sdk/php.md)
- [Python SDK](https://docs.mangopay.com/release-notes/sdk/python.md)
- [Ruby SDK](https://docs.mangopay.com/release-notes/sdk/ruby.md)
- [Dashboard](https://docs.mangopay.com/release-notes/dashboard.md)
- [Node.js](https://docs.mangopay.com/sdks/nodejs.md): Learn all about Mangopay’s open-source Node.js SDK.
- [PHP](https://docs.mangopay.com/sdks/php.md)
- [Ruby](https://docs.mangopay.com/sdks/ruby.md): Learn all about Mangopay’s Ruby SDK.
- [Java](https://docs.mangopay.com/sdks/java.md): Learn all about Mangopay’s Java SDK.
- [Python](https://docs.mangopay.com/sdks/python.md): Learn all about Mangopay’s open-source Python SDK.
- [.NET](https://docs.mangopay.com/sdks/net.md)
- [Checkout SDK overview](https://docs.mangopay.com/sdks/checkout.md): Learn about the Mangopay Checkout SDK: how it works, supported payment methods, features and versions.
- [Checkout Web integration](https://docs.mangopay.com/sdks/checkout/web.md)
- [Recipients embedded experience](https://docs.mangopay.com/sdks/elements.md): Integrating the Recipients UI component using Mangopay Elements
- [Vault – Web](https://docs.mangopay.com/sdks/vault/web.md): Learn how to securely tokenize end user’s cards using the Mangopay Vault SDK for websites.
- [Profiler overview](https://docs.mangopay.com/sdks/profiler.md): Learn how the Mangopay fraud prevention profiler can enhance your protection.
- [Profiler - Web](https://docs.mangopay.com/sdks/profiler/web.md): How to integrate the fraud prevention profiler on web.
- [Profiler - iOS](https://docs.mangopay.com/sdks/profiler/ios.md): How to integrate the fraud prevention profiler on iOS.
- [Profiler - Android](https://docs.mangopay.com/sdks/profiler/android.md): How to integrate the fraud prevention profiler on Android.
- [Mirakl Connector](https://docs.mangopay.com/connectors/mirakl.md): Optimize your Mirakl marketplace with the Mangopay Connector for Mirakl.
- [Third-party PSPs with Echo](https://docs.mangopay.com/connectors/mirakl/acquiring/echo.md)
- [Enrich Orders with custom fields](https://docs.mangopay.com/connectors/mirakl/acquiring/echo/custom-fields.md): How to set up and integrate custom fields for Echo with Mirakl
- [Onboarding and synchronizing sellers](https://docs.mangopay.com/connectors/mirakl/sellers.md): Guide to the new Mangopay-hosted experiences to onboard your sellers
- [Postman](https://docs.mangopay.com/postman.md): How to use Postman to test the Mangopay API, with our dedicated collection containing all endpoints plus feature-focused flows.
- [Payment methods](https://docs.mangopay.com/testing/payment-methods.md): Card numbers and testing data for all payment methods to use in Sandbox testing: Visa, Mastercard, Google Pay, Apple Pay, PayPal, Klarna, as well as banking payments and virtual accounts.
- [Payouts](https://docs.mangopay.com/testing/payouts.md): How to test payouts with Mangopay: test bank accounts for IBAN and GB, as well as instant payouts and error cases.
- [Address verification system (AVS)](https://docs.mangopay.com/testing/mocks/avs.md): Use test values to simulate scenarios in the address verification system.
- [Recurring card payments](https://docs.mangopay.com/testing/mocks/recurring-card-payments.md): Register recurring payments using test values to simulate error cases in the series of payments.
- [All error codes](https://docs.mangopay.com/errors/codes.md)
- [Error report](https://docs.mangopay.com/errors/error-report.md): Learn about HTTP errors in the Mangopay API: how the error report is structured and what information it provides to help you debug your integration.
- [HTTP response codes](https://docs.mangopay.com/errors/http-response-codes.md): Learn about HTTP response codes returned by Mangopay's REST API and what they mean.
- [Webhook notifications](https://docs.mangopay.com/webhooks.md)
- [Event types](https://docs.mangopay.com/webhooks/event-types.md)
- [Customizing bank statement references](https://docs.mangopay.com/bank-statements.md): Send custom text to appear on the user’s bank statement for a payment on your platform.
- [Reports](https://docs.mangopay.com/reports.md): How to leverage the Mangopay API’s reporting endpoints to get the data you need on transaction activity.
- [Platform fees report](https://docs.mangopay.com/reports/platform-fees.md): List transactions crediting or debiting your platform’s Fees Wallet
- [Transactions report](https://docs.mangopay.com/reports/transactions.md): List transactions crediting or debiting user wallets
- [Wallets report](https://docs.mangopay.com/reports/wallets.md): List user wallets, their owners, descriptions and tags, and their balances at the time of report creation
- [Team management](https://docs.mangopay.com/dashboard/team.md): Manage your company's team members on the Mangopay Dashboard using role-based access control (RBAC)
- [Roles and scopes](https://docs.mangopay.com/dashboard/team/roles.md): Understand the action scopes in reach Dashboard role
- [Security at Mangopay](https://docs.mangopay.com/security.md): How Mangopay handles security, and best practices for your platform and users
- [Support](https://docs.mangopay.com/support.md)
- [Mangopay e-wallet system](https://docs.mangopay.com/guides/e-wallet-system.md): How Mangopay’s flexible e-wallet infrastructure can supercharge your payment flows.
- [Currencies](https://docs.mangopay.com/guides/currencies.md): Summary of Mangopay features by currency
- [Fees and billing](https://docs.mangopay.com/guides/fees.md): Learn how your platform can take fees on transactions, plus how Mangopay’s billing cycle works.
- [Glossary](https://docs.mangopay.com/guides/glossary.md): Understand key terms in payments and compliance for Mangopay flexible e-wallet solution
- [Introduction and types](https://docs.mangopay.com/guides/users/types.md): How your user community maps on to Mangopay’s user types, from private individuals to businesses, as well as non-profits and sole proprietors.
- [Categories](https://docs.mangopay.com/guides/users/categories.md): How Mangopay's system of Payer and Owner categories enables efficiency and security for your users: required information, permitted actions, plus details on the Platform category.
- [Blocked users](https://docs.mangopay.com/guides/users/blocked-users.md): Understand Mangopay’s criteria and processes for blocking users, including the reasons why and steps you can take to get them unblocked.
- [Country restrictions](https://docs.mangopay.com/guides/users/country-restrictions.md): Understand Mangopay’s country-specific restrictions, refusing funds based on origin and preventing the creation of users, bank accounts, and payouts.
- [Terms and conditions](https://docs.mangopay.com/guides/users/terms.md)
- [Privacy](https://docs.mangopay.com/guides/users/privacy.md)
- [Inactive users](https://docs.mangopay.com/guides/users/inactivity.md): Mangopay’s policy on inactive accounts (also called dormant accounts) and inactivity fees
- [Introduction to SCA](https://docs.mangopay.com/guides/sca.md): Learn about Mangopay's SCA features applicable to Owner users
- [SCA session redirection](https://docs.mangopay.com/guides/sca/session.md): Learn how to redirect a user for their hosted SCA session
- [Authentication factors](https://docs.mangopay.com/guides/sca/factors.md): Learn how authentication factors work on the hosted webpage
- [WebAuthn passkey on iOS](https://docs.mangopay.com/guides/sca/factors/passkey-ios.md): Integrate Mangopay's passkey factor in iOS apps
- [WebAuthn passkey on Android](https://docs.mangopay.com/guides/sca/factors/passkey-android.md): Integrate Mangopay's passkey factor in Android apps
- [SCA on users](https://docs.mangopay.com/guides/sca/users.md): Read about how SCA impacts user endpoints
- [SCA on recipients (bank accounts)](https://docs.mangopay.com/guides/sca/recipients.md): Read about Mangopay's new Recipients feature, replacing bank accounts
- [SCA on transfers](https://docs.mangopay.com/guides/sca/transfers.md): Read how SCA impacts the transfer endpoint
- [SCA on Mangopay Account access](https://docs.mangopay.com/guides/sca/wallets.md): Read about how SCA impacts wallet access endpoints
- [Proxy management](https://docs.mangopay.com/guides/sca/proxy-management.md): Managing user consent to the proxy allowing you to take action on their behalf
- [SCA on your platform](https://docs.mangopay.com/guides/sca/platform.md): Integrating the mTLS certificate factor required for platforms taking SCA action under proxy
- [Introduction](https://docs.mangopay.com/guides/users/verification.md): Understand identity verification with Mangopay: the rationale behind KYC/KYB, requirements for Owner users, and the specific documents needed for individuals and legal entities.
- [KYC/KYB restriction changes and pay-in beneficiaries](https://docs.mangopay.com/guides/payin-beneficiaries.md): Understand the KYC/KYB restrictions on transfers and pay-ins, and how to declare verified Owners as beneficiaries of pay-ins
- [KYC/KYB limits on payouts and user balance](https://docs.mangopay.com/guides/users/limits.md): Read about the KYC/KYB limits on payouts and wallet balance that are applicable under Mangopay's Payment Services (EEA) and Electronic Money Services (UK)
- [All requirements by user type](https://docs.mangopay.com/guides/users/verification/requirements.md)
- [Accepted identity documents](https://docs.mangopay.com/guides/users/verification/requirements/id-accepted.md): See all information required for individuals and the specific ID documents accepted depending on the country of issue.
- [Accepted local KYB documents](https://docs.mangopay.com/guides/users/verification/requirements/kyb-local.md)
- [Hosted IDV for KYC/KYB](https://docs.mangopay.com/guides/users/verification/hosted.md): Integrate Mangopay's web-hosted KYC/KYB verification solution
- [Natural users](https://docs.mangopay.com/guides/users/verification/hosted/natural.md): UX steps, validation flows, and outcomes of the hosted IDV flow for Natural Users
- [Soletrader users](https://docs.mangopay.com/guides/users/verification/hosted/soletrader.md): UX steps, validation flows, and outcomes of the hosted IDV flow for Legal Soletrader users
- [Multi-session PSC flow for Legal Users](https://docs.mangopay.com/guides/users/verification/hosted/business.md): UX steps, validation flows, and outcomes of the hosted IDV flow for Legal Business, Organization, and Partnership users
- [Business - Legacy single-session flow](https://docs.mangopay.com/guides/users/verification/hosted/business-legacy.md): Details of the legacy single-session flow for Business users, where a single legal representative is verified within the main session
- [Organization - Legacy single-session flow](https://docs.mangopay.com/guides/users/verification/hosted/organization-legacy.md): Details of the legacy single-session flow for Organization users, where a single legal representative is verified within the main session
- [Dealing with hosted KYC/KYB refusals](https://docs.mangopay.com/guides/users/verification/hosted/refusals.md)
- [KYC/KYB renewal](https://docs.mangopay.com/guides/users/verification/renewal.md): How KYC/KYB verification affects users on an ongoing basis
- [Verification downgrade](https://docs.mangopay.com/guides/users/verification/downgrade.md): Learn about the verification downgrade mechanism, the scenarios triggering a downgrade, and hook notifications for changes.
- [Document submission process](https://docs.mangopay.com/guides/users/verification/documents/submission.md): Learn about Mangopay’s KYC/KYB document validation process: submission steps, constraints, and dealing with refusals.
- [Document types](https://docs.mangopay.com/guides/users/verification/documents/types.md): Learn about types of KYC/KYB document with Mangopay: which are required for natural and legal users, plus submission constraints and guidelines.
- [How to submit a KYC Document](https://docs.mangopay.com/guides/users/verification/documents/submission/how-to.md): Step-by-step guide to submitting verification (KYC/KYB) documents: uploading files, managing outcomes, and setting up webhooks.
- [Identity proof best practices](https://docs.mangopay.com/guides/users/verification/documents/submission/id-best-practices.md): See best practices for submitting identity proof documents and errors to avoid to ensure that the document can be read and validated.
- [Dealing with refusals](https://docs.mangopay.com/guides/users/verification/documents/submission/refusals.md):
- [Company number](https://docs.mangopay.com/guides/users/verification/company-number.md): Manage the company numbers of legal users effectively, and see all expected formats per country, to accelerate the KYB verification process.
- [Beneficial owners](https://docs.mangopay.com/guides/users/verification/beneficial-owners.md): Learn about disclosing beneficial owners for Mangopay users: required information and documents, submission process, and dealing with refusals.
- [How to submit a UBO Declaration](https://docs.mangopay.com/guides/users/verification/beneficial-owners/how-to.md): Step-by-step guide to submitting beneficial owner (UBO) declarations of beneficial owners, including managing outcomes and setting up webhooks.
- [All supported payment methods](https://docs.mangopay.com/guides/payment-methods.md): Increase conversion and expand to new markets
- [Payment method activation](https://docs.mangopay.com/guides/payment-methods/activation.md): Activating additional payment methods and currencies for your platform
- [Card processing overview](https://docs.mangopay.com/guides/payment-methods/card.md)
- [Overview](https://docs.mangopay.com/guides/payment-methods/card/direct.md)
- [How to process a card payment](https://docs.mangopay.com/guides/payment-methods/card/direct/how-to.md): Make a card payment to get funds into a Mangopay wallet
- [Overview](https://docs.mangopay.com/guides/payment-methods/card/recurring.md): Understand recurring card payments and how they work, with customizable options for subscriptions and installments.
- [How to process a recurring card payment](https://docs.mangopay.com/guides/payment-methods/card/recurring/how-to.md): Step-by-step guide to processing recurring card payments, with flexible options for subscriptions and installments.
- [Overview](https://docs.mangopay.com/guides/payment-methods/card/preauthorization.md): Find out about Mangopay’s preauthorization features to reserve funds on a card to be captured later, with 7-day or 30-day options.
- [How to process a 7-day card preauthorization](https://docs.mangopay.com/guides/payment-methods/card/preauthorization/how-to.md): Step-by-step guide to preauthorizing funds on a card, then making one or multiple captures and releasing the hold on the remaining funds.
- [30-day preauth](https://docs.mangopay.com/guides/payment-methods/card/extended-preauthorization.md): How to place a hold on a card and capture the amount within 30 days.
- [Overview](https://docs.mangopay.com/guides/payment-methods/card/validation.md): Understand how the card validation feature can benefit your platform and your users by asking the user to authenticate themselves without processing a payment.
- [How to validate a card without debiting a payment](https://docs.mangopay.com/guides/payment-methods/card/validation/how-to.md): Step-by-step guide to validating a user's card without debiting a transaction, allowing you to provide a better registration experience.
- [3DS](https://docs.mangopay.com/guides/payment-methods/card/3ds.md): Learn about the 3D Secure protocol, the multi-factor authentication for online card payments.
- [Co-branded cards](https://docs.mangopay.com/guides/payment-methods/card/co-branded.md): Learn more about managing co-branded payment cards with Mangopay.
- [Card fingerprint](https://docs.mangopay.com/guides/payment-methods/card/fingerprint.md)
- [Address verification system](https://docs.mangopay.com/guides/payment-methods/card/avs.md): Learn about how to leverage Mangopay’s card anti-fraud features, including unique card fingerprints and an address verification system for enhanced security in only payments.
- [Bank wire](https://docs.mangopay.com/guides/payment-methods/banking/bank-wire.md)
- [Pay by Bank](https://docs.mangopay.com/guides/payment-methods/banking/pay-by-bank.md)
- [Virtual accounts](https://docs.mangopay.com/guides/payment-methods/banking/virtual-iban.md)
- [Direct debit](https://docs.mangopay.com/guides/payment-methods/banking/direct-debit.md): Learn about direct debits with Mangopay: how to create a bank account, set up a mandate and make a pay-in with Bacs or SEPA schemes.
- [Overview](https://docs.mangopay.com/guides/payment-methods/apple-pay.md): How users can securely make using cards saved with Apple Pay on iOS apps and websit
Measured from the saved file
Linked document
UTF-8 text size
68.8 KB70422 bytes
Token count
17294o200k_base encoding
Markdown links
475475 distinct URLs
Fenced code blocks
0494 lines in the file
Size measures the captured UTF-8 text, not compressed transfer size. Tokens are counted with a named tokenizer; other models can count differently. Neither measure establishes context compatibility or answer quality.
Project H1
Mangopay docs
Context architecture
How the content is divided
4 H2 sections organize 475 parsed Markdown links. 473 links point to .md or .markdown paths; 0 link occurrences use another hostname. Linked destinations have not been recursively validated.
H2 section
Links
UTF-8 bytes
Tokens
Instructions for AI AgentsLine 3
0
259
67
DocsLine 9
236
33242
8336
API DocsLine 250
237
36650
8818
OpenAPI SpecificationLine 490
2
179
53
Link counts exclude parsed fenced and inline code and resolve relative destinations against the final endpoint. Section sizes cover the text below each H2 until the next H2.
Embedded material
Code, installation and API examples
Fenced blocks
0 closed
Declared languages
No fenced blocks detected
Package-install commands
0 detected in fenced or inline code
Authentication examples
0 fenced lines match API-key, Authorization, Bearer, OAuth or access-token patterns
HTTP request examples
0 fenced lines match request-method patterns
Authentication links
3 links have authentication-related labels
Embedded example text and links to further documentation are counted separately. A code block does not establish that a sample runs or that an authentication flow succeeds.
Publisher prioritization
The Optional section
No H2 section named “Optional” was detected in this file.
The community proposal uses Optional by convention for secondary links that can be skipped for a shorter context. This label does not establish that everything outside it is critical, or that the material inside it is deprecated.
Machine-readable routes
MCP references and configuration text
MCP-related text was detected in the captured file. 0 links have MCP-related labels or paths. 0 fenced lines match mcpServers, mcp_servers or an mcp add command.
These are text and link observations. No MCP server connection, authentication or tool call was tested.
A verified text response establishes a companion at the checked URL. It does not prove the bundle contains all product documentation, that generation is automated, or that it fits an assistant’s context window.
Change evidence
What can be said about freshness
This capture establishes a baseline. Update frequency cannot be determined from one observation.
Linked release and migration material
9 links have release, changelog, deprecation or migration terms in their labels or paths. These provide places to investigate product changes separately.
File changes can reveal documentation edits or navigation changes. They do not by themselves measure product release velocity, accuracy, agent adoption or AI visibility.
Counts use a deterministic parser, not a spec-compliance grade. Unusual Markdown and indented code can fall outside its recognized patterns. See the llms.txt proposal and tokenizer implementation.