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

# API - November 17, 2026

## Changed

### IP allowlist required for each Client ID

Your platform must now declare IP addresses from which your API requests originate.

All platforms need to add their IP addresses (CIDR ranges) to an allowlist in the [Mangopay Dashboard](https://hub.mangopay.com/). You need to do this for each Client ID that reaches Mangopay's servers, in your Production and Sandbox environments.

Once you activate enforcement on your IP allowlist (before the deadline communicated via email), any API requests originating from IPs not included in the list will be blocked.

This change helps improve security for your platform and your users by ensuring that, in addition to being valid, authentication credentials are also being used from an expected and authorized source.

To set up your IP allowlist:

* Refer to the [IP allowlist](/api-reference/overview/ip-allowlist) guide for detailed guidance
* Connect to the [Mangopay Dashboard](https://hub.mangopay.com/) (***Settings*** > ***Team & security*** > ***IP allowlist***, requires **Admin** role)

> **Warning**
>
> **Caution – Enforcement blocks traffic from non-allowed sources**
>
> Once you have added all IP addresses to your allowlist for a given Client ID, you can activate enforcement in the Dashboard.
>
> When you activate enforcement, any API calls originating from sources not included in the CIDR ranges on the allowlist are refused and return a 403 - Forbidden HTTP error. API calls originating from IPs in the allowlist continue to reach Mangopay as before.
>
> If your list does not comprehensively include all public IPs of all your systems that call Mangopay’s API endpoints, then your services could be inadvertently interrupted.
>
> Mangopay is not responsible for any service disruption resulting from a misconfiguration of the IP allowlist feature.