Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Mangopay/mangopay4-php-sdk/llms.txt

Use this file to discover all available pages before exploring further.

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.