> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.mangopay.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.mangopay.com/_mcp/server.

# 005405

<table>
  <tbody>
    <tr>
      <th class="header">
        Error message
      </th>

      <td class="table-content">
        Balance of client fee wallet unsufficient
      </td>
    </tr>

    <tr>
      <th class="header">
        Description
      </th>

      <td class="table-content">
        The refund failed because the fees exceeds the balance of the Fees Wallet.
      </td>
    </tr>

    <tr>
      <th class="header">
        Categories
      </th>

      <td class="table-content">
        Refund
      </td>
    </tr>
  </tbody>
</table>

#### Causes

This error occurs when attempting to make a refund with a fees `Amount` superior to the platform's Fees Wallet `Balance` amount.

#### What to do

In such cases, platforms can:

* Wait for their Fees Wallet to be credited again in order to make a new attempt for the refund

#### Example

Below the API response after attempting to make a refund while the Fees Wallet didn’t have the necessary funds.

**`API Response`**

```json API Response
{
    "Id": "163107946",
    "Tag": "Created using MANGOPAY API Collection Postman",
    "CreationDate": 1677248439,
    "AuthorId": "146476890",
    "CreditedUserId": null,
    "DebitedFunds": {
        "Currency": "EUR",
        "Amount": 33203
    },
    "CreditedFunds": {
        "Currency": "EUR",
        "Amount": 3303
    },
    "Fees": {
        "Currency": "EUR",
        "Amount": -100
    },
    "Status": "FAILED",
    "ResultCode": "005405",
    "ResultMessage": "Balance of client fee wallet unsufficient",
    "ExecutionDate": null,
    "Type": "PAYOUT",
    "Nature": "REFUND",
    "InitialTransactionId": "163093582",
    "InitialTransactionType": "PAYIN",
    "InitialTransactionNature": "REGULAR",
    "DebitedWalletId": "148968396",
    "CreditedWalletId": null,
    "RefundReason": {
        "RefundReasonMessage": null,
        "RefundReasonType": "INITIALIZED_BY_CLIENT"
    }
}
```