POST
/
v2.01
/
{ClientId}
/
wallets
/
{WalletId}
/
bankingaliases
/
iban
{
    "OwnerName": "Alex Smith",
    "Country": "FR",
    "Tag": "Created using Mangopay API Postman Collection"
}  
{
    "OwnerName": "Alex Smith",
    "IBAN": "FR7674521100005657670994474",
    "BIC": "MPAYFRP1PIN",
    "CreditedUserId": "user_m_01HSB23417BFG7YXR7E371JSEA",
    "Country": "FR",
    "Tag": "Created using Mangopay API Postman Collection",
    "CreationDate": 1710846581,
    "Active": true,
    "Type": "IBAN",
    "Id": "wltbank_m_01HSB6E769Y3ZBYDJACSP3THGA",
    "WalletId": "wlt_m_01HSB6DE1YT1EMTH0K7ASYPG96"
}

Caution – Replaced by Virtual Accounts

New integrations should use Virtual Accounts, which have replaced Banking Aliases. Existing banking aliases can continue to be used and these endpoints are still supported.

See the Banking Alias object for a comparison.

The OwnerName must match the name of the user owning the wallet (FirstName and LastName for a Natural User, Name for a Legal User).

If Mangopay has provided your platform with a Technical Collection Virtual IBAN for reconciliation purposes, the OwnerName must be “Mangopay S.A.” or “Mangopay S.A. - Your Trading Name”. Please ensure your have confirmed this integration with our teams via the Dashboard.

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.

Path parameters

WalletId
string
required

The unique identifier of the wallet.

Body parameters

OwnerName
string
required

Max. length: 255 characters

The owner of the banking alias. The OwnerName must match the name of the user owning the wallet (FirstName and LastName for a Natural User, Name for a Legal User).

If Mangopay has provided your platform with a Technical Collection Virtual IBAN for reconciliation purposes, the OwnerName must be “Mangopay S.A.” or “Mangopay S.A. - Your Trading Name”. Please ensure your have confirmed this integration with our teams via the Dashboard.

Country
string
required

Allowed values: DE, DK, ES, FR, GB, LU, PL

The country of the banking alias. The country must correspond to the currency of the wallet.

Tag
string

Max. length: 255 characters

Custom data that you can add to this object.

Responses

{
    "OwnerName": "Alex Smith",
    "IBAN": "FR7674521100005657670994474",
    "BIC": "MPAYFRP1PIN",
    "CreditedUserId": "user_m_01HSB23417BFG7YXR7E371JSEA",
    "Country": "FR",
    "Tag": "Created using Mangopay API Postman Collection",
    "CreationDate": 1710846581,
    "Active": true,
    "Type": "IBAN",
    "Id": "wltbank_m_01HSB6E769Y3ZBYDJACSP3THGA",
    "WalletId": "wlt_m_01HSB6DE1YT1EMTH0K7ASYPG96"
}
{
    "OwnerName": "Alex Smith",
    "Country": "FR",
    "Tag": "Created using Mangopay API Postman Collection"
}