.NET SDK

​

3.40.0 - Mar 23, 2026

​

Added

​

Support for mTLS authentication

• Added ClientCertificate, ClientCertificateString, ClientCertificatePassword to Configuration.cs
• Added GetEffectiveCertificate() method to Configuration.cs which returns an instance of X509Certificate2 based on the provided configuration
• Updated the RestSharpDto() method in RestTool.cs to take account for the certificate
• Moved global private readonly RestClientOptions _options; to a local variable inside the RestSharpDto() method
• Updated the GetInstance() to include the certificate param (optional)
• Updated README.md file with details on how to configure mTLS for the SDK

​

3.39.1 - Feb 23, 2026

​

Added

​

ChargeBearer body parameter on payouts

• Added ChargeBearer param (String) to PayOutDTO and PayOutBankWirePostDTO classes
• Updated tests

​

Added

​

AuthenticationType response property on card pay-ins

• Added the AuthenticationResult class
• Added AuthenticationResult param (Object containing AuthenticationType) to CardPreAuthorizationDTO, CardValidationDTO, DepositDTO, ApplePayDirectPayInDTO, GooglePayDirectPayInDTO, PayInCardDirectDTO, PayInCardWebDTO, PayInGooglePayDirectDTO, RecurringPayInDTO classes
• Updated tests

​

Added

​

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

• Added PaymentCategory (String) to RecurringPayInCITPostDTO, RecurringPayInMITPostDTO, RecurringPayInDTO classes
• Updated tests

​

3.39.0 - Feb 12, 2026

​

FX

​

Breaking change

​

Custom fees

• Added Fees to ConversionQuotePostDTO
• Added Fees, RequestedFees to ConversionQuoteDTO
• Added RequestedFees to ConversionDTO

​

Added

​

User margin

• Added UserMargin to ConversionQuotePostDTO, InstantConversionPostDTO
• Added MarginsResponse to ConversionDTO, ConversionQuoteDTO

​

Echo

​

Breaking change

​

Settlement upload endpoints

• Updated settlement_sample.csv and tests

var dto = new GenerateSettlementUploadUrlPostDTO { FileName = "settlement_sample.csv" };
await Api.ApiSettlements.GenerateUploadUrl(dto);

var dto = new GenerateSettlementUploadUrlPutDTO { FileName = "settlement_sample_new.csv" };
await Api.ApiSettlements.GenerateNewUploadUrl(dto, settlement.SettlementId);

• Added FileName and UploadUrl to IntentSettlementDTO
• Added GenerateSettlementUploadUrlPostDTO class
• Added GenerateSettlementUploadUrlPutDTO class

​

Added

​

GET validations for a Settlement endpoint

• Added SettlementValidationDTO, SettlementValidationFooterDTO, SettlementValidationLineDTO classes
• Added GetValidations method to ApiSettlements

await Api.ApiSettlements.GetValidations(settlement.SettlementId);

​

PUT Cancel a Settlement endpoint

• Added Cancel method to ApiSettlements

await Api.ApiSettlements.Cancel(settlement.SettlementId);

​

Intent unfunded amounts and source wallet

• Added SplitOriginWalletId to PayInIntentLineItem and PayInIntentSplitPostDTO
• Added UnfundedSellerAmount to PayInIntentLineItem
• Added UnfundedAmount to PayInIntentDTO, PayInIntentAuthorizationPostDTO

​

POST Create an Intent Refund

• Added PayInIntentRefund and PayInIntentCapture to PayInIntentDTO
• Added CreatePayInIntentPartialRefundAsync, CreatePayInIntentFullRefundAsync methods to ApiPayIns
• Added PayInIntentPartialRefundPostDTO, PayInIntentFullRefundPostDTO classes

 await Api.PayIns.CreatePayInIntentPartialRefundAsync(dto, intent.Id);
 await Api.PayIns.CreatePayInIntentFullRefundAsync(dto, intent.Id);

​

POST Reverse an Intent Refund

• Added FullReversePayInIntentRefundPostDTO, PartialReversePayInIntentRefundPostDTO classes
• Added FullReversePayInIntentRefundAsync, PartialReversePayInIntentRefundAsync methods to ApiPayIns

await Api.PayIns.PartialReversePayInIntentRefundAsync(dto, intent.Id, intent.Refund.Id);

await Api.PayIns.FullReversePayInIntentRefundAsync(dto, intent.Id, intent.Refund.Id);

​

POST Create an Intent Dispute

• Added PayInIntentDispute to PayInIntentDTO
• Added PayInIntentPartialDisputePostDTO, PayInIntentFullDisputePostDTO classes
• Added CreateFullPayInIntentDisputeAsync, CreatePartialPayInIntentDisputeAsync methods to ApiPayIns

await Api.PayIns.CreateFullPayInIntentDisputeAsync(dto, intent.Id, intent.Capture.Id);

await Api.PayIns.CreatePartialPayInIntentDisputeAsync(dto, intent.Id, intent.Capture.Id);

​

PUT Update an Intent Dispute

• Added Decision to PayInIntentDTO
• Added DisputeOutcomePutDTO class
• Added UpdatePayInIntentDisputeOutcomeAsync method to ApiPayIns

await Api.PayIns.UpdatePayInIntentDisputeOutcomeAsync(putDto, intent.Id, intent.Capture.Id, intent.Dispute.Id);

​

3.38.0 - Jan 30, 2026

​

Added

​

Support for new SCA status endpoint

   public class ConsentScopeDTO
   {
       public string ContactInformationUpdate { get; set; }


       public string RecipientRegistration { get; set; }


       public string Transfer { get; set; }


       public string ViewAccountInformation { get; set; }
   }

   public class ScaStatusDTO : EntityBase
   {
       public string UserStatus { get; set; }


       public bool IsEnrolled { get; set; }


       [JsonConverter(typeof(UnixDateTimeConverter))]
       public DateTime? LastEnrollmentDate { get; set; }


       [JsonConverter(typeof(UnixDateTimeConverter))]
       public DateTime? LastConsentCollectionDate { get; set; }


       public ConsentScopeDTO ConsentScope { get; set; }
   }

       /// <summary>
       /// Get SCA status
       /// </summary>
       /// <param name="userId">User identifier</param>
       /// <returns>ScaStatusDTO instance</returns>
       public async Task<ScaStatusDTO> GetScaStatusAsync(string userId)
       {
           return await this.GetObjectAsync<ScaStatusDTO>(MethodKey.UsersScaStatusGet, entitiesId: userId);
       }

​

New event types

namespace MangoPay.SDK.Core.Enumerations
{
    /// <summary>Event types enumeration.</summary>
    public enum EventType
    {
        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,
    }
}

​

RecipientId property on payouts

• Updated MangoPay.SDK/Entities/GET/PayOutBankWireDTO.cs (marked BankAccountId nullable and added RecipientId)
• Updated MangoPay.SDK/Entities/POST/PayOutBankWirePostDTO.cs (marked BankAccountId nullable and added RecipientId)
• Updated corresponding tests

​

3.37.0 - Nov 28, 2025

​

Changed

• Migrated to V4 naming convention

​

3.36.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.36.0 - Oct 28, 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.35.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)
• 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.34.3 - Sep 23, 2025

​

Added

• Support for ProfilingAttemptReference on all payment methods for Mangopay’s Fraud Prevention solution
• 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.34.2 - Sep 3, 2025

​

Added

• Support for missing properties on UserDTO base class: UserCategory, TermsAndConditionsAccepted, TermsAndConditionsAcceptedDate (the properties have been moved to UserDTO)
• Support for missing DisputeReasonType enum value

​

Changed

• OAuth token refresh buffer before expiry updated to 30s
• Removed unused ApiPermissionGroups and ApiSingleSignOn, API endpoints no longer available

​

Fixed

• Error parsing to avoid ArgumentNullException
• Tests

​

3.34.1 - Aug 14, 2025

​

Added

• Support for POST Create a Quoted Conversion between Client Wallets and POST Create an Instant Conversion between Client Wallets

​

3.34.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.33.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.33.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.32.0 - Jun 16, 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.31.1 - Jun 16, 2025

​

Added

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

​

3.31.0 - Jun 10, 2025

​

Added

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

• REPORT_GENERATED
• REPORT_FAILED

​

3.30.1 - Jun 6, 2025

​

Added

• Support for RecipientScope query parameter on GET List Recipients for a User
• POST Validate the format of User data

​

Fixed

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