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

# API - May 27, 2026

## Added

### Virtual Accounts for Australia (AU) and Liechtenstein (LI), accepting AUD and CHF

Mangopay can now offer [Virtual Accounts](/guides/payment-methods/banking/virtual-iban) for Australia (AU) and Liechtenstein (LI), which accept **AUD** and **CHF** currencies respectively.

For these countries, the [POST Create a Virtual Account](/api-reference/virtual-accounts/create-virtual-account) endpoint returns the local and international account details described below.

#### AU - Australia

If `Country` is `AU`, `LocalAccountDetails.Account` returns the bank state branch (BSB) code and account number. For example:

```json
{
//...
  "LocalAccountDetails": {
    //...
		"Account": {
			"BSBCode": "255000",
			"AccountNumber": "0087883000"
		  },
    //...
  }
//...
}
```

For `AU`, the `InternationalAccountDetails.Account` returns `null`. The AU account can only accept domestic wire transfers and `InternationalPayinAvailable` is `false`.

#### LI - Lichtenstein

If `Country` is `LI`, `LocalAccountDetails.Account` returns the bank clearing number and account number:

```json
{
//...
	"LocalAccountDetails": { 
    //...
		"Account": {
			"BCNumber": "65512",
			"AccountNumber": "432034640067"
		},
    //...
  }
//...
}
```

For `LI`, the `InternationalAccountDetails.Account` returns the same as the local details. The account can accept non-domestic payments and `InternationalPayinAvailable` is `true`.

To get started offering these accounts to your users, contact Mangopay [via the Dashboard](https://hub.mangopay.com/) **→**

---

## Added

### PayPal preauthorization enabling a single capture within 3 days (recommended)

Platform can now offer preauthorized payments with PayPal. The transaction relies on two API objects:

* The preauthorization returns the `RedirectURL` redirection URL on which the user can authenticate
* Once authorized, the preauthorized pay-in allows your platform to capture the funds without the user present

The PayPal preauthorization:

* Places a hold on the card (or other funding instrument) linked in the User's PayPal account.
* Should be captured within **3 days** as recommended by PayPal (but the technical limit is **29 days**).
* May not be permitted by some issues and for some cards types.
* Only allows a **single capture**, for an amount equal to or less than the preauthorized amount (multi-capture is not available for PayPal preauthorizations). Multi-capture functionality is not available for PayPal.

The new [POST Create a PayPal Deposit Preauthorization](/api-reference/extended-preauthorizations/create-paypal-extended-preauthorization) endpoint creates a type of the existing [Deposit Preauthorization](/api-reference/extended-preauthorizations/extended-preauthorization-object) with `PaymentType` of `PAYPAL`.

The PayPal Deposit Preauthorization object can be retrieved and canceled (if not used) using the existing Deposit Preauthorization endpoints:

* [PUT Cancel a Deposit Preauthorization](/api-reference/extended-preauthorizations/cancel-extended-preauthorization)
* [GET View a Deposit Preauthorization](/api-reference/extended-preauthorizations/view-extended-preauthorization)
* [GET List Deposit Preauthorizations for a User](/api-reference/extended-preauthorizations/list-extended-preauthorizations-user)

To capture funds, use the existing [POST Create a Deposit Preauthorized PayIn](/api-reference/extended-preauthorizations/create-extended-preauthorized-payin) against a `DepositId` with `PaymentType` of `PAYPAL`.

> **Check**
>
> **Best practice - Capture funds within 3 days**
>
> PayPal recommends that you capture preauthorized funds within 3 days. This is because the success of the capture is subject to risk and the availability of funds on the card (or other funding instrument) that the user has linked to their PayPal account.

Read more about [preauthorized payments with PayPal](/guides/payment-methods/paypal#preauthorized-payments) **→**