Error types, codes, and objects

Learn about error types, codes, and objects.

Change event error object

When DigitalRiver.js detects a problem with an element, its change event returns an error that contains a type, code, and message.

Change Event Error object

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

Create source error object

If a problem occurs during the tokenization request, the createSource method and on source event return an error with a type and an array of errors[], each of which contains a detailed message.

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 must only indicate that the payment has been declined and do not share the code or descriptions 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 method is not allowed. Provide a valid method 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