POST
/
v2.01
/
{ClientId}
/
wallets
{
    "Description": "Description of the user's wallet",
    "Owners": [
        "user_m_01J18HZSACR1EMYNY1TBS8KTJD"
    ],
    "Currency": "EUR",
    "Tag": "Created using Mangopay API Postman Collection",
}  
{
    "Description": "Description of the user's wallet",
    "Owners": [
        "user_m_01J18HZSACR1EMYNY1TBS8KTJD"
    ],
    "Id": "wlt_m_01J6EN9X1Q0PGM0CJ9QD197CRG",
    "Balance": {
        "Currency": "EUR",
        "Amount": 0
    },
    "Currency": "EUR",
    "FundsType": "DEFAULT",
    "Tag": "Created using Mangopay API Postman Collection",
    "CreationDate": 1724921476
}
Best practice – Create one wallet per user and currencyWhile Mangopay authorizes you to create as many wallets as required, we recommend you create one wallet per user and currency.
Caution – Currency not updatableThe Currency of a created wallet cannot be changed.

Body parameters

Description
string
required
Max. length: 255 charactersThe description of the wallet. It can be a name, the type, or anything else that can help you clearly identify the wallet on the platform (and for your end users).
Owners
array
required
stringThe unique identifier of the user owning the wallet.Note: Only one owner can be defined; this array accepts only one string.
Currency
string
required
Allowed values: The three-letter ISO 4217 code (EUR, GBP, etc) of a supported currency (depends on feature, contract, and activation settings).The currency of the wallet.
Tag
string
Max. length: 255 charactersCustom data that you can add to this object.
For wallets, you can use this parameter to identify the corresponding end user in your platform.

Responses

{
    "Description": "Description of the user's wallet",
    "Owners": [
        "user_m_01J18HZSACR1EMYNY1TBS8KTJD"
    ],
    "Id": "wlt_m_01J6EN9X1Q0PGM0CJ9QD197CRG",
    "Balance": {
        "Currency": "EUR",
        "Amount": 0
    },
    "Currency": "EUR",
    "FundsType": "DEFAULT",
    "Tag": "Created using Mangopay API Postman Collection",
    "CreationDate": 1724921476
}
{
    "Description": "Description of the user's wallet",
    "Owners": [
        "user_m_01J18HZSACR1EMYNY1TBS8KTJD"
    ],
    "Currency": "EUR",
    "Tag": "Created using Mangopay API Postman Collection",
}