Overview
User management
- Users
- User regulatory status
- User e-money
User verification
- User data format
- KYC documents
- UBO declarations
Wallets
- User wallets
- Client wallets
Cards
- Card registrations
- Cards
- Metadata
- Card validations
Card pay-ins
- Direct card pay-ins
- Recurring card pay-ins
- Preauthorizations
- Deposit preauthorizations
- Web card pay-ins
Banking pay-ins
- Bank wires
- Pay by bank
- Virtual IBAN
- Direct debits
- Web direct debits
APM pay-ins
- Apple Pay
- Bancontact
- BLIK
- Giropay
- Google Pay
- iDEAL
- Klarna
- MB WAY
- Multibanco
- Payconiq
- PayPal
- Satispay
- Swish
- TWINT
Transfers
- Transfers
Refunds
- Refunds
Disputes
- Disputes
- Dispute documents
- Repudiations
- Dispute settlement
Payouts
- Bank accounts
- Payouts
FX conversions
- Conversion rates
- Quotes
- Conversions
Transactions
- Transactions
Helpers
- API responses
- Country authorizations
- Webhooks
- Events
- Reports
Platform account
- Client
- Dashboard permissions
Create an IBAN Banking Alias
{
"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"
}
Path parameters
The unique identifier of the wallet.
Body parameters
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.
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.
Responses
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 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.
Returned 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, GB
The type of banking alias.
The GB value is only returned if the Country is GB.
The unique identifier of the object.
The unique identifier of the wallet.
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 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.
Returned 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, GB
The type of banking alias.
The GB value is only returned if the Country is GB.
The unique identifier of the object.
The unique identifier of the wallet.
{
"Message": "One or several required parameters are missing or incorrect. An incorrect resource ID also raises this kind of error.",
"Type": "param_error",
"Id": "fd020620-8e5c-4b64-925c-aa980e42c237#1670340996",
"Date": 1670340997.0,
"errors": {
"Country": "The requested country is not supported"
}
}
{
"Message": "There is already a banking alias existing for this wallet",
"Type": "wallet_banking_alias_already_exists",
"Id": "77b73aa3-e08e-4e04-9ffd-5c94ed4f73ff",
"Date": 1732178114,
"errors": null
}
{
"Message": "Invalid country GB for EUR wallet. Possible value(s): LU/FR/ES/DE.",
"Type": "country_not_associated_to_wallet_currency",
"Id": "1eb1c947-bac2-4127-a636-fe7d811db9e7",
"Date": 1725288513.0,
"errors": null
}
{
"Message": "This endpoint is not available for your account",
"Type": "forbidden_ressource",
"Id": "441d156a-ebd1-421e-851b-460a25c6a53f#1670262779",
"Date": 1670262780.0,
"errors": null
}
{
"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"
}
Was this page helpful?
{
"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"
}