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

# .NET SDK - 4.1.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, DTOs, enums, and events reproduce the deposit shapes one-to-one:

* Added `ApiExtendedPreauthorizations` (exposed as `MangoPayApi.ExtendedPreauthorizations`) with:
  * `CreateAsync` ([POST Create a Card Extended Preauthorization](/api-reference/extended-preauthorizations/create-card-extended-preauthorization))
  * `CreatePayPalExtendedPreauthorizationAsync` ([POST Create a PayPal Extended Preauthorization](/api-reference/extended-preauthorizations/create-paypal-extended-preauthorization))
  * `GetAsync` / `GetPayPalExtendedPreauthorizationAsync` ([GET View an Extended Preauthorization](/api-reference/extended-preauthorizations/view-extended-preauthorization))
  * `UpdateAsync` / `UpdatePayPalExtendedPreauthorizationAsync` ([PUT Cancel an Extended Preauthorization](/api-reference/extended-preauthorizations/cancel-extended-preauthorization))
  * `GetAllForCardAsync` ([GET List Extended Preauthorizations for a Card](/api-reference/extended-preauthorizations/list-extended-preauthorizations-card))
  * `GetAllForUserAsync` ([GET List Extended Preauthorizations for a User](/api-reference/extended-preauthorizations/list-extended-preauthorizations-user))
  * `GetTransactionsAsync` ([GET List Transactions for an Extended Preauthorization](/api-reference/transactions/list-transactions-extended-preauthorization))
* Added `ApiPayIns.CreateExtendedPreauthorizedPayIn` for [POST Create an Extended Preauthorized PayIn](/api-reference/extended-preauthorizations/create-extended-preauthorized-payin).
* Added DTOs `ExtendedPreauthorizationDTO`, `ExtendedPreauthorizationPostDTO`, `ExtendedPreauthorizationPutDTO`, `PayPalExtendedPreauthorizationDTO`, `PayPalExtendedPreauthorizationPostDTO`, `ExtendedPreAuthorizedPayInDTO`, and `ExtendedPreAuthorizedPayInPostDTO`, mirroring their deposit counterparts (the `DepositId` field becomes `ExtendedPreauthorizationId`).
* Added the `ExtendedPreauthorizationStatus` enum and `ExtendedPreauthorizationDeserializer`.

---

## Deprecated

### Deposit Preauthorization feature deprecated

Marked `[Obsolete]` in favor of the Extended Preauthorization equivalents ([API release note](/release-notes/api/2026-10-01)):

* `ApiDeposits` / `MangoPayApi.Deposits`
* `DepositDTO`
* `DepositPostDTO`
* `DepositPutDTO`
* `PayPalDepositPreauthorizationDTO`
* `DepositStatus`
* `ApiPayIns.CreateCardPreAuthorizedDepositPayIn`

---

## Added

### Extended Preauthorization event types

New `EventType` values, 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`

---

## Added

### `ProfilingAttemptReference` on users

Added to the SCA user DTOs:

* `UserNaturalScaOwnerPostDTO`
* `UserNaturalScaPayerPostDTO`
* `UserLegalScaOwnerPostDTO`
* `UserLegalScaPayerPostDTO`
* `UserNaturalScaPutDTO`
* `UserLegalScaPutDTO`
* `CategorizeUserNaturalPutDTO`
* `CategorizeUserLegalPutDTO`

---

## Changed

### Regex timeouts

Added timeouts to regular-expression evaluation in `RestTool` and `ApiIdempotent`, to guard against catastrophic backtracking.

---

## Added

### Settlement event types

New `EventType` values, 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`

---

## Fixed

### Event type deserialization breaking pagination

Listing hooks or events failed entirely if a single item carried an `EventType` value not yet known to the SDK — one unrecognized value threw and broke deserialization of the whole page. A new `TolerantEnumConverter`, applied to `EventType` on `EventDTO` and `HookDTO`, now degrades an unknown or `null` value to a new `NotSpecified` fallback member instead of throwing.