Morapay Developer Docs

Code: api.connection_failed
HTTP: 502 Bad Gateway

What happened

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

Safe message

We could not reach the payment service. Please try again.

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

Why this happened

The client received a non-JSON or empty response from the API.

How to fix it

Verify baseUrl, TLS, and that the Morapay API is reachable from your server.

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.ApiConnectionFailed) {
    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.gateway_timeout api.proxy.core_unconfigured

Getting started

Concepts

Frontend & UI

Developer tools

Errors

Support

api.connection_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