v2

latestOpenAPI 3.1.02026-07-262279731.3 MB

virtualAccounts

Deactivate a Virtual Account

<Warning icon="fa-regular fa-triangle-exclamation"> **Caution - Deactivating a Virtual Account is irreversible**

Once the Virtual Account object is deactivated, it is closed and cannot be reopened.

Any funds wired to this IBAN or local account details won’t be credited to the corresponding wallet and will be returned to the sender.

If such cases arise, contact Mangopay <a href="https://hub.mangopay.com/" target="_blank">via the Dashboard</a>. </Warning>

Close an account permanently to prevent it being used

This call serves only to deactivate a virtual account if it is no longer needed. Once deactivated, the account Status is CLOSED.

put/v2.01/{ClientId}/wallets/{WalletId}/virtual-accounts/{VirtualAccountId}

Path parameters

ClientIdstring required

Platform's API account identifier, associated with the API key.

WalletIdstring required

The unique identifier of the wallet.

VirtualAccountIdstring required

The unique identifier of the Virtual Account or legacy Banking Alias (the legacy BankingAliasId value can be used on this endpoint).

Headers

Authorizationstring required

Bearer authentication of the form Bearer <token>, where token is your auth token.

If your platform is using a proxy to take SCA-triggering action on behalf of users, you also need to integrate mTLS authentication and use the api-mtls base URL.

Request body

Activeboolean

Whether or not the Virtual Account is active.

Caution: Setting this value to false permanently closes the account and is irreversible.

Response

Success