Skip to main content
PUT
/
v2.01
/
{ClientId}
/
wallets
/
{WalletId}
/
virtual-accounts
/
{VirtualAccountId}
{
    "Active": false
}

{
    "Id": "wltbank_m_01J7NCAT73Q15SVSM9S6Z36GRZ",
    "Tag": "Created using Mangopay API Postman Collection",
    "CreationDate": 1726220691,
    "WalletId": "wlt_m_01J7NC9YKP3NB1PADF4SHZY712",
    "VirtualAccountPurpose": "COLLECTION",
    "Country": "GB",
    "Status": "CLOSED",
    "Active": false,
    "AccountOwner": "MGP PlatformTradingName",
    "LocalAccountDetails": {
        "Address": {
            "StreetName": "68 King William Street",
            "PostCode": "EC4N 7HR",
            "TownName": "London",
            "CountrySubDivision": null,
            "Country": "GB"
        },
        "Account": {
            "SortCode": "608382",
            "AccountNumber": "22276063"
        },
        "BankName": "Banking Circle S.A. UK Branch"
    },
    "InternationalAccountDetails": [
        {
            "Address": {
                "StreetName": "68 King William Street",
                "PostCode": "EC4N 7HR",
                "TownName": "London",
                "CountrySubDivision": null,
                "Country": "GB"
            },
            "Account": {
              "Iban": "GB92SAPY60838222276063",
                "Bic": "SAPYGB2L"
            },
            "BankName": "Banking Circle S.A. UK Branch"
        }
    ],
    "Capabilities": {
        "LocalPayinAvailable": true,
        "InternationalPayinAvailable": true,
        "Currencies": [
            "GBP"
        ]
    },
    "ResultCode": "000000",
    "ResultMessage": "Success"
}
This call serves only to deactivate a virtual account if it is no longer needed. Once deactivated, the account Status is CLOSED.
Caution - Deactivating a Virtual Account is irreversibleOnce 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 via the Dashboard.

​
Path parameters

​
WalletId
string
required
The unique identifier of the wallet.
​
VirtualAccountId
string
required
The unique identifier of the Virtual Account or legacy Banking Alias (the legacy BankingAliasId value can be used on this endpoint).

​
Body parameters

​
Active
boolean
Whether or not the Virtual Account is active.Caution: Setting this value to false permanently closes the account and is irreversible.

​
Responses

​
Id
string
Max length: 128 characters (see data formats for details)The unique identifier of the object.
​
Tag
string
Max. length: 255 charactersCustom data that you can add to this object.
​
CreationDate
Unix timestamp
The date and time at which the object was created.
​
WalletId
string
The unique identifier of the wallet.
​
VirtualAccountPurpose
string
Returned values: COLLECTION, USER_OWNEDThe type of the virtual account:
  • COLLECTION - Owned by Mangopay and usable by platforms and/or users for the purpose of collecting and reconciling incoming funds paid by users.
  • USER_OWNED - Owned by the wallet owner, enabling them to accept and store funds and make payments. Offering User-Owned Accounts requires your platform to sign the VOP contract amendment.
For more information, see the virtual account guide.
​
Country
string
Returned values: The two-letter ISO 3166-1 country code (LU, FR, GB, etc.) of an available country (depends on contract and activation settings).The country of the IBAN. The country must correspond to the currency of the wallet. See the virtual account guide for details.
​
Status
string
The status of the Virtual Account:
  • PENDING – The account creation request is being processed and full account details may not yet be returned. Any funds sent to the account are returned (if account details exist). PENDING can transition to ACTIVE or FAILED.
  • ACTIVE – The account is active and can receive funds (see note about delayed UK CoP recognition for GB accounts). ACTIVE can transition to BLOCKED or CLOSED.
  • BLOCKED – The account is blocked and is not active. Any funds sent to the account are returned. This temporary status may be used during processes relating to user verification or fraud screening. BLOCKED can transition to ACTIVE or CLOSED.
  • CLOSED – The account has been deactivated and is closed. Any funds sent to the account are returned. This is a final state.
  • FAILED – The account creation request failed or was rejected. This final state is rare. Any funds sent to the account are returned (if account details exist).
See the virtual account guide for more details.
​
Active
boolean
Whether or not the Virtual Account is active.
​
AccountOwner
string
The owner of the virtual account.The account owner is assigned automatically depending on the VirtualAccountPurpose:
  • COLLECTION – Owned by Mangopay SA or Mangopay UK Ltd., mentioning the platform’s trading name in the format “MGP PlatformTradingName”
  • USER_OWNED – Owned by the owner of the associated wallet: FirstName LastName for Natural Users; Name for Legal Users
​
LocalAccountDetails
object
The account details in local format.Best practice: Retrieve both the fields and values of these objects dynamically to present to the user. The LocalAccountDetails.Account object has different properties depending on the virtual account Country.
​
InternationalAccountDetails
array (object)
List of the account details in international format.Best practice: Retrieve both the fields and values of these objects dynamically to present to the user. The InternationalAccountDetails.Account object has different properties depending on the virtual account Country.
​
Capabilities
object
Information about the account’s payment capabilities.
​
ResultCode
string
The code indicating the result of the operation. This information is mostly used to handle errors or for filtering purposes.
​
ResultMessage
string
The explanation of the result code.
{
    "Id": "wltbank_m_01J7NCAT73Q15SVSM9S6Z36GRZ",
    "Tag": "Created using Mangopay API Postman Collection",
    "CreationDate": 1726220691,
    "WalletId": "wlt_m_01J7NC9YKP3NB1PADF4SHZY712",
    "VirtualAccountPurpose": "COLLECTION",
    "Country": "GB",
    "Status": "CLOSED",
    "Active": false,
    "AccountOwner": "MGP PlatformTradingName",
    "LocalAccountDetails": {
        "Address": {
            "StreetName": "68 King William Street",
            "PostCode": "EC4N 7HR",
            "TownName": "London",
            "CountrySubDivision": null,
            "Country": "GB"
        },
        "Account": {
            "SortCode": "608382",
            "AccountNumber": "22276063"
        },
        "BankName": "Banking Circle S.A. UK Branch"
    },
    "InternationalAccountDetails": [
        {
            "Address": {
                "StreetName": "68 King William Street",
                "PostCode": "EC4N 7HR",
                "TownName": "London",
                "CountrySubDivision": null,
                "Country": "GB"
            },
            "Account": {
              "Iban": "GB92SAPY60838222276063",
                "Bic": "SAPYGB2L"
            },
            "BankName": "Banking Circle S.A. UK Branch"
        }
    ],
    "Capabilities": {
        "LocalPayinAvailable": true,
        "InternationalPayinAvailable": true,
        "Currencies": [
            "GBP"
        ]
    },
    "ResultCode": "000000",
    "ResultMessage": "Success"
}

{
    "Active": false
}