Error types, codes, and objects

Learn about error types, codes, and objects.

Change event error object

When a DigitalRiver.js detects an error with an element, it returns an error object with the change event. This object will contain a type, code, and message.

Change Event Error object
Change Event Error object
{
"type": "validation_error",
"code": "invalid_card_number",
"message": "Your card number is invalid."
}

Create source error object

DigitalRiver.js returns this error object within the createSource method if an error occurs with the tokenization request. This object will contain a type and an array of messages that will explain the error in detail.

Create Source Error object
Create Source Error object
{
"type": "bad_request",
"errors": [{
"code": "invalid_parameter",
"parameter": "owner.firstName",
"message": "'' is not a valid owner.firstname."
},
{
"code": "currency_unsupported",
"parameter": "currency",
"message": "currency 'xyz' is not supported."
}]
}

Error codes

The following table contains a list of DigitalRiver.js error codes.

You can find the complete list of error types and error codes in the Digital River API reference.

It's important that you only indicate that the payment has been declined and do not share the code or descriptions listed below with the customer.

Code

Description

address_mismatch

There is a problem with your address.

invalid_expiration_date

The card is expired or the expiration date is invalid.

invalid_format

The format of your request is invalid.

invalid_parameter

The parameter is invalid. Check the Digital River API Reference to see which values are valid and try again.

invalid_string_empty

The string value is empty. Provide a valid string value and try again.

method_not_allowed

The string value is empty. Provide a valid string value and try again.

missing_parameter

A parameter is missing. Check the Digital River API Reference to see which values are required and try again.

not_found

The item requested was not found.

source_not_found

The source you have requested was not found.

unknown_error

An unknown error has occurred