Java SDK - 2.70.0

October 1, 2026

Added

Extended Preauthorization feature to rename Deposit Preauthorization

Extended Preauthorization renames Deposit Preauthorization, now deprecated (API release note). The new API works the same way, with ExtendedPreauthorization / PayPalExtendedPreauthorization replacing Deposit / PayPalDepositPreauthorization / CreateDeposit / UpdateDeposit. The DTO fields and method behavior are otherwise identical.

• New ExtendedPreauthorizationApi, exposed via MangoPayApi.getExtendedPreauthorizationApi() / setExtendedPreauthorizationApi(...), backed by ExtendedPreauthorizationApiImpl.
• New entities ExtendedPreauthorization and PayPalExtendedPreauthorization, a new ExtendedPreauthorizationStatus enum, and ExtendedPreauthorizationDeserializer.
• The following methods mirror DepositApi one-to-one:
  • create (POST Create a Card Extended Preauthorization)
  • createPayPalPreauthorization (POST Create a PayPal Extended Preauthorization)
  • get (GET View an Extended Preauthorization)
  • getAllForUser (GET List Extended Preauthorizations for a User)
  • getAllForCard (GET List Extended Preauthorizations for a Card)
  • getTransactions (GET List Transactions for an Extended Preauthorization)

One method differs from the Deposit Preauthorization API:

• No standalone cancel(...) method. DepositApi.cancel(String depositId) has no equivalent on ExtendedPreauthorizationApi. To cancel, use update(...) with the PaymentStatus set to CANCELED, backed by PUT Cancel an Extended Preauthorization.
• update(...) takes the entity instead of (id, status). DepositApi.update(String depositId, PaymentStatus paymentStatus) becomes ExtendedPreauthorizationApi.update(ExtendedPreauthorization extendedPreauthorization), to which you pass the ExtendedPreauthorization with its Id and PaymentStatus set to CANCELED, rather than two separate arguments.

---

Added

createExtendedPreauthorizedPayIn on PayInApi

New PayInApi.createExtendedPreauthorizedPayIn(PayIn payIn, String idempotencyKey), backed by POST Create an Extended Preauthorized PayIn, the extended-preauthorization counterpart to the now-deprecated createDepositPreauthorizedPayInWithoutComplement(...).

---

Added

ExtendedPreauthorizationId on Transaction

Transaction now exposes getExtendedPreauthorizationId() / setExtendedPreauthorizationId(...) (serialized as ExtendedPreauthorizationId), mirroring the now-deprecated DepositId (API release note).

---

Added

Extended Preauthorization event types

New EventType constants, mirroring the Extended Preauthorization webhook events:

• EXTENDED_PREAUTHORIZATION_CREATED
• EXTENDED_PREAUTHORIZATION_PAYMENT_WAITING
• EXTENDED_PREAUTHORIZATION_PAYMENT_VALIDATED
• EXTENDED_PREAUTHORIZATION_PAYMENT_FAILED
• EXTENDED_PREAUTHORIZATION_FAILED
• EXTENDED_PREAUTHORIZATION_PAYMENT_CANCEL_REQUESTED
• EXTENDED_PREAUTHORIZATION_PAYMENT_CANCELED
• EXTENDED_PREAUTHORIZATION_PAYMENT_EXPIRED

Appended at the end of the enum, so existing ordinals are unchanged.

---

Added

Settlement event types

New EventType constants, mirroring the Settlement webhook events:

• SETTLEMENT_CREATED
• SETTLEMENT_UPLOADED
• SETTLEMENT_PENDING_UPLOAD
• SETTLEMENT_PENDING_FUNDS_RECEPTION
• SETTLEMENT_RECONCILED
• SETTLEMENT_PARTIALLY_MATCHED
• SETTLEMENT_UNMATCHED
• SETTLEMENT_INSUFFICIENT_FUNDS
• SETTLEMENT_CANCELLED
• SETTLEMENT_FAILED

Appended at the end of the enum, so existing ordinals are unchanged.

---

Added

ProfilingAttemptReference on SCA users

UserNaturalSca and UserLegalSca now expose getProfilingAttemptReference() / setProfilingAttemptReference(...) (serialized as ProfilingAttemptReference).

---

Deprecated

Deposit Preauthorization feature deprecated

The following are @Deprecated in favor of their Extended Preauthorization equivalents (API release note); they’re still fully functional and only produce compile-time warnings:

• DepositApi and MangoPayApi.getDepositApi() / setDepositApi(...).
• Entities Deposit, PayPalDepositPreauthorization, CardPreAuthorizedDepositPayIn, and DTOs CreateDeposit / UpdateDeposit.