Banking pay-insVirtual accountsBanking alias

The Banking Alias object

Deprecated

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.

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 – Verification of Payee

Verification of Payee (VOP) changes the behavior of the OwnerName value by setting it automatically based on the User’s UserCategory and KYCLevel.

Read more in the VOP guide.

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 is GB), and no further country expansion is planned

Attributes

OwnerNamestringOptional
IBANstringOptional
BICstringOptional
VirtualAccountPurposestringOptional
CreditedUserIdstringOptional
CountrystringOptional
TagstringOptional
CreationDateintegerOptional
ActivebooleanOptional
TypestringOptional
IdstringOptional
WalletIdstringOptional
The unique identifier of the wallet.
LocalAccountDetailsobjectOptional
Guide
Learn more about virtual IBAN
How to
Learn how to attach a virtual IBAN to a wallet