{"_id":"59df6a523b756800107b2039","category":{"_id":"59df6a523b756800107b202a","version":"59df6a523b756800107b201e","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":"59df6a523b756800107b201e","project":"57336fd5a6a9c40e00e13a0b","__v":1,"createdAt":"2017-10-12T13:12:50.128Z","releaseDate":"2017-10-12T13:12:50.128Z","categories":["59df6a523b756800107b201f","59df6a523b756800107b2020","59df6a523b756800107b2021","59df6a523b756800107b2022","59df6a523b756800107b2023","59df6a523b756800107b2024","59df6a523b756800107b2025","59df6a523b756800107b2026","59df6a523b756800107b2027","59df6a523b756800107b2028","59df6a523b756800107b2029","59df6a523b756800107b202a","59df6a523b756800107b202b","59df6a523b756800107b202c","59df6a523b756800107b202d","59df6a523b756800107b202e"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"3.23 Release","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":2,"body":"The following errors can be returned in response to a Card Transaction request. For details on how to address the error, refer to the Action column. \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.\",\n    \"14-1\": \"CVV_ERROR\",\n    \"14-2\": \"Payment processing failure due to CVV error.\",\n    \"15-1\": \"DO_NOT_HONOR\",\n    \"15-2\": \"Payment processing failure due to issuing bank decline.\",\n    \"16-1\": \"EXPIRED_CARD\",\n    \"16-2\": \"Payment processing failure due to expired card.\",\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.\",\n    \"21-1\": \"INVALID_CARD_NUMBER\",\n    \"21-2\": \"Payment processing failure due to invalid card number.\",\n    \"22-1\": \"INVALID_CARD_TYPE\",\n    \"22-2\": \"Payment processing failure due to invalid card type.\",\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.\",\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.\",\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.\",\n    \"29-1\": \"PROCESSING_TIMEOUT\",\n    \"29-2\": \"Payment processing failure due to timeout.\",\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.\",\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.\",\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.\",\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.\",\n    \"45-1\": \"INVALID_TRANSACTION_ID\",\n    \"45-2\": \"Transaction ID is invalid.\",\n    \"35-0\": \"15008\",\n    \"35-1\": \"SHOPPER_NOT_FOUND\",\n    \"35-2\": \"The Shopper ID passed in the request was not found.\",\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.\",\n    \"37-0\": \"16003\",\n    \"37-1\": \"MULTIPLE_PAYMENT_METHODS_NON_SELECTED\",\n    \"37-2\": \"Shopper has multiple payment methods, but none is selected.\",\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.\",\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    \"h-3\": \"Action\",\n    \"0-3\": \"Retry after validating request. If issue persists, contact BlueSnap Support.\",\n    \"1-3\": \"Retry with card holder info or vaulted shopper ID.\",\n    \"2-3\": \"Retry with HTTP PUT method.\",\n    \"3-3\": \"Retry with correct API version.\",\n    \"4-3\": \"Retry. If issue persists, contact BlueSnap Support.\",\n    \"5-3\": \"Retry with correct resource.\",\n    \"6-3\": \"Retry with correct merchant transaction ID.\",\n    \"7-3\": \"Retry with recurring transaction element.\",\n    \"8-3\": \"Contact BlueSnap Support.\",\n    \"9-3\": \"Retry with card type element.\",\n    \"10-3\": \"Do not retry.\",\n    \"11-3\": \"Retry with 3D Secure authentication.\",\n    \"12-3\": \"Do not retry.\",\n    \"13-3\": \"Retry with a different card or decline the transaction.\",\n    \"14-3\": \"Retry with correct CVV code.\",\n    \"15-3\": \"Retry with different payment method or retry again in 24 hours.\",\n    \"16-3\": \"Retry with correct expiration date. If issue persists, retry with different payment method or decline the transaction.\",\n    \"17-3\": \"Retry. If issue persists, contact BlueSnap Support.\",\n    \"18-3\": \"Do not retry.\",\n    \"19-3\": \"Do not retry.\",\n    \"20-3\": \"Retry with different payment method, retry later, or decline the transaction.\",\n    \"21-3\": \"Retry with correct card number. If issue persists, retry with different payment method or decline the transaction.\",\n    \"22-3\": \"Retry with correct card number or different payment method, or decline the transaction.\",\n    \"23-3\": \"Retry with correct PIN, password, or ID. If issue persists, contact BlueSnap Support.\",\n    \"24-3\": \"Retry with different payment method, retry later, or decline the transaction.\",\n    \"25-3\": \"Do not retry.\",\n    \"26-3\": \"Retry with correct amount. If issues persists, decline the transaction.\",\n    \"27-3\": \"Do not retry.\",\n    \"28-3\": \"Retry. If issue persists, contact the issuing bank or decline the transaction.\",\n    \"29-3\": \"Retry.\",\n    \"30-3\": \"Retry.\",\n    \"31-3\": \"Retry.\",\n    \"32-3\": \"Do not retry.\",\n    \"33-3\": \"Do not retry.\",\n    \"34-3\": \"Contact BlueSnap Support.\",\n    \"35-3\": \"Retry with correct vaulted shopper ID.\",\n    \"36-3\": \"Do not retry.\",\n    \"37-3\": \"Retry with specified payment method.\",\n    \"38-3\": \"Retry with correct merchant transaction ID. If issue persists, contact BlueSnap Support.\",\n    \"39-3\": \"Contact BlueSnap Support.\",\n    \"40-3\": \"Retry with different payment method or decline the transaction.\",\n    \"41-3\": \"Retry Auth request with correct details.\",\n    \"42-3\": \"Do not retry.\",\n    \"43-3\": \"Do not retry. Create new transaction request.\",\n    \"44-3\": \"Retry with transaction ID.\",\n    \"45-3\": \"Retry with correct transaction ID.\",\n    \"46-3\": \"Do not retry.\",\n    \"47-3\": \"Retry with correct details.\",\n    \"48-3\": \"Retry with encrypted card number.\",\n    \"49-3\": \"Retry with encrypted security code.\"\n  },\n  \"cols\": 4,\n  \"rows\": 50\n}\n[/block]","excerpt":"","slug":"card-transaction-errors","type":"basic","title":"Card Transaction Errors"}

Card Transaction Errors


The following errors can be returned in response to a Card Transaction request. For details on how to address the error, refer to the Action column.

Code
Name
Description
Action

7

INVALID_TRANSACTION_TYPE

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

Retry after validating request. If issue persists, contact BlueSnap Support.

30

MISSING_SHOPPER_OR_CARD_HOLDER

No card holder or vaulted shopper id

Retry with card holder info or vaulted shopper ID.

85

INVALID_HTTP_METHOD

CAPTURE transactions should be sent using an HTTP PUT method

Retry with HTTP PUT method.

10000

INVALID_API_VERSION

The API version passed in the request is invalid.

Retry with correct API version.

10000

PAYMENT_GENERAL_FAILURE

A general payment failure has occurred.

Retry. If issue persists, contact BlueSnap Support.

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.

Retry with correct resource.

10001

INVALID_MERCHANT_TRANSACTION_ID

Merchant-transaction-id should be up to 50 characters

Retry with correct merchant transaction ID.

10001

INVALID_RECURRING_TRANSACTION

recurring-transaction element is missing or invalid

Retry with recurring transaction element.

10001

MERCHANT_CONFIGURATION_ERROR

Merchant Configuration Error

Contact BlueSnap Support.

10001

MISSING_CARD_TYPE

card-type element is required

Retry with card type element.

11001

XSS_EXCEPTION

User input suspected as malicious.

Do not retry.

14001

THREE_D_SECURITY_AUTHENTICATION_REQUIRED

3D security authentication is required.

Retry with 3D Secure authentication.

14002

CALL_ISSUER

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

Do not retry.

14002

CARD_LOST_OR_STOLEN

The card is lost or stolen.

Retry with a different card or decline the transaction.

14002

CVV_ERROR

Payment processing failure due to CVV error.

Retry with correct CVV code.

14002

DO_NOT_HONOR

Payment processing failure due to issuing bank decline.

Retry with different payment method or retry again in 24 hours.

14002

EXPIRED_CARD

Payment processing failure due to expired card.

Retry with correct expiration date. If issue persists, retry with 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.

Retry. If issue persists, contact BlueSnap Support.

14002

HIGH_RISK_ERROR

Payment processing failure due to high risk.

Do not retry.

14002

INCORRECT_INFORMATION

Payment processing failure due to incorrect information.

Description will contain additional information about the specific error.

Do not retry.

14002

INSUFFICIENT_FUNDS

Payment processing failure due to insufficient funds.

Retry with different payment method, retry later, or decline the transaction.

14002

INVALID_CARD_NUMBER

Payment processing failure due to invalid card number.

Retry with correct card number. If issue persists, retry with different payment method or decline the transaction.

14002

INVALID_CARD_TYPE

Payment processing failure due to invalid card type.

Retry with correct card number or different 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.

Retry with correct PIN, password, or ID. If issue persists, contact BlueSnap Support.

14002

LIMIT_EXCEEDED

Payment processing failure because card limit has exceeded.

Retry with different payment method, retry later, or decline the transaction.

14002

PICKUP_CARD

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

Do not retry.

14002

PROCESSING_AMOUNT_ERROR

Payment processing failure due to invalid amount for this transaction.

Retry with correct amount. If issues persists, decline the transaction.

14002

PROCESSING_DUPLICATE

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

Do not retry.

14002

PROCESSING_GENERAL_DECLINE

Payment processing failure due to an unspecified error returned.

Retry. If issue persists, contact the issuing bank or decline the transaction.

14002

PROCESSING_TIMEOUT

Payment processing failure due to timeout.

Retry.

14002

SYSTEM_TECHNICAL_ERROR

Payment processing failure due to system technical error.

Retry.

14002

THE_ISSUER_IS_UNAVAILABLE_OR_OFFLINE

Payment processing failure because the issuer is unavailable or offline.

Retry.

14002

THREE_D_SECURE_FAILURE

Payment processing failure due to 3D secure failure.

Do not retry.

14002

RESTRICTED_CARD

Payment processing failure due to restricted card.

Do not retry.

14016

NO_AVAILABLE_PROCESSORS

There are no available processors for the specific request.

Contact BlueSnap Support.

15008

SHOPPER_NOT_FOUND

The Shopper ID passed in the request was not found.

Retry with correct vaulted shopper ID.

15012

SHOPPER_COUNTRY_OFAC_SANCTIONED

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

Do not retry.

16003

MULTIPLE_PAYMENT_METHODS_NON_SELECTED

Shopper has multiple payment methods, but none is selected.

Retry with specified payment method.

20002

MULTIPLE_TRANSACTIONS_FOUND

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

Retry with correct merchant transaction ID. If issue persists, contact BlueSnap Support.

20003

TRANSACTION_LOCKED

Transaction ${transactionType} failed. Transaction locked.

Contact BlueSnap Support.

20004

TRANSACTION_PAYMENT_METHOD_NOT_SUPPORTED

Payment method is not supported.

Retry with different payment method or decline the transaction.

20005

TRANSACTION_NOT_AUTHORIZED

Transaction is not authorized.

Retry Auth request with correct details.

20006

TRANSACTION_ALREADY_EXISTS

Transaction AUTH_REVERSAL FAILED. Transaction already exists.

Do not retry.

20007

TRANSACTION_EXPIRED

Transaction is expired.

Do not retry. Create new transaction request.

20008

TRANSACTION_ID_REQUIRED

Transaction ID is required.

Retry with transaction ID.

20009

INVALID_TRANSACTION_ID

Transaction ID is invalid.

Retry with correct transaction ID.

20010

TRANSACTION_ALREADY_CAPTURED

Transaction was already captured.

Do not retry.

-

CREDIT_CARD_DETAILS_PLAIN_AND_ENCRYPTED

Shopper credit card cannot contain both plain and encrypted details.

Retry with correct details.

-

CREDIT_CARD_ENCRYPTED_NUMBER_REQUIRED

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

Retry with encrypted card number.

-

CREDIT_CARD_ENCRYPTED_SECURITY_CODE_REQUIRED

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

Retry with encrypted security code.