API - May 27, 2026

Added

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

Mangopay can now offer Virtual Accounts for Australia (AU) and Liechtenstein (LI), which accept AUD and CHF currencies respectively.

For these countries, the POST Create a 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:

1
{
2
//...
3
  "LocalAccountDetails": {
4
    //...
5
		"Account": {
6
			"BSBCode": "255000",
7
			"AccountNumber": "0087883000"
8
		  },
9
    //...
10
  }
11
//...
12
}

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:

1
{
2
//...
3
	"LocalAccountDetails": { 
4
    //...
5
		"Account": {
6
			"BCNumber": "65512",
7
			"AccountNumber": "432034640067"
8
		},
9
    //...
10
  }
11
//...
12
}

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 →

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 endpoint creates a type of the existing Deposit Preauthorization 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
• GET View a Deposit Preauthorization
• GET List Deposit Preauthorizations for a User

To capture funds, use the existing POST Create a Deposit Preauthorized PayIn against a DepositId with PaymentType of PAYPAL.

Read more about preauthorized payments with PayPal →