...
Some 4xx errors that could be handled programmatically include an error code that briefly explains the error reported.
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
HTTP Status Codes | Type | 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
Code | MessageError | Scenario | TBD|
400 | 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 |
invalid_client | Wrong or missing client id or client_secret | ||
400 | invalid_request | Invalid or missing grant_type parameter | |
400 | not_found | Authorization ID not found | |
400 | invalid_account | Wrong account number (if requested) | |
401 | invalid_token | Wrong or expired access token. | |
401 | Unauthorized | Wrong or missing Merchant authorization | |
404 | not_found | Customer Account not found | |
409 | authentication_failure | Missing or wrong Merchant authentication parameters | |
409 | tos_agreement_required | Terms and Conditions missing or not agreed | |
409 | customer_already_exists | Customer applying already has an account | |
409 | application_declined, application_declined_2, application_declined_3 | Customer application declined | |
409 | creditapp_id_not_found | Credit Application ID was not found | |
409 | application_marked_pending_1, application_marked_pending_2 | Customer application pending | |
409 | application_create_error | There was an error creating the Credit Application | |
409 | user_not_active | Customer Account is not activated | |
409 | not_found | Customer could not be found | |
409 | user_not_able_to_purchase | Customer account is not able to make a purchase (status other than normal) | |
409 | user_not_able_to_preaut | Customer is not make to make an authorization | |
409 | not_found | Customer Account number could not be found | |
409 | secret_answer_mismatch | Security question answer does not match what is on file for the customer | |
409 | merchant_override_is_not_allowed | Merchant is not configured for Merchant Override | |
409 | piw_mismatch | Personal Identification word entered does not match what is on file for the customer | |
409 | Driver License's not supported | ||
409 | wrong_verification_code | Verification code entered is incorrect | |
409 | verification_code_required | Verification code is a required parameter. | |
409 | invalid_transaction_type | ||
409 | not_enough_credit | ||
409 | limit_payment_amount_24 | ||
409 | refunds_limit_exceeded_amount |
Input Errors
Example Response
| Code Block |
|---|
...
| ||
{ "url": "/flexiti/pos-api/v2.5/client-id/flexitidemo/apply", "message": "Some inputs are wrong!", "error": "wrong_inputs", "field_errors": [ { "param": "SIN", "msg": "wrong format" } ] } |
Code | Error | Scenario |
409 | wrong format | Mismatch data type |
409 | required | Mandatory parameter not sent in the request. |
409 | invalid_date_format | Date with wrong format |
409 | type | Mismatch data type |
409 | length | Data length exceeded |