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

# Python SDK - 3.57.0

June 24, 2026

## Added

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

* Added the `FlowDescriptor` object (`FlowId`, `Beneficiaries`) and the `flow_descriptor` field on `PayIn`, `RecurringPayInRegistration`, `PreAuthorization`, and `Deposit`

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

### Apple Pay and Google Pay recurring pay-ins

New recurring pay-in classes with clearer naming, replacing the CIT/MIT-specific classes:

* Added `RecurringCardPayIn`, `RecurringPayPalPayIn`, `RecurringApplePayPayIn`, and `RecurringGooglePayPayIn`
* Added `RecurringApplePayPayInRegistration` and `RecurringGooglePayPayInRegistration`, plus `APPLEPAY` and `GOOGLEPAY` recurring registration payment types

Read more about [Apple Pay and Google Pay recurring payments](/release-notes/api/2026-06-23) **→**

### PayPal deposit preauthorizations

New deposit preauthorization resource classes for the POST Create a [PayPal Deposit Preauthorization](/api-reference/extended-preauthorizations/create-paypal-extended-preauthorization) endpoint:

* Added `DepositPreauthorization` shared base, with `CardDepositPreauthorization` and `PayPalDepositPreauthorization` payment method classes
* Added `PreAuthorizedDepositPayIn` with `create_without_complement`

### Support for `DateRangeBy` on reports

* `ReportV2` now supports the `DateRangeBy` (`date_range_by`) parameter

### Support for `Email` on webhooks

* `Notification` (Hook) now exposes the `Email` (`email`) property to set and retrieve the address used for [email alerts for consecutive failed notifications](/webhooks#email-alerts-for-consecutive-failed-notifications).

### Recipients pagination

* `Recipient.get_user_recipients` now supports pagination (`page` / `per_page`)

## Deprecated

### Older recurring pay-in and deposit-preauthorization classes

The following are deprecated, but remain available for backward compatibility:

* `RecurringPayInCIT` and `RecurringPayInMIT` use `RecurringCardPayIn` instead
* `RecurringPayPalPayInCIT` and `RecurringPayPalPayInMIT` use `RecurringPayPalPayIn` instead
* `Deposit` uses `CardDepositPreauthorization` instead
* `CardPreAuthorizedDepositPayIn` uses `PreAuthorizedDepositPayIn` instead