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.
90	`MISSING_CARD_TYPE`	`card-type` element is required	Retry with the `card-type` element
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.
14002	`THREE_D_SECURITY_AUTHENTICATION_REQUIRED`	3D security authentication is required.	Retry with 3D Secure authentication.
14002	`ACCOUNT_CLOSED`	Payment processing failure because account is closed.	Do not retry.
14002	`AUTHORIZATION_AMOUNT_ALREADY_REVERSED`	Payment processing failure because the authorization has already been reversed.	Do not retry.
14002	`AUTHORIZATION_AMOUNT_NOT_VALID`	Payment processing failure due to invalid amount for this transaction.	Retry with correct amount. If issue persists, decline the transaction.
14002	`AUTHORIZATION_EXPIRED`	Payment processing failure because the authorization has expired.	Do not retry.
14002	`AUTHORIZATION_REVOKED`	Authorization has been revoked for recurring transaction.	Do not retry.
14002	`AUTHORIZATION_NOT_FOUND`	Payment processing failure because the authorization was not found.	Do not retry.
14002	`BLS_CONNECTION_PROBLEM`	Your payment request could not be successfully completed.	Do not retry.
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.	Retry with a different payment method or retry in 24 hours.
14002	`INCORRECT_INFORMATION`	Payment processing failure due to incorrect information. Description will contain additional information about the specific error.	Do not retry.
14002	`INCORRECT_SETUP`	Payment processing failure due to incorrect setup.	Contact BlueSnap Support.
14002	`INSUFFICIENT_FUNDS`	Payment processing failure due to insufficient funds.	Retry with different payment method, retry later, or decline the transaction.
14002	`INVALID_AMOUNT`	Payment processing failure due to invalid amount for this transaction.	Retry with correct amount. If issue persists, 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	`INVALID_TRANSACTION`	Payment processing failure because this transaction is not allowed by the issuer.	Do not retry.
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	`REFUND_FAILED`	A general payment failure has occurred for this refund.	Retry. If issue persists, contact BlueSnap Support.
14002	`RESTRICTED_CARD`	Payment processing failure due to restricted card.	Do not retry.
14002	`STRONG_CUSTOMER_AUTHENTICATION_REQUIRED`	The transaction failed because there is no strong customer authentication.	Check the card details and try again.
14002	`SYSTEM_TECHNICAL_ERROR`	Payment processing failure due to problematic transaction.	Do not 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.
14011	`PAYMENT_METHOD_NOT_SUPPORTED`	Payment processing failure because the attempted operation is not supported for this payment method.	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.
20017	`TRANSACTION_CARD_NOT_VALID`	Transaction CAPTURE failed. Card is no longer valid.	Retry with different card information.
20031	`MISSING_RELEVANT_METHOD_FOR_SHOPPER`	Shopper has no relevant payment method. For example, CC.	Update the vaulted shopper with a relevant payment method. or Include the payment method in the Auth Only or Auth Capture request.
20036	`CREDIT_CARD_DETAILS_PLAIN_AND_ENCRYPTED`	Shopper credit card cannot contain both plain and encrypted details.	Retry with correct details.
20036	`CREDIT_CARD_ENCRYPTED_NUMBER_REQUIRED`	Encrypted Field 'Encrypted Card Number' is required.	Retry with encrypted card number.
20036	`CREDIT_CARD_ENCRYPTED_SECURITY_CODE_REQUIRED`	Encrypted Field 'Encrypted Security Code' is required.	Retry with encrypted security code.
24012	`USER_NOT_AUTHORIZED`	User is not authorized to perform the requested action
43008	`EXTERNAL_TAX_SERVICE_MISMATCH_CURRENCY`	The given currency must match the original tax quote currency.	Retry the transaction with the same currency as the tax quote. or Create a new tax quote with the desired currency and retry the transaction.
43009	`EXTERNAL_TAX_SERVICE_UNEXPECTED_TOTAL_PAYMENT`	The given total payment must match the original total calculated in the given tax quote reference.	Retry with the correct amount.
43010	`EXTERNAL_TAX_SERVICE_TAX_REFERENCE_ALREADY_USED`	The given tax reference was already in use. For example: the tax quote was not created by merchant trying to use it, the tax quote is expired, or the tax quote is non-existent.	Create a new tax quote and retry the transaction.