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 currency

While Mangopay authorizes you to create as many wallets as required, we recommend you create one wallet per user and currency.

Caution – Currency not updatable

The Currency of a created wallet cannot be changed.

​
Body parameters

​
Description
string
required

Max. length: 255 characters

The 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

string

The 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 characters

Custom 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",
}