> 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.

# 001001

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

      <td class="table-content">
        Unsufficient wallet balance
      </td>
    </tr>

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

      <td class="table-content">
        The wallet does not contain enough funds to process the transaction.
      </td>
    </tr>

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

      <td class="table-content">
        Transfer

        \


        Wallet

        \


        Payout

        \


        Refund
      </td>
    </tr>
  </tbody>
</table>

#### Causes

This error occurs when the wallet does not contain enough funds to process a transaction.

#### What to do

In such cases, the transaction must be made with an amount inferior or equal to the amount available on the debited Wallet.

#### Examples

In the example below, a transfer has been attempted from a wallet with insufficient funds.

**`API Response`**

```json API Response

{
    "Id": "157756496",
    "Tag": "Created using MANGOPAY API Collection Postman",
    "CreationDate": 1670423591,
    "AuthorId": "150429004",
    "CreditedUserId": "156671912",
    "DebitedFunds": {
        "Currency": "EUR",
        "Amount": 5000
    },
    "CreditedFunds": {
        "Currency": "EUR",
        "Amount": 5000
    },
    "Fees": {
        "Currency": "EUR",
        "Amount": 0
    },
    "Status": "FAILED",
    "ResultCode": "001001",
    "ResultMessage": "Unsufficient wallet balance",
    "ExecutionDate": null,
    "Type": "TRANSFER",
    "Nature": "REGULAR",
    "DebitedWalletId": "150523186",
    "CreditedWalletId": "157756444"
}
```

In the example below, a payout has been attempted from a wallet with insufficient funds.

**`API Response`**

```json API Response
{
    "ModeRequested":"STANDARD",
    "ModeApplied":"STANDARD",
    "FallbackReason":null,
    "EndToEndId":"d8818543c2d84f12a918c116516fa87a",
    "Id":"6658661",
    "Tag":"Custom meta",
    "CreationDate":1677146852,
    "AuthorId":"6658653",
    "CreditedUserId":null,
    "DebitedFunds":{
        "Currency":"EUR",
        "Amount":4900
    },
    "CreditedFunds":{
        "Currency":"EUR",
        "Amount":4900
    },
    "Fees":{
        "Currency":"EUR",
        "Amount":0
    },
    "Status":"FAILED",
    "ResultCode":"001001",
    "ResultMessage":"Unsufficient wallet balance",
    "ExecutionDate":null,
    "Type":"PAYOUT",
    "Nature":"REGULAR",
    "CreditedWalletId":null,
    "DebitedWalletId":"6658655",
    "PaymentType":"BANK_WIRE",
    "BankAccountId":"6658659",
    "BankWireRef":"Ref15469532"
}
```