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

October 1, 2026

## Added

### Extended Preauthorization feature to rename Deposit Preauthorization

Support for Extended Preauthorization, renaming the existing Deposit Preauthorization, now deprecated ([API release note](/release-notes/api/2026-10-01)). Every deposit resource, field, endpoint, and helper has a like-for-like counterpart under the `/extended-preauthorizations/` API, with the "deposit" terminology replaced by "extended preauthorization":

* Added the `ExtendedPreauthorization` shared base and its `CardExtendedPreauthorization` and `PayPalExtendedPreauthorization` payment-method subclasses (mirroring `DepositPreauthorization`, `CardDepositPreauthorization`, and `PayPalDepositPreauthorization`), with the same fields and helpers:
  * `get_all_for_user` ([GET List Extended Preauthorizations for a User](/api-reference/extended-preauthorizations/list-extended-preauthorizations-user))
  * `get_all_for_card` ([GET List Extended Preauthorizations for a Card](/api-reference/extended-preauthorizations/list-extended-preauthorizations-card))
  * `get_transactions` ([GET List Transactions for an Extended Preauthorization](/api-reference/transactions/list-transactions-extended-preauthorization))
  * `cast`
* Added the `PreAuthorizedExtendedPayIn` pay-in (mirroring `PreAuthorizedDepositPayIn`), created via [POST Create an Extended Preauthorized PayIn](/api-reference/extended-preauthorizations/create-extended-preauthorized-payin).
* Added the `EXTENDED_PREAUTHORIZATION_*` hook event types, mirroring the [Extended Preauthorization webhook events](/webhooks/event-types#extended-preauthorizations):
  * `CREATED`
  * `PAYMENT_WAITING`
  * `PAYMENT_VALIDATED`
  * `PAYMENT_FAILED`
  * `FAILED`
  * `PAYMENT_CANCEL_REQUESTED`
  * `PAYMENT_CANCELED`
  * `PAYMENT_EXPIRED`

---

## Added

### Settlement hook event types

Added the `SETTLEMENT_*` hook event types, mirroring the [Settlement webhook events](/webhooks/event-types#settlements):

* `CREATED`
* `UPLOADED`
* `PENDING_UPLOAD`
* `PENDING_FUNDS_RECEPTION`
* `RECONCILED`
* `PARTIALLY_MATCHED`
* `UNMATCHED`
* `INSUFFICIENT_FUNDS`
* `CANCELLED`
* `FAILED`

---

## Added

### `ProfilingAttemptReference` on SCA users

`NaturalUserSca` and `LegalUserSca` now support the `ProfilingAttemptReference` (`profiling_attempt_reference`) property.

---

## Deprecated

### Deposit Preauthorization feature deprecated

The `Deposit`, `DepositPreauthorization`, `CardDepositPreauthorization`, `PayPalDepositPreauthorization`, `PreAuthorizedDepositPayIn`, and `CardPreAuthorizedDepositPayIn` resources are now deprecated in favor of their Extended Preauthorization counterparts. They are kept unchanged for backward compatibility and will be removed in a future major version.

---

## Fixed

### `__str__` representations

Fixed the `__str__` representations of the following; several referenced missing attributes or produced malformed output:

* `Billing`
* `FallbackReason`
* `PaymentRef`
* `InstantPayout`
* `DebitedBankAccount`
* `Shipping`
* `CurrentState`
* `MarginsResponse`
* `VerificationOfPayee`
* `ConsentScope`