Skip to main content

[2.59.0] - 2026-01-30

Added

Support for new SCA status endpoint

The SDK now supports the new GET View the SCA status of a User endpoint. New method in UserApi:
import com.mangopay.entities.subentities.ScaStatus;

/**
    * Get SCA status
    * @param userId User identifier
    * @return ScaStatus instance
    * @throws Exception
    */
   ScaStatus getScaStatus(String userId) throws Exception;
New ScaStatus class:
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;
    }
}
New ConsentScope class:
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;
    }
}
New test in UserApiImplTest:
    @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

New EventType:
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

New RecipientId property added to PayOutPaymentDetailsBankWire.

Fixed

Fixed PayOut serializer to include PaymentRef

The PayOut serializer now returns the PaymentRef object.

[2.58.1] - 2026-01-16

Fixed

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

[2.58.0] - 2025-12-02

Changed

  • Migrated to V4 naming convention

[2.57.1] - 2025-11-25

Added

[2.57.0] - 2025-10-27

Added

Changed

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

[2.56.0] - 2025-10-01

Added

[2.55.3] - 2025-09-23

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] - 2025-09-02

Added

  • Support for missing webhook event types

Changed

  • OAuth token refresh buffer before expiry updated to 30s

Fixed

  • Tests

[2.55.1] - 2025-08-14

Added

[2.55.0] - 2025-08-07

Added

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

[2.54.1] - 2025-07-28

Added

[2.54.0] - 2025-07-18

Added

Endpoints for Mangopay Echo, a solution for platforms working with another third-party PSP for funds acquisition (including via the Mirakl Connector):

[2.53.0] - 2025-06-24

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] - 2025-06-12

Updated

  • release configurations

[2.52.1] - 2025-06-12

Added

[2.52.0] - 2025-06-10

Added

Endpoints for new Reporting Service feature: Webhook event types for new Reporting Service:
  • REPORT_GENERATED
  • REPORT_FAILED

[2.51.1] - 2025-06-06

Added

Fixed

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