Skip to main content

​
Description

The Client Wallet object represents one of two wallets created automatically by Mangopay for the platform in each currency:
  • Fees Wallet - Stores all Fees taken on transactions by the platform and paid out by Mangopay automatically as part of the billing cycle (see the Fees guide). The FundsType of the Fees Wallet is FEES.
  • Repudiation Wallet - Manages funds relating to disputes management. The FundsType of the Repudiation Wallet is CREDIT.
There can be only one wallet per FundsType and Currency.
Note – Latency of balance updateThe client wallet balance can take a few minutes to be updated after a transfer with fees has been done.

​
Attributes

​
Balance
object
The current balance of the wallet.
​
Currency
string
Returned 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.
​
FundsType
string
Returned values: DEFAULT, FEES, CREDITThe type of funds in the wallet:
  • DEFAULT – Regular funds for user-owned wallets. Wallets with this FundsType cannot have a negative balance.
  • FEES – Fees Wallet, for fees collected by the platform, specific to the Client Wallet object.
  • CREDIT – Repudiation Wallet, for funds for the platform’s dispute management, specific to the Client Wallet object.
Note: The Fees Wallet and Repudiation Wallet are created automatically by Mangopay for each currency.
​
Id
string
The unique identifier of the wallet.The Id of Client Wallet object has the format FundsType_Currency, for example: FEES_EUR, CREDIT_GBP, etc.
​
Tag
string
Max. length: 255 charactersThis parameter usually allows you to enter custom data, but in the case of the Client Wallet object, it is always “null” as the object is automatically created.
​
CreationDate
Unix timestamp
The date and time at which the wallet was created.