Error Overview
Flexiti uses conventional HTTP response codes to indicate the success or failure of an API request. In general: Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, a transaction failed, etc.). Codes in the 5xx range indicates an error with Flexiti's servers.
Some 4xx errors that could be handled programmatically include an error code that briefly explains the error reported.
HTTP Status Code Summary
Code | Status |
|---|---|
200 - Success | Everything worked as expected. |
400 - Bad Request | The request was unacceptable, often due to missing a required parameter. |
401 - Unauthorized | An error with the Merchant authentication. |
402 - Request Failed | The parameters were valid but the request failed. |
404 - Not Found | The requested resource doesn't exist. |
409 - Bad Request | The request was unacceptable, often due to missing a required parameter. |
500, 502, 503, 504 - Server Errors | Something went wrong on the Flexiti side. (These are rare.) |
General Errors
HTTP Code | Message | Error | Scenario |
|---|---|---|---|
TBD | The access token provided is invalid. | invalid_token | Wrong token. |
TBD | The access token provided has expired. | invalid_token | Expired token. |
TBD | Client credentials are invalid | invalid_credentials | Wrong client Id or client secret |
TBD | Invalid or missing client_id parameter | invalid_client | Wrong or missing client id |
TBD | Account not found | invalid_account | Wrong account number (if requested) |
TBD | Not found | not_found | Authorization Id not found |
Input Errors
Example Response
}
"url": "/flexiti/pos-api/v2/client-id/flexitidemo/apply",
"message": "Some inputs are wrong!",
"error": "wrong_inputs",
"field_errors": [
{
"param": "SIN",
"msg": "wrong format"
}
]
}