Skip to main content
The Mangopay API is based on REST principles, providing a simple and secure way to process payment flows. To work with our API, you can:
  • Use the HTTP/REST endpoints
  • Take advantage of our SDKs
  • Make use of our official integrations

Environments

Mangopay provides two environments:
ProductionSandbox
https://api.mangopay.comhttps://api.sandbox.mangopay.com
The Mangopay API accepts and returns:
Content-Typeapplication/json
EncodingUTF-8 JSON
Note – Endpoints requiring a different Content-TypeThere are two endpoints that require the application/x-www-form-urlencoded Content-Type:

UK platforms

Previously, Mangopay required platforms that contracted with Mangopay’s UK entity to include an HTTP header in all API requests in Production. This is no longer the case. The header x-tenant-id (with values eu (default) or uk) is deprecated and ignored by Mangopay if sent. In the SDKs, there was a UK header flag boolean which, when true, set the header value to uk. The tenant notion was replaced with the Licensor field of the API’s Client object, and it is set automatically by Mangopay.