virtualAccounts

Deactivate a Virtual Account

Changed on
<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}

Request

  • Base URL
    https://api.sandbox.mangopay.com
  • URL
    https://api.sandbox.mangopay.com/v2.01/{ClientId}/wallets/{WalletId}/virtual-accounts/{VirtualAccountId}
  • Auth
    HTTP bearer

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

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

OR
OR
OR
OR
OR
OR
OR
OR
OR

Changes

  • f44a59c76515Revision changes
    • warning

      deleted the header request parameter Authorization

    • info

      the endpoint scheme security oauth2 was added to the API

  • 8e731ec4a85bRevision changes
    • info

      api operation id deactivate_virtual_account removed and replaced with virtualAccounts_deactivate_virtual_account