Morapay Developer Docs

Code: links.amount.below_minimum
HTTP: 422 Unprocessable Entity

What happened

The API rejected a payment link or checkout link create/update request.

Safe message

This amount is below the minimum allowed for mobile money checkout in this region.

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

Display message

The transaction amount must be at least 1.00 GHS.

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

Why this happened

Mobile network operators enforce a platform floor transaction limit (for example, 1.00 GHS in Ghana).

How to fix it

Validate cart totals and dynamic pricing so amount meets the regional minimum before calling morapay.link.create() or morapay.products.link().

UI hint

Field	Value
`severity`	`warning`
`placement`	`inline`
`actionText`	`Update amount`

Programmatic handling

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

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

links.slug.duplicate

Getting started

Concepts

Frontend & UI

Developer tools

Errors

Support

links.amount.below_minimum

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