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.

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.
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	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
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

{
    "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

POS API v2.5 - Error Handling

Error Overview

Error Overview

HTTP Status Code Summary

General Errors

Input Errors