Error Handling
All SDK methods raise aMoneiError on failure:
Common Error Codes
| Code | HTTP Status | Meaning |
|---|---|---|
UNAUTHORIZED | 401 | Missing or invalid API key / bearer token |
FORBIDDEN | 403 | Insufficient permissions or KYC tier too low |
NOT_FOUND | 404 | Resource does not exist |
VALIDATION_ERROR | 422 | Invalid request body |
INSUFFICIENT_FUNDS | 400 | Wallet balance too low |
RATE_LIMITED | 429 | Too many requests, back off and retry |
INTERNAL_ERROR | 500 | Something went wrong on our end |

