Error Handling Standards
Standardized HTTP response error codes and recommended client handling strategies.
| HTTP Status | Error Type | Description & Strategy |
|---|---|---|
| 200 OK | Success | Request completed successfully. Check status or response_code in response body. |
| 400 Bad Request | Invalid Request | Missing mandatory parameters or malformed JSON payload. |
| 401 Unauthorized | Authentication | Invalid or expired API Key / Bearer token in headers. |
| 422 Validation Error | Schema Validation | Payload validation failed. Check specific field error messages returned in the error object. |
| 500 Internal Error | Server Error | Upstream bank or provider timeout. Implement exponential backoff retry logic. |