The developer.datatrans.com Developer Hub

Welcome to the developer.datatrans.com developer hub. You'll find comprehensive guides and documentation to help you start working with developer.datatrans.com as quickly as possible, as well as support if you get stuck. Let's jump right in!

Error Messages

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 not always available

Please note some special errors do not contain any detailed error message. Whenever available, we return a human-readable error message.

Error code
Explanation

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 about a month ago

Error Messages


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.