Error Overview
Flexiti uses conventional HTTP response codes to indicate the success or failure of an API request. In general:
...
HTTP Status Codes | Type | Status |
200 | Success | Everything worked as expected. |
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 or wrong format. |
500, 502, 503, 504 | Server Errors | Something went wrong on the Flexiti side. (These are rare.) |
General Errors
...
Code | Error | Scenario |
400 | 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 |
404 | customer_identity_not_found | The customer didn’t pass through the widget or was not authenticated properly |
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 status different to normal (NNOR) |
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 | wrong_verification_code | Verification code entered is incorrect |
409 | verification_code_required | Verification code is a required parameter. |
409 | invalid_transaction_type | wrong value for transaction type in the request |
409 | not_enough_credit | Customer does not have enough open to buy for transaction amount |
409 | limit_payment_amount_24 | Payments made on the account exceed the $10,000/day limit |
409 | refunds_limit_exceeded_amount | Refund amount exceeds account limit |
409 | auth_not_allowed | Merchant has not configured pre-auth in Lexi. |
409 | plan_term_not_set | Merchant has not configured the financing option (Plan and Term or Regular Purchase) in Lexi. |
409 | plan_term_not_available |
|
409 | credit_exceeded | Amount requested plus fees is greater than the available credit of the customer account. |
409 | generic_error | A generic error covering backend process issues |
Input Errors
Input errors will tend to follow this model:
...