The Banking Alias object

This use of this feature is subject to a declaration to the local banking authorities. We therefore require you to sign an amendment to your contract that will specify which BIC you will be able to use inconjuction with the IBAN. Please contact your account manager for more info

Banking aliases allow you to create a way to pay funds directly into a wallet, without having to declare the payin beforehand (unlike a traditional payin bankwire). For example, if you create an IBAN banking alias for a wallet, you'll be given a unique IBAN and BIC for this wallet. Any funds that we receive for this IBAN and BIC will be automatically credited to the wallet. You should be aware that you are unable to add Fees to a payin created via a banking alias.

Note that only IBAN type banking aliases are available at present, and only the currency EUR is supported. You are also only able to create one banking alias per wallet due to regulation requirements. Once created, you can not change the CreditedUserId

These are the base parameters for a Banking Alias - for each type (see below) there are various other parameters specific to that type.

If required, you may request the address associated to the banking alias from our support team.

Please note that this functionality doesn't work with the old SDK versions, and with system prior to PHP 5.4.

Parameters

CreditedUserId
string

string:

Maximum length is 255 characters

The user ID who is credited (defaults to the owner of the wallet)

WalletId
string

string:

Maximum length is 255 characters

The ID of a wallet

Type
BankingAliasType

BankingAliasType:

IBAN

The type of banking alias. Currently only IBAN is supported

The type of banking alias (note that only IBAN is available at present)

Country
BankingAliasCountry

BankingAliasCountry:

LU, FR

The country format for the banking alias.

The country format for the banking alias.

OwnerName
string

string:

Maximum length is 255 characters

The owner of the wallet/banking alias

Active
bool

bool:

true, false

Whether the banking alias is active or not

{
"CreditedUserId": "8494514",
"WalletId": "8494559",
"Type": "IBAN",
"Country": "LU",
"OwnerName": "Joe Blogs",
"Active": true
}

The IBAN Bank Aliasing object

Parameters

CreditedUserId
string

string:

Maximum length is 255 characters

The user ID who is credited (defaults to the owner of the wallet)

WalletId
string

string:

Maximum length is 255 characters

The ID of a wallet

Type
BankingAliasType

BankingAliasType:

IBAN

The type of banking alias. Currently only IBAN is supported

The type of banking alias (note that only IBAN is available at present)

Country
BankingAliasCountry

BankingAliasCountry:

LU, FR

The country format for the banking alias.

The country format for the banking alias.

OwnerName
string

string:

Maximum length is 255 characters

The owner of the wallet/banking alias

Active
bool

bool:

true, false

Whether the banking alias is active or not

IBAN
string

string:

Maximum length is 255 characters

The IBAN of the banking alias

BIC
string

string:

Maximum length is 255 characters

The BIC of the banking alias

{
"CreditedUserId": "8494514",
"WalletId": "8494559",
"Type": "IBAN",
"Country": "LU",
"OwnerName": "Joe Blogs",
"Active": true,
"IBAN": "FR7630004000031234567890143",
"BIC": "BNPAFRPP"
}

Create an IBAN Banking Alias

POST .../v2.01/ClientId

The ID of your client account

/wallets/WalletId

The ID of a wallet

/bankingaliases/iban/

Parameters

OwnerName
string

string:

Maximum length is 255 characters

required

The owner of the wallet/banking alias

Tag
string

string:

Daily | Weekly | TwiceAMonth | Monthly | Bimonthly | Quarterly | Semiannual |Annual | Biannual

optional

Custom data that you can add to this item

Country
BankingAliasCountry

BankingAliasCountry:

LU, FR

The country format for the banking alias.

required

The country format for the banking alias.

  • View
  • Code
    A code sample is not available
  • Run
  • View
  • Code
    A code sample is not available
  • Run
POST .../wallets/:WalletId/bankingaliases/iban/ HTTP/1.1
Body Parameters :
{
"OwnerName": "Joe Blogs",
"Tag": "custom meta",
"Country": "LU"
}
POST .../wallets//bankingaliases/iban/ HTTP/1.1
Body Parameters :
{
"OwnerName": "",
"Tag": "",
"Country": ""
}

Deactivate a Banking Alias

Note that once deactivated, a banking alias can't be reactivated afterwards, and any funds received to this banking alias won't be credited to the wallet. In this case, please contact our finance team at finance@mangopay.com.

PUT .../v2.01/ClientId

The ID of your client account

/bankingaliases/BankingAliasId

The ID of a banking alias

/

Parameters

Active
bool

bool:

true, false

required

Whether the banking alias is active or not

  • View
  • Code
    A code sample is not available
  • Run
  • View
  • Code
    A code sample is not available
  • Run
PUT .../bankingaliases/:BankingAliasId/ HTTP/1.1
Body Parameters :
{
"Active": true
}
PUT .../bankingaliases// HTTP/1.1
Body Parameters :
{
"Active": ""
}

View a Banking Alias

View the details of a banking alias

GET .../v2.01/ClientId

The ID of your client account

/bankingaliases/BankingAliasId

The ID of a banking alias

/
  • View
  • Code
    A code sample is not available
  • Run
  • View
  • Code
    A code sample is not available
  • Run
GET .../bankingaliases/:BankingAliasId/ HTTP/1.1
GET .../bankingaliases// HTTP/1.1

View the Banking Alias for a Wallet

To view a wallet's banking aliases - remember that you can only have one banking alias per wallet (even though it is a list format).

GET .../v2.01/ClientId

The ID of your client account

/wallets/WalletId

The ID of a wallet

/bankingaliases/
  • View
  • Code
    A code sample is not available
  • Run
  • View
  • Code
    A code sample is not available
  • Run
GET .../wallets/:WalletId/bankingaliases/ HTTP/1.1
GET .../wallets//bankingaliases/ HTTP/1.1
Share feedback