Overview
User management
- Users
- User regulatory status
- User e-money
User verification
- IDV sessions
- 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
- Pay by bank
- Virtual IBAN
- Direct debits
- Web direct debits
APM pay-ins
- Apple Pay
- Bancontact
- Bizum
- 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
- Recipients
- Bank accounts
- Payouts
FX conversions
- Conversion rates
- Quotes
- Conversions
Transactions
- Transactions
Helpers
- API responses
- Country authorizations
- Webhooks
- Events
- Reports
Platform account
- Client
- Dashboard permissions
View a Virtual Account
// GET has no body parameters
{
"Id": "wltbank_m_01J7NCAT73Q15SVSM9S6Z36GRZ",
"Tag": "Created using Mangopay API Postman Collection",
"CreationDate": 1726220691,
"WalletId": "wlt_m_01J7NC9YKP3NB1PADF4SHZY712",
"VirtualAccountPurpose": "COLLECTION",
"Country": "GB",
"Status": "ACTIVE",
"Active": true,
"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"
}
Path parameters
The unique identifier of the wallet.
The unique identifier of the virtual account.
Responses
Max length: 128 characters (see data formats for details)
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.
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 toACTIVEorFAILED.ACTIVE– The account is active and can receive funds (see note about delayed UK CoP recognition forGBaccounts).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 “MGPPlatformTradingName”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 - US – Format if
CountryisUS - CA – Format if
CountryisCA
Caution: Other formats are planned in future as Mangopay’s account coverage expands. Ensure you retrieve the Account object’s properties and values dynamically.
The name of the bank.
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.
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.
The name of the bank.
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.
Returned false if Country is US or CA.
The code indicating the result of the operation. This information is mostly used to handle errors or for filtering purposes.
The explanation of the result code.
Functional errors (ResultCode) are possible on a 200 response. Read more →
{
"Id": "wltbank_m_01J7NCAT73Q15SVSM9S6Z36GRZ",
"Tag": "Created using Mangopay API Postman Collection",
"CreationDate": 1726220691,
"WalletId": "wlt_m_01J7NC9YKP3NB1PADF4SHZY712",
"VirtualAccountPurpose": "COLLECTION",
"Country": "GB",
"Status": "ACTIVE",
"Active": true,
"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"
}
// GET has no body parameters
Was this page helpful?
// GET has no body parameters
{
"Id": "wltbank_m_01J7NCAT73Q15SVSM9S6Z36GRZ",
"Tag": "Created using Mangopay API Postman Collection",
"CreationDate": 1726220691,
"WalletId": "wlt_m_01J7NC9YKP3NB1PADF4SHZY712",
"VirtualAccountPurpose": "COLLECTION",
"Country": "GB",
"Status": "ACTIVE",
"Active": true,
"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"
}