Migration Guide

use MangoPay\Money;

$conversion = new \MangoPay\CreateInstantConversion();
$conversion->DebitedFunds = new Money();
$conversion->DebitedFunds->Currency = 'EUR';
$conversion->DebitedFunds->Amount = 1000;

// Fees as Money object
$conversion->Fees = new Money();
$conversion->Fees->Currency = 'EUR';
$conversion->Fees->Amount = 10;

$result = $api->Conversions->CreateInstantConversion($conversion);

use MangoPay\Money;
use MangoPay\CustomFees;

$conversion = new \MangoPay\CreateInstantConversion();
$conversion->DebitedFunds = new Money();
$conversion->DebitedFunds->Currency = 'EUR';
$conversion->DebitedFunds->Amount = 1000;

// Fees as CustomFees object
$conversion->Fees = new CustomFees();
$conversion->Fees->Type = 'FIXED'; // or 'PERCENTAGE'
$conversion->Fees->Value = 10; // Fixed amount or percentage value

$result = $api->Conversions->CreateInstantConversion($conversion);

$conversion = new \MangoPay\CreateInstantConversion();
$conversion->DebitedFunds = new Money();
$conversion->DebitedFunds->Currency = 'EUR';
$conversion->DebitedFunds->Amount = 1000;

// Set custom user margin (in basis points)
$conversion->UserMargin = 50; // 0.5%

$result = $api->Conversions->CreateInstantConversion($conversion);

// Direct upload method
$api->Settlements->upload($settlementId, $filePath);

// Direct update method
$api->Settlements->update($settlementId, $settlement);

// Step 1: Generate upload URL
$uploadUrl = $api->Settlements->GenerateUploadUrl($settlementId, 'filename.csv');

// Step 2: Upload file to the URL (using your preferred HTTP client)
// Example with cURL:
$ch = curl_init($uploadUrl->UploadUrl);
curl_setopt($ch, CURLOPT_PUT, true);
curl_setopt($ch, CURLOPT_INFILE, fopen($filePath, 'r'));
curl_setopt($ch, CURLOPT_INFILESIZE, filesize($filePath));
curl_exec($ch);
curl_close($ch);

// For generating a new upload URL:
$newUploadUrl = $api->Settlements->GenerateNewUploadUrl($settlementId, 'new-filename.csv');

{
  "require": {
    "mangopay4/php-sdk": "^3.48"
  }
}

composer update mangopay4/php-sdk

// GetSchema returned stdClass objects
$schema = $api->Recipients->GetSchema('GB');
// $schema properties were stdClass instances

// GetSchema now returns properly typed arrays
$schema = $api->Recipients->GetSchema('GB');
// $schema properties are now typed arrays instead of stdClass

// Before
if ($schema->someProperty instanceof \stdClass) {
    // Handle stdClass
}

// After - check for array instead
if (is_array($schema->someProperty)) {
    // Handle array
}

// Always check for null before accessing
if ($user->PendingUserAction !== null) {
    $redirectUrl = $user->PendingUserAction->RedirectUrl;
}

User-Agent: Mangopay-SDK/SDKVersion (Language/LanguageVersion)

$registration->TotalAmount = 10000; // Integer

use MangoPay\Money;

$registration->TotalAmount = new Money();
$registration->TotalAmount->Currency = 'EUR';
$registration->TotalAmount->Amount = 10000;

use MangoPay\UserLegal;
use MangoPay\LegalPersonType;
use MangoPay\Address;

$user = new UserLegal();
$user->LegalPersonType = LegalPersonType::Partnership;
$user->Name = "Example Partnership";
$user->Email = "[email protected]";

$user->LegalRepresentativeFirstName = "John";
$user->LegalRepresentativeLastName = "Doe";
$user->LegalRepresentativeBirthday = mktime(0, 0, 0, 12, 21, 1975);
$user->LegalRepresentativeNationality = "GB";
$user->LegalRepresentativeCountryOfResidence = "GB";

$user->HeadquartersAddress = new Address();
$user->HeadquartersAddress->AddressLine1 = "1 London Road";
$user->HeadquartersAddress->City = "London";
$user->HeadquartersAddress->PostalCode = "SW1A 1AA";
$user->HeadquartersAddress->Country = "GB";

$createdUser = $api->Users->Create($user);

$api = new MangoPayApi();
$user = new MangoPayUserNatural();

use MangoPay\MangoPayApi;
use MangoPay\UserNatural;

$api = new MangoPayApi();
$user = new UserNatural();

require_once 'mangopay2-php-sdk/MangoPaySDK.php';

require_once 'vendor/autoload.php';

require_once '/path/to/mangopay/Autoloader.php';

use MangoPay\MangoPayApi;

$api = new MangoPayApi();
$api->Config->ClientId = 'your-sandbox-client-id';
$api->Config->ClientPassword = 'your-sandbox-api-key';
$api->Config->BaseUrl = 'https://api.sandbox.mangopay.com';
$api->Config->TemporaryFolder = '/tmp/mangopay-sandbox/';