Java SDK

​

2.61.0 - Mar 23, 2026

​

Added

​

Support for mTLS authentication

• Added keyStore, keyStorePassword and cachedSslContext to Configuration.java
• Added buildSslContext() method to Configuration.java which initializes, caches and returns a SSLContext
• Updated the configureSslContext() method in RestTool.java to use the buildSslContext() method from above
• Updated the requests logic to add the mTLS certificate if present
• Updated README.md file with details on how to configure mTLS for the SDK

​

2.60.1 - Feb 19, 2026

​

Added

​

ChargeBearer body parameter on payouts

• Added ChargeBearer param (String) to PayOutPaymentDetailsBankWire class
• Updated the PayOutSerializer to include ChargeBearer on PayOutPaymentDetailsBankWire serialization
• Updated the PayOutDeserializer to deserialize the ChargeBearer and include it in PayOutPaymentDetailsBankWire
• Updated tests

​

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

​

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

• Added PaymentCategory (String) to RecurringPayInCIT and RecurringPayInMIT classes
• Updated the RecurringPayInDeserializer to deserialize the PaymentCategory and include it in PayInPaymentDetailsCard
• Updated tests

​

2.60.0 - Feb 12, 2026

​

Users

​

Possible breaking change

​

User serializer for natural Owner users

​

FX

​

Breaking change

​

Custom fees

• Added Fees to CreateConversionQuote
• Added Fees and RequestedFees to ConversionQuote
• Added RequestedFees to Conversion

​

Added

​

User margin

• Added UserMargin to CreateInstantConversion and CreateConversionQuote
• Added MarginsResponse to Conversion and ConversionQuote

​

Echo

​

Breaking change

​

Settlement upload endpoints

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

// null idempotencyKey in this example
Settlement settlement = api.getSettlementApi().generateUploadUrl(settlementFileName, null); 

Settlement dto = new Settlement().setFileName("new_file_name_settlement.csv");
dto.setId(existingSettlement.getSettlementId()); 
Settlement newUploadUrl = api.getSettlementApi().generateNewUploadUrl(dto);

​

Added

​

GET validations for a Settlement endpoint

• Added SettlementValidation, SettlementValidationFooter, SettlementValidationLine classes
• Added getValidations method to SettlementApi

// in this example, Pagination is null
SettlementValidation validation = api.getSettlementApi().getValidations(settlement.getSettlementId(), null);

​

PUT Cancel a Settlement endpoint

• Added cancel method to SettlementApi

// in this case, the IdempotencyKey is null
Settlement canceled = api.getSettlementApi().cancel(settlement.getSettlementId(), null);

​

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 PayInApi:

// idempotencyKey is null in this example
api.getPayInApi().createPayInIntentRefund(intentId, refundToBeCreated, null);

​

POST Reverse an Intent Refund

• Added reversePayInIntentRefund method to PayInApi:

// idempotencyKey is null in this example
PayInIntent reverseResult = api.getPayInApi().reversePayInIntentRefund(intent.getId(), intent.getRefund().getId(), reverseToBeCreated, null);

​

POST Create an Intent Dispute

• Added Dispute to PayInIntent
• Added createPayInIntentDispute method to PayInApi:

// idempotencyKey is null in this example
PayInIntent disputeResult = api.getPayInApi().createPayInIntentDispute(intent.getId(), intent.getCapture().getId(), disputeToBeCreated, null);

​

PUT Update an Intent Dispute

• Added Decision to PayInIntent
• Added updatePayInIntentDisputeOutcome method to PayInApi:

PayInIntent dto = new PayInIntent().setDecision("DEFENDED");
PayInIntent updatedDispute = api.getPayInApi().updatePayInIntentDisputeOutcome(intent.getId(), intent.getCapture().getId(), intent.getDispute().getId(), dto);

​

2.59.0 - Jan 30, 2026

​

Added

​

Support for new SCA status endpoint

import com.mangopay.entities.subentities.ScaStatus;

/**
    * Get SCA status
    * @param userId User identifier
    * @return ScaStatus instance
    * @throws Exception
    */
   ScaStatus getScaStatus(String userId) throws Exception;

package com.mangopay.entities.subentities;

import com.google.gson.annotations.SerializedName;
import com.mangopay.core.Dto;

public class ScaStatus extends Dto {
    @SerializedName("UserStatus")
    private String userStatus;

    @SerializedName("IsEnrolled")
    private Boolean isEnrolled;

    @SerializedName("LastEnrollmentDate")
    private Long lastEnrollmentDate;

    @SerializedName("LastConsentCollectionDate")
    private Long lastConsentCollectionDate;

    @SerializedName("ConsentScope")
    private ConsentScope consentScope;

    public String getUserStatus() {
        return userStatus;
    }

    public ScaStatus setUserStatus(String userStatus) {
        this.userStatus = userStatus;
        return this;
    }

    public Boolean getEnrolled() {
        return isEnrolled;
    }

    public ScaStatus setEnrolled(Boolean enrolled) {
        isEnrolled = enrolled;
        return this;
    }

    public Long getLastEnrollmentDate() {
        return lastEnrollmentDate;
    }

    public ScaStatus setLastEnrollmentDate(Long lastEnrollmentDate) {
        this.lastEnrollmentDate = lastEnrollmentDate;
        return this;
    }

    public Long getLastConsentCollectionDate() {
        return lastConsentCollectionDate;
    }

    public ScaStatus setLastConsentCollectionDate(Long lastConsentCollectionDate) {
        this.lastConsentCollectionDate = lastConsentCollectionDate;
        return this;
    }

    public ConsentScope getConsentScope() {
        return consentScope;
    }

    public ScaStatus setConsentScope(ConsentScope consentScope) {
        this.consentScope = consentScope;
        return this;
    }
}

package com.mangopay.entities.subentities;

import com.google.gson.annotations.SerializedName;
import com.mangopay.core.Dto;

public class ConsentScope extends Dto {
    @SerializedName("ContactInformationUpdate")
    private String contactInformationUpdate;

    @SerializedName("RecipientRegistration")
    private String recipientRegistration;

    @SerializedName("Transfer")
    private String transfer;

    @SerializedName("ViewAccountInformation")
    private String viewAccountInformation;

    public String getContactInformationUpdate() {
        return contactInformationUpdate;
    }

    public ConsentScope setContactInformationUpdate(String contactInformationUpdate) {
        this.contactInformationUpdate = contactInformationUpdate;
        return this;
    }

    public String getRecipientRegistration() {
        return recipientRegistration;
    }

    public ConsentScope setRecipientRegistration(String recipientRegistration) {
        this.recipientRegistration = recipientRegistration;
        return this;
    }

    public String getTransfer() {
        return transfer;
    }

    public ConsentScope setTransfer(String transfer) {
        this.transfer = transfer;
        return this;
    }

    public String getViewAccountInformation() {
        return viewAccountInformation;
    }

    public ConsentScope setViewAccountInformation(String viewAccountInformation) {
        this.viewAccountInformation = viewAccountInformation;
        return this;
    }
}

    @Test
    public void getScaStatus() throws Exception {
        ScaStatus scaStatus = api.getUserApi().getScaStatus(ACTIVE_USER_NATURAL_SCA_ID);

        assertNotNull(scaStatus);
        assertEquals(true, scaStatus.getEnrolled());
        assertNotNull(scaStatus.getLastEnrollmentDate());
        assertNotNull(scaStatus.getConsentScope().getContactInformationUpdate());
        assertEquals("ACTIVE", scaStatus.getUserStatus());
    }

​

New event types

package com.mangopay.core.enumerations;
/**
 * Event types enumeration.
 */
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

​

Fixed

​

Fixed PayOut serializer to include PaymentRef

​

2.58.1 - Jan 16, 2026

​

Fixed

• Checks for null when parsing error responses from the API, resolving JsonNull unsupported operation exception on some HTTP 401 responses

​

2.58.0 - Dec 2, 2025

​

Changed

• Migrated to V4 naming convention

​

2.57.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)

​

2.57.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
• Support for GET View card details for a Web Card PayIn endpoint

​

Changed

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

​

2.56.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

​

2.55.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

​

2.55.2 - Sep 2, 2025

​

Added

• Support for missing webhook event types

​

Changed

• OAuth token refresh buffer before expiry updated to 30s

​

Fixed

• Tests

​

2.55.1 - Aug 14, 2025

​

Added

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

​

2.55.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

​

2.54.1 - Jul 28, 2025

​

Added

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

​

2.54.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

​

2.53.0 - Jun 24, 2025

​

Changed

• Minimum language version changed to Java 8.0 or higher
• Java sourceCompatibility changed to 1.8
• README updated

​

Added

• New endpoint POST Create a Bizum PayIn
• New webhook event types for SCA enrollment - API release planned for Monday, 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 planned for Monday:
• USER_CATEGORY_UPDATED_TO_OWNER
• USER_CATEGORY_UPDATED_TO_PAYER
• USER_CATEGORY_UPDATED_TO_PLATFORM
• Support for PLATFORM value to UserCategory enum

​

2.52.2 - Jun 12, 2025

​

Updated

• release configurations

​

2.52.1 - Jun 12, 2025

​

Added

• US and CA virtual accounts for local pay-in collection
• GET List Transactions for a Card Fingerprint

​

2.52.0 - Jun 10, 2025

​

Added

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

• REPORT_GENERATED
• REPORT_FAILED

​

2.51.1 - Jun 6, 2025

​

Added

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

​

Fixed

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