Morapay Developer Docs

Code: payouts.clearing.refund_failed
HTTP: 500 Internal Server Error

What happened

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

Safe message

This payout could not be completed. Please contact support.

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

Why this happened

Clearing funds back to inventory failed during payout lifecycle processing.

How to fix it

Contact Morapay support with the requestId. Do not retry the same batch until the settlement state is confirmed.

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.PayoutsClearingRefundFailed) {
    console.error(err.format());
    // Customer UI: err.displayMessage ?? err.safeMessage
    // Support: err.requestId
  }
}

payouts.network.carrier_down crypto.chain.unsupported

Getting started

Concepts

Frontend & UI

Developer tools

Errors

Support

payouts.clearing.refund_failed

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