Overview
User management
- Users
- User regulatory status
- User e-money
User verification
- User data format
- KYC documents
- UBO declarations
Wallets
- User wallets
- Client wallets
Cards
- Card registrations
- Cards
- Metadata
- Card validations
Card pay-ins
- Direct card pay-ins
- Recurring card pay-ins
- Preauthorizations
- Deposit preauthorizations
- Web card pay-ins
Banking pay-ins
- Bank wires
- Virtual IBAN
- Direct debits
- Web direct debits
APM pay-ins
- Apple Pay
- Bancontact
- BLIK
- Giropay
- Google Pay
- iDEAL
- Klarna
- MB WAY
- Multibanco
- Payconiq
- PayPal
- Satispay
- Swish
- TWINT
Transfers
- Transfers
Refunds
- Refunds
Disputes
- Disputes
- Dispute documents
- Repudiations
- Dispute settlement
Payouts
- Bank accounts
- Payouts
FX conversions
- Conversion rates
- Quotes
- Conversions
Transactions
- Transactions
Helpers
- API responses
- Country authorizations
- Webhooks
- Events
- Reports
Platform account
- Client
- Dashboard permissions
Deactivate a Virtual Account
Close an account permanently to prevent it being used
{
"Active": false
}
{
"Id": "wltbank_m_01J7NCAT73Q15SVSM9S6Z36GRZ",
"Tag": "Created using Mangopay API Postman Collection",
"CreationDate": 1726220691,
"WalletId": "wlt_m_01J7NC9YKP3NB1PADF4SHZY712",
"CreditedUserId": "user_m_01J7KACBPAV7XAF8AH9BDCJPRS",
"VirtualAccountPurpose": "COLLECTION",
"Country": "GB",
"Status": "CLOSED",
"Active": false,
"AccountOwner": "Mangopay SA (for ACME Platform)",
"LocalAccountDetails": {
"Address": {
"StreetName": "2, Avenue Amélie",
"PostCode": "L-1125",
"TownName": "Luxembourg",
"CountrySubDivision": null,
"Country": "Luxembourg",
},
"Account": {
"SortCode": "608382",
"AccountNumber": "21762697",
}
},
"InternationalAccountDetails": {
"Address": {
"StreetName": "2, Avenue Amélie",
"PostCode": "L-1125",
"TownName": "Luxembourg",
"CountrySubDivision": null,
"Country": "Luxembourg",
},
"Account": {
"Iban": "GB62SAPY60838221762697",
"Bic": null
}
},
"Capabilities": {
"LocalPayinAvailable": true,
"InternationalPayinAvailable": true,
"Currencies": [
"GBP"
]
}
}
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 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 via the Dashboard.
Path parameters
The unique identifier of the wallet.
The unique identifier of the virtual account.
Body parameters
Whether or not the Virtual Account is active.
Caution: Setting this value to false permanently closes the account and is irreversible.
Responses
The unique identifier of the object.
Max. length: 255 characters
Custom data that you can add to this object.
The date and time at which the object was created.
The unique identifier of the wallet.
The unique identifier of the user whose wallet is credited.
Allowed values: COLLECTION, USER_OWNED
The 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.
For more information, see virtual account guide.
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.
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).PENDINGcan transition toACTIVE,FAILED, orBLOCKED.ACTIVE– The account is active and can receive funds.ACTIVEcan transition toBLOCKEDorCLOSED.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.BLOCKEDcan transition toACTIVEorCLOSED.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.
Whether or not the Virtual Account is active.
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 “Mangopay SA (for Your Trading Name)”USER_OWNED– Owned by the owner of the associated wallet:FirstNameLastNamefor Natural Users;Namefor Legal Users
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.
The address associated with the account.
Max. length: 255 characters
The building number and street name of the address.
Max. length: 50 characters
The postal code of the address.
Max. length: 255 characters
The town or city of the address.
Max. length: 255 characters
The region, state, or county of the address.
Format: Two-letter country code (ISO 3166-1 alpha-2 format)
The country of the address.
Details of the account in local account identifier format.
The properties of this object differ depending on the Virtual Account Country:
- IBAN – Format if
CountryisDK,DE,ES,FR,LU - GB – Format if
CountryisGB
Caution: Other formats are planned in future as Mangopay’s account coverage expands. Ensure you retrieve the Account object’s properties and values dynamically.
List of the account details in international format.
Note: The InternationalAccountDetails.Account is returned in IBAN and BIC format, but it is possible that the properties of these objects vary in future so you should retrieve both the fields and values dynamically.
The address associated with the account.
Max. length: 255 characters
The building number and street name of the address.
Max. length: 50 characters
The postal code of the address.
Max. length: 255 characters
The town or city of the address.
Max. length: 255 characters
The region, state, or county of the address.
Format: Two-letter country code (ISO 3166-1 alpha-2 format)
The country of the address.
Information about the account’s payment capabilities.
Whether or not local bank wires can be made to this account.
Whether or not international bank wires can be made to this account.
Related resources
Guide
Learn more about virtual accounts
Virtual Account object
Read about the Virtual Account API endpoints
{
"Id": "wltbank_m_01J7NCAT73Q15SVSM9S6Z36GRZ",
"Tag": "Created using Mangopay API Postman Collection",
"CreationDate": 1726220691,
"WalletId": "wlt_m_01J7NC9YKP3NB1PADF4SHZY712",
"CreditedUserId": "user_m_01J7KACBPAV7XAF8AH9BDCJPRS",
"VirtualAccountPurpose": "COLLECTION",
"Country": "GB",
"Status": "CLOSED",
"Active": false,
"AccountOwner": "Mangopay SA (for ACME Platform)",
"LocalAccountDetails": {
"Address": {
"StreetName": "2, Avenue Amélie",
"PostCode": "L-1125",
"TownName": "Luxembourg",
"CountrySubDivision": null,
"Country": "Luxembourg",
},
"Account": {
"SortCode": "608382",
"AccountNumber": "21762697",
}
},
"InternationalAccountDetails": {
"Address": {
"StreetName": "2, Avenue Amélie",
"PostCode": "L-1125",
"TownName": "Luxembourg",
"CountrySubDivision": null,
"Country": "Luxembourg",
},
"Account": {
"Iban": "GB62SAPY60838221762697",
"Bic": null
}
},
"Capabilities": {
"LocalPayinAvailable": true,
"InternationalPayinAvailable": true,
"Currencies": [
"GBP"
]
}
}
{
"Active": false
}
Was this page helpful?
{
"Active": false
}
{
"Id": "wltbank_m_01J7NCAT73Q15SVSM9S6Z36GRZ",
"Tag": "Created using Mangopay API Postman Collection",
"CreationDate": 1726220691,
"WalletId": "wlt_m_01J7NC9YKP3NB1PADF4SHZY712",
"CreditedUserId": "user_m_01J7KACBPAV7XAF8AH9BDCJPRS",
"VirtualAccountPurpose": "COLLECTION",
"Country": "GB",
"Status": "CLOSED",
"Active": false,
"AccountOwner": "Mangopay SA (for ACME Platform)",
"LocalAccountDetails": {
"Address": {
"StreetName": "2, Avenue Amélie",
"PostCode": "L-1125",
"TownName": "Luxembourg",
"CountrySubDivision": null,
"Country": "Luxembourg",
},
"Account": {
"SortCode": "608382",
"AccountNumber": "21762697",
}
},
"InternationalAccountDetails": {
"Address": {
"StreetName": "2, Avenue Amélie",
"PostCode": "L-1125",
"TownName": "Luxembourg",
"CountrySubDivision": null,
"Country": "Luxembourg",
},
"Account": {
"Iban": "GB62SAPY60838221762697",
"Bic": null
}
},
"Capabilities": {
"LocalPayinAvailable": true,
"InternationalPayinAvailable": true,
"Currencies": [
"GBP"
]
}
}