# API 6.0 Error Codes Learn how to handle APIv6 error codes. ## Error handling for API 6.0 Learn how to tackle the common errors that may arise when using the **placeOrder** call via 2Checkout API. ## Error codes for Order Object ### Item: Product
Error codes for Product | Error code | Description | | ------------------------------------------------------------ | ---------------------------------------------------------------------------------- | | ORDER\_PRODUCTS\_EMPTY | No products have been provided. | | ORDER\_PRODUCT\_RENEWAL\_SUBSCRIPTION\_REFERENCE\_EMPTY | Subscription reference cannot be empty. | | ORDER\_PRODUCT\_RENEWAL\_SUBSCRIPTION\_REFERENCE\_INVALID | Subscription reference is invalid. | | ORDER\_PRODUCT\_RENEWAL\_SUBSCRIPTION\_REFERENCE\_NOT\_FOUND | Subscription reference is invalid. | | ORDER\_PRODUCT\_RENEWAL\_PERIOD\_INVALID | The renewal period is invalid. | | ORDER\_PRODUCTS\_RENEWAL\_NOT\_ALLOWED | Renewal is not allowed with multiple products. | | ORDER\_PRODUCT\_CODE\_INVALID | Invalid product code. | | PRODUCT\_ERROR | Invalid product id. | | ORDER\_PRODUCT\_CODE\_INVALID | Requested product \[%s] was not found. | | ORDER\_PRODUCT\_PRICE\_STRUCTURE\_INVALID | The price structure is not valid. | | ORDER\_PRODUCT\_PRICE\_AMOUNT\_INVALID | The price amount is not valid. | | ORDER\_PRODUCT\_PRICE\_TYPE\_INVALID | The price type is not valid | | ORDER\_PRODUCT\_PRICE\_TYPE\_BASE\_INVALID | The price amount does not need to be set on the base price flow. | | ORDER\_PRODUCT\_PRICE\_TYPE\_DEFAULT\_INVALID | The price amount does not need to be set on the default price flow. | | ORDER\_PRODUCT\_PRICE\_TYPE\_CUSTOM\_INVALID | The price amount is mandatory to be set on the custom price flow. | | ORDER\_PRODUCT\_INVALID | Internal product validation error. | | ORDER\_PRODUCT\_NAME\_INVALID | Name is mandatory when you set `IsDynamic` to TRUE. | | ORDER\_ITEMS\_INVALID | Invalid items. You cannot mix dynamic and catalog products. | | ORDER\_PRODUCT\_IS\_DYNAMIC\_INVALID | Invalid `IsDynamic` value. Use: TRUE or FALSE. | | ORDER\_PRODUCT\_PURCHASE\_TYPE\_INVALID | Invalid product purchase type. Accepted values: PRODUCT, SHIPPING, COUPON and TAX. | | ORDER\_PRODUCT\_TANGIBLE\_INVALID | Invalid `Tangible` value. Use: TRUE or FALSE. | | ORDER\_ITEMS\_QUANTITY\_INVALID | Item quantity must be between 1 and 99999. |
### Item: Trial
Error codes for Trial | Error code | Description | | -------------------------- | ------------------------------------------------- | | INVALID\_PRODUCT | Invalid product ID. | | PRODUCT\_ALREADY\_IN\_CART | Product already in cart. | | INVALID\_TRIAL\_PERIOD | The trial period needs to be greater than 0 days. | | INVALID\_TRIAL\_PRODUCT | Invalid trial product. |
### Item: Cross-sell
Error codes for Cross-sell | Error code | Description | | ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | INVALID\_CROSS\_SELL\_PRODUCT | Invalid cross-sell product ID/Invalid cross-sell parent product code/Invalid cross-sell parent product ID/Invalid cross-sell products for a specified campaign. | | PRODUCT\_ALREADY\_IN\_CART | Product already in cart. | | PRODUCT\_NOT\_IN\_CART | The cross-sell master product is not already in the cart. | | INVALID\_CROSS\_SELL\_CAMPAIGN | Invalid cross-sell campaign. | | ORDER\_ITEMS\_CROSS\_SELL\_PARENT\_DISABLED | Parent product form cross-sell campaign is disabled. | | ORDER\_ITEMS\_CROSS\_SELL\_CHILD\_DISABLED | Child product form cross-sell campaign is disabled. | | ITEM\_CROSS\_SELL\_INVALID | CrossSell field is invalid. | | ITEM\_CROSS\_SELL\_PARENT\_CODE\_INVALID | CrossSell parent code is invalid. | | ITEM\_CROSS\_SELL\_CAMPAIGN\_CODE\_INVALID | CrossSell campaign code is invalid. | | ITEM\_CROSS\_SELL\_AUTOADDED\_INVALID | CrossSell `AutoAdded` field is invalid. |
### Item: Price\_options
Error codes for Price_options | Error code | Description | | -------------------------------------------------------- | -------------------------------------------- | | INVALID\_OPTIONS | Your pricing has error: %s. | | ORDER\_ITEMS\_PRICE\_OPTIONS\_NAME\_EMPTY | Item price options name is empty. | | ORDER\_ITEMS\_PRICE\_OPTIONS\_OPTION\_NAME\_EMPTY | Item price options option name is empty. | | ORDER\_ITEMS\_PRICE\_OPTIONS\_OPTION\_VALUE\_EMPTY | Item price options option value is empty. | | ORDER\_ITEMS\_PRICE\_OPTIONS\_NAME\_INVALID | Invalid item price options name. | | ORDER\_ITEMS\_PRICE\_OPTIONS\_INVALID | Invalid item price options. | | ORDER\_ITEMS\_PRICE\_OPTIONS\_OPTION\_NAME\_INVALID | Invalid item price options option name. | | ORDER\_ITEMS\_PRICE\_OPTIONS\_OPTION\_VALUE\_INVALID | Invalid item price options option value. | | ORDER\_ITEMS\_PRICE\_OPTIONS\_OPTION\_SURCHARGE\_INVALID | Invalid item price options option surcharge. |
### Item: Price
Error codes for Price | Error code | Description | | ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | | PRICE\_ERROR | The price needs to be a decimal value. | | PRODUCT\_ERROR | You need to add the product to the order before setting the price./Invalid product id. | | CURRENCY\_ERROR | No currency is set for the current session. | | ORDER\_ITEMS\_RECURRING\_OPTIONS\_CYCLE\_UNIT\_INVALID | Invalid item recurring option cycle unit. Accepted values: DAY, WEEK, MONTH, YEAR. | | ORDER\_ITEMS\_RECURRING\_OPTIONS\_CYCLE\_LENGTH\_INVALID | Invalid item recurring option cycle length. Use integers. | | ORDER\_ITEMS\_RECURRING\_OPTIONS\_CONTRACT\_UNIT\_INVALID | Invalid item recurring option contract unit. Accepted values: DAY, WEEK, MONTH, YEAR, FOREVER. | | ORDER\_ITEMS\_RECURRING\_OPTIONS\_CONTRACT\_LENGTH\_INVALID | Invalid item recurring option contract length. Use integers. | | ORDER\_ITEMS\_RECURRING\_OPTIONS\_CYCLE\_AMOUNT\_INVALID | Item recurring option cycle amount must be zero or a positive value (INT or FLOAT). | | ORDER\_PRODUCT\_PRICE\_AMOUNT\_TYPE\_INVALID | The price amount type is not valid. |
### Item: Refund
Error codes for Refund | Error code | Description | | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | ORDER\_REFUND\_ORDER\_REF\_MISSING | `ORDER_REF` missing or format incorrect. | | ORDER\_REFUND\_ORDER\_AMOUNT\_MISSING | `ORDER_AMOUNT` missing or format incorrect. | | ERROR\_CANCELLING\_ORDER | Error canceling order. | | ORDER\_ALREADY\_CANCELED | Order already canceled. | | UNKNOWN\_ERROR | Unknown error. | | ORDER\_REFUND\_INVALID\_ORDER\_REF | Invalid `ORDER_REF`. | | ORDER\_REFUND\_INVALID\_ORDER\_AMOUNT | Invalid `ORDER_AMOUNT`. | | ORDER\_REFUND\_LINE\_ITEM\_REFERENCE\_MISSING | `ORDER_REFUND_LINE_ITEM_REFERENCE` missing or format incorrect. | | ORDER\_REFUND\_PRODUCTS\_QTY\_MISSING | `PRODUCTS_QTY` missing or format incorrect. | | ORDER\_REFUND\_INVALID\_PRODUCTS\_QTY | Invalid `PRODUCTS_QTY`. | | ORDER\_REFUND\_AMOUNT\_MISSING | `AMOUNT` missing or format incorrect. | | ORDER\_REFUND\_AMOUNT\_INVALID | Invalid `AMOUNT`. | | ORDER\_REFUND\_ALREADY\_PLACED\_TOTAL\_REFUND | You have already placed a Total refund for this order. | | ORDER\_REFUND\_ALREADY\_PLACED | You have already placed a refund for this order. | | ORDER\_REFUND\_ALREADY\_HAVE\_PENDING\_REFUND\_REQUEST | You already have a pending refund request. | | ORDER\_REFUND\_AMOUNT\_EXCEEDED\_MAXIMUM\_REFUNDABLE\_AMOUNT | The maximum refundable amount for this order has been exceeded. | | ORDER\_REFUND\_FAILED\_DUE\_TO\_ORDER\_CURRENT\_STATUS | You cannot place a refund request due to the order's current status. | | ORDER\_REFUND\_FAILED\_DUE\_TO\_PAYMENT\_DETAILS | You cannot place a refund request due to the order's payment details. | | ORDER\_REFUND\_FAILED\_DUE\_TO\_PERIOD\_TO\_REQUEST\_REFUND\_HAS\_EXPIRED | The allowed period to request a new refund for this order has expired. | | ORDER\_REFUND\_MULTIPLE\_NOT\_SUPPORTED\_BY\_PAYMENT\_TYPE | Multiple refunds are not supported by this order's payment type. | | ORDER\_REFUND\_NOT\_SUPPORTED\_FOR\_CROSS\_VENDOR\_SALE | Refunding not supported for this Cross Vendor Sale order. | | ORDER\_REFUND\_TOTAL\_NEGATIVE | Order total is negative. | | ORDER\_REFUND\_AMOUNT\_NEGATIVE | Order amount is negative. | | ORDER\_REFUND\_ITEM\_AMOUNT\_NEGATIVE | Order item amount is negative. | | ORDER\_REFUND\_FAILED\_DUE\_TO\_ORDER\_APPROVAL\_STATUS | You cannot place a refund request due to the order's approval status. | | ORDER\_REFUND\_MULTIPLE\_REFUNDS\_NOT\_SUPPORTED | Multiple refunds are not supported by this order's terminal. | | ORDER\_REFUND\_PARTIAL\_REVERSE\_NOT\_SUPPORTED | Partial reverse is not supported. | | ORDER\_REFUND\_INVALID\_PRODUCT\_TYPE | Invalid product type. Refunds are available only for the following product types: REGULAR / BUNDLE / MEDIA / DOWNLOAD\_INSURANCE / SHIPPING, but not for DISCOUNT. | | ORDER\_REFUND\_FAILED\_DUE\_TO\_OPEN\_CHARGEBACK\_DISPUTE | You cannot request a refund because a chargeback dispute was open for the order. | | ORDER\_REFUND\_INVALID\_REASON | Invalid `REFUND_REASON`. | | ORDER\_REFUND\_LINE\_ITEM\_REFERENCES\_NOT\_FOUND | `ORDER_REFUND_LINE_ITEM_REFERENCES` is incorrect or not part of Order. | | ORDER\_REFUND\_FEATURE\_MISSING | You are not allowed to request refund. |
### Item: Mark\_Shipped
Error codes for Mark_Shipped | Error code | Description | | ---------------------------------------------- | ------------------------------------------------------------------------------ | | ORDER\_MARK\_SHIPPED\_ALREADY\_MARKED\_SHIPPED | Sale already marked shipped. | | ORDER\_MARK\_SHIPPED\_NOT\_SHIPPABLE | Item not shippable. | | ORDER\_MARK\_SHIPPED\_STATUS\_INVALID | Order Status is not Payment Authorized. | | ORDER\_MARK\_SHIPPED\_AUTH\_EXPIRED | Payment authorization has expired. Reauthorize payment before marking shipped. | | ORDER\_MARK\_SHIPPED\_TOO\_SOON | Please wait 24 hours before trying to reauthorize again. | | ORDER\_MARK\_SHIPPED\_REAUTH\_FAILED | Failed to reauthorize payment. | | ORDER\_MARK\_SHIPPED\_INTERNAL\_ERROR\_REAUTH | Failed to mark shipped but reauthorization succeeded. | | ORDER\_MARK\_SHIPPED\_INTERNAL\_ERROR | Failed to mark shipped. |
### Item: Shipping\_Price
Error codes for Shipping_Price | Error code | Description | | ----------------------------------- | --------------------------------------------------------------------------------------------------- | | COUPON\_CODES\_INVALID | The coupon codes format is invalid. | | BILLING\_DETAILS\_COUNTRY\_INVALID | The billing country code is invalid. | | DELIVERY\_DETAILS\_COUNTRY\_INVALID | The delivery country code is invalid. | | PARAMETERS\_INVALID | The country code \[%s] does not have a currency that is in your account's transactional currencies. | | ITEMS\_INVALID | The shipping price can only be calculated for physical products. |
### Item: Billing\_Details
Error codes for Billing_Details | Error code | Description | | ------------------------------------------------------- | --------------------------------------------------------------- | | ORDER\_BILLING\_DETAILS\_COUNTRY\_DYNAMIC\_NOT\_ALLOWED | Functionality not available for your account. | | ORDER\_BILLING\_DETAILS\_EMPTY | Billing details can not be used for delivery as they are empty. | | ORDER\_BILLING\_EMAIL\_EMPTY | Email cannot be empty. | | ORDER\_BILLING\_EMAIL\_EMAIL\_INVALID | Email is not valid. | | ORDER\_BILLING\_FIRST\_NAME\_EMPTY | The First Name cannot be empty. | | ORDER\_BILLING\_LAST\_NAME\_EMPTY | The Last Name cannot be empty. | | ORDER\_BILLING\_ADDRESS1\_EMPTY | The Address 1 cannot be empty. | | ORDER\_BILLING\_CITY\_EMPTY | The City cannot be empty. | | ORDER\_BILLING\_ZIP\_EMPTY | The Zip cannot be empty. | | ORDER\_BILLING\_STATE\_EMPTY | The State cannot be empty. | | ORDER\_BILLING\_DETAILS\_COUNTRY\_EMPTY | The Country cannot be empty. | | ORDER\_BILLING\_DETAILS\_COUNTRY\_INVALID | The Country is not supported by the vendor. | | ORDER\_BILLING\_DETAILS\_STATE\_EMPTY | The State cannot be empty. | | ORDER\_BILLING\_DETAILS\_STATE\_INVALID | The State is not valid. | | ORDER\_BILLING\_DETAILS\_PHONE\_EMPTY | The Phone cannot be empty. | | ORDER\_BILLING\_DETAILS\_CPF\_CNPJ\_EMPTY | The CPF/CPNJ cannot be empty. | | ORDER\_BILLING\_DETAILS\_CPF\_CNPJ\_INVALID | The CPF/CNPJ is invalid. | | ORDER\_BILLING\_DETAILS\_COMPANY\_EMPTY | The Company cannot be empty. | | ORDER\_BILLING\_DETAILS\_GSTIN\_EMPTY | The GSTIN number cannot be empty. | | ORDER\_BILLING\_DETAILS\_GSTIN\_INVALID | The GSTIN number is invalid. | | ORDER\_BILLING\_DETAILS\_FISCAL\_CODE\_EMPTY | The Fiscal Code cannot be empty. | | ORDER\_BILLING\_DETAILS\_TAX\_OFFICE\_EMPTY | The Tax office cannot be empty. | | ORDER\_BILLING\_DETAILS\_TAX\_OFFICE\_INVALID | The Tax office is not valid. | | ORDER\_BILLING\_DETAILS\_FISCAL\_CODE\_INVALID | The Fiscal Code is not valid. | | ORDER\_BILLING\_DETAILS\_INVALID | No billing details have been provided. | | ORDER\_BILLING\_DETAILS\_EMAIL\_EMPTY | The billing email cannot be empty. | | ORDER\_BILLING\_DETAILS\_PHONE\_INVALID | The Phone is invalid (10/11 digits expected). | | ORDER\_BILLING\_DETAILS\_TAX\_OFFICE\_INVALID | TaxOffice length exceeds 50 characters. |
### Item: Delivery
Error codes for Delivery | Error code | Description | | ------------------------------------------ | ----------------------------------------------------- | | ORDER\_DELIVERY\_EMAIL\_EMPTY | The Email cannot be empty. | | ORDER\_DELIVERY\_EMAIL\_EMAIL\_INVALID | The Email is not valid. | | ORDER\_DELIVERY\_FIRST\_NAME\_EMPTY | The First Name cannot be empty. | | ORDER\_DELIVERY\_LAST\_NAME\_EMPTY | The Last Name cannot be empty. | | ORDER\_DELIVERY\_ADDRESS1\_EMPTY | The Address 1 cannot be empty. | | ORDER\_DELIVERY\_CITY\_EMPTY | The City cannot be empty. | | ORDER\_DELIVERY\_ZIP\_EMPTY | The Zip cannot be empty. | | ORDER\_DELIVERY\_STATE\_EMPTY | The State cannot be empty. | | ORDER\_DELIVERY\_DETAILS\_COUNTRY\_INVALID | The country code is not valid for the current vendor. |
### Item: Payment\_Method
Error codes for Payment_Method | Error code | Description | | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ORDER\_PAYMENT\_METHOD\_EMPTY | No payment method has been provided. | | ORDER\_PAYMENT\_METHOD\_INVALID | The payment method is not supported by your account. | | ORDER\_PAYMENT\_METHOD\_PREVIOUS\_ORDER\_REFNO\_EMPTY | The previous order reference number cannot be empty. | | ORDER\_PAYMENT\_METHOD\_RETRY\_INVALID | This payment method is not supported for retrying this order. | | ORDER\_PAYMENT\_METHOD\_RESTRICTED | The payment method is restricted for product. | | ORDER\_PAYMENT\_METHOD\_COUNTRY\_INVALID | The payment method is not available in the selected country. | | ORDER\_PAYMENT\_METHOD\_CURRENCY\_INVALID | The payment currency is not supported for selected payment method. | | ORDER\_PAYMENT\_METHOD\_NOT\_ALLOWED | Card processing is restricted. Your integration does not meet the requirements for handling sensitive card data. | | ORDER\_PAYMENT\_METHOD\_PREVIOUS\_ORDER\_EMAIL\_INVALID | The billing email is different from the one of the reference order. | | ORDER\_PAYMENT\_METHOD\_CC\_VENDOR\_3DS\_RETURN\_URL\_EMPTY | The `PaymentDetails.PaymentMethod.Vendor3DSReturnURL` can not be empty. | | ORDER\_PAYMENT\_METHOD\_CC\_VENDOR\_3DS\_RETURN\_URL\_INVALID | The `PaymentDetails.PaymentMethod.Vendor3DSReturnURL` is not valid. | | ORDER\_PAYMENT\_METHOD\_CC\_VENDOR\_3DS\_CANCEL\_URL\_EMPTY | The `PaymentDetails.PaymentMethod.Vendor3DSCancelURL` can not be empty. | | ORDER\_PAYMENT\_METHOD\_CC\_VENDOR\_3DS\_CANCEL\_URL\_INVALID | The `PaymentDetails.PaymentMethod.Vendor3DSCancelURL` is not valid. | | ORDER\_PAYMENT\_METHOD\_PAYPAL\_EXPRESS\_PROCESS\_ERROR | An error occurred while trying to place the order. | | ORDER\_PAYMENT\_METHOD\_PAYPAL\_EXPRESS\_INTERNAL\_ERROR | An error from Paypal Express gateway. | | ORDER\_PAYMENT\_METHOD\_DIRECT\_DEBIT\_PROCESS\_ERROR | An error occurred while trying to place the order. | | ORDER\_PAYMENT\_METHOD\_DIRECT\_DEBIT\_INTERNAL\_ERROR | Generic error. | | ORDER\_PAYMENT\_METHOD\_IDEAL\_PROCESS\_ERROR | An error occurred while trying to place the order. | | ORDER\_PAYMENT\_METHOD\_IDEAL\_INTERNAL\_ERROR | Generic error. | | ORDER\_PAYMENT\_METHOD\_WE\_CHAT\_PAY\_PROCESS\_ERROR | An error occurred while trying to place the order. | | ORDER\_PAYMENT\_METHOD\_WE\_CHAT\_PAY\_INTERNAL\_ERROR | Generic error. | | ORDER\_PAYMENT\_METHOD\_DIRECT\_DEBIT\_SWIFT\_EMPTY | The swift code cannot be empty. | | ORDER\_PAYMENT\_METHOD\_DIRECT\_DEBIT\_IBAN\_EMPTY | The IBAN cannot be empty or exceed 28 characters./The FirstName cannot be empty or exceed 30 characters./The LastName cannot be empty or exceed 30 characters. | | ORDER\_PAYMENT\_METHOD\_IDEAL\_BANK\_CODE\_EMPTY | The bank code cannot be empty. | | ORDER\_PAYMENT\_METHOD\_INVALID | The payment method \[%s] is not supported. | | ORDER\_PAYMENT\_METHOD\_ORDER\_REFERENCE\_INVALID | Order reference number is required for \[%s] payment method./Order reference number is invalid for subscription reference \[%s]. | | PAYMENT\_ERROR | You cannot place a trial order using \[%s] payment method. | | PAYMENT\_ERROR | You cannot place a trial order without a payment method. | | ORDER\_PAYMENT\_METHOD\_CARD\_MONTH\_INVALID | The expiration month is invalid. | | ORDER\_PAYMENT\_METHOD\_CARD\_YEAR\_INVALID | The expiration year is invalid. | | ORDER\_PAYMENT\_METHOD\_CARD\_DATE\_INVALID | The card has expired. | | ORDER\_PAYMENT\_METHOD\_CARD\_PROCESS\_ERROR | Couldn't complete the payment validation process: Error processing the credit card transaction. Please contact the issuer bank for more details, or enter another card. | | ORDER\_PAYMENT\_METHOD\_CARD\_PROCESS\_ERROR | Couldn't complete the payment validation process: Error processing the credit card transaction. Insufficient funds. Please charge your card account or enter another card. | | ORDER\_PAYMENT\_METHOD\_CARD\_PROCESS\_ERROR | Couldn't complete the payment validation process: Access denied in payment gateway! The transaction cannot be finalized at this time. Please try to finalize the transaction in a few minutes. | | ORDER\_PAYMENT\_METHOD\_CARD\_PROCESS\_ERROR | Couldn't complete the payment validation process: Error processing the credit card transaction. Please enter another card or try to finalize the transaction in a few minutes. | | ORDER\_PAYMENT\_METHOD\_CARD\_PROCESS\_ERROR | 'Couldn't complete the payment validation process: \
Error processing the credit card transaction. Your credit card was not charged.\
\
Possible cause: \
  • your card is not active for online transactions\
  • you have entered invalid or incomplete credit card details\
  • a temporary error occurred while processing the payment\
    \
    \Recommendations:\
    Please enter another card or try to finalize the transaction in a few minutes. If you still get an error, please contact the issuer bank for more details by calling the number on the back of your card.\    \
    • | | ORDER\_PAYMENT\_METHOD\_CARD\_PROCESS\_ERROR | Couldn't complete the payment validation process: Error processing the credit card transaction. Expired card. Please contact the issuer bank for more details, or enter another card. | | ORDER\_PAYMENT\_METHOD\_CARD\_PROCESS\_ERROR | Couldn't complete the payment validation process: Error processing the credit card transaction. No such card. The transaction can be finalized only after entering a valid credit card. | | ORDER\_PAYMENT\_METHOD\_CARD\_PROCESS\_ERROR | Couldn't complete the payment validation process: Error processing the credit card transaction. You have entered an invalid CVV2 or CVC2. | | ORDER\_CURRENCY\_CODE\_EMPTY | The currency code cannot be empty. | | ORDER\_CURRENCY\_INVALID | The currency \[%s] is not supported by the vendor. | | PAYMENT\_DECRYPTION\_FAILED | Invalid key identifier. | | TEST\_ORDER\_NOT\_ALLOWED | Test orders are not available for your account. | | ORDER\_PAYMENT\_METHOD\_CCID\_INVALID | Invalid CVV2/CVC2 code. | | ORDER\_PAYMENT\_METHOD\_CARD\_HOLDER\_INVALID | Invalid name. | | ORDER\_PAYMENT\_METHOD\_CARD\_NUMBER\_INVALID | Your card type \[%s] does not match the card number \[%s]. | | ORDER\_PAYMENT\_METHOD\_CARD\_CURRENCY\_INVALID | The provided currency \[%s] is not supported with this card type. Supported currencies: \[%s]. | | ORDER\_REF\_MISMATCH | The reference number does not belong to a valid order. | | ORDER\_FRAUD\_ERROR | The reference number identifies an order that is not yet cleared by fraud. | | ORDER\_STATUS\_ERROR | The reference number identifies an order with an incorrect status. | | PAYMENT\_ERROR | The referenced order has an unsupported payment method. | | ORDER\_PAYMENT\_METHOD\_CARD\_INVALID | Forbidden. You've reached the maximum allowed number of orders with the same credit card. | | ORDER\_PAYMENT\_METHOD\_CARD\_INVALID | Invalid card number entered. | | ORDER\_PAYMENT\_METHOD\_CARD\_INVALID | Visa usually has 16 or 13 digits, but you entered 14. | | ORDER\_PAYMENT\_METHOD\_CARD\_INVALID | Unknown error! | | ORDER\_PAYMENT\_METHOD\_CARD\_INVALID | We don't accept %s cards for online processing. | | ORDER\_PAYMENT\_METHOD\_CARD\_INVALID | Card number is missing %s digit(s). | | ORDER\_PAYMENT\_METHOD\_CARD\_INVALID | The month isn't a string. | | ORDER\_PAYMENT\_METHOD\_CARD\_INVALID | Month has invalid format. | | ORDER\_PAYMENT\_METHOD\_CARD\_INVALID | Invalid expiration date entered or the card has expired. | | PAYMENT\_ERROR | AutoApprove feature is not available for your account. | | PAYMENT\_ERROR | Net payment terms has to be a number of days between \[%d] and \[%d]. | | ORDER\_PAYMENT\_METHOD\_DIRECT\_DEBIT\_IBANSWIFT\_INCORRECT | Invalid IBAN: \[%s] or SWIFT CODE: \[%s]. | | ORDER\_PAYMENT\_METHOD\_DIRECT\_DEBIT\_IBAN\_INVALID | Invalid IBAN: \[%s]. | | ORDER\_PAYMENT\_METHOD\_DIRECT\_DEBIT\_SWIFT\_INVALID | Invalid SWIFT code: \[%s]. | | ORDER\_PAYMENT\_METHOD\_PAYPAL\_RETURN\_URL\_EMPTY | The return URL can not be empty. | | ORDER\_PAYMENT\_METHOD\_IDEAL\_RETURN\_URL\_EMPTY | The return URL can not be empty. | | ORDER\_PAYMENT\_METHOD\_WE\_CHAT\_PAY\_RETURN\_URL\_EMPTY | The return URL can not be empty. | | ORDER\_PAYMENT\_METHOD\_EXTERNAL\_RETURN\_URL\_EMPTY | The return URL can not be empty. | | ORDER\_PAYMENT\_METHOD\_PAYPAL\_RETURN\_URL\_INVALID | The return URL is not valid. | | ORDER\_PAYMENT\_METHOD\_IDEAL\_RETURN\_URL\_INVALID | The return URL is not valid. | | ORDER\_PAYMENT\_METHOD\_WE\_CHAT\_RETURN\_URL\_INVALID | The return URL is not valid. | | ORDER\_PAYMENT\_METHOD\_EXTERNAL\_RETURN\_URL\_INVALID | The return URL is not valid. | | ORDER\_PAYMENT\_METHOD\_IDEAL\_BANK\_CODE\_INVALID | Invalid bank code \[%s]. | | INVALID\_PAYMENT\_METHOD | This payment method is not available for your account. | | INVALID\_CC\_TOKEN | Invalid token. | | INVALID\_EES\_TOKEN | The token is not valid. In order to proceed with the place order a valid token is required. | | ORDER\_PAYMENT\_METHOD\_APPLE\_PAY\_TOKEN\_INVALID | Invalid payment data: Invalid token. | | ORDER\_PAYMENT\_METHOD\_INVALID | The payment method \[%s] is not supported. | | PAYMENT\_ERROR | Company name is mandatory for Purchase Order. |
    ### Item: Payment\_Details
    Error codes for Payment_Details | Error code | Description | | -------------------------------- | ----------------------------------------------------------------------------------------------------------- | | ORDER\_PAYMENT\_DETAILS\_INVALID | No payment details have been provided/Free orders without payment details are not enabled for your account. |
    ### Item: Currency
    Error codes for Currency | Error code | Description | | ---------------------------- | -------------------------------------------------- | | ORDER\_CURRENCY\_CODE\_EMPTY | The currency code cannot be empty. | | ORDER\_CURRENCY\_INVALID | The currency \[%s] is not supported by the vendor. |
    ### Item: Language
    Error codes for Language | Error code | Description | | ------------------------ | ----------------------------------------------------------- | | ORDER\_LANGUAGE\_EMPTY | Language code cannot be empty. | | ORDER\_LANGUAGE\_INVALID | Language \[%s] is not supported by current vendor settings. |
    ### Item: Affiliate
    Error codes for Affiliate | Error code | Description | | ------------------------ | ---------------------------------------------- | | AFFILIATE\_CODE\_EMPTY | The `AffiliateCode` parameter cannot be empty. | | AFFILIATE\_CODE\_INVALID | The `AffiliateCode` parameter is invalid. |
    ### Item: ExtraInformation
    Error codes for ExtraInformation | Error code | Description | | ------------------------------------- | --------------------------------------------------------------- | | INVALID\_RETRY\_FAILED\_PAYMENT\_LINK | The retry payment link is not a valid URL. | | INVALID\_RETRY\_FAILED\_PAYMENT\_LINK | The retry payment link has no parameter with placeholder \[%s]. |
    ### Item: Source
    Error codes for Source | Error code | Description | | --------------- | ----------------------------- | | INVALID\_SOURCE | The provided source is empty. |
    ### Item: Gift\_details
    Error codes for Gift_details | Error code | Description | | ---------------------- | ------------------------------------------------------------------------------------------- | | INVALID\_GIFT\_DETAILS | Gift details require that `FirstName`, `LastName`, and `Email` be non-empty. | | INVALID\_GIFT\_EMAIL | The gift email \[%s] is not valid. | | PRODUCT\_ERROR | Cannot mark the order as a gift until there are products added to the cart. | | PRODUCT\_ERROR | Cannot mark the order as a gift because there are products that are not available as gifts. |
    ### Item: Coupon
    Error codes for Coupon | Error code | Description | | ---------------------------- | ------------------------------------- | | ORDER\_COUPON\_CODE\_EMPTY | The coupon code is empty. | | ORDER\_COUPON\_CODE\_INVALID | The provided coupon \[%s] is invalid. |
    ### Item: Promotion
    Error codes for Promotion | Error code | Description | | ---------------------------------------- | --------------------------------------------- | | ORDER\_PRODUCT\_PROMOTION\_CODE\_INVALID | The provided promotion code \[%s] is invalid. |
    ### Item: Additional\_Field
    Error codes for Additional_Field | Error code | Description | | ---------------------------------- | --------------------------------------------------------------------------------------- | | ORDER\_ADDITIONAL\_FIELD\_REQUIRED | The order additional information field \[%s] was not set, and it's marked as mandatory. |
    ### Item: Order\_Product\_Additional\_Fields
    Error codes for Order_Product_Additional_Fields | Error code | Description | | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | | ORDER\_PRODUCT\_ADDITIONAL\_FIELD\_REQUIRED | Add the required product additional information fields \[%s] for products \[%s]. | | ORDER\_PRODUCT\_ADDITIONAL\_FIELD\_REQUIRED | The product additional information field \[%s] was not set for product \[%s], and it\\'s marked as mandatory |
    ### Item: SubscriptionCustomSettings
    Error codes for SubscriptionCustomSettings | Error code | Description | | ------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- | | ORDER\_ITEMS\_SUBSCRIPTION\_CUSTOM\_SETTINGS\_CYCLE\_UNIT\_INVALID | Invalid item subscription custom settings cycle unit. Accepted values: DAY, MONTH. | | ORDER\_ITEMS\_SUBSCRIPTION\_CUSTOM\_SETTINGS\_CYCLE\_LENGTH\_INVALID | Invalid item subscription custom settings cycle length. Use positive integers, or -1 when contract length is NULL. | | ORDER\_ITEMS\_SUBSCRIPTION\_CUSTOM\_SETTINGS\_CONTRACT\_LENGTH\_INVALID | Invalid item subscription custom settings contract length. Use positive integers or NULL. | | ORDER\_ITEMS\_SUBSCRIPTION\_CUSTOM\_SETTINGS\_CONTRACT\_LENGTH\_FORBIDDEN | Forbidden item subscription custom settings contract length. Use a value that is a multiple of the cycle length value. | | ORDER\_ITEMS\_SUBSCRIPTION\_CUSTOM\_SETTINGS\_CYCLE\_AMOUNT\_INVALID | Item subscription custom settings cycle amount must be a positive value (INT or FLOAT). | | ORDER\_ITEMS\_SUBSCRIPTION\_CUSTOM\_SETTINGS\_CYCLE\_AMOUNT\_TYPE\_INVALID | Invalid item subscription custom settings cycle amount type. Accepted values: NET, GROSS. | | ORDER\_ITEMS\_SUBSCRIPTION\_CUSTOM\_SETTINGS\_CLIENT\_DEAL\_AUTO\_RENEWAL\_INVALID | Invalid item subscription custom settings client deal auto-renewal. | | ORDER\_ITEMS\_SUBSCRIPTION\_CUSTOM\_SETTINGS\_MERCHANT\_DEAL\_AUTO\_RENEWAL\_INVALID | Invalid item subscription custom settings merchant deal auto-renewal. |
    ### Other
    Other error codes | Error code | Description | | --------------------------------- | ---------------------------------------------------------------------------------------------- | | ORDER\_PHYSICAL\_FEATURE\_MISSING | You are not allowed to place orders with physical products. | | ORDER\_ERROR | Couldn't process the order/Order reference is invalid. | | GIFT\_ORDER\_NOT\_ALLOWED | Cannot place the order because order is marked as gift and product is not available as a gift. | | TEST\_ORDER\_NOT\_ALLOWED | Test orders are not available for your account. | | ORDER\_CURRENCY\_MISMATCH | Order currency values must match. | | ORDER\_TOTAL\_NEGATIVE | Order total must be zero or a positive value. | | ORDER\_TEST\_MODE\_REQUIRED | Test mode is required on test subscriptions. | | BANNED\_SHOPPER\_IP | The shopper is banned. | | AUTHENTICATION\_ERROR | Authentication needed for this resource. |
    --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.2checkout.com/json-rpc-api-reference/json-rpc-api-6.0/api-6.0-error-codes.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.