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

May 21, 2026

## Added

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

Support for the new Apple Pay and Google Pay recurring pay-in endpoints (`/payins/payment-methods/applepay/recurring`, `/payins/payment-methods/googlepay/recurring`):

* Added registration POST DTOs `RecurringApplePayPayInRegistrationPostDTO` and `RecurringGooglePayPayInRegistrationPostDTO`, and pay-in POST DTOs `RecurringApplePayPayInCITPostDTO`, `RecurringApplePayPayInMITPostDTO`, `RecurringGooglePayPayInCITPostDTO`, `RecurringGooglePayPayInMITPostDTO`
* Added `ApiPayIns.CreateRecurringApplePayPayInRegistration`, `CreateRecurringGooglePayInRegistration`, `CreateRecurringApplePayPayInCIT`, `CreateRecurringApplePayPayInMIT`, `CreateRecurringGooglePayPayInCIT`, `CreateRecurringGooglePayPayInMIT`
* Added `MethodKey.PayinsRecurringApplePay` and `MethodKey.PayinsRecurringGooglePay`, with matching idempotency `Resource` mappings (`RecurringPayInDTO`)
* Added `APPLEPAY` and `GOOGLEPAY` values to `RecurringPayInRegistrationPaymentType`

## Added

### Newly named recurring pay-in registration methods for cards

To align with the new methods for Apple Pay and Google Pay, new methods have been introduced for cards:

* `CreateRecurringCardPayInCIT`
* `CreateRecurringCardPayInMIT`

## Deprecated

### Card-prefixed recurring registration methods

The legacy card-specific methods are marked `[Obsolete]`. They continue to function but  the new methods hit the same endpoint and behave identically:

* `CreateRecurringPayInRegistrationCIT` → use `CreateRecurringCardPayInCIT`
* `CreateRecurringPayInRegistrationMIT` → use `CreateRecurringCardPayInMIT`

## Changed

### `CurrentState` moved to `RecurringPayInRegistrationDTO`

`CurrentState` was moved from `RecurringPayInRegistrationGetDTO` up to its parent `RecurringPayInRegistrationDTO`, alongside two new fields `ResultCode` and `ResultMessage`. Registration POST responses now expose all three. Code reading `getDto.CurrentState` keeps working unchanged through inheritance.

## Changed

### `MethodKey` renamed

* Renamed `MethodKey.PayInsCreateCardPreAuthorizedDeposit` → `MethodKey.PayInsCreateDepositPreauthorizedPayInWithoutComplement`. `MethodKey` is an internal routing enum; consumers calling `ApiPayIns.*` methods are unaffected.

## Deprecated

### Card-prefixed deposit preauthorization methods

The following `ApiPayIns` methods/overloads are marked `[Obsolete]`. New equivalents have been added with clearer names that drop the `Card` prefix — they hit the same endpoints and behave identically, only the naming differs:

* `CreateCardPreAuthorizedDepositPayIn` → use `CreateDepositPreauthorizedPayInWithoutComplement`
* `CreateDepositPreauthorizedPayInPriorToComplement(CardPreAuthorizedDepositPayInPostDTO)` → use the overload accepting `PreAuthorizedDepositPayInPostDTO` (returns `PreAuthorizedDepositPayInDTO`)
* `CreateDepositPreauthorizedPayInComplement(CardPreAuthorizedDepositPayInPostDTO)` → use the overload accepting `PreAuthorizedDepositPayInPostDTO` (returns `PreAuthorizedDepositPayInDTO`)

The legacy `CardPreAuthorizedDepositPayInDTO`/`CardPreAuthorizedDepositPayInPostDTO` types are retained, and idempotency `Resource` mappings for the deposit-preauthorized pay-in endpoints continue to deserialize to `CardPreAuthorizedDepositPayInDTO`.

## Added

### PayPal deposit preauthorizations

Support for the new PayPal deposit preauthorization endpoint (`/deposit-preauthorizations/payment-methods/paypal`):

* Added `PayPalDepositPreauthorizationDTO` (GET) and `PayPalDepositPreauthorizationPostDTO` (POST). `PayPalDepositPreauthorizationDTO` extends `DepositDTO`.
* Added `ApiDeposits.CreatePayPalDepositPreauthorizationAsync`, `GetPayPalDepositPreauthorizationAsync`, `UpdatePayPalDepositPreauthorizationAsync`
* Added `MethodKey.DepositsCreatePayPalPreauthorization` and the matching idempotency `Resource` mapping (`PayPalDepositPreauthorizationDTO`)
* `DepositDTO` is now annotated with a `JsonConverter` (`DepositDeserializer`) that returns a `PayPalDepositPreauthorizationDTO` instance when `PaymentType` is `PAYPAL`. Card deposits continue to deserialize to `DepositDTO` exactly as before, so existing code is unaffected.

## Added

### Deposit preauthorization types and methods with cleaner names

Additive companions to the existing card-prefixed types/methods, functionally identical:

* Added `PreAuthorizedDepositPayInDTO` and `PreAuthorizedDepositPayInPostDTO`
* Added `ApiPayIns.CreateDepositPreauthorizedPayInWithoutComplement`
* Added overloads of `CreateDepositPreauthorizedPayInPriorToComplement` and `CreateDepositPreauthorizedPayInComplement` that accept `PreAuthorizedDepositPayInPostDTO` and return `PreAuthorizedDepositPayInDTO`

## Added

### `DateFilterBy` on `ReportPostDTO`

* Added optional `DateFilterBy` to `ReportPostDTO` for [POST Create a Report](/api-reference/reporting/create-report)

## Added

### Local Virtual Account properties for DK, AU, LI

Added properties to support `LocalAccount` details on Virtual Accounts:

* For DK, `BankCode` (4-digit bank code)
* For AU, `BSBCode` (6-digit Bank State Branch code)
* For LI, `BCNumber` (5-digit bank clearing number)