Status Code Error Messages

Status Code
Error Code
Description
Where Used
400 Bad Request
invalid-request
Invalid page size. Must be positive, non-zero, and less than 100000.
GET categories
GET category
GET category products
The payment method type for the request was invalid.
POST payment method
validation-failure
The request could not be validated for one of the following reasons:
  • The site does not accept the return.
  • The order is not in a returnable state
  • The return window expired for the specified product.
  • The requested return quantity is greater than the eligible quantity for the line item.
  • The specified line item cannot be returned through the self-service Returns API.

401 Unauthorized
invalid_token
The request contains an invalid token. The token is no longer valid and must be refreshed to continue making API calls. See 401 Error for more information.
GET account
403 Forbidden
forbidden
The request could not be completed, as the call is not permitted.

404 Not Found
resource-not-found
Could not find a [resourceName] resource with an internal ID [resourceId].

405 Method Not Allowed
method-not-allowed
OAuth API—Request used incorrect HTTP method.
Shopper API—The method is not allowed.

409 Conflict
[resource}-already-exists
Tried to create a [resourceName] with an ID [resourceId] and that resource already exists.

apply-payment-failure
A payment method cannot be applied to an empty cart pr the requested payment method failed to apply to the cart.
POST payment method
apply-shopper-failure The shopper account information could not be applied to cart.
POST apply shopper
cart-fraud-failure The order could not be submitted due to fraud validation failure.
POST submit cart
cart-payment-failure The order could not be submitted due to payment processing failure.
POST apply shopper
POST submit cart
credit-card-declined The credit card payment was declined. POST payment method
POST submit cart
credit-floor-exceeded Total amount for the order does not exceed the credit card minimum.
POST submit cart
credit-card-expired The credit card used for payment has expired. POST submit cart
coupon-code-aldready-used The shopper previously entered this coupon code. The coupon code cannot be used.
POST cart
field-too-long
The field [filedName] is longer than the maximum length [fieldMaxLength] allowed.

invalid-bill-to-country The country's billing or shipping address for the request is invalid.
POST billing address
POST shipping address
PUT billing address
PUT shipping address
invalid-coupon The coupon code is invalid. The coupon code cannot be used.
POST cart
invalid-credit-card-expiration-date The credit card expiration date specified for the cart is invalid. POST submit cart
invalid-credit-card-number The credit card number specified for the cart is invalid. POST payment method
POST submit cart
invalid-currency-code Requested currency is not supported.
POST me
POST shopper (client maintains login credetials)
POST shopper (Digital River maintains login credetials)
invalid-keyword-expression Invalid keyword expression: [expression entered]
GET product
GET products
GET product variations
invalid-locale Requested locale is not valid.
POST me
POST shopper (client maintains login credetials)
POST shopper (Digital River maintains login credetials)
invalid-offer-id The offer ID for the request is invalid DELETE line item
DELETE line items
GET line item
GET line items
invalid-payment-failure The cart could not be processed due to no available payment methods set.
POST apply shopper
invalid-payment-method The specified payment method is not suppored for the cart. POST payment method
invalid-request Request missing required product identifier.
POST line item
POST line items
invalid-token Request contains an invalid token.
GET token
POST me
inventory-unavailable-error Inventory unavailable for the product specified in the request.
DELETE line item
DELETE line items
GET line item
GET line items
POST cart
POST line item
POST line items
ip-address-restriction-error Country for IP address is restricted for request.
GET cart
GET me
POST cart
POST line item
POST line items
POST me
POST shopper (client maintains login credetials)
POST shopper (Digital River maintains login credetials)
inventory-status-failure Inventory unavailable for one or more of the products in the cart.
POST submit cart
line-item-creation-failure Line Item could not be created for the specified product. POST cart
POST line items
line-item-update-failure Line Item could not be updated for the request.
DELETE line item
DELETE line items
GET line item
GET line items
POST cart
POST line item
POST line items
offer-already-used The offer has already been used.
POST cart
offer-not-active The offer for the request is not active.
POST cart
offer-not-applicable
The offer ID for request cannot be applied to the cart.
DELETE line item
DELETE line items
GET line item
GET line items
POST cart
POST line items
offer-not-deployed Offer is not deployed. Coupon code cannot be used
POST cart
offer-unavailable The offer ID for the request is not available for the cart.
DELETE line item
DELETE line items
GET line item
GET line items
POST cart
POST line items
offer-usage-limit-exceeded Offer usage limit exceeded. The coupon code cannot be used.
POST cart
operation-failed
The operation could not be completed.

payment-post-auth-failure The order could not be submitted due to payment processing failure.
POST submit cart
paypal-failure The cart could not be processed due to payPal returned a failure or declined status.
POST apply shopper
paypal-lookup-failure The cart could not be processed due to paypal lookup processing failure.
POST apply shopper
rate-limit-quota-exceeded
Exceeded the quota for the allowed number of API requests
POST billing address
restricted-bill-to-country The country's billing or shipping address for the request is restricted.
POST apply shopper
POST shipping address
PUT billing address
PUT shipping address
shopper-usage-limit-exceeded The shopper exceeded the offer usage limit. The coupon code cannot be used.
POST cart
submit-cart-failed The cart is not complete and could not be submitted.
POST submit cart
wish-list-already-exists A wish list with that name already exists.
POST wish lists (create)
POST wish lists (update)
wish-list-failure The wish list request could not be processed. The wish list is currently unavailable.
POST wish lists (create)
POST wish lists (update)
wish-list-limit-exceeded Exceeded the wish list line item limit. The wish list contains the maximum number of line items
POST wish lists (create)
POST wish lists (update)
wish-lists-unavailable Wish lists are not enabled for the site.
POST wish lists (create)
POST wish lists (update)
500 Internal Server Error
system-error
An unexpected system error occurred.
GET account