Morapay Developer Docs

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

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

Getting started

Concepts

Frontend & UI

Developer tools

Errors

Support

payouts.momo.insufficient_balance

What happened

Safe message

Display message

Why this happened

How to fix it

UI hint

Programmatic handling

​What happened

​Safe message

​Display message

​Why this happened

​How to fix it

​UI hint

​Programmatic handling

​Related codes

What happened

Safe message

Display message

Why this happened

How to fix it

UI hint

Programmatic handling

Related codes