Errors

Learn how Digital River handles errors.

Digital River uses HTTP response status codes. These codes indicate whether an API request succeeded or failed. HTTP status codes group responses into the following classes:

  • The 2xx range indicates success.

  • The 4xx range indicates an error that failed based on the provided information provided (for example, you omitted a parameter or a charge failed).

  • The 5xx range indicates an error with Digital River's servers.

You can handle some 4xx errors programmatically to include an error code that briefly explains the error reported (for example, include an error code when you decline a card).

See Error codes for more information.

Error codes

The following table contains a list of API error codes.

Code

Description

account_closed

Stop all billing as this account is closed.

already_exists

The item you tried to create already exists.

amount_too_large

The given amount is too large. Provide a smaller amount and try again.

api_key_expired

The API key has expired.

approved

Approved.

card_expired

The card has expired. Provide valid card information and try again.

card_limit_exceeded

The transaction exceeds the card limit amount.

card_type_block

The merchant has blocked this card type.

card_velocity_exceeded

The transaction exceeds the card velocity amount.

charge_expired

The charge has expired. Provide valid charge information and try again.

charge_not_capturable

The charge could not be captured.

country_restricted

A user provided a restricted country. Make sure that users can only sign up from supported countries.

currency_unsupported

The currency provided is not supported. Provide a supported currency and try again.

declined

The card has been declined for an unknown reason.

do_not_honor

The card issuing bank has declined this payment.

email_invalid

The email address is invalid. Provide a valid email address and try again.

fraud

The transaction has been identified by the issuing bank as fraudulent.

fraud_block

The transaction has been identified by Digital River as fraudulent.

invalid_address

The address does not match the card network's records.

invalid_amount

The amount is not accepted by the card network.

invalid_boolean

The boolean value is invalid. Provide a valid boolean value and try again.

invalid_card_bin

The card bin is invalid.

invalid_card_number

The card number entered is invalid.

invalid_currency

This currency is not supported.

invalid_empty

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

invalid_expiration_date

The card is expired or the expiration date is invalid.

invalid_integer

The integer value is valid. Provide a value integer value and try again.

invalid_metadata_key

The metadata key is invalid. Provide a value metadata key and try again. See Metadata for requirements and try again.

invalid_metadata_value

The value provided for the metadata was invalid. See Metadata for requirements and try again.

invalid_parameter

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

invalid_pin

The PIN provided is invalid or incorrect.

invalid_quantity_amount

The quantity provided in the request was invalid. Check our API Reference to see what is a valid quantity and try again.

invalid_security_code

The security code provided is invalid or incorrect.

invalid_shipping_choice

The shipping choice is invalid. Provide a valid shipping choice and try again.

invalid_string_blank

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

invalid_string_empty

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

invalid_transaction_type

The transaction type is invalid.

issuer_invalid_card

The card does not exist with the issuer.

issuer_not_found

The card issuer does not exist.

issuer_unavailable

The card issuing bank could not be reached.

insufficient_funds

The card has insufficient funds to complete the purchase.

limit_exceeded

The transaction amount exceeds your assigned limit.

lost_stolen_card

The issuing bank has marked this card lost or stolen.

mid_limit_exceeded

The transaction amount exceeds the limit assigned for this MID.

missing_parameter

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

no_response

The payment processor did not respond.

not_found

The item requested was not found.

out_of_inventory

The item is not in inventory.

pin_try_exeeded

The bank's allowable number of PIN tries has been exceeded.

postal_code_invalid

The postal code is invalid. Enter a valid postal code and try again.

restricted_card

restricted by the card network.

sku_inactive

The given SKU is inactive. Provide an active SKU and try again.

source_expired

The source provided has expired. Check Sources to see which sources have not expired and try again.

source_not_chargeable

The source provided is not chargeable. Check Sources to see which sources are chargeable and try again.

stop_recurring

The card holder has requested all recurring and / or installment charges to be stopped.

tax_id_invalid

The tax identifier is not valid. Correct the tax identifier and try again.

too_many_metadata_pairs

The request contained too many metadata pairs. See Metadata for requirements and try again.

unknown_parameter

The request contains an unknown parameter. Check our API Reference to see which values are required and try again.