Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

  • Plan and Term for prime category for a non-prime customer.

  • Plan "DP - SAC Interest Accrues" for a QC customer.

  • Plan "DP - SAC No Payments + No Interest Accrued" for a ROC customer.

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:

...