> ## Documentation Index
> Fetch the complete documentation index at: https://docs.morapay.io/llms.txt
> Use this file to discover all available pages before exploring further.

# payouts.momo.insufficient_balance

> This payout cannot be completed right now. Please try again shortly.

**Code:** `payouts.momo.insufficient_balance`\
**HTTP:** `400 Bad Request`

## What happened

The API could not complete a payout, disbursement, or treasury operation.

## Safe message

> This payout cannot be completed right now. Please try again shortly.

Use `err.safeMessage` or `err.displayMessage` in customer UI, not `err.message`.

## Display message

> Your payout balance is too low to complete this transfer.

Use `err.displayMessage` in UI components. Reserve `err.message` for server logs.

## Why this happened

Your Morapay treasury account does not have enough fiat liquidity for this payout batch.

## How to fix it

Check available balance with await morapay.disbursement.account() before initiating transfers. Top up your fiat pool or reduce batch size.

## UI hint

| Field        | Value          |
| ------------ | -------------- |
| `severity`   | `critical`     |
| `placement`  | `modal`        |
| `actionText` | `View balance` |

## Programmatic handling

```typescript theme={null}
import { MorapayInvalidRequestError, isMorapayError, MorapayErrorCode } from "@morapay/sdk";

catch (err) {
  if (isMorapayError(err) && err.code === MorapayErrorCode.PayoutsMomoInsufficientBalance) {
    console.error(err.format());
    // Customer UI: err.displayMessage ?? err.safeMessage
    // Support: err.requestId
  }
}
```

## Related codes

* [`payouts.network.carrier_down`](/errors/codes/payouts-network-carrier-down)
* [`payouts.clearing.refund_failed`](/errors/codes/payouts-clearing-refund-failed)