PHP SDK

​

3.51.0 - Mar 23, 2026

​

Added

​

Support for mTLS authentication

• Added ClientCertificatePath, ClientCertificateKeyPath, ClientCertificateString, ClientCertificateKeyString, ClientCertificateKeyPassword properties to Configuration.php
• Updated the BuildRequest() method to add the mTLS certificate based on the configuration properties
• Updated README.md file with details on how to configure mTLS for the SDK

​

3.50.1 - Feb 23, 2026

​

Added

​

ChargeBearer body parameter on payouts

• Added ChargeBearer param (String) to PayOutPaymentDetailsBankWire class
• Updated tests

​

Added

​

AuthenticationType response property on card pay-ins

• Added the AuthenticationResult class
• Added AuthenticationResult param (Object containing AuthenticationType) to CardPreAuthorization, CardValidation, Deposit, PayIn classes
• Updated tests

​

Added

​

TelephoneOrder body parameter on recurring card pay-ins (CIT and MIT)

• Added PaymentCategory (String) to RecurringPayInCIT and RecurringPayInMIT classes
• Updated tests

​

3.50.0 - Feb 12, 2026

​

FX

​

Breaking change

​

Custom fees

• Added RequestedFees to ConversionQuote
• Added RequestedFees to Conversion

​

Added

​

User margin

• Added UserMargin to CreateInstantConversion, ConversionQuote
• Added MarginsResponse to Conversion, ConversionQuote

​

Echo

​

Breaking change

​

Settlement upload endpoints

• Updated settlement_sample.csv and tests
• Added FileName and UploadUrl to Settlement

 $settlement = new Settlement();
 $settlement->FileName = 'settlement_sample.csv';
 result = $this->_api->Settlements->GenerateUploadUrl($settlement);

$dto = new Settlement();
$dto->FileName = 'updated_settlement_sample.csv';
$dto->Id = $settlement->SettlementId;
$result = $this->_api->Settlements->GenerateNewUploadUrl($dto);

​

Added

​

GET validations for a Settlement endpoint

• Added SettlementValidation, SettlementValidationFooter, SettlementValidationLine classes
• Added GetValidations method to ApiSettlements

_api->Settlements->GetValidations($settlement->SettlementId, $pagination);

​

PUT Cancel a Settlement endpoint

• Added Cancel method to ApiSettlements

_api->Settlements->Cancel($settlement->SettlementId);

​

Intent unfunded amounts and source wallet

• Added SplitOriginWalletId to PayInIntentLineItem and PayInIntentSplit
• Added UnfundedSellerAmount to PayInIntentLineItem
• Added UnfundedAmount to PayInIntent

​

POST Create an Intent Refund

• Added Refund and Capture to PayInIntent
• Added CreatePayInIntentRefund method to ApiPayIns

_api->PayIns->CreatePayInIntentRefund($intent->Id, $refundDto);

​

POST Reverse an Intent Refund

• Added ReversePayInIntentRefund method to ApiPayIns

_api->PayIns->ReversePayInIntentRefund($intent->Id, $intent->Refund->Id, $reverseRefundDto);

​

POST Create an Intent Dispute

• Added Dispute to PayInIntent
• Added CreatePayInIntentDispute method to ApiPayIns

_api->PayIns->CreatePayInIntentDispute($intent->Id, $intent->Capture->Id, $disputeDto);

​

PUT Update an Intent Dispute

• Added Decision to PayInIntent
• Added UpdatePayInIntentDisputeOutcome method to ApiPayIns

$outcomeDto = new PayInIntent();
$outcomeDto->Decision = "DEFENDED";
_api->PayIns->UpdatePayInIntentDisputeOutcome($intent->Id, $intent->Capture->Id, $intent->Dispute->Id, $outcomeDto);

​

Fixed

​

VirtualAccountCapabilities

• Fixed LocalPayInAvailable and InternationalPayInAvailable in VirtualAccountCapabilities class

​

3.49.0 - Jan 30, 2026

​

Added

​

Support for new SCA status endpoint

​

RecipientId property on payouts

​

New event types

​

3.48.0 - Nov 28, 2025

​

Changed

• Migrated to V4 naming convention

​

3.47.1 - Nov 25, 2025

​

Added

• Support for ScaContext on POST Create a Recipient for platforms taking action by proxy with consent from the user (API release note)

​

3.47.0 - Oct 27, 2025

​

Added

• New POST Manage proxy consent for a User endpoint to obtain and manage user consent via the hosted SCA experience (if proxy is activated). A proxy and user consent are now required to use the USER_NOT_PRESENT value for ScaContext (API release note)
• ScaContext request parameter newly added on all user POST and PUT endpoints, enabling the platform to request these actions with USER_NOT_PRESENT – provided the proxy is in place, activated, and the user has given consent (API release note)
• Support for the Licensor property on GET View a Client

​

Changed

• x-tenant-id deprecated as no longer necessary for UK platforms; the parameter is ignored by Mangopay

​

3.46.0 - Oct 1, 2025

​

Added

• Verification of Payee (VOP) API response fields (RecipientVerificationOfPayee and sub-properties) on the endpoints GET View a Recipient, POST Create a Recipient, POST Create a Payout (API release note, #739)
• Support for the POST Cancel an Intent endpoint for Echo, Mangopay’s solution for platforms working with another third-party PSP for funds acquisition
• Support for POST Submit data for a PayPal PayIn endpoint

​

3.45.2 - Sep 23, 2025

​

Added

• Support for ProfilingAttemptReference on all payment methods for Mangopay’s Fraud Prevention solution #743
• Webhook event types for Echo, Mangopay’s solution for third-party PSP integrations: INTENT_AUTHORIZED,INTENT_CAPTURED,INTENT_REFUNDED,INTENT_REFUND_REVERSED,INTENT_DISPUTE_CREATED,INTENT_DISPUTE_DEFENDED,INTENT_DISPUTE_WON,INTENT_DISPUTE_LOST,INTENT_SETTLED_NOT_PAID,INTENT_PAID,SPLIT_CREATED,SPLIT_PENDING_FUNDS_RECEPTION,SPLIT_AVAILABLE,SPLIT_REJECTED,SPLIT_REVERSED
• Support for VirtualAccountPurpose on Banking Alias object

​

3.45.1 - Sep 3, 2025

​

Added

• Support for Fees on ConversionQuote

​

Improved

• OAuth token refresh buffer before expiry updated to 30s
• Curl verification of SSL certificate
• PHP 8.2 compatibility

​

Fixed

• Tests

​

3.45.0 - Aug 14, 2025

​

Changed

• Type casting to deserialize arrays in GetSchema

⚠️Caution – Potentially breaking The new GetSchema typings may result in a breaking change if your integration relies on the stdClass returned previously.

• Made PendingUserAction nullable

​

Added

• Support for POST Create a Bank Wire to the Repudiation Wallet

​

3.44.0 - Aug 7, 2025

​

Added

• PUT Update an Intent Split
• POST Execute an Intent Split
• POST Reverse an Intent Split
• GET View an Intent Split

• ECHO_INTENT
• ECHO_INTENT_ACTION
• ECHO_SETTLEMENT
• ECHO_SPLIT

​

3.43.1 - Jul 28, 2025

​

Added

• Sku parameter on LineItem, for Klarna PayIns
• handle new endpoint View supported banks for Pay by Bank, to enable presentation of banks to user before Pay by Bank payment request

​

3.43.0 - Jul 18, 2025

​

Added

• POST Create an Intent
• GET View an Intent
• POST Create a Capture for an Intent
• POST Create a Settlement
• PUT Update a Settlement
• GET View a Settlement
• POST Create an Intent Split

​

3.42.0 - Jul 3, 2025

​

Added

• New endpoint POST Create a Bizum PayIn
• New webhook event types for SCA enrollment (API release note), note that these are triggered on enrollment not authentication:
  • SCA_ENROLLMENT_SUCCEEDED
  • SCA_ENROLLMENT_FAILED
  • SCA_ENROLLMENT_EXPIRED
• New webhook event types for UserCategory change (API release note):
  • USER_CATEGORY_UPDATED_TO_OWNER
  • USER_CATEGORY_UPDATED_TO_PAYER
  • USER_CATEGORY_UPDATED_TO_PLATFORM
• Support for PLATFORM value to UserCategory enum
• Support for GET List Transactions for a Card Fingerprint

​

3.41.1 - Jun 12, 2025

​

Added

• US and CA virtual accounts for local pay-in collection

​

Fixed

• On POST Enroll a User, PendingUserAction cast to MangoPayPendingUserAction instead of stdClass

​

3.41.0 - Jun 10, 2025

​

Added

• POST Create a Report
• GET View a Report
• GET List all Reports

• REPORT_GENERATED
• REPORT_FAILED

​

3.40.1 - Jun 6, 2025

​

Added

• Support for RecipientScope query parameter on GET List Recipients for a User
• Support for missing webhook event types (recurring registration, deposit preauth, etc)

​

Fixed

• Status enum value on Identity Verification object changed from OUTDATED to OUT_OF_DATE