Error Codes
We don't usually have any trouble on our end. If that's the case we'll let you know!
The finaX API uses following error codes:
| Code | Text | Description |
|---|---|---|
| 402 | API Key suspended | API key suspended. Payment required. |
| 403 | Unauthorized | Unauthorized. API Key HTTP Header missing or invalid. |
| 415 | Unsupported media type | Invalid Content-Type header - check header information for endpoint. |
| 422 | Error processing input | Error processing input. |
| 429 | Request limit reached | Request limit for API key has been reached. |
| 500 | Server Error | Something went wrong on our side. |
HTTP 422 - Processing errors
HTTP 422 errors are mostly returned when there is something wrong with the given input. A field might be missing, a business rule might invalidate the requests's content etc.
Since version 1.6.0 it is possible to change the language for these error messages through the Accept-Language header.
The error message might be helpful for your users or just for debugging purposes. The field names for an error message remain in English.
Furthermore in case a business rule is violated, a string with the name of the rule in contained in the error json payload in the field business_rule.
Please note that error messages (the message field in the error response payload) may change in future.