List Virtual Accounts for a Wallet

Path parameters

WalletId · string · required

The unique identifier of the wallet.

Query parameters

page · integer

Start value: 1

Default value: 1

Indicates the index of the page for the pagination.

per_page · integer

Min. value: 1; max. value: 100

Default value: 10

Indicates the number of items returned for each page of the pagination.

Sort · string

Allowed values: CreationDate:ASC, CreationDate:DESC

Indicates the direction in which to sort the list.

Responses

200

Array (Virtual Accounts) · array

The list of virtual accounts created by the platform.

Show properties

Object (Virtual Account) · object

The Virtual Account object created by the platform

Show properties

Id · string

Max length: 128 characters (see data formats for details)

The unique identifier of the object.

Tag · string

Max. length: 255 characters

Custom 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

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.

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.

Show child attributes

Address · object

The address associated with the account.

Show child attributes

StreetName · string

Max. length: 255 characters

The building number and street name of the address.

PostCode · string

Max. length: 50 characters

The postal code of the address.

TownName · string

Max. length: 255 characters

The town or city of the address.

CountrySubDivision · string

Max. length: 255 characters

The region, state, or county of the address.

Country · string

Format: Two-letter country code (ISO 3166-1 alpha-2 format)

The country of the address.

Account · object | null

Details of the account in local account identifier format.

The properties of this object differ depending on the Virtual Account Country:

• IBAN – Format if Country is DK, DE, ES, FR, LU
• GB – Format if Country is GB
• US – Format if Country is US
• CA – Format if Country is CA

Caution: Other formats are planned in future as Mangopay’s account coverage expands. Ensure you retrieve the Account object’s properties and values dynamically.

IBAN

Hide properties

IBAN · string

The international bank account number (IBAN) of the account.

BIC · string

The bank identifier code (BIC) of the account.

BankName · string | null

The name of the bank.

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.

Show child attributes

Address · object

The address associated with the account.

Show child attributes

StreetName · string

Max. length: 255 characters

The building number and street name of the address.

PostCode · string

Max. length: 50 characters

The postal code of the address.

TownName · string

Max. length: 255 characters

The town or city of the address.

CountrySubDivision · string

Max. length: 255 characters

The region, state, or county of the address.

Country · string

Format: Two-letter country code (ISO 3166-1 alpha-2 format)

The country of the address.

Account · object | null

Details of the account in international format.

Returned null if Country is US or CA as Capabilities.InternationalPayinAvailable is always false.

Show child attributes

IBAN · string

The international bank account number (IBAN) of the account.

BIC · string

The bank identifier code (BIC) of the account.

BankName · string | null

The name of the bank.

Capabilities · object

Information about the account’s payment capabilities.

Show child attributes

LocalPayinAvailable · boolean

Whether or not local bank wires can be made to this account.

InternationalPayinAvailable · boolean

Whether or not international bank wires can be made to this account.

Returned false if Country is US or CA.

Currencies · array

Returned values: One or more currency codes in ISO 4217 format (EUR, GBP, etc.)

List of currencies supported by the account.

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.

Functional errors (ResultCode) are possible on a 200 response. Read more →

---

Response

[
    {
        "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": "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": "SAPYGB2L"
                }
            }
        ],
        "Capabilities": {
            "LocalPayinAvailable": true,
            "InternationalPayinAvailable": true,
            "Currencies": [
                "GBP"
            ]
        },
    "ResultCode": "000000",
    "ResultMessage": "Success"
    }
]

REST

// GET has no body parameters