Morapay Developer Docs

Code: api.service_unavailable
HTTP: 503 Service Unavailable

What happened

The Morapay API could not complete the request due to rate limits, connectivity, or infrastructure.

Safe message

Our payment service is temporarily unavailable. Please try again shortly.

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

Why this happened

The Morapay API could not complete the request due to a transient infrastructure issue.

How to fix it

Retry with backoff. If the issue persists, contact support with the requestId.

UI hint

Field	Value
`severity`	`critical`
`placement`	`toast`
`actionText`	`Retry`

Programmatic handling

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

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

api.rate_limited
api.proxy.core_unconfigured
api.proxy.signing_unconfigured
api.proxy.core_unreachable

api.rate_limited api.internal_error

Getting started

Concepts

Frontend & UI

Developer tools

Errors

Support

api.service_unavailable

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