Morapay Developer Docs

Code: api.proxy.core_unreachable
HTTP: 502 Bad Gateway

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 was temporarily unreachable.

How to fix it

Verify baseUrl, network connectivity, and that the API is running. Retry with backoff.

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

api.rate_limited
api.service_unavailable
api.proxy.core_unconfigured
api.proxy.signing_unconfigured

api.proxy.signing_unconfigured Get help

Getting started

Concepts

Frontend & UI

Developer tools

Errors

Support

api.proxy.core_unreachable

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