Morapay Developer Docs

Code: payouts.network.carrier_down
HTTP: 503 Service Unavailable

What happened

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

Safe message

Mobile money is temporarily unavailable. Please try again in a few minutes.

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

Why this happened

A regional mobile money operator node (MTN, Telecel, etc.) is reporting downtime.

How to fix it

Queue the payout for retry and alert operations. Include requestId when contacting Morapay support.

UI hint

Field	Value
`severity`	`critical`
`placement`	`modal`
`actionText`	`View account`

Programmatic handling

import { MorapayApiError, isMorapayError, MorapayErrorCode } from "@morapay/sdk";

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

payouts.momo.insufficient_balance payouts.clearing.refund_failed

Getting started

Concepts

Frontend & UI

Developer tools

Errors

Support

payouts.network.carrier_down

What happened

Safe message

Why this happened

How to fix it

UI hint

Programmatic handling

​What happened

​Safe message

​Why this happened

​How to fix it

​UI hint

​Programmatic handling

​Related codes

What happened

Safe message

Why this happened

How to fix it

UI hint

Programmatic handling

Related codes