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

July 14, 2026

## Fixed

### Echo Settlement validation errors response mapping

* `SettlementValidation.footer_errors` and `SettlementValidation.lines_errors` are now parsed into typed objects (`SettlementFooterError`, `SettlementLineError` and `SettlementLineErrorDetail`) instead of raw list entries
* Although the field types change from `ListField` to dedicated fields, this is not a breaking change: the previous `ListField` mapping never worked because the API returns structured objects, so the raw values were unusable

---

## Deprecated

### Non-SCA user endpoints

* `NaturalUser` and `LegalUser` (non-SCA user endpoints) are deprecated; use `NaturalUserSca` / `LegalUserSca` and `User.get_sca` instead
* All deprecated members are kept unchanged for backward compatibility and will be removed in a future major version

---

## Deprecated

### Deposit-preauthorization complement flow

* The capture-with-complement flow on `CardPreAuthorizedDepositPayIn` and `PreAuthorizedDepositPayIn` (`create_prior_to_complement`, `create_complement`) is deprecated; use `create_without_complement` instead. These methods now emit a deprecation warning
* All deprecated members are kept unchanged for backward compatibility and will be removed in a future major version