Skip to main content
Morapay errors are designed as an on-demand consultant, not just a stack trace. Every failed Merchant API response includes enough context for developers, support engineers, and customer-facing UI.

Error envelope

Field guide

SDK usage

Error code dictionary

Import MorapayErrorCode for IDE autocomplete instead of string literals. Typos fail at compile time when you compare against the dictionary:

Error subclasses

Semantic codes

Codes follow domain.resource.reason:

Authentication

KYB and permissions

Payouts and treasury

Crypto checkout

Resources and validation

Platform and connectivity

Next step

Get help: how to reach support with the right context.