Skip to main content
This page contains the complete version history of the Mangopay PHP SDK, including all features, improvements, and bug fixes across releases.

​
Latest Releases

​
[3.50.1] - 2026-02-23

​
Added - ChargeBearer body parameter on payouts

On POST Create a Payout, platforms can now request to pay all SWIFT fees using the OUR value of the new ChargeBearer property (API release note).

​
Added - AuthenticationType response property on card pay-ins

The AuthenticationResult.AuthenticationType response property is now returned on card pay-ins.

​
Added - TelephoneOrder body parameter on recurring card pay-ins

To support the TelephoneOrder property on POST Create a Recurring PayIn (MIT) and POST Create a Recurring PayIn (CIT), the SDK now handles the PaymentCategory parameter.

​
[3.50.0] - 2026-02-12

This release contains breaking changes related to FX fees and Settlement upload endpoints.

​
FX - Breaking change: Custom fees

To support percentage-based FX fees (API release note):
  • Breaking change – The CreateInstantConversion.Fees type is now CustomFees instead of Money, to support the new FX fees structure of Type (PERCENTAGE | FIXED) and Value
  • Breaking change - The ConversionQuote.Fees type is now CustomFees instead of Money, to support the new FX fees structure of Type (PERCENTAGE | FIXED) and Value
  • Added RequestedFees to ConversionQuote and Conversion

​
FX - Added: User margin

To support the FX user margin (API release note):
  • Added UserMargin to CreateInstantConversion and ConversionQuote
  • Added MarginsResponse to Conversion and ConversionQuote

​
Echo - Breaking change: Settlement upload endpoints

To support the new behavior of the POST Create a Settlement endpoint:
  • Updated settlement_sample.csv and tests
  • Added FileName and UploadUrl to Settlement
  • Added GenerateSettlementUploadUrl interface
  • Breaking change – Replaced upload method in ApiSettlements with GenerateUploadUrl
  • Breaking change – Replaced update method in ApiSettlements with GenerateNewUploadUrl

​
Echo - New endpoints

​
Echo - New properties

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

​
Fixed - VirtualAccountCapabilities

Fixed LocalPayInAvailable and InternationalPayInAvailable in VirtualAccountCapabilities class.

​
[3.49.0] - 2026-01-27

​
Added

  • Support for GET View the SCA status of a User endpoint (API release note)
  • Support for new event types:
    • SCA_CONTACT_INFORMATION_UPDATE_CONSENT_GIVEN
    • SCA_CONTACT_INFORMATION_UPDATE_CONSENT_REVOKED
    • SCA_TRANSFER_CONSENT_GIVEN
    • SCA_TRANSFER_CONSENT_REVOKED
    • SCA_RECIPIENT_REGISTRATION_CONSENT_GIVEN
    • SCA_RECIPIENT_REGISTRATION_CONSENT_REVOKED
    • SCA_VIEW_ACCOUNT_INFORMATION_CONSENT_GIVEN
    • SCA_VIEW_ACCOUNT_INFORMATION_CONSENT_REVOKED
    • SCA_EMAIL_VERIFIED
    • SCA_PHONE_NUMBER_VERIFIED
  • Support for RecipientId property on payouts (API release note)

​
[3.48.0] - 2025-11-28

​
Changed

  • Migrated to V4 naming convention

​
[3.47.1] - 2025-11-25

​
Added

​
[3.47.0] - 2025-10-27

​
Added

  • New POST Manage proxy consent for a User endpoint to obtain and manage user consent via the hosted SCA experience
  • ScaContext request parameter on all user POST and PUT endpoints, enabling platforms to request these actions with USER_NOT_PRESENT
  • 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

​
Previous Releases

​
Added

​
Added

  • Support for ProfilingAttemptReference on all payment methods for Mangopay’s Fraud Prevention solution
  • Webhook event types for Echo:
    • 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

​
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 fixed
Potentially breaking: The new GetSchema typings may result in a breaking change if your integration relies on the stdClass returned previously.

​
Changed

  • Type casting to deserialize arrays in GetSchema
  • Made PendingUserAction nullable

​
Added

​
Added

Support for new Splits endpoints for Echo (API release note):New ReportTypes for Echo:
  • ECHO_INTENT
  • ECHO_INTENT_ACTION
  • ECHO_SETTLEMENT
  • ECHO_SPLIT

​
2024 Releases

​
Added

New endpoints for the Virtual Account object:
  • Create a Virtual Account
  • Deactivate a Virtual Account
  • View a Virtual Account
  • List Virtual Accounts for a Wallet
  • View Client Availabilities

​
Added

​
2023 Releases

​
Added

  • Instantly convert funds between 2 wallets of different currencies owned by the same user with the new SPOT FX endpoints

​
Added

  • Multibanco, Satispay, Blik, Klarna payment methods (private beta)
  • Card validation endpoint (private beta)
  • New parameter for Paypal: ShippingPreference
  • Timeout configuration is now customizable (default: 30s)

​
Updated

  • Google Pay integration improved (private beta)

​
Fixed

  • MBWay & PayPal now using Web Execution Type

​
Added

  • Knowing when a dispute was closed is now possible with the new ClosedDate parameter for the Dispute object
  • Updated endpoints: View a Dispute, List Disputes for a User, List Disputes for a Wallet, List all Disputes, List Disputes that need settling
The ClosedDate field only displays values for Disputes closed after this release. Otherwise, a null value is returned.

​
Added

  • New legal entity type: PARTNERSHIP for the LegalPersonType parameter
  • Updated user creation and update endpoints to support the new type
Changing the LegalPersonType to PARTNERSHIP for an existing user will automatically result in:
  • A KYC downgrade to Light (default) verification
  • The REGISTRATION_PROOF document being flagged as OUT_OF_DATE

​
2022 Releases

​
Added

​
New 30-day preauthorization feature

Preauthorizations can now hold funds for up to 30 days:
  • The ApiDeposits class has been added with methods for creating, fetching and canceling a deposit
  • The CreateCardPreAuthorizedDepositPayIn() method has been added to the ApiPayIns class

​
Added

Recurring: €0 deadlines for CITSetting free recurring payment deadlines is now possible for CIT (customer-initiated transactions) with the FreeCycles parameter.

​
Added

​
UserCategory management

Users can now be differentiated with the new UserCategory parameter:
  • Payer – For users who only pay
  • Owner – For users who receive funds (required to accept T&Cs)

​
RecurringPayinRegistrationId in all PayIn GET calls

Added missing RecurringPayinRegistrationId to all PayIn get calls.

​
Added

  • Terms and conditions acceptance can now be registered via the SDK with the new TermsAndConditionsAccepted parameter

​
2021 Releases

​
Added

New hooks for Instant payouts:
  • INSTANT_PAYOUT_SUCCEEDED
  • INSTANT_PAYOUT_FALLBACKED

​
Added

  • Recurring payments feature
  • Create a Recurring PayIn Registration object
  • Initiate recurring payment flow with authenticated transaction (CIT)
  • Continue recurring payment flow with non-authenticated transaction (MIT)
This feature requires Support team approval for production use.

​
Added

  • Instant payment mode for payouts (25 seconds vs 48 hours)
  • This feature must be authorized and activated by MANGOPAY
For the complete version history prior to 2021, please refer to the CHANGELOG.md file in the GitHub repository.

​
Getting Help

Report Issues

Found a bug or have a feature request? Report it on GitHub.

Migration Guide

Learn how to migrate between major versions.

Build docs developers (and LLMs) love

Get started for freeTalk to us