> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.mangopay.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.mangopay.com/_mcp/server.

# 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](/release-notes/api/2026-10-01)). 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](/api-reference/extended-preauthorizations/create-card-extended-preauthorization))
  * `createPayPalPreauthorization` ([POST Create a PayPal Extended Preauthorization](/api-reference/extended-preauthorizations/create-paypal-extended-preauthorization))
  * `get` ([GET View an Extended Preauthorization](/api-reference/extended-preauthorizations/view-extended-preauthorization))
  * `getAllForUser` ([GET List Extended Preauthorizations for a User](/api-reference/extended-preauthorizations/list-extended-preauthorizations-user))
  * `getAllForCard` ([GET List Extended Preauthorizations for a Card](/api-reference/extended-preauthorizations/list-extended-preauthorizations-card))
  * `getTransactions` ([GET List Transactions for an Extended Preauthorization](/api-reference/transactions/list-transactions-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](/api-reference/extended-preauthorizations/cancel-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](/api-reference/extended-preauthorizations/create-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](/release-notes/api/2026-10-01)).

---

## Added

### Extended Preauthorization event types

New `EventType` constants, mirroring the [Extended Preauthorization webhook events](/webhooks/event-types#extended-preauthorizations):

* `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](/webhooks/event-types#settlements):

* `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](/release-notes/api/2026-10-01)); they're still fully functional and only produce compile-time warnings:

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