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

June 24, 2026

## Added

### `FlowDescriptor` for declaring pay-in `Beneficiaries`

New `FlowDescriptor` sub-entity (with `FlowId` and a list of `FlowDescriptorBeneficiary`, each carrying a `UserId`), on `PayIn`, `CardPreAuthorization`, `Deposit`, `CreateDeposit`, `CreateRecurringPayment` and `RecurringPayInRegistration`. `PayInSerializer` now serializes the `FlowDescriptor` field on the request body.

Read more in the [API release note](/release-notes/api/2026-06-24) and [dedicated guide](/guides/payin-beneficiaries) **→**

### Support for `Email` on webhooks

`Hook` now exposes an `Email` field (`getEmail()` / `setEmail()`) to set and retrieve the [email alert for failed notifications](/webhooks#email-alerts-for-consecutive-failed-notifications).

### Support for `CreateReport.DateRangeBy` on reports (replacing `DateFilterBy`)

`CreateReport` now exposes `getDateRangeBy()` / `setDateRangeBy(...)` with the serialized field name `DateRangeBy`. The matching `DateRangeBy` field was also added to the `Report` response entity.

This corrects the field name to match the API: the previous `DateFilterBy` was not accepted by the API, so report creation with a date range filter did not work with the old name. Use `DateRangeBy` for date range filtering to function correctly.

## Deprecated

### `CreateReport.DateFilterBy`

`CreateReport.getDateFilterBy()` / `setDateFilterBy(...)` (serialized as `DateFilterBy`) are now `@Deprecated` and retained for backward compatibility. They are not accepted by the API; migrate to `getDateRangeBy()` / `setDateRangeBy(...)`.