Rave Errors

RAVE API errors can be grouped into three main categories. The validation errors, rave errors and provider errors.
They are usually returned in this format with the 400 http status code:

{
"status": "error",
"message": "merchant secret key required",
"data": null
}

VALIDATION ERRORS

Validation errors are returned when one or more validation rules fail. Examples include not passing required parameters e.g. not passing the transaction / provider ref during a re-query call will result in the error below:

{
"status": "error",
"message": "Cardno is required",
"data": null
}

RAVE ERRORS

Rave errors are returned for one of two reasons:

An internal process error precluding a request from completing such as a server timeout
Request from merchant keys that fail some limit / resource access / compliance checks

The errors include:
You can only charge Nigerian Accounts in Naira
This error occurs when you attempt to charge a Nigerian bank account with a currency other than the Nigerian Naira.

USSD charges can only be done in Naira
This error occurs when you attempt a USSD charge with a currency other than the Nigerian Naira.

Invalid Auth model. Preauth can only be used with NOAUTH / BVN
This error occurs wen you attempt a PREAUTH charge passing an auth model other than NOAUTH / BVN.

Transaction with ref EXAMPLE-REF either does not exist or is not a valid preauth transaction
This error occurs when you try to perform a capture on a transaction that doesn't exist or belong to your merchant or is not as a result of an initial PREAUTH charge call.

Transaction has been flagged as fraudulent
This error occurs when a transaction's flagged by the fraud detection service used by Rave.

Token not found
This error occurs when an attempt is made to perform a tokenized charge with an invalid or non-existent token

That token has expired
This error occurs when an already used token is passed as the token value when performing a tokenized charge.

Transaction already complete
This error occurs when you try to validate an already completed transaction. (A transaction for which validation had previously been done)

Transaction not found
This error occurs when you try to validate a transaction with a non-existent reference.

Merchant limit is set at 3000 pending go live. Please contact support
This error occurs when your account has not been approved by the compliance team.

Compliance Required. Please contact support
This error occurs when your account is under complaince review.

Compliance status failure. Please contact support
This error occurs when your account's compliance submission has been rejected by compliance team

Merchant over the allowed compliance value limit
This error occurs when your account is under compliance review and you attempt a charge with an amount greater than the allowed in-review compliance limit.

You have exceeded your daily limit
This error occurs when you attempt a charge with an amount greater than the daily transaction amount limit applicable to your merchant account

amount should be between xxxx and xxxxxxx
This error occurs when you attempt a charge with an amount greater than the maximum transation amount and lesser than the minimum transaction

Sorry, that country does not exist. Please check and try again
This error occurs when you pass a country code not currently supported by Rave

Currency: XXX does not exist
This error occurs when you pass a currency not currently supported by Rave for charge calls.

Merchant needs approval to make transactions.
This error occurs mostly on Subdomain merchants that have not been approved by their parents for charge transactions

Merchant is required to implement checksum. Please contact support
This error occurs when you are making a charge request without passing the integrity hash parameter

Payment details mismatch. Please contact support
This error occurs when the hash passed for checksum enabled API requests does not match the server generated hash.

An error occured while attempting to decrypt some parameters
This error occurs when request payload contains parameters encrypted wrongly

Inactive public key passed
This error occurs when a public key that has been deactivated is passed during a charge call

PROVIDER ERRORS

Provider errors are returned from the payment provider.

UNSPECIFIED_FAILURE
Transaction could not be processed.

DECLINED
Transaction declined by issuer.

TIMED_OUT
Response timed out

EXPIRED_CARD
Transaction declined due to expired card

INSUFFICIENT_FUNDS
Transaction declined due to insufficient funds

ACQUIRER_SYSTEM_ERROR
Acquirer system error occurred processing the transaction

SYSTEM_ERROR
Internal system error occurred processing the transaction

NOT_SUPPORTED
Transaction type not supported

DECLINED_DO_NOT_CONTACT
Transaction declined - do not contact issuer

ABORTED
Transaction aborted by payer

BLOCKED
Transaction blocked due to Risk or 3D Secure blocking rules

CANCELLED
Transaction cancelled by payer

DEFERRED_TRANSACTION_RECEIVED
Deferred transaction received and awaiting processing

REFERRED
Transaction declined - refer to issuer

AUTHENTICATION_FAILED
3DS authentication failed

INVALID_CSC
Invalid card security code

LOCK_FAILURE
Order locked - another transaction is in progress for this order

NOT_ENROLLED_3D_SECURE
Card holder is not enrolled in 3D Secure

EXCEEDED_RETRY_LIMIT
Transaction retry limit exceeded

DECLINED_AVS
Transaction declined due to address verification

DECLINED_CSC
Transaction declined due to card security code

DECLINED_AVS_CSC
Transaction declined due to address verification and card security code

DECLINED_PAYMENT_PLAN
Transaction declined due to payment plan

UNKNOWN
Response unknown

CARD_NOT_ENROLLED
The card is not enrolled for 3DS authentication

AUTHENTICATION_NOT_AVAILABLE
Authentication is not currently available

AUTHENTICATION_ATTEMPTED
Authentication was attempted but the card issuer did not perform the authentication

CARD_DOES_NOT_SUPPORT_3DS
The card does not support 3DS authentication

This is a non-exhaustive list and would keep getting updated as we update the error list.