🟢 HTTP Status Codes
Standardized HTTP response status codes returned by IMB Payment API services.
| Code | Meaning | Description & Strategy |
|---|---|---|
| 200 | OK | Successful request. All queries processed as expected. |
| 201 | Created | Resource created successfully. |
| 400 | Bad Request | Invalid request parameters or missing mandatory fields. |
| 401 | Unauthorized | Authentication failed. Missing or invalid x-client-id or x-client-secret. |
| 403 | Forbidden | Access to resource denied. IP address not whitelisted or permission lacking. |
| 404 | Not Found | Resource does not exist or request ID not found. |
| 409 | Conflict | Duplicate or conflicting operation (e.g. duplicate transaction ref). |
| 422 | Unprocessable Entity | Invalid resource state or parameter validation failure. |
| 429 | Too Many Requests | Rate limit exceeded. Exceeded 60 requests per minute limit. |
| 500 | Internal Server Error | Problem on IMB Payments' side or upstream provider. Retry with exponential backoff. |