View a Banking Alias for a Wallet

Deprecated

GET

/v2.01/:ClientId/wallets/:WalletId/bankingaliases

GET

/v2.01/:ClientId/wallets/:WalletId/bankingaliases

$ curl https://api.sandbox.mangopay.com/v2.01/{ClientId}/wallets/{WalletId}/bankingaliases \
>      -H "Authorization: Bearer <token>"

1 [
2   {
3     "OwnerName": "MGP PlatformTradingName",
4     "IBAN": "FR7674521100005657670994474",
5     "BIC": "MPAYFRP1PIN",
6     "VirtualAccountPurposeResponse": "COLLECTION",
7     "CreditedUserId": "user_m_01HSB23417BFG7YXR7E371JSEA",
8     "Country": "FR",
9     "Tag": "Created using Mangopay API Postman Collection",
10     "CreationDate": 1710846581,
11     "Active": true,
12     "Type": "IBAN",
13     "Id": "wltbank_m_01HSB6E769Y3ZBYDJACSP3THGA",
14     "WalletId": "wlt_m_01HSB6DE1YT1EMTH0K7ASYPG96"
15   },
16   {
17     "OwnerName": "MGP PlatformTradingName",
18     "IBAN": "FR7674521100005657670994474",
19     "BIC": "MPAYFRP1PIN",
20     "VirtualAccountPurposeResponse": "COLLECTION",
21     "CreditedUserId": "user_m_01HSB23417BFG7YXR7E371JSEA",
22     "Country": "FR",
23     "Tag": "Created using Mangopay API Postman Collection",
24     "CreationDate": 1710846581,
25     "Active": true,
26     "Type": "IBAN",
27     "Id": "wltbank_m_01HSB6E769Y3ZBYDJACSP3THGA",
28     "WalletId": "wlt_m_01HSB6DE1YT1EMTH0K7ASYPG96"
29   }
30 ]

Deprecated – Decommissioning planned for 2027

Mangopay plans to decommission the Banking Alias endpoints in 2027.

Platforms using them should plan to re-integrate using the Virtual Account endpoints.

Existing Banking Alias objects are available via the GET View a Virtual Account endpoint by using the Banking Alias Id and WalletId as path parameters.

Note - Payee confirmation in the UK

When the user sets up the payee with their bank, Mangopay UK or Mangopay SA is displayed as the account holder name. You should communicate this to them to avoid confusion.

View a Banking Alias for a Wallet

<Warning icon="fa-regular fa-triangle-exclamation"> **Deprecated – Decommissioning planned for 2027** Mangopay plans to decommission the Banking Alias endpoints in 2027. Platforms using them should plan to re-integrate using the [Virtual Account](/api-reference/virtual-accounts/virtual-account-object) endpoints. Existing Banking Alias objects are available via the [GET View a Virtual Account](/api-reference/virtual-accounts/view-virtual-account) endpoint by using the Banking Alias `Id` and `WalletId` as path parameters. </Warning> <Note icon="fa-regular fa-circle-info"> **Note - Payee confirmation in the UK** When the user sets up the payee with their bank, Mangopay UK or Mangopay SA is displayed as the account holder name. You should communicate this to them to avoid confusion. </Note> View a Banking Alias for a Wallet

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

If your platform is using a proxy to take SCA-triggering action on behalf of users, you also need to integrate mTLS authentication and use the api-mtls base URL.

Bearer authentication of the form `Bearer <token>`, where token is your auth token. If your platform is using a [proxy](/guides/sca/proxy-management) to take SCA-triggering action on behalf of users, you also need to integrate [mTLS authentication](/guides/sca/platform) and use the `api-mtls` base URL.

Path parameters

ClientIdstringRequired

Platform's API account identifier, associated with the API key.

WalletIdstringRequired

The unique identifier of the wallet.

Response

Success

Array (Banking Alias)list of objects

The list of banking aliases created by the platform.