The Wallet object

A Wallet is an object in which PayIns and Transfers from users are stored in order to collect money. You can pay into a Wallet, withdraw funds from a wallet or transfer funds from a Wallet to another Wallet.

Parameters

Owners
list

list

An array of userIDs of who own's the wallet. For now, you only can set up a unique owner.

Balance
Money

Money:

View Sub-parameters

The current balance of the wallet

Balance.Currency
Currency

Currency:

AED, AUD, CAD, CHF, CZK, DKK, EUR, GBP, HKD, JPY, NOK, PLN, SEK, USD, ZAR

The currency - should be ISO_4217 format

Balance.Amount
int

int

An amount of money in the smallest sub-division of the currency, e.g. 12.60 EUR would be represented as 1260 whereas 12 JPY would be represented as just 12)

FundsType
FundsType

FundsType:

DEFAULT, FEES, CREDIT

The type of funds in the wallet

Description
string

string:

Maximum length is 255 characters

A description of the wallet

Currency
Currency

Currency:

AED, AUD, CAD, CHF, CZK, DKK, EUR, GBP, HKD, JPY, NOK, PLN, SEK, USD, ZAR

The currency - should be ISO_4217 format

{
"Owners": [ "8494514" ],
"Balance": {
"Currency": "EUR",
"Amount": 12
},
"FundsType": "DEFAULT",
"Description": "My big project",
"Currency": "EUR"
}

Create a Wallet

Once a wallet is created, its Currency can not be changed

POST .../v2.01/ClientId

The ID of your client account

/wallets/

Parameters

Owners
list

list

required

An array of userIDs of who own's the wallet. For now, you only can set up a unique owner.

Description
string

string:

Maximum length is 255 characters

required

A description of the wallet

Currency
Currency

Currency:

AED, AUD, CAD, CHF, CZK, DKK, EUR, GBP, HKD, JPY, NOK, PLN, SEK, USD, ZAR

required

The currency - should be ISO_4217 format

Tag
string

string:

Maximum length is 255 characters

optional

Custom data that you can add to this item

  • View
  • Code
  • Run
  • View
  • Code
  • Run
POST .../wallets/ HTTP/1.1
Body Parameters :
{
"Owners": [ "8494514" ],
"Description": "My big project",
"Currency": "EUR",
"Tag": "custom meta"
}
POST .../wallets/ HTTP/1.1
Body Parameters :
{
"Owners": [ "" ],
"Description": "",
"Currency": "",
"Tag": ""
}

Update a Wallet

PUT .../v2.01/ClientId

The ID of your client account

/wallets/WalletId

The ID of a wallet

/

Parameters

Description
string

string:

Maximum length is 255 characters

optional

A description of the wallet

  • View
  • Code
  • Run
  • View
  • Code
  • Run
PUT .../wallets/:WalletId/ HTTP/1.1
Body Parameters :
{
"Description": "My big project"
}
PUT .../wallets// HTTP/1.1
Body Parameters :
{
"Description": ""
}

View a Wallet

GET .../v2.01/ClientId

The ID of your client account

/wallets/WalletId

The ID of a wallet

/
  • View
  • Code
  • Run
  • View
  • Code
  • Run
GET .../wallets/:WalletId/ HTTP/1.1
GET .../wallets// HTTP/1.1

List Wallets for a User

GET .../v2.01/ClientId

The ID of your client account

/users/UserId

A Mangopay user's ID

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