409 Conflict

Understand the 409 Conflict error codes for the Shopper APIs.

If an operation conflicts with the current state of the target resource, the server may return a 409 Conflict error code. The server usually returns this error code when creating or modifying an already existing resource or when there are conflicts in the request. The purpose of this code is to inform you to review the request and make adjustments to avoid conflict before resubmitting.

[resource]-already-exists

A user tried to create a [resourceName] with an ID [resourceId], and that resource already exists.

account_closed

Stop all billing as this account is closed.

add-base-product-cart-error

The system cannot add base products to the cart. The possible error descriptions are as follows:

• Base products cannot be added to cart.

  The system cannot add base products to the cart.

apply-payment-failure

The system cannot apply a payment method or fails to apply the requested payment method to the cart. The possible error descriptions are as follows:

• The shopper must have an approved line of credit account.

  Apply payment failure due to the shopper having no approved line of credit account.

• The line of credit account is not available.

  The line of credit account is unavailable, causing the shopper an application failure.

• Insufficient credit balance available.

  There is no sufficient credit balance available.

• Purchase amount does not meet minimum requirements.

  The total purchase amount of the requisition is less than the minimum amount set by the site.

• A payment method cannot be detached from an empty cart. The system cannot detach a payment method from an empty cart.

• The source with id [{souce_id}] was not found. The system cannot find the source with the ID {source_id}.

apply-shopper-failure

The system cannot apply the shopper's account information to the cart. The possible error descriptions are as follows:

• Shopper account information could not be applied to cart.

  The system cannot apply the shopper's account information to the cart.

Billing Address country for request is invalid

The country associated with the billing address for the request is invalid.

card_expired

The card is expired.

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.

cart-charge-failure

The system could not process the cart due to a charge failure. The possible error descriptions are as follows:

• Failed to charge source. The system failed to charge the source.

cart-failure

Some cart operation actions failed. The possible error descriptions are as follows:

• Unable to retrieve the cart details due to data inconsistency.

  The system failed to retrieve cart data.

cart-fraud-failure

The system cannot submit the order due to fraud validation failure. The possible error descriptions are as follows:

• The order could not be submitted due to fraud validation failure

  The request could not submit the order due to a fraud validation failure.

cart-payment-failure

The system cannot submit the order due to a payment processing failure. The possible error descriptions are as follows:

• The order could not be submitted due to payment processing failure The request did not submit the order due to payment processing failure.

• The cart could not be processed due to payment processing failure

  The system cannot process the cart due to a payment processing failure.

credit-card-declined

The credit card payment was declined.

credit-card-expired

The credit card used for payment has expired. The possible error descriptions are as follows:

• The credit card used for payment has expired

  The credit card used for payment has expired.

credit-floor-exceeded

The total amount for the order does not exceed the credit card minimum.

concurrent-cart-modification-failure

Concurrent cart modification is not allowed. The possible error descriptions are as follows:

• Request attempted to modify the cart while the cart was being updated by another request.

  Two cart modification requests cannot occur at the same. Wait a little while and try again.

coupon-code-already-used

The shopper previously entered this coupon code. The shopper cannot use this coupon code again.

declined

The card has been declined for an unknown reason.

decline_do_not_retry

The card has been declined for an unknown reason.

delete-payment-failure

The system cannot delete a payment method from a cart. The possible error descriptions are as follows:

• Payment method cannot be deleted from an empty cart. The system cannot delete a payment method from an empty cart.

do_not_honor

The card issuing bank has declined this payment.

EMPTY_LINE_ITEM_ID

The line-item ID is missing. Provide the line item ID and try again.

EMPTY_RETURN_REASON

Provide a reason for the return and try again.

external-reference-ID-conflict

The products use the same external reference ID [erid-1234]: [12345600, 12345700, 12345800]. Either use the actual product identifier in the request or ensure the external reference ID for each product is unique.

• unable-to-determine-product-by-ERID The external reference ID is not unique.

field-too-long

The field [fieldName] is longer than the maximum length [fieldMaxLength] allowed.

fraud

The issuing bank has identified the transaction as fraudulent.

fraud_block

Digital River has identified the transaction as fraudulent.

insufficient_funds

The card has insufficient funds to complete the purchase.

invalid_address

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

invalid_amount

The card network does not accept the amount.

invalid-bill-to-country

The country's billing or shipping address for the request is invalid. The possible error descriptions are as follows:

• Billing Address country for request is invalid

  The country of billing address for the request is invalid.

invalid_card_bin

The card BIN is invalid.

invalid_card_number

The card number entered is invalid.

invalid-coupon

The coupon code is invalid. The shopper cannot use the coupon code.

invalid-credit-card-expiration-date

The credit card expiration date specified for the cart is invalid.

invalid-credit-card-number

The credit card number specified for the cart is invalid. Provide a valid credit card number and try again.

invalid_currency

This currency is not supported.

invalid_expiration_date

The card is expired, or the expiration date is invalid.

invalid-ip-address

The format of the IP address is invalid. The possible error descriptions are as follows:

• Requested ip address is not valid—The format of the IP address is invalid. Provide a valid IP address and try again.

invalid-locale

The requested locale is not valid. Provide a valid locale and try again.

invalid-keyword-expression

Invalid keyword expression: [expression entered]

invalid-offer-id

The offer ID is invalid. Provide a valid offer ID and try again.

invalid-payment-failure

The system cannot process the cart because the payment methods were not set. The possible error descriptions are as follows:

• The cart could not be processed due to no available payment methods set

  The system cannot process the cart because the payment methods are unavailable.

invalid-payment-method

The cart does not support the specified payment method. The possible error descriptions are as follows:

• Payment method is not supported for this Site

  The site does not support the specified payment method.

invalid-payment-source

This error code appears when the provided payment source is invalid or cannot be processed. Ensure the payment source details are correct and try again.

The possible error descriptions are as follows:

• A PaymentSource with Source ID [sourceId] is not valid for creating BillingOption. A payment source with the specified source ID is not valid for creating a billing option.

invalid_pin

The PIN provided is invalid or incorrect.

invalid-postal-code

If you intend to enter a 9-digit postal code, use the following format: #####-####.

invalid-product-id

The product identifier is invalid. Provide the correct product identifier and try again.

invalid-request

Request the missing required product identifier.

invalid_security_code

The security code provided is invalid or incorrect.

invalid-ship-to-country

The shipping address country is restricted for request. The possible error descriptions are as follows:

• Shipping Address country for request is invalid

  The shipping address country for the request is invalid.

invalid-token

The request contains an invalid token.

invalid_transaction_type

The transaction type is invalid.

inventory-status-failure

Inventory is unavailable for one or more of the products in the cart.

inventory-unavailable-error

Inventory is unavailable for the product specified in the request. The possible error descriptions are as follows:

• We're sorry but {product_name} is currently out of stock and cannot be added to your cart. We apologize for any inconvenience.

  The product cannot be added to the cart because it is out of stock.

• Were sorry but there is not enough of this product in stock to complete this order. Please update your quantities and proceed to checkout.

  The inventory quantity is not enough to complete this order.

• We are sorry, some products are out of stock and unavailable for purchase at this time

  Some products are out of stock for a bundled child with a tight bundle policy. The following description appears in the subcode: inventory-unavailable-to-add-tight-bundle-child-line-item

• We're sorry but {product_name} is currently out of stock and cannot be added to your cart. We apologize for any inconvenience.

  Some products are out of stock for a bundled child with a semi-tight bundle policy. The following description appears in the subcode: inventory-unavailable-to-add-semi-tight-bundle-child-line-item.

• We are sorry, but the following products are currently out of stock and cannot be added to your cart: {product_name}. We apologize for any inconvenience.

  Some products are out of stock for a bundled child with a semi-tight bundle policy. The following description appears in the subcode: inventory-unavailable-to-add-semi-tight-bundle-child-line-item

ip-address-restriction-error

The country associated with the IP address for the request is restricted. The possible error descriptions are as follows:

• Country for ip address is restricted for request The country associated with the IP address for the request is restricted.

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.

limit_exceeded

The transaction amount exceeds your assigned limit.

line-item-creation-failure

The system cannot create a line item for the specified product. The possible error descriptions are as follows:

• Line item could not be created.

  The system cannot create the line item.

• Your shopping cart is currently empty.

  The shopping cart cannot be empty when creating a line item.

• This product is no longer available.

  The system could not create a line item because the product was unavailable.

• Line Item could not be created for the product specified.The product with the provided product ID is not in the group associated with the offer.

line-item-update-failure

The system cannot update the line item for the request. The possible error descriptions are as follows:

• Line Item could not be updated for the request

  The system cannot update the line item for the request.

lost_stolen_card

The issuing bank has marked this card as lost or stolen.

mid_limit_exceeded

The transaction amount exceeds the limit assigned for this MID.

no_response

The payment processor did not respond.

offer-already-used

The offer is already in use.

offer-not-active

The offer for the request is not active.

offer-not-applicable

• Always triggered offer is not supported. The system cannot apply the offer ID for the request to the cart.

• The offer ID: {offerId} for the request is invalid. Provide a valid offer ID or Offer external reference ID and try again.

offer-not-deployed

The system cannot use an undeployed coupon code.

offer-unavailable

The offer ID for the request is not available for the cart.

offer-usage-limit-exceeded

Exceeded the offer usage limit. Shoppers cannot use the coupon code.

operation-failed

The system cannot complete the operation. The possible error descriptions are as follows:

• Cart could not be established for request.

  An error caused a cart establishment failure.

• Coupon Code cannot be used due to an undefined reason. The provided coupon code failed, and the reason is unknown. The coupon code could be unknown, invalid, or expired.

• A service failure occurred that prevented the request from being processedAn error occurred during the process of determining the fulfiller.

• TAX_000001—The address verification failed during tax computation, such as ZIP or postal code do not match.

• Line item could not be determined. Multiple line items found for productWhen the system was going to update the line item, it found multiple product line items in the cart.

• Quantity restrictions in place; minimum required quantity is [{minumum quantity}].The product has a minimum purchase quantity, and the requested quantity is less than the minimum quantity.

• Purchase history restrictions in place; allowed quantity is [{maximum quantity}].The requested quantity is greater than the maximum purchasable quantity of the product.

• Exception occurred while checking ShippingMethod by ShippingMethodSetterAn exception occurred while checking the shipping method.

over-private-store-shopper-restriction

The system cannot add the product to the cart. The shopper requested more than the maximum purchasable quantity [x], or the remaining purchasable quantity [y] is less than the quantity they requested. The possible error descriptions are as follows:

• Maximum purchasable quantity[{maximum quantity}]; Remaining purchasable quantity[{remaining purchasable quantity}]; The product cannot be added to the cart. The sum of this request quantity and the quantity already purchased in the cart is over the maximum purchasable quantity when the product in a private store has a maximum purchasable quantity and the purchase history restriction setting is proper.

payment-post-auth-failure

The system could not submit the order due to payment processing failure.

payment-unexpected-error

The system cannot process the cart because an unexpected payment error occurred. The possible error descriptions are as follows:

• The request failed to complete. The system could not complete the request because of an unexpected payment failure.

paypal-failure

The system cannot process the cart because PayPal returned a failure or declined status.

paypal-lookup-failure

Due to a PayPal lookup processing failure, the system cannot process the cart. The possible error descriptions are as follows:

• The cart could not be processed due to paypal lookup processing failure Due to a PayPal lookup processing failure, the system cannot process the cart.

pin_try_exceeded

You exceeded the maximum number of allowed PIN attempts at the bank.

precondition-failure

The request failed on some precondition validations. The possible error descriptions are as follows:

• Invalid offer level for applied offer with offer ID: {offerId}. Provide a valid offer level and try again. The offer level for the applied offer with offerId is invalid.

• Invalid offer type for applied offer with offer ID: {offerId}. Provide a valid offer type and try again. The offer type for the applied offer with offerId is invalid.

• Applied the wrong offer ID: {offerId} with the offer. Enter the correct offer ID and try again. The trigger point for the applied offer with offerId is invalid.

• Applied the wrong offer ID: {offerId} for this site. Enter the correct offer ID and try again. The offer with offerId is unavailable.

• The applied offer with offer ID: {offerId} is unavailable. Ensure the active offer is within the total usage limit and that the supported locale matches the user's locale and try again. The applied offer with the provided offerId is unavailable.

private-store-remaining-quantity-under-line-item-restriction

The system cannot add the product to the cart. The shopper requested more than the remaining quantity [x] or less than the minimum. The issuer requires voice authorizationquantity [y].

rate-limit-quota-exceeded

You have exceeded the allowable number of API requests, resulting in an error due to exceeding the rate limit quota.

resource-already-exists

This error appears when a user attempts to create a resource that already exists. It prevents duplicate entries and maintains data integrity. The possible error descriptions are as follows:

• A Payment Option with a nickname of [nickname] already exists. A Payment Option with a nickname already exists.

• A PaymentSource with a Source ID [sourceId] already exists. A PaymentSource with a Source ID already exists.

restricted-bill-to-country

The billing address country for the request is restricted. The possible error descriptions are as follows:

• Billing Address country is restricted for requestThe billing address country for the request is restricted.

restricted_card

The card network has restricted the use of this card.

restricted-ship-to-country

The country associated with the shipping address is restricted. The possible error descriptions are as follows:

• Shipping Address country is restricted for request The country associated with the shipping address is restricted. Provide a shipping address for a supported country and try again.

resume-cart-failure

The system cannot resume the cart. The possible error descriptions are as follows:

• Requisition is not present or not in Source Pending Redirect state. The requisition state is incorrect (not source_pending_redirect).

• The pending redirect order could not be resumed. The payment session status is incorrect (failed, cancelled, pending_redirect, requires_source).

• The pending redirect order is no longer eligible for Resume API. Please use Order API to check current status. The order was transferred back to ODS.

shipping-option-failure

Shipping option cannot be applied to cart. The shipping option failed when applied to the cart. Provide a valid shipping option and try again.

shopper-usage-limit-exceeded

The shopper exceeded the offer usage limit. The shopper cannot use the coupon code.

stop_recurring

The cardholder has asked for all recurring or installment charges to be cancelled.

submit-cart-failed

The cart is incomplete, so the shopper could not submit the cart. The possible error descriptions are as follows:

• Session cannot be null.

  The session is null, causing the submit cart to fail.

• A requisition cannot be null.

  The requisition is null, causing the submit cart to fail.

• Terms of Sales Acceptance must be true so shopper confirmed the agreement.The Terms of Sales Acceptance is false, causing the submit cart to fail.

• Cannot use non-recurring payment method to purchase commitment type subscriptionThe requisition contains a subscription commit line item, and the payment source does not exist or is not reusable.

• The cart is not complete and could not be submitted.The cart is not complete, causing the submit cart to fail.

• The cart cannot be completed due to payment processing failure.The system cannot complete the cart due to a payment processing failure.

under-private-store-line-item-restriction

The product in the private store has a minimum purchasable quantity, and the amount requested is less than the minimum purchasable quantity.

• Minimum purchasable quantity[x]; Cannot add the product to the cart.

valid-currency-code

The requested currency is not supported.

validation-error

• invalid-offer-state The request to deploy the offer ID [offerId] failed because the subscription is in the PendingActivation state.

vat-exemption-failure

This site does not have Rest of World tax exemption enabled. Enable Global Tax ID Management in Global Commerce and try again.

• Tax Exemption Rest of World tax exemption is not enabled for this site.

voice_authorization_required

The issuer requires voice authorization.