This page describes the possible error codes you may encounter with your transactions. Some of these error messages are only returned if for specific integrations.
Error message are not always available
Please note some special errors do not contain any detailed error message. Whenever available, we return a human-readable error message.
DECLINED
Probably the most common error of all, your transaction was declined. This can have various reasons. Please refer to the error message for more details.
SOFT_DECLINED
3DS 2.0 requires this transaction to do a 3D Secure authentication to complete the authorization. Please note that this error will only be returned if you are processing transactions with 3DS 2.
UNKNOWN_ERROR
An unknown error occurred. This should not be returned. If you encounter such an error, please contact us and provide the transactionId
of that transaction.
UNAUTHORIZED
Your merchantId
is not authorized to access this API endpoint.
INVALID_TRANSACTION_STATUS
The performed action cannot be done for this specific transactionId
. For example, if you try to settle an already settled transaction.
TRANSACTION_NOT_FOUND
The transactionId
you are trying to process cannot be found. Either it is inexistent or it belongs to a different merchantId
.
INVALID_JSON_PAYLOAD
The syntax of your JSON payload is wrong.
UNRECOGNIZED_PROPERTY
JSON payload contains an unrecognized property.
INVALID_PROPERTY
A property with the JSON payload has a wrong format.
CLIENT_ERROR
We return this error when there is no specific error code available related to your request. For example when using GET
instead of POST
.
SERVER_ERROR
We return this error when there was an error on our side.
EXPIRED_CARD
The card is expired.
INVALID_CARD
The card number is invalid.
BLOCKED_CARD
The card is blocked.
UNSUPPORTED_CARD
Your merchantId
does not support this card brand.
INVALID_ALIAS
The token is invalid.
INVALID_CVV
The card security code is invalid.
DUPLICATE_REFNO
You are trying to use a refno
that was used previously. Please try again with a unique refno
.
BLOCKED_BY_VELOCITY_CHECKER
We return this error if at least 20 wrong tokens were used in the past 15 minutes.
INVALID_SETUP
Your merchantId
seems to have a setup issue. Please contact us for more details.
INVALID_SIGN
The sign value is wrong. This error message is part of our Legacy APIs and is no longer returned in newer integrations.
Updated 2 months ago