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-Type

There are two endpoints that require the application/x-www-form-urlencoded Content-Type:

​
UK platforms

Platforms that have contracted with Mangopay’s UK entity must include the following header in all requests in Production:

KeyValue
x-tenant-iduk

There is no equivalent for platforms contracting with other Mangopay entities.

If you’re using an SDK, you need to change the configuration during initialization by setting the UK header flag value to true.

<?php

require_once 'vendor/autoload.php';

use MangoPay\MangoPayApi;
use MangoPay\Libraries\ResponseException as MGPResponseException;
use MangoPay\Libraries\Exception as MGPException;

$api = new MangoPayApi();

$api->Config->ClientId = 'your-mangopay-client-id';
$api->Config->ClientPassword = 'your-mangopay-api-key';
$api->Config->TemporaryFolder = 'tmp/';
$api->Config->UKHeaderFlag = true;