Errors

All platform APIs should return a machine-readable error code, a human-readable message, and a safe retry recommendation.

Common Categories

  • `EGC_AUTH_INVALID_KEY`, `EGC_AUTH_INVALID_SIGNATURE`, `EGC_AUTH_TIMESTAMP_EXPIRED`
  • `EGC_COUNTRY_UNAVAILABLE`, `EGC_CURRENCY_UNSUPPORTED`, `EGC_PRODUCT_NOT_AVAILABLE`
  • `EGC_KYC_REQUIRED`, `EGC_KYB_REQUIRED`, `EGC_MERCHANT_NOT_APPROVED`
  • `EGC_WALLET_FROZEN`, `EGC_WALLET_INSUFFICIENT_BALANCE`, `EGC_TRANSACTION_DUPLICATE`
  • `EGC_PROVIDER_UNAVAILABLE`, `EGC_COMPLIANCE_REVIEW`, `EGC_WEBHOOK_FAILED`