Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mangopay.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Added

​
ScaContext request parameter added to Recipient creation endpoint

The ScaContext parameter has been added to the POST Create a Recipient endpoint to enable platforms to request this action on behalf of the user with the user’s consent. Provided RecipientScope is PAYOUT (which is the default value), then the ScaContext parameter is set to USER_PRESENT by default because the user must perform SCA to register the external bank account. If your platform has a proxy in place with the user that allows you to register a bank account on their behalf, then the user must also provide consent to Mangopay. Once proxy management is activated by Mangopay, the user can provide consent via the hosted SCA session returned on the POST Manage proxy consent for a User endpoint, or the next SCA session returned for them after proxy activation. If proxy management is activated for the action and the user has given consent, then your platform can use the USER_NOT_PRESENT value to create a recipient without the User present to perform SCA. If the User has not given or revoked consent, then a 403 error is returned. No changes are required on Recipients for platforms not using proxy for external bank account registration. Read more about proxy management →

​
Changed

​
Legacy User endpoints deprecated

The legacy User endpoints, made redundant during the introduction of SCA, have been marked as deprecated:
Caution – Endpoints planned for removal Dec 15, 2025The endpoints above will cease to function after Dec 15, 2025.Your platform must integrate the equivalent SCA-enabled endpoints to avoid errors.All platforms should call the new endpoints in all cases, including those where SCA is not required (e.g. for PAYER users).

​
Changed

In Sandbox, SCA is now applied to all Legal User types by default. Previously, the SCA redirection link (RedirectUrl) was only returned if the LegalPersonType was SOLETRADER. In Production, SCA will be applied to all Legal User types on Dec 15, 2025. Read more about legal user integration for SCA →