The Banking Alias object
Description
Mangopay relies on the Banking Alias object to create a virtual IBAN or account number attached to a wallet. Once attached, the IBAN can be used by end users to wire funds directly to the wallet.
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.
Constraints and comparison with virtual accounts:
- It’s not possible to take
Fees
on External Instruction pay-ins to banking aliases – this constraint also exists on virtual accounts - Only one Banking Alias can be created per wallet, whereas multiple are possible with virtual accounts (of the same type)
- On Banking Alias,
LocalAccountDetails
are only available for the UK (Country
isGB
), and no further country expansion is planned
Attributes
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.
The IBAN (international bank account number) of the banking alias.
The BIC (international identifier of the bank) for the banking alias.
The banking alias details in local format returned if applicable for the Country
(e.g. GB
), otherwise null
.
The unique identifier of the user whose wallet is credited, in other words, the Owner of the wallet for which the alias is created.
Note: Once the banking alias is created, it is not possible to change the CreditedUserId
.
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.
Max. length: 255 characters
Custom data that you can add to this object.
The date and time at which the object was created.
Whether or not the banking alias is active.
Caution: Setting this value to false
is irreversible.
Returned values: IBAN
The type of banking alias.
The unique identifier of the object.
The unique identifier of the wallet.