{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","settings":"","results":{"codes":[]},"params":[]},"next":{"description":"","pages":[]},"title":"Shopper Errors","type":"basic","slug":"shopper-errors","excerpt":"","body":"The following errors can be returned in response to requests related to shoppers, including [Create Order and New Shopper](doc:create-shopper-and-order), [Create Shopper](doc:create-shopper), [Update Shopper](doc:update-shopper), [Retrieve Shopper](doc:retrieve-vaulted-shopper), and [Delete Shopper](doc:delete-shopper).\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Name\",\n    \"h-1\": \"Description\",\n    \"h-2\": \"Code\",\n    \"17-0\": \"INVALID_VAT_ID\",\n    \"17-1\": \"The VAT ID passed in the request is invalid.\",\n    \"17-2\": \"-\",\n    \"0-0\": \"CLIENT_ENCRYPTION_BAD_INPUT\",\n    \"0-1\": \"Credit card details decryption failed due to invalid input.\",\n    \"0-2\": \"19000\",\n    \"1-2\": \"19000\",\n    \"2-2\": \"19000\",\n    \"1-0\": \"CLIENT_ENCRYPTION_BAD_PUBLIC_KEY\",\n    \"1-1\": \"Credit card details decryption failed due to invalid public key.\",\n    \"2-1\": \"Credit card details decryption failed.\",\n    \"2-0\": \"CLIENT_ENCRYPTION_GENERAL_FAILURE\",\n    \"3-0\": \"CREDIT_CARD_DETAILS_PLAIN_AND_ENCRYPTED\",\n    \"3-1\": \"Shopper credit card cannot contain both plain and encrypted details.\",\n    \"4-0\": \"CREDIT_CARD_ENCRYPTED_NUMBER_REQUIRED\",\n    \"4-1\": \"Credit card encrypted number is required.\",\n    \"5-0\": \"CREDIT_CARD_ENCRYPTED_SECURITY_CODE_REQUIRED\",\n    \"5-1\": \"Credit card encrypted security code is required.\",\n    \"3-2\": \"-\",\n    \"4-2\": \"-\",\n    \"5-2\": \"-\",\n    \"6-0\": \"CURRENCY_CODE_NOT_FOUND\",\n    \"6-1\": \"The Currency Code passed in the request was not found.\\nor\",\n    \"6-2\": \"13001\",\n    \"7-0\": \"CVV_ERROR\",\n    \"7-1\": \"Payment processing failure due to CVV error.\",\n    \"7-2\": \"14002\",\n    \"9-0\": \"HIGH_RISK_ERROR\",\n    \"9-1\": \"Payment processing failure due to high risk.\",\n    \"9-2\": \"14002\",\n    \"10-0\": \"INCORRECT_INFORMATION\",\n    \"10-1\": \"Payment processing failure due to incorrect information.\",\n    \"10-2\": \"14002\",\n    \"11-0\": \"INVALID_CARD_NUMBER\",\n    \"12-0\": \"INVALID_CARD_TYPE\",\n    \"11-1\": \"Payment processing failure due to invalid card number.\",\n    \"11-2\": \"14002\",\n    \"12-2\": \"14002\",\n    \"12-1\": \"Payment processing failure due to invalid card type.\",\n    \"13-0\": \"INVALID_IP_ADDRESS\",\n    \"13-1\": \"The IP address passed in the request is invalid.\",\n    \"13-2\": \"15001\",\n    \"14-0\": \"INVALID_NUM_OF_SHOPPER_PAYMENT_METHODS\",\n    \"14-1\": \"The number of shopper payment methods is invalid.\",\n    \"14-2\": \"1000\",\n    \"15-0\": \"INVALID_PIN_OR_PW_OR_ID_ERROR\",\n    \"15-1\": \"Payment processing failure due to invalid PIN or password or ID error.\",\n    \"15-2\": \"14002\",\n    \"16-0\": \"INVALID_SHOPPER_ID\",\n    \"16-1\": \"The Shopper ID passed in the request is invalid.\",\n    \"16-2\": \"-\",\n    \"21-0\": \"SHOPPER_ID_MISMATCH\",\n    \"21-1\": \"Shopper ID mismatch.\",\n    \"21-2\": \"-\",\n    \"22-0\": \"SHOPPER_ID_REQUIRED\",\n    \"22-1\": \"Shopper ID is required.\",\n    \"22-2\": \"16001 or empty\",\n    \"23-0\": \"SHOPPER_IP_REQUIRED\",\n    \"23-1\": \"Shopper IP address is required.\",\n    \"23-2\": \"10001\",\n    \"24-0\": \"SHOPPER_NOT_FOUND\",\n    \"24-2\": \"15008\",\n    \"24-1\": \"The Shopper ID passed in the request was not found.\",\n    \"26-0\": \"SYSTEM_TECHNICAL_ERROR\",\n    \"26-2\": \"14002\",\n    \"26-1\": \"Payment processing failure due to system technical error.\",\n    \"27-0\": \"THE_ISSUER_IS_UNAVAILABLE_OR_OFFLINE\",\n    \"27-2\": \"14002\",\n    \"27-1\": \"Payment processing failure because the issuer is unavailable or offline.\",\n    \"28-0\": \"TOO_MANY_PAYMENT_METHODS_SELECTED\",\n    \"28-1\": \"Only one selected payment method is allowed for shopper.\",\n    \"28-2\": \"16002\",\n    \"29-0\": \"UNKNOWN_COUNTRY_CODE\",\n    \"30-0\": \"UNKNOWN_COUNTRY_FOR_IP_ADDRESS\",\n    \"31-0\": \"UNKNOWN_CURRENCY\",\n    \"32-0\": \"UNKNOWN_STATE_CODE\",\n    \"33-0\": \"UNKNOWN_STATE_FOR_IP_ADDRESS\",\n    \"29-1\": \"Unknown country code.\",\n    \"29-2\": \"-\",\n    \"30-1\": \"Country cannot be resolved according to IP address.\",\n    \"30-2\": \"15001\",\n    \"31-1\": \"Currency can not be resolved. Missing currency or country or IP.\",\n    \"31-2\": \"-\",\n    \"32-1\": \"Unknown state code.\",\n    \"32-2\": \"-\",\n    \"33-1\": \"State cannot be resolved according to IP address.\",\n    \"33-2\": \"15001\",\n    \"18-0\": \"SELLER_SHOPPER_ALREADY_EXISTS\",\n    \"19-0\": \"SHOPPER_COUNTRY_OFAC_SANCTIONED\",\n    \"18-1\": \"Internal merchant shopper ID already exists.\",\n    \"18-2\": \"15004\",\n    \"19-1\": \"One of the shopper's countries was defined as OFAC sanctioned.\",\n    \"19-2\": \"15012\",\n    \"20-0\": \"SHOPPER_HAS_MULTIPLE_CREDIT_CARDS\",\n    \"20-1\": \"Shopper has multiple credit cards.\",\n    \"20-2\": \"-\",\n    \"25-0\": \"SHOPPER_USERNAME_ALREADY_EXISTS\",\n    \"25-1\": \"Shopper user name already exists.\",\n    \"25-2\": \"15010\",\n    \"34-1\": \"Produced by one of the following errors:\\n* The payment method you are trying to delete is associated to at least 1 active subscription.\\n* The payment method you are trying to delete is associated with at least 1 payment that is pending approval.\",\n    \"34-2\": \"10001\",\n    \"34-0\": \"VALIDATION_GENERAL_FAILURE\",\n    \"8-1\": \"Produced by one of the following errors:\\n* Shopper has made purchases in the past 12 months\\n* Shopper has pending SEPA or ECP payment that has not yet been approved/rejected\\n* Shopper has active subscriptions. Active subscriptions must be canceled before attempting to delete.\",\n    \"8-0\": \"DELETE_SHOPPER_VALIDATION_FAILURE\",\n    \"8-2\": \"14110\"\n  },\n  \"cols\": 3,\n  \"rows\": 35\n}\n[/block]","updates":[],"order":6,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"6040037678d626005641a143","project":"57336fd5a6a9c40e00e13a0b","version":{"version":"8976-Extended","version_clean":"8976.0.0-Extended","codename":"3.37 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["6040037678d626005641a084","6040037678d626005641a085","6040037678d626005641a086","6040037678d626005641a087","6040037678d626005641a088","6040037678d626005641a089","6040037678d626005641a08a","6040037678d626005641a08b","6040037678d626005641a08c","6040037678d626005641a08d","6040037678d626005641a08e"],"_id":"6040037678d626005641a154","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"5c742637ad58c70033b9c762","createdAt":"2018-04-24T15:33:45.744Z","releaseDate":"2018-04-24T15:33:45.744Z"},"category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Errors","slug":"errors","order":7,"from_sync":false,"reference":false,"_id":"6040037678d626005641a08b","version":"6040037678d626005641a154","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2015-10-15T16:21:09.840Z","__v":0},"user":"5beb1b96bc2003003ecd645e","createdAt":"2018-12-19T16:12:39.512Z","__v":0,"parentDoc":null}

The following errors can be returned in response to requests related to shoppers, including Create Order and New Shopper, Create Shopper, Update Shopper, Retrieve Shopper, and Delete Shopper.

Name
Description
Code

CLIENT_ENCRYPTION_BAD_INPUT

Credit card details decryption failed due to invalid input.

19000

CLIENT_ENCRYPTION_BAD_PUBLIC_KEY

Credit card details decryption failed due to invalid public key.

19000

CLIENT_ENCRYPTION_GENERAL_FAILURE

Credit card details decryption failed.

19000

CREDIT_CARD_DETAILS_PLAIN_AND_ENCRYPTED

Shopper credit card cannot contain both plain and encrypted details.

-

CREDIT_CARD_ENCRYPTED_NUMBER_REQUIRED

Credit card encrypted number is required.

-

CREDIT_CARD_ENCRYPTED_SECURITY_CODE_REQUIRED

Credit card encrypted security code is required.

-

CURRENCY_CODE_NOT_FOUND

The Currency Code passed in the request was not found.
or

13001

CVV_ERROR

Payment processing failure due to CVV error.

14002

DELETE_SHOPPER_VALIDATION_FAILURE

Produced by one of the following errors:

  • Shopper has made purchases in the past 12 months
  • Shopper has pending SEPA or ECP payment that has not yet been approved/rejected
  • Shopper has active subscriptions. Active subscriptions must be canceled before attempting to delete.

14110

HIGH_RISK_ERROR

Payment processing failure due to high risk.

14002

INCORRECT_INFORMATION

Payment processing failure due to incorrect information.

14002

INVALID_CARD_NUMBER

Payment processing failure due to invalid card number.

14002

INVALID_CARD_TYPE

Payment processing failure due to invalid card type.

14002

INVALID_IP_ADDRESS

The IP address passed in the request is invalid.

15001

INVALID_NUM_OF_SHOPPER_PAYMENT_METHODS

The number of shopper payment methods is invalid.

1000

INVALID_PIN_OR_PW_OR_ID_ERROR

Payment processing failure due to invalid PIN or password or ID error.

14002

INVALID_SHOPPER_ID

The Shopper ID passed in the request is invalid.

-

INVALID_VAT_ID

The VAT ID passed in the request is invalid.

-

SELLER_SHOPPER_ALREADY_EXISTS

Internal merchant shopper ID already exists.

15004

SHOPPER_COUNTRY_OFAC_SANCTIONED

One of the shopper's countries was defined as OFAC sanctioned.

15012

SHOPPER_HAS_MULTIPLE_CREDIT_CARDS

Shopper has multiple credit cards.

-

SHOPPER_ID_MISMATCH

Shopper ID mismatch.

-

SHOPPER_ID_REQUIRED

Shopper ID is required.

16001 or empty

SHOPPER_IP_REQUIRED

Shopper IP address is required.

10001

SHOPPER_NOT_FOUND

The Shopper ID passed in the request was not found.

15008

SHOPPER_USERNAME_ALREADY_EXISTS

Shopper user name already exists.

15010

SYSTEM_TECHNICAL_ERROR

Payment processing failure due to system technical error.

14002

THE_ISSUER_IS_UNAVAILABLE_OR_OFFLINE

Payment processing failure because the issuer is unavailable or offline.

14002

TOO_MANY_PAYMENT_METHODS_SELECTED

Only one selected payment method is allowed for shopper.

16002

UNKNOWN_COUNTRY_CODE

Unknown country code.

-

UNKNOWN_COUNTRY_FOR_IP_ADDRESS

Country cannot be resolved according to IP address.

15001

UNKNOWN_CURRENCY

Currency can not be resolved. Missing currency or country or IP.

-

UNKNOWN_STATE_CODE

Unknown state code.

-

UNKNOWN_STATE_FOR_IP_ADDRESS

State cannot be resolved according to IP address.

15001

VALIDATION_GENERAL_FAILURE

Produced by one of the following errors:

  • The payment method you are trying to delete is associated to at least 1 active subscription.
  • The payment method you are trying to delete is associated with at least 1 payment that is pending approval.

10001