{"_id":"59a45d447ee621000fc9d3d8","category":{"_id":"59a45d447ee621000fc9d3c3","version":"59a45d437ee621000fc9d3b7","project":"57336fd5a6a9c40e00e13a0b","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-15T16:21:09.840Z","from_sync":false,"order":11,"slug":"errors","title":"Errors"},"user":"560d5913af97231900938124","project":"57336fd5a6a9c40e00e13a0b","parentDoc":null,"version":{"_id":"59a45d437ee621000fc9d3b7","project":"57336fd5a6a9c40e00e13a0b","__v":1,"createdAt":"2017-08-28T18:13:23.840Z","releaseDate":"2017-08-28T18:13:23.840Z","categories":["59a45d447ee621000fc9d3b8","59a45d447ee621000fc9d3b9","59a45d447ee621000fc9d3ba","59a45d447ee621000fc9d3bb","59a45d447ee621000fc9d3bc","59a45d447ee621000fc9d3bd","59a45d447ee621000fc9d3be","59a45d447ee621000fc9d3bf","59a45d447ee621000fc9d3c0","59a45d447ee621000fc9d3c1","59a45d447ee621000fc9d3c2","59a45d447ee621000fc9d3c3","59a45d447ee621000fc9d3c4","59a45d447ee621000fc9d3c5","59a45d447ee621000fc9d3c6","59a45d447ee621000fc9d3c7"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"3.22.1","version_clean":"8976.0.0-XML","version":"8976-XML"},"__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-02-26T17:07:55.782Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":39,"body":"The following errors can be returned in response to a Card Transaction request.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Code\",\n    \"h-1\": \"Name\",\n    \"h-2\": \"Description\",\n    \"11-0\": \"14001\",\n    \"12-0\": \"14002\",\n    \"13-0\": \"14002\",\n    \"14-0\": \"14002\",\n    \"15-0\": \"14002\",\n    \"16-0\": \"14002\",\n    \"18-0\": \"14002\",\n    \"19-0\": \"14002\",\n    \"20-0\": \"14002\",\n    \"21-0\": \"14002\",\n    \"22-0\": \"14002\",\n    \"23-0\": \"14002\",\n    \"24-0\": \"14002\",\n    \"25-0\": \"14002\",\n    \"26-0\": \"14002\",\n    \"3-0\": \"10000\",\n    \"10-0\": \"11001\",\n    \"3-2\": \"The API version passed in the request is invalid.\",\n    \"3-1\": \"INVALID_API_VERSION\",\n    \"10-1\": \"XSS_EXCEPTION\",\n    \"10-2\": \"User input suspected as malicious.\",\n    \"38-0\": \"20002\",\n    \"46-0\": \"20010\",\n    \"38-1\": \"MULTIPLE_TRANSACTIONS_FOUND\",\n    \"38-2\": \"Transaction retrieval service failure. Multiple transactions found with merchant transaction ID: ${merchantTransactionId}.\",\n    \"46-1\": \"TRANSACTION_ALREADY_CAPTURED\",\n    \"46-2\": \"Transaction was already captured.\",\n    \"11-1\": \"THREE_D_SECURITY_AUTHENTICATION_REQUIRED\",\n    \"11-2\": \"3D security authentication is required.\",\n    \"12-1\": \"CALL_ISSUER\",\n    \"12-2\": \"Payment processing failure due to an unspecified error. Please contact the issuing bank.\",\n    \"13-1\": \"CARD_LOST_OR_STOLEN\",\n    \"13-2\": \"The card is lost or stolen.\\nRetry the transaction using a different card or decline the transaction.\",\n    \"14-1\": \"CVV_ERROR\",\n    \"14-2\": \"Payment processing failure due to CVV error.\\nCorrect the CVV code and retry the transaction.\",\n    \"15-1\": \"DO_NOT_HONOR\",\n    \"15-2\": \"Payment processing failure due to issuing bank decline. Try another payment method or wait 24 hours before trying again.\",\n    \"16-1\": \"EXPIRED_CARD\",\n    \"16-2\": \"Payment processing failure due to expired card. \\nCorrect the expiration date and retry. If the transaction still fails, retry with a different payment method or decline the transaction.\",\n    \"18-1\": \"HIGH_RISK_ERROR\",\n    \"18-2\": \"Payment processing failure due to high risk.\",\n    \"19-1\": \"INCORRECT_INFORMATION\",\n    \"19-2\": \"Payment processing failure due to incorrect information.\\n\\n*Description will contain additional information about the specific error.*\",\n    \"20-1\": \"INSUFFICIENT_FUNDS\",\n    \"20-2\": \"Payment processing failure due to insufficient funds.\\nRetry the transaction at a later date, use a new payment method, or decline the transaction.\",\n    \"21-1\": \"INVALID_CARD_NUMBER\",\n    \"21-2\": \"Payment processing failure due to invalid card number.\\nCorrect the card number and retry the transaction.  If the transaction still fails, try a new payment method or decline the transaction.\",\n    \"22-1\": \"INVALID_CARD_TYPE\",\n    \"22-2\": \"Payment processing failure due to invalid card type.\\nCorrect the card number and retry the transaction.  If the transaction still fails, try a new payment method or decline the transaction.\",\n    \"23-1\": \"INVALID_PIN_OR_PW_OR_ID_ERROR\",\n    \"23-2\": \"Payment processing failure due to invalid PIN, password or ID error.\",\n    \"24-1\": \"LIMIT_EXCEEDED\",\n    \"24-2\": \"Payment processing failure because card limit has exceeded.\\nRetry the transaction later, use a new payment method, or decline the transaction.\",\n    \"25-1\": \"PICKUP_CARD\",\n    \"25-2\": \"Payment processing failure. The card has been reported lost or stolen and should be removed from use.\",\n    \"26-1\": \"PROCESSING_AMOUNT_ERROR\",\n    \"26-2\": \"Payment processing failure due to invalid amount for this transaction.\\nValidate the amount submitted is correct and resubmit.  If the transaction still fails decline the transaction\",\n    \"27-1\": \"PROCESSING_DUPLICATE\",\n    \"27-2\": \"Payment processing failure due to duplication. The transaction is a duplicate of a previously submitted transaction.\",\n    \"28-1\": \"PROCESSING_GENERAL_DECLINE\",\n    \"28-2\": \"Payment processing failure due to an unspecified error returned. Retry the transaction and if problem continues contact the issuing bank, or decline the transaction.\",\n    \"29-1\": \"PROCESSING_TIMEOUT\",\n    \"29-2\": \"Payment processing failure due to timeout.\\nRetry the transaction.\",\n    \"33-1\": \"RESTRICTED_CARD\",\n    \"33-2\": \"Payment processing failure due to restricted card.\",\n    \"27-0\": \"14002\",\n    \"28-0\": \"14002\",\n    \"29-0\": \"14002\",\n    \"33-0\": \"14002\",\n    \"30-1\": \"SYSTEM_TECHNICAL_ERROR\",\n    \"30-2\": \"Payment processing failure due to system technical error.\\nRetry the transaction.\",\n    \"30-0\": \"14002\",\n    \"31-0\": \"14002\",\n    \"31-1\": \"THE_ISSUER_IS_UNAVAILABLE_OR_OFFLINE\",\n    \"31-2\": \"Payment processing failure because the issuer is unavailable or offline.\\nRetry the transaction.\",\n    \"40-0\": \"20004\",\n    \"41-0\": \"20005\",\n    \"42-0\": \"20006\",\n    \"43-0\": \"20007\",\n    \"44-0\": \"20008\",\n    \"45-0\": \"20009\",\n    \"40-1\": \"TRANSACTION_PAYMENT_METHOD_NOT_SUPPORTED\",\n    \"40-2\": \"Payment method is not supported.\\nRetry the transaction with another payment method or decline the transaction.\",\n    \"41-1\": \"TRANSACTION_NOT_AUTHORIZED\",\n    \"41-2\": \"Transaction is not authorized.\",\n    \"42-1\": \"TRANSACTION_ALREADY_EXISTS\",\n    \"42-2\": \"Transaction AUTH_REVERSAL FAILED. Transaction already exists.\",\n    \"43-1\": \"TRANSACTION_EXPIRED\",\n    \"43-2\": \"Transaction is expired.\",\n    \"44-1\": \"TRANSACTION_ID_REQUIRED\",\n    \"44-2\": \"Transaction ID is required.\\nAdd the transaction ID and retry the transaction.\",\n    \"45-1\": \"INVALID_TRANSACTION_ID\",\n    \"45-2\": \"Transaction ID is invalid.\\nCorrect the transaction ID and retry the transaction.\",\n    \"35-0\": \"15008\",\n    \"35-1\": \"SHOPPER_NOT_FOUND\",\n    \"35-2\": \"The Shopper ID passed in the request was not found.\\nValidate the shopper id is correct and resubmit.\",\n    \"36-0\": \"15012\",\n    \"36-1\": \"SHOPPER_COUNTRY_OFAC_SANCTIONED\",\n    \"36-2\": \"One of the shopper's countries was defined as OFAC sanctioned.\\nDo not resubmit.\",\n    \"37-0\": \"16003\",\n    \"37-1\": \"MULTIPLE_PAYMENT_METHODS_NON_SELECTED\",\n    \"37-2\": \"Shopper has multiple payment methods, but none is selected.\\nCorrect the payment method and resubmit.\",\n    \"39-0\": \"20003\",\n    \"39-1\": \"TRANSACTION_LOCKED\",\n    \"39-2\": \"Transaction ${transactionType} failed. Transaction locked.\",\n    \"17-0\": \"14002\",\n    \"17-1\": \"GENERAL_PAYMENT_PROCESSING_ERROR\",\n    \"17-2\": \"Payment processing failure due to an unspecified error. Description will contain the error code and message sent by the processor if applicable.\",\n    \"47-0\": \"-\",\n    \"48-0\": \"-\",\n    \"49-0\": \"-\",\n    \"47-1\": \"CREDIT_CARD_DETAILS_PLAIN_AND_ENCRYPTED\",\n    \"47-2\": \"Shopper credit card cannot contain both plain and encrypted details.\\nCorrect the shopper details and resubmit.\",\n    \"48-1\": \"CREDIT_CARD_ENCRYPTED_NUMBER_REQUIRED\",\n    \"48-2\": \"Encrypted Field 'Encrypted Card Number' is required.\\nAdd the encrypted card number and resubmit.\",\n    \"49-1\": \"CREDIT_CARD_ENCRYPTED_SECURITY_CODE_REQUIRED\",\n    \"49-2\": \"Encrypted Field 'Encrypted Security Code' is required.\\nAdd the encrypted security code and resubmit.\",\n    \"0-0\": \"7\",\n    \"0-1\": \"INVALID_TRANSACTION_TYPE\",\n    \"0-2\": \"Transaction type is invalid.\\nNote: HTTP status is 403 Forbidden\",\n    \"4-1\": \"PAYMENT_GENERAL_FAILURE\",\n    \"4-0\": \"10000\",\n    \"4-2\": \"A general payment failure has occurred.\",\n    \"5-0\": \"10001\",\n    \"5-1\": \"VALIDATION_GENERAL_FAILURE\",\n    \"5-2\": \"The resource passed in the request has violated validation rules. Additional information about the specific issue is provided in the error description.\",\n    \"32-0\": \"14002\",\n    \"32-1\": \"THREE_D_SECURE_FAILURE\",\n    \"32-2\": \"Payment processing failure due to 3D secure failure.\",\n    \"34-0\": \"14016\",\n    \"34-1\": \"NO_AVAILABLE_PROCESSORS\",\n    \"34-2\": \"There are no available processors for the specific request.\",\n    \"6-1\": \"INVALID_MERCHANT_TRANSACTION_ID\",\n    \"7-1\": \"INVALID_RECURRING_TRANSACTION\",\n    \"8-1\": \"MERCHANT_CONFIGURATION_ERROR\",\n    \"9-1\": \"MISSING_CARD_TYPE\",\n    \"6-0\": \"10001\",\n    \"7-0\": \"10001\",\n    \"8-0\": \"10001\",\n    \"9-0\": \"10001\",\n    \"1-0\": \"30\",\n    \"1-2\": \"No card holder or vaulted shopper id\",\n    \"1-1\": \"MISSING_SHOPPER_OR_CARD_HOLDER\",\n    \"2-0\": \"85\",\n    \"2-1\": \"INVALID_HTTP_METHOD\",\n    \"2-2\": \"CAPTURE transactions should be sent using an HTTP PUT method\",\n    \"6-2\": \"Merchant-transaction-id should be up to 50 characters\",\n    \"7-2\": \"recurring-transaction element is missing or invalid\",\n    \"8-2\": \"Merchant Configuration Error\",\n    \"9-2\": \"card-type element is required\"\n  },\n  \"cols\": 3,\n  \"rows\": 50\n}\n[/block]","excerpt":"","slug":"card-transaction-errors","type":"basic","title":"Card Transaction Errors"}

Payment API (XML)

Card Transactions

PayPal Transactions

ACH/ECP Transactions

SEPA Direct Debit Transactions

Batch Transactions

Refunds

Vaulted Shoppers

Subscriptions

Marketplace

Wallets

Errors

Resources

Test Data & Codes

Guides & Tools

Mobile SDK

Card Transaction Errors

The following errors can be returned in response to a Card Transaction request.

Code
Name
Description

7

INVALID_TRANSACTION_TYPE

Transaction type is invalid.
Note: HTTP status is 403 Forbidden

30

MISSING_SHOPPER_OR_CARD_HOLDER

No card holder or vaulted shopper id

85

INVALID_HTTP_METHOD

CAPTURE transactions should be sent using an HTTP PUT method

10000

INVALID_API_VERSION

The API version passed in the request is invalid.

10000

PAYMENT_GENERAL_FAILURE

A general payment failure has occurred.

10001

VALIDATION_GENERAL_FAILURE

The resource passed in the request has violated validation rules. Additional information about the specific issue is provided in the error description.

10001

INVALID_MERCHANT_TRANSACTION_ID

Merchant-transaction-id should be up to 50 characters

10001

INVALID_RECURRING_TRANSACTION

recurring-transaction element is missing or invalid

10001

MERCHANT_CONFIGURATION_ERROR

Merchant Configuration Error

10001

MISSING_CARD_TYPE

card-type element is required

11001

XSS_EXCEPTION

User input suspected as malicious.

14001

THREE_D_SECURITY_AUTHENTICATION_REQUIRED

3D security authentication is required.

14002

CALL_ISSUER

Payment processing failure due to an unspecified error. Please contact the issuing bank.

14002

CARD_LOST_OR_STOLEN

The card is lost or stolen.
Retry the transaction using a different card or decline the transaction.

14002

CVV_ERROR

Payment processing failure due to CVV error.
Correct the CVV code and retry the transaction.

14002

DO_NOT_HONOR

Payment processing failure due to issuing bank decline. Try another payment method or wait 24 hours before trying again.

14002

EXPIRED_CARD

Payment processing failure due to expired card.
Correct the expiration date and retry. If the transaction still fails, retry with a different payment method or decline the transaction.

14002

GENERAL_PAYMENT_PROCESSING_ERROR

Payment processing failure due to an unspecified error. Description will contain the error code and message sent by the processor if applicable.

14002

HIGH_RISK_ERROR

Payment processing failure due to high risk.

14002

INCORRECT_INFORMATION

Payment processing failure due to incorrect information.

Description will contain additional information about the specific error.

14002

INSUFFICIENT_FUNDS

Payment processing failure due to insufficient funds.
Retry the transaction at a later date, use a new payment method, or decline the transaction.

14002

INVALID_CARD_NUMBER

Payment processing failure due to invalid card number.
Correct the card number and retry the transaction. If the transaction still fails, try a new payment method or decline the transaction.

14002

INVALID_CARD_TYPE

Payment processing failure due to invalid card type.
Correct the card number and retry the transaction. If the transaction still fails, try a new payment method or decline the transaction.

14002

INVALID_PIN_OR_PW_OR_ID_ERROR

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

14002

LIMIT_EXCEEDED

Payment processing failure because card limit has exceeded.
Retry the transaction later, use a new payment method, or decline the transaction.

14002

PICKUP_CARD

Payment processing failure. The card has been reported lost or stolen and should be removed from use.

14002

PROCESSING_AMOUNT_ERROR

Payment processing failure due to invalid amount for this transaction.
Validate the amount submitted is correct and resubmit. If the transaction still fails decline the transaction

14002

PROCESSING_DUPLICATE

Payment processing failure due to duplication. The transaction is a duplicate of a previously submitted transaction.

14002

PROCESSING_GENERAL_DECLINE

Payment processing failure due to an unspecified error returned. Retry the transaction and if problem continues contact the issuing bank, or decline the transaction.

14002

PROCESSING_TIMEOUT

Payment processing failure due to timeout.
Retry the transaction.

14002

SYSTEM_TECHNICAL_ERROR

Payment processing failure due to system technical error.
Retry the transaction.

14002

THE_ISSUER_IS_UNAVAILABLE_OR_OFFLINE

Payment processing failure because the issuer is unavailable or offline.
Retry the transaction.

14002

THREE_D_SECURE_FAILURE

Payment processing failure due to 3D secure failure.

14002

RESTRICTED_CARD

Payment processing failure due to restricted card.

14016

NO_AVAILABLE_PROCESSORS

There are no available processors for the specific request.

15008

SHOPPER_NOT_FOUND

The Shopper ID passed in the request was not found.
Validate the shopper id is correct and resubmit.

15012

SHOPPER_COUNTRY_OFAC_SANCTIONED

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

16003

MULTIPLE_PAYMENT_METHODS_NON_SELECTED

Shopper has multiple payment methods, but none is selected.
Correct the payment method and resubmit.

20002

MULTIPLE_TRANSACTIONS_FOUND

Transaction retrieval service failure. Multiple transactions found with merchant transaction ID: ${merchantTransactionId}.

20003

TRANSACTION_LOCKED

Transaction ${transactionType} failed. Transaction locked.

20004

TRANSACTION_PAYMENT_METHOD_NOT_SUPPORTED

Payment method is not supported.
Retry the transaction with another payment method or decline the transaction.

20005

TRANSACTION_NOT_AUTHORIZED

Transaction is not authorized.

20006

TRANSACTION_ALREADY_EXISTS

Transaction AUTH_REVERSAL FAILED. Transaction already exists.

20007

TRANSACTION_EXPIRED

Transaction is expired.

20008

TRANSACTION_ID_REQUIRED

Transaction ID is required.
Add the transaction ID and retry the transaction.

20009

INVALID_TRANSACTION_ID

Transaction ID is invalid.
Correct the transaction ID and retry the transaction.

20010

TRANSACTION_ALREADY_CAPTURED

Transaction was already captured.

-

CREDIT_CARD_DETAILS_PLAIN_AND_ENCRYPTED

Shopper credit card cannot contain both plain and encrypted details.
Correct the shopper details and resubmit.

-

CREDIT_CARD_ENCRYPTED_NUMBER_REQUIRED

Encrypted Field 'Encrypted Card Number' is required.
Add the encrypted card number and resubmit.

-

CREDIT_CARD_ENCRYPTED_SECURITY_CODE_REQUIRED

Encrypted Field 'Encrypted Security Code' is required.
Add the encrypted security code and resubmit.