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

# PHP SDK - 4.2.0

June 24, 2026

## Added

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

New `FlowDescriptor` class (`FlowId`, `Beneficiaries`) and `FlowDescriptorBeneficiary` class (`UserId`). A new optional `FlowDescriptor` property was added to `CardPreAuthorization`, `CreateDeposit`, `Deposit`, `PayIn`, and `RecurringPayInRegistration`, with the appropriate `GetSubObjects()` mappings.

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

### Support for `Email` on webhooks

New optional `Email` property on `Hook` to set and retrieve the [email alert for failed notifications](/webhooks#email-alerts-for-consecutive-failed-notifications).

### Renamed `Report.DateFilterBy` to `Report.DateRangeBy`

The `DateFilterBy` property introduced in 4.1.0 has been renamed to `DateRangeBy` to align with the API. Update any code that set `Report::$DateFilterBy` to use `Report::$DateRangeBy` instead.

### Support for `Report.DateRangeBy` on reports

New `Report.DateRangeBy` property on `Report` to align with the API. Use this instead of the deprecated `DateFilterBy`.

## Deprecated

* `Report.DateFilterBy` deprecated in favor of `DateRangeBy`. The property is kept for backward compatibility and will be removed in a future version.